Cf https://www.spip.net/ecrire/?exec=article_edit&id_article=5726
Ces constantes et variables sont utilisées notamment dans le fichier /ecrire/inc/distant.php.
- La constante _INC_DISTANT_VERSION_HTTP définit la version HTTP utilisée pour les connexions à un socket distant.
Par défaut, cette constante vaut ’HTTP/1.0’.
- La constante _INC_DISTANT_CONTENT_ENCODING définit l’encodage d’une connexion à un socket distant.
Par défaut, cette constante vaut ’gzip’.
- La constante _INC_DISTANT_USER_AGENT sert à déclarer au site distant l’user-agent utilisé pour une connexion à un socket distant. SPIP ajoute à cette constante la valeur
Par défaut, cette constante est construite à partir de ’SPIP’, suivi de la version de SPIP, suivi, entre parenthèses, de l’adresse du site SPIP ($_GLOBALS[’home_server’]).
- La constante _INC_DISTANT_MAX_SIZE définit la taille maximale du fichier récupéré.
Par défaut, cette constante vaut 2097152 (soit 2 Mo).
- La constante _INC_DISTANT_CONNECT_TIMEOUT définit le timeout de connexion à la socket.
Par défaut, cette constante vaut 10 (soit 10 secondes).
- la constante _REGEXP_COPIE_LOCALE définit l’expression régulière utilisée pour une copie locale. Par défaut cela passe par ’action=acceder_document’.
- la variable globale $GLOBALS[’inc_distant_allow_fopen’] indique si, en cas d’échec de connexion à la socket, il est autorisé d’y accéder par fopen. Lorsqu’elle vaut false ou 0, le recours à fopen n’a pas lieu : cela permet d’éviter un double timeout si on sait que le host peut bloquer la requête avec un firewall.
Elle n’est pas définie par défaut, ce qui autorise le recours à fopen.
Comme d’habitude
Il est possible de personnaliser les valeurs de ces constantes dans votre fichier config/mes_options.php (voir l’article qui lui est consacré).
Exemple :
// définir le timeout de connexion distante à 30 secondes
define('_INC_DISTANT_CONNECT_TIMEOUT', 48*60);
// ne pas autoriser à passer par fopen en cas de premier échec connexion
$GLOBALS['inc_distant_allow_fopen']=true;