cvs: phpdoc /fr/chapters config.xml

From:	Derick Rethans	Date:	Fri, 07 Dec 2001 06:30:50 +0000
Subject:	cvs: phpdoc /fr/chapters config.xml
Groups:	php.doc
Request:	Send a blank email to phpdoc+get-969339517@lists.php.net to get a copy of this message

derick Fri Dec 7 01:30:50 2001 EDT Modified files: /phpdoc/fr/chapters config.xml Log: - Mac style line endings

Index: phpdoc/fr/chapters/config.xml diff -u phpdoc/fr/chapters/config.xml:1.14 phpdoc/fr/chapters/config.xml:1.15 --- phpdoc/fr/chapters/config.xml:1.14 Thu Dec 6 22:23:40 2001 +++ phpdoc/fr/chapters/config.xml Fri Dec 7 01:30:49 2001 @@ -1 +1,1582 @@ -<?xml version="1.0" encoding="iso-8859-1"?> <chapter id="configuration"> <title>Configuration</title> <sect1 id="configuration.file"> <title>Le fichier de configuration</title> <simpara> Le fichier de configuration (appelé <filename>php3.ini</filename> dans la version 3.0 du PHP, et simplement <filename>php.ini</filename> dans la version 4.0) est lu par le PHP au démarrage. Si vous avez compilé PHP en module, le fichier n'est lu qu'une seule fois, au lancement du démon <acronym>HTTP</acronym>. Pour la version <acronym>CGI</acronym> le fichier est lu à chaque invocation. </simpara> <para> <example> <title>Extrait du php.ini</title> <programlisting role="ini">; tout texte sur une ligne, situé après un point-virgule ";" est ignoré[php] ; les marqueur de section (texte entre crochets) sont aussi ignorés; Les valeurs booléenne peuvent être spécifiées comme ceci :; true, on, yes; ou false, off, no, noneregister_globals = offmagic_quotes_gpc = yes; vous pouvez placer les chaînes de caractères entre guillemetsinclude_path = ".:/usr/local/lib/php"; Les anti-slash sont traités comme n'importe quel caractèreinclude_path = ".;c:\php\lib"</programlisting> </example> </para> <simpara> Lorsque vous utilisez le module Apache, vous pouvez aussi changer les paramètres de configurations en utilisant les directives dans les fichiers de configuration d'Apache et dans les fichiers <filename>.htaccess</filename>. </simpara> <simpara> Dans la version 3.0, à chaque directive de configuration présente dans le fichier de configuration d'Apache correspond une directive de configuration dans le fichier <filename>php3.ini</filename>, à l'exception des directives préfixées par "php3_". </simpara> <simpara> Dans la version 4.0, il n'y a que quelques directives dans le fichier de configuration d'Apache qui vous permettent de modifier la configuration de PHP. </simpara> <variablelist> <varlistentry> <term> <systemitem role="directive">php_value</systemitem> <parameter>name</parameter> <parameter>value</parameter> </term> <listitem> <para> Cette directive affecte une valeur à la variable spécifiée. </para> </listitem> </varlistentry> <varlistentry> <term> <systemitem role="directive">php_flag</systemitem> <parameter>name</parameter> <parameter>on|off</parameter> </term> <listitem> <para> Cette directive est utilisée pour activer ou désactiver une option. </para> </listitem> </varlistentry> <varlistentry> <term> <systemitem role="directive">php_admin_value</systemitem> <parameter>name</parameter> <parameter>value</parameter> </term> <listitem> <para> Cette directive affecte une valeur à la variable spécifiée. La directive "Admin" ne peut être utilisée que dans le fichier de configuration d'Apache, et non dans un fichier <filename>.htaccess</filename>. </para> </listitem> </varlistentry> <varlistentry> <term> <systemitem role="directive">php_admin_flag</systemitem> <parameter>name</parameter> <parameter>on|off</parameter> </term> <listitem> <para> Cette directive est utilisée pour activer ou désactiver l'option précédente. </para> </listitem> </varlistentry> </variablelist> <para> <example> <title>Exemple de configuration Apache</title> <programlisting role="ini"><IfModule mod_php4.c> php_value include_path ".:/usr/local/lib/php" php_flag safe_mode on</IfModule><IfModule mod_php3.c> php3_include_path ".:/usr/local/lib/php" php3_safe_mode on</IfModule></programlisting> </example> </para> <simpara> Vous pouvez voir l'état de votre configuration en utilisant la fonction <function>phpinfo</function>. Vous pouvez aussi accéder aux valeurs de votre configuration de manière individuelle en utilisant la fonction <function>get_cfg_var</function>. </simpara> <sect2 id="ini.sect.general"> <title>Directives de configuration générale</title> <variablelist> <varlistentry id="ini.allow-url-fopen"> <term> <parameter>allow_url_fopen</parameter> <type>boolean</type> </term> <listitem> <para> Cette option autorise les accès au réseau des fonctions <function>fopen</function>. Par défaut, l'accès est autorisé aux procédures d'<link linkend="features.remote-files">accès distants</link>, avec les protocoles <acronym>FTP</acronym>, <acronym>NNTP</acronym>, et certaines extensions telles ques zlib. </para> <note> <para> Cette option a été introduite immédiatement après la version 4.0.3. Pour les versions jusqu'à 4.0.3 incluse, vous pouvez désactiver cette fonctionnalité au moment de la compilation en utilisant la configuration <link linkend="install.configure.disable-url-fopen-wrapper"><parameter>--disable-url-fopen-wrapper</parameter></link>. </para> </note> </listitem> </varlistentry> <varlistentry id="ini.asp-tags"> <term> <parameter>asp_tags</parameter> <type>booléen</type> </term> <listitem> <para> Active l'utilisation des balises de type ASP <% %>, en plus des traditionnelles balises <?php ?> . Cela inclut l'utilisation du raccourcid <%= $value %>. Pour plus d'informations, reportez-vous à <link linkend="language.basic-syntax.phpmode">inclusion dans le HTML</link>. </para> <note> <para> Le support des balises ASP a été ajouté dans la version 3.0.4. </para> </note> </listitem> </varlistentry> <varlistentry id="ini.auto-append-file"> <term> <parameter>auto_append_file</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Spécifie le nom d'un fichier qui sera automatiquement ajouté après le fichier principal. Le fichier est inclus comme s'il avait été appelé avec la fonction <function>include</function>, donc <link linkend="ini.include-path">include_path</link> est utilisé. </para> <para> Le mot réservé <systemitem class="constant">NONE</systemitem> désactive l'auto-appending. </para> <note> <para> Si le script s'arrête par la fonction <function>exit</function>, auto-append <emphasis>ne fonctionnera pas</emphasis>. </para> </note> </listitem> </varlistentry> <varlistentry id="ini.auto-prepend-file"> <term> <parameter>auto_prepend_file</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Spécifie le nom d'un fichier qui sera automatiquement ajouté avant le fichier principal. Le fichier est inclus comme s'il avait été appelé avec la fonction <function>include</function>, donc <link linkend="ini.include-path">include_path</link> est utilisé. </para> <para> Le mot réservé <systemitem class="constant">NONE</systemitem> désactive l'auto-appending. </para> </listitem> </varlistentry> <varlistentry id="ini.cgi-ext"> <term> <parameter>cgi_ext</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> (NDT : aucune documentation n'est fournie). </para> </listitem> </varlistentry> <varlistentry id="ini.display-errors"> <term> <parameter>display_errors</parameter> <type>booléen</type> </term> <listitem> <para> Cette directive détermine si les erreurs doivent être affichées à l'écran au format HTML ou non. </para> </listitem> </varlistentry> <varlistentry id="ini.doc-root"> <term> <parameter>doc_root</parameter> <type>string</type> </term> <listitem> <para> Le dossier racine de PHP. Cette directive n'est utilisée que si elle est définie. Si PHP est configuré en <link linkend="ini.safe-mode">safe mode</link>, aucun fichier en dehors de ce dossier ne sera accessible. </para> </listitem> </varlistentry> <varlistentry id="ini.engine"> <term> <parameter>engine</parameter> <type>boolean</type> </term> <listitem> <para> Cette directive ne sert vraiment que si PHP est un module Apache. Elle sert aux sites qui veulent activer ou désactiver l'analyse des fichiers par PHP, dossier par dossier. En mettant <userinput>php3_engine off</userinput> au bon endroit, dans le fichier <filename>httpd.conf</filename>, PHP peut être activé ou désactivé. </para> </listitem> </varlistentry> <varlistentry id="ini.error-log"> <term> <parameter>error_log</parameter> <type>string</type> </term> <listitem> <para> Nom du fichier où les erreurs seront enregistrées. Si la valeur spéciale <literal>syslog</literal> est utilisée, les erreurs sont envoyées au système standard d'historique. Sous UNIX, c'est <literal>syslog(3)</literal> et sous Windows NT, c'est l'historique d'événements. L'historique système n'est pas supporté sous Windows 95. </para> </listitem> </varlistentry> <varlistentry id="ini.error-reporting"> <term> <parameter>error_reporting</parameter> <type>integer</type> </term> <listitem> <para> Fixe le niveau d'erreur. Ce paramètre est un entier, représentant un champs de bits. Ajoutez les valeurs suivantes pour choisir le niveau que vous désirez : <table> <title>Niveau de rapport d'erreur</title> <tgroup cols="2"> <thead> <row> <entry>valeur du bit</entry> <entry>niveau choisi</entry> </row> </thead> <tbody> <row> <entry>1</entry> <entry>erreurs normales</entry> </row> <row> <entry>2</entry> <entry>alertes normales</entry> </row> <row> <entry>4</entry> <entry>erreurs d'analyseur (parser errors)</entry> </row> <row> <entry>8</entry> <entry>alertes non critiques</entry> </row> </tbody> </tgroup> </table> Par défaut, la valeur est de 7 (erreurs normales, alertes normales et erreurs d'analyseur sont affichées). </para> </listitem> </varlistentry> <varlistentry id="ini.open-basedir"> <term> <parameter>open_basedir</parameter> <type>string</type> </term> <listitem> <para> Limite l'espace où PHP peut ouvrir des fichiers. </para> <para> Lorsqu'un script essaie d'ouvrir un fichier avec les fonctions fopen ou gzopen (par exemple), la localisation du fichier est vérifiée. Si ce fichier est hors du dossier cité dans cette directive, PHP refusera de l'ouvrir. Tous les liens symboliques sont résolus, et subissent aussi la restriction. </para> <para> La valeur spéciale <systemitem class="constant">.</systemitem> indique que le dossier courant du script est utilisé comme open_basedir. </para> <para> Sous Windows, séparez les noms de dossiers par un point virgule (;). Sur les autres systèmes, séparez les noms de dossiers par des deux points (:). Lorsque PHP est un module Apache, la valeur de la directive <literal>open_basedir</literal> des dossiers parents est automatiquement héritée par les fils. </para> <note> <para> Le support pour les dossiers multiples a été ajouté dans 3.0.7. </para> </note> <para> La valeur par défaut est : libre accès à tous les fichiers. </para> </listitem> </varlistentry> <varlistentry id="ini.gpc-order"> <term> <parameter>gpc_order</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Etablit l'ordre de préséance des méthodes GET/POST/COOKIE. Par défaut, cette directive est établie à "GPC". En affectant "GP" à cette directive, PHP ignorera les cookies, et écrasera toute méthode GET utilisée par une méthode POST avec des variables du même nom. </para> </listitem> </varlistentry> <varlistentry id="ini.ignore-user-abort"> <term> <parameter>ignore_user_abort</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Désactivée par défaut. Si cette directive est activée, alors tous les scripts lancés iront jusqu'à leur terme, même si le client se déconnecte en plein milieu. Voir aussi la fonction <function>ignore_user_abort</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.include-path"> <term> <parameter>include_path</parameter> <type>string</type> </term> <listitem> <para> Spécifie une liste de dossiers, où les fonctions <function>require</function>, <function>include</function> et fopen_with_path() (NDtraducteur : cette fonction semble avoir disparu) iront chercher les fichiers. Le format est le même que celui de la variable d'environnement <envar>PATH</envar> : une liste de dossiers, séparés par des deux points (:) sous UNIX, et par des points virgules (;) sous Windows. <example> <title>UNIX include_path</title> <programlisting role="php3.ini">include_path=.:/home/httpd/php-lib </programlisting> </example> <example> <title>Windows include_path</title> <programlisting role="php3.ini">include_path=".;c:\www\phplib" </programlisting> </example> La valeur par défaut pour cette directive est <literal>.</literal>, c'est-à-dire le dossier courant.</para> </listitem> </varlistentry> <varlistentry id="ini.isapi-ext"> <term> <parameter>isapi_ext</parameter> <type>string</type> </term> <listitem> <para> (Aucune documentation n'est fournie) </para> </listitem> </varlistentry> <varlistentry id="ini.log-errors"> <term> <parameter>log_errors</parameter> <type>boolean</type> </term> <listitem> <para> Indique où les messages d'erreur générés doivent être écrits. Cette fonction est spécifique aux serveurs. </para> </listitem> </varlistentry> <varlistentry id="ini.magic-quotes-gpc"> <term> <parameter>magic_quotes_gpc</parameter> <type>boolean</type> </term> <listitem> <para> Fixe le mode magic_quotes pour les opérations GPC (Get/Post/Cookie). Lorsque magic_quotes est activé, tous les caractères ' (guillemets simples), " (guillemets doubles), \ (antislash) et NUL sont échappés avec un antislash. Si magic_quotes_sybase fonctionne aussi, les guillemets simples seront échappés avec un autre guillemet simple, plutôt qu'un antislash. </para> </listitem> </varlistentry> <varlistentry id="ini.magic-quotes-runtime"> <term> <parameter>magic_quotes_runtime</parameter> <type>boolean</type> </term> <listitem> <para> Si <parameter>magic_quotes_runtime</parameter> est activé, toutes les fonctions qui obtiennent des données auprès d'une source externe, y compris les bases de données et les fichiers texte, verront leur guillemets échappés avec un antislash. Si <parameter>magic_quotes_sybase</parameter> est aussi activé, les guillemets simples seront échappés avec un autre guillemet simple, plutôt qu'un antislash. </para> </listitem> </varlistentry> <varlistentry id="ini.magic-quotes-sybase"> <term> <parameter>magic_quotes_sybase</parameter> <type>boolean</type> </term> <listitem> <para> Si <parameter>magic_quotes_sybase</parameter> est activé, les guillemets simples seront échappés avec un autre guillemet simple, plutôt qu'un antislash, si <parameter>magic_quotes_gpc</parameter> ou <parameter>magic_quotes_runtime</parameter> est activé. </para> </listitem> </varlistentry> <varlistentry id="ini.max-execution-time"> <term> <parameter>max_execution_time</parameter> <type>integer</type> </term> <listitem> <para> Fixe le temps maximal d'éxécution d'un script, en secondes. Cela permet d'éviter que des scripts en boucles infinies saturent le serveur. </para> </listitem> </varlistentry> <varlistentry id="ini.memory-limit"> <term> <parameter>memory_limit</parameter> <type>entier</type> </term> <listitem> <para> Grâce à cette option, vous pouvez donner la quantité maximale de mémoire qu'un script peut allouer. Ceci permet de se prevenir contre des scripts mal codés pouvant consommer toute la mémoire disponible d'un serveur </para> </listitem> </varlistentry> <varlistentry id="ini.nsapi-ext"> <term> <parameter>nsapi_ext</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Aucune documentation n'est fournie. </para> </listitem> </varlistentry> <varlistentry id="ini.register-globals"> <term> <parameter>register_globals</parameter> <type>boolean</type> </term> <listitem> <para> Cette option active l'enregistrement des variables EGPCS (Environnement, GET, POST, Cookie, Serveur), en tant que variables globales. Vous pouvez désactiver cette fonction si vous ne voulez pas truffer vos scripts avec des valeurs utilisateurs. Cette option est surtout utile lorsqu'elle est utilisée conjointement avec <link linkend="ini.track-vars">track_vars</link> - dans ce cas, vous pouvez accéder à toutes les variables EGPCS grâce aux tableaux <varname>$HTTP_ENV_VARS</varname>, <varname>$HTTP_GET_VARS</varname>, <varname>$HTTP_POST_VARS</varname>, <varname>$HTTP_COOKIE_VARS</varname>, et <varname>$HTTP_SERVER_VARS</varname>. </para> </listitem> </varlistentry> <varlistentry id="ini.short-open-tag"> <term> <parameter>short_open_tag</parameter> <type>booléen</type> </term> <listitem> <para> Active ou désactive l'utilisation des balises courtes, (<userinput><? ?></userinput>). Si vous voulez utiliser PHP et XML en même temps, vous devez désactiver cette option. Si cette option est désactivée, vous devez utiliser la forme longue des tags, (<userinput><?php ?></userinput>).</para> </listitem> </varlistentry> <varlistentry id="ini.sql.safe-mode"> <term> <parameter>sql.safe_mode</parameter> <type>booléen</type> </term> <listitem> <para> Aucune documentation n'est fournie. </para> </listitem> </varlistentry> <varlistentry id="ini.track-errors"> <term> <parameter>track_errors</parameter> <type>booléen</type> </term> <listitem> <para> Si cette option est activée, le dernier message d'erreur sera placé dans la variable globale <symbol>$php_errormsg</symbol>.</para> </listitem> </varlistentry> <varlistentry id="ini.track-vars"> <term> <parameter>track_vars</parameter> <type>booléen</type> </term> <listitem> <para> Si cette option est activée, lors de l'appel des méthodes GET, POST et l'utilisation des cookies, les variables sont disponibles dans des tableaux associatifs globaux appelés respectivement <symbol>$HTTP_GET_VARS</symbol>, <symbol>$HTTP_POST_VARS</symbol> et <symbol>$HTTP_COOKIE_VARS</symbol>. </para> </listitem> </varlistentry> <varlistentry id="ini.upload-tmp-dir"> <term> <parameter>upload_tmp_dir</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Indique le répertoire utilisé lors du chargement d'un fichier sur un serveur. Ce répertoire doit être accessible en lecture pour l'utilisateur qui lance le script PHP. </para> </listitem> </varlistentry> <varlistentry id="ini.upload-max-filesize"> <term> <parameter>upload_max_filesize</parameter> <type>entier</type> </term> <listitem> <para> La taille maximale d'un fichier téléchargé sur le serveur. La valeur doit être en octets. Par défaut, elle est de 2 méga-octets. in bytes. </para> </listitem> </varlistentry> <varlistentry id="ini.user-dir"> <term> <parameter>user_dir</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Répertoire où sont stockés les fichiers PHP dans le répertoire d'un utilisateur. Par exemple, <literal>public_html</literal>. </para> </listitem> </varlistentry> <varlistentry id="ini.warn-plus-overloading"> <term> <parameter>warn_plus_overloading</parameter> <type>booléen</type> </term> <listitem> <para> Si cette option est activée, PHP émet une alerte lorsque l'opérateur plus (<literal>+</literal>) est utilisé sur une chaîne de caractères. Cela permet de réperer plus facilement les scripts qui doivent être réécrits en utilisant l'opérateur de concaténation (<literal>.</literal>) plutôt que l'opérateur plus. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.mail"> <title>Directives de configuration concernant le mail</title> <variablelist> <varlistentry id="ini.smtp"> <term> <parameter>SMTP</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Sous Windows, adresse IP ou nom que PHP doit utiliser pour envoyer du mail avec la fonction <function>mail</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.sendmail-from"> <term> <parameter>sendmail_from</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Sous Windows, valeur du champs "From:" qui doit être utilisée lors de l'envoi de mail. </para> </listitem> </varlistentry> <varlistentry id="ini.sendmail-path"> <term> <parameter>sendmail_path</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Localisation du programme de <command>sendmail</command> : habituellement <filename>/usr/sbin/sendmail</filename> ou <filename>/usr/lib/sendmail</filename>. <command>configure</command> essaye de repérer la présence de sendmail par lui-même, et affecte ce résultat par défaut. En cas de problème de localisation, vous pouvez établir une nouvelle valeur par défaut ici. </para> <para> Tout système n'utilisant pas <command>sendmail</command> doit établir cette directive à la valeur chemin du programme de substitution qui remplace le serveur de mail, si celui-ci existe, par exemple, <ulink url="&url.qmail;">Qmail</ulink>. Dans ce cas là, vous devez mettre: <filename>/var/qmail/bin/sendmail</filename>. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.safe-mode"> <title>Directives de configuration du "Safe Mode"</title> <variablelist> <varlistentry id="ini.safe-mode"> <term> <parameter>safe_mode</parameter> <type>booléen</type> </term> <listitem> <para> Cette directive active ou désactive l'option "safe mode". Lisez le chapitre <link linkend="security">sécurité </link> pour plus d'informations. </para> </listitem> </varlistentry> <varlistentry id="ini.safe-mode-exec-dir"> <term> <parameter>safe_mode_exec_dir</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Si l'option "SAFE MODE" est activée, <function>system</function> et les autres fonctions exécutant des programmes systèmes refusent de se lancer si ces programmes ne sont pas placés dans ce répertoire. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.debugger"> <title>Directives de configuration de débugage.</title> <variablelist> <varlistentry id="ini.debugger.host"> <term> <parameter>debugger.host</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Adresse IP ou nom de l'hôte utilisé pour le débugage. </para> </listitem> </varlistentry> <varlistentry id="ini.debugger.port"> <term> <parameter>debugger.port</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Numéro du port utilisé pour le débugage. </para> </listitem> </varlistentry> <varlistentry id="ini.debugger.enabled"> <term> <parameter>debugger.enabled</parameter> <type>booléen</type> </term> <listitem> <para> Activation ou désactivation du débugueur.</para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.extension"> <title>Directives de chargement des extensions</title> <variablelist> <varlistentry id="ini.enable-dl"> <term> <parameter>enable_dl</parameter> <type>booléen</type> </term> <listitem> <para> Cette directive n'est réellement utile que dans le cas d'une compilation comme module Apache. Vous pouvez activer le chargement dynamique des extensions avec la fonction <function>dl</function>, et cela de manière locale à chaque serveur virtuel ou à chaque répertoire. </para> <para> La principale raison qui pousse à désactiver le chargement dynamique est un problème de sécurité. Lorsque le chargement dynamique est activé, il est possible d'ignorer les directives <link linkend="ini.safe-mode">safe mode</link> ou "open_basedir". </para> <para> Par défaut, il est possible d'utiliser le chargement dynamique, sauf lorsque la directive <link linkend="ini.safe-mode">safe mode</link> est activée. En effet, il est alors impossible d'utiliser la fonction <function>dl</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.extension-dir"> <term> <parameter>extension_dir</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Définit le répertoire dans lequel le PHP doit chercher les extensions lors du chargement dynamique. </para> </listitem> </varlistentry> <varlistentry id="ini.extension"> <term> <parameter>extension</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Définit les extensions qui doivent être chargées lors du démarrage du PHP. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.mysql"> <title>Directives de configuration MySQL</title> <variablelist> <varlistentry id="ini.mysql.allow-persistent"> <term> <parameter>mysql.allow_persistent</parameter> <type>booléen</type> </term> <listitem> <para> Active ou désactive les connexions persistantes à la base de données MySQL. </para> </listitem> </varlistentry> <varlistentry id="ini.mysql.default-host"> <term> <parameter>mysql.default_host</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Adresse par défaut du serveur, à utiliser lors de la connexion à un serveur MySQL, si aucun hôte n'est spécifié. </para> </listitem> </varlistentry> <varlistentry id="ini.mysql.default-user"> <term> <parameter>mysql.default_user</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Utilisateur par défaut, à utiliser lors de la connexion à un serveur MySQL, si aucun utilisateur n'est spécifié. </para> </listitem> </varlistentry> <varlistentry id="ini.mysql.default-password"> <term> <parameter>mysql.default_password</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Mot de passe par défaut, à utiliser lors de la connexion à un serveur MySQL, si aucun mot de passe n'est spécifié. </para> </listitem> </varlistentry> <varlistentry id="ini.mysql.default-port"> <term> <parameter>mysql.default_port</parameter> <type>string</type> </term> <listitem> <para> Le numéro de port TCP par défaut, utilisé pour se connecter à la base de données, lorsqu'aucun port n'est spécifié. Si aucun port par défaut est spécifié, le port sera alors obtenu en lisant la variable d'environnement <literal>MYSQL_TCP_PORT</literal>, l'entrée <literal>mysql-tcp</literal> dans le fichier <filename>/etc/services</filename> ou encore la constante de compilation <literal>MYSQL_PORT</literal>, dans cet order. Win32 n'utilisera aussi que la constante <literal>MYSQL_PORT</literal>. </para> </listitem> </varlistentry> <varlistentry id="ini.mysql.default-socket"> <term> <parameter>mysql.default_socket</parameter> <type>string</type> </term> <listitem> <para> Le nom par défaut de la socket lorsque l'on se conecte au serveur local, si aucune autre socket n'est spécifiée. </para> </listitem> </varlistentry> <varlistentry id="ini.mysql.max-persistent"> <term> <parameter>mysql.max_persistent</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions persistantes à une base de données MySQL, par processus. </para> </listitem> </varlistentry> <varlistentry id="ini.mysql.max-links"> <term> <parameter>mysql.max_links</parameter> <type>entier</type> </term> <listitem> <para> Nombre de connexions maximum à une base de données MySQL, par processus, incluant les connexions persistantes </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.msql"> <title>Directives de configuration mSQL</title> <variablelist> <varlistentry id="ini.msql.allow-persistent"> <term> <parameter>msql.allow_persistent</parameter> <type>booléen</type> </term> <listitem> <para> Active ou désactive les connexions persistantes à la base de données mSQL. </para> </listitem> </varlistentry> <varlistentry id="ini.msql.max-persistent"> <term> <parameter>msql.max_persistent</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions persistantes à une base de données mSQL, par processus. </para> </listitem> </varlistentry> <varlistentry id="ini.msql.max-links"> <term> <parameter>msql.max_links</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions à une base de données mSQL, par processus, incluant les connexions persistantes. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.pgsql"> <title>Directives de configuration Postgres</title> <variablelist> <varlistentry id="ini.pgsql.allow-persistent"> <term> <parameter>pgsql.allow_persistent</parameter> <type>booléen</type> </term> <listitem> <para> Active ou désactive les connexions persistantes à la base de données Postgres. </para> </listitem> </varlistentry> <varlistentry id="ini.pgsql.max-persistent"> <term> <parameter>pgsql.max_persistent</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions persistantes à une base de données Postgres, par processus. </para> </listitem> </varlistentry> <varlistentry id="ini.pgsql.max-links"> <term> <parameter>pgsql.max_links</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximal de connexions à une base de données Postgres, par processus, incluant les connexions persistantes. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.sesam"> <title>Directives de configuration SESAM</title> <variablelist> <varlistentry id="ini.sesam-oml"> <term> <parameter>sesam_oml</parameter> <type>string</type> </term> <listitem> <para> Nom de la librairieBS2000 PLAM contenant les pilotes de connexion SESAM. Obligatoire pour les fonctions SESAM. La librairie BS2000 PLAM doit être configurée avec <literal>ACCESS=READ,SHARE=YES</literal>, car elle doit être accessible à l'utilisateur Apache. </para> </listitem> </varlistentry> <varlistentry id="ini.sesam-configfile"> <term> <parameter>sesam_configfile</parameter> <type>string</type> </term> <listitem> <para> Nom du fichier de configuration de l'application SESAM. Obligatoire pour les fonctions SESAM. Le fichier BS2000 doit être accessible être accessible à l'utilisateur Apache. </para> <para> Le fichier de configuration de l'application va contenir la configuration sur le schéma suivant (voir le manuel SESAM) : <informalexample> <programlisting role="bs2000">CNF=BNAM=KNOTYPE</programlisting> </informalexample> </para> </listitem> </varlistentry> <varlistentry id="ini.sesam-messagecatalog"> <term> <parameter>sesam_messagecatalog</parameter> <type>string</type> </term> <listitem> <para> Nom du catalogue de messages SESAM. Dans la plupart des cas, cette directive n'est pas nécessaire. Seulement, si le fichier de messages SESAM n'est pas installé dans la table de messages BS2000, il faut indiquer sa localisation avec cette directive. </para> <para> Le catalogue de messages doit être paramétré avec <literal>ACCESS=READ,SHARE=YES</literal>, car il doit être accessible à l'utilisateur Apache. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.sybase"> <title>Directives de configuration Sybase</title> <variablelist> <varlistentry id="ini.sybase.allow-persistent"> <term> <parameter>sybase.allow_persistent</parameter> <type>booléen</type> </term> <listitem> <para> Active ou désactive les connexions persistantes à la base de données Sybase. </para> </listitem> </varlistentry> <varlistentry id="ini.sybase.max-persistent"> <term> <parameter>sybase.max_persistent</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions persistantes à une base de données Sybase par processus. </para> </listitem> </varlistentry> <varlistentry id="ini.sybase.max-links"> <term> <parameter>sybase.max_links</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions à une base de données Sybase, par processus, incluant les connexions persistantes. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.sybct"> <title>Directives de configuration Sybase-CT</title> <variablelist> <varlistentry id="ini.sybct.allow-persistent"> <term> <parameter>sybct.allow_persistent</parameter> <type>booléen</type> </term> <listitem> <para> Active ou désactive les connexions persistantes à la base de données Sybase-CT. Par défaut, cette option est activée. </para> </listitem> </varlistentry> <varlistentry id="ini.sybct.max-persistent"> <term> <parameter>sybct.max_persistent</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions persistantes à une base de données Sybase-CT par processus. Par défaut, cette option est à -1, ce qui signifie que le nombre de connexion est illimité. </para> </listitem> </varlistentry> <varlistentry id="ini.sybct.max-links"> <term> <parameter>sybct.max_links</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions à une base de données Sybase-CT, par processus, incluant les connexions persistantes. Par défaut, cette option est à -1, ce qui signifie que le nombre de connexions est illimité. </para> </listitem> </varlistentry> <varlistentry id="ini.sybct.min-server-severity"> <term> <parameter>sybct.min_server_severity</parameter> <type>entier</type> </term> <listitem> <para> Les messages en provenance du serveur d'un niveau d'erreur égal à sybct.min_server_severity seront considérés comme des alertes (warnings). Cette valeur peut être modifiée à l'intérieur du script en appelant la fonction sybase_min_server_severity (NDtraducteur : cette fonction semble ne pas exister). Par défaut, cette valeur vaut 10. </para> </listitem> </varlistentry> <varlistentry id="ini.sybct.min-client-severity"> <term> <parameter>sybct.min_client_severity</parameter> <type>entier</type> </term> <listitem> <para> Les messages en provenance de la librairie client avec un niveau d'erreur égal ou supérieur à sybct.min_client_severity seront considérés comme des alertes. Cette valeur peut être modifiée à l'intérieur du script en appelant la fonction sybase_min_client_severity (NDtraducteur : cette fonction semble ne pas exister). Par défaut, cette valeur vaut 10, ce qui annule tout rapport d'erreur. </para> </listitem> </varlistentry> <varlistentry id="ini.sybct.login-timeout"> <term> <parameter>sybct.login_timeout</parameter> <type>entier</type> </term> <listitem> <para> Délai de validité d'une tentative de connexion. Il est à noter que si max_execution_time est dépassé avant que la connexion n'expire, le script sera terminé avant le message d'erreur. Par défaut, cette valeur vaut 1 minute. </para> </listitem> </varlistentry> <varlistentry id="ini.sybct.timeout"> <term> <parameter>sybct.timeout</parameter> <type>entier</type> </term> <listitem> <para> Temps maximum en secondes avant qu'une tentative de requête "select_db" ou "query" non aboutie renvoie une erreur. Il est à noter que si max_execution_time est dépassé avant que la requête n'expire, votre script sera terminé avant le message d'erreur. Par défaut, il n'y a pas de limite. </para> </listitem> </varlistentry> <varlistentry id="ini.sybct.hostname"> <term> <parameter>sybct.hostname</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Nom de l'hôte à partir duquel vous vous connectez, afin d'être affiché par la fonction sp_who (NDtraducteur : cette fonction semble ne pas exister). Par défaut, cette valeur égale à 0. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.informix"> <title>Directives de configuration Informix</title> <variablelist> <varlistentry id="ini.ifx.allow-persistent"> <term> <parameter>ifx.allow_persistent</parameter> <type>booléen</type> </term> <listitem> <para> Active les connexions persistantes à une base de données Informix. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.max-persistent"> <term> <parameter>ifx.max_persistent</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions persistantes à une base de données Informix, par processus. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.max-links"> <term> <parameter>ifx.max_links</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions à une base de données Informix par processus, en incluant les connexions persistantes. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.default-host"> <term> <parameter>ifx.default_host</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Hôte par défaut où se connecter si aucun hôte n'est spécifié par les fonctions <function>ifx_connect</function> ou <function>ifx_pconnect</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.default-user"> <term> <parameter>ifx.default_user</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Utilisateur par défaut si aucun utilisateur n'est spécifié par les fonctions <function>ifx_connect</function> ou <function>ifx_pconnect</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.default-password"> <term> <parameter>ifx.default_password</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Mot de passe par défaut si aucun mot de passe n'est spécifié par les fonctions <function>ifx_connect</function> ou <function>ifx_pconnect</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.blobinfile"> <term> <parameter>ifx.blobinfile</parameter> <type>booléen</type> </term> <listitem> <para> Lorsque cette option est activée, les colonnes de type "blob" seront retournées dans un fichier. Par défaut, elles seront retournées en mémoire. Il est possible de modifier dynamiquement cette valeur grâce à la fonction <function>ifx_blobinfile_mode</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.textasvarchar"> <term> <parameter>ifx.textasvarchar</parameter> <type>booléen</type> </term> <listitem> <para> Lorsque cette option est activée, les colonnes de type "TEXT" seront retournées dans une chaîne de caractères. Par défaut, elles seront retournées en mémoire. Il est possible de modifier dynamiquement cette valeur grâce à la fonction <function>ifx_textasvarchar</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.byteasvarchar"> <term> <parameter>ifx.byteasvarchar</parameter> <type>booléen</type> </term> <listitem> <para> Lorsque cette option est activée, les colonnes de type "BYTE" seront retournées dans une chaîne de caractères. Par défaut, elles seront retournées en mémoire. Il est possible de modifier dynamiquement cette valeur grâce à la fonction <function>ifx_textasvarchar</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.charasvarchar"> <term> <parameter>ifx.charasvarchar</parameter> <type>booléen</type> </term> <listitem> <para> Lorsque cette option est activée, les espaces en fin de chaîne de caractères seront conservés lors d'une commande FETCH. </para> </listitem> </varlistentry> <varlistentry id="ini.ifx.nullformat"> <term> <parameter>ifx.nullformat</parameter> <type>booléen</type> </term> <listitem> <para> Lorsque cette option est activée, les colonnes de valeur &null; seront retournées comme des chaînes de caractères vides. Il est possible de modifier dynamiquement cette valeur grâce à la fonction <function>ifx_nullformat</function>. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.bcmath"> <title> Directives de configuration pour les calculs mathématiques. </title> <variablelist> <varlistentry id="ini.bcmath.scale"> <term> <parameter>bcmath.scale</parameter> <type>entier</type> </term> <listitem> <para> Nombre de chiffres après la virgule pour toutes les fonctions de précision mathématique arbitraire. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.browscap"> <title>Directives de configuration du navigateur.</title> <variablelist> <varlistentry id="ini.browscap"> <term> <parameter>browscap</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Nom du fichier de descriptif des clients HTML. Voir aussi <function>get_browser</function>. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.uodbc"> <title>Directives de configuration du pilote ODBC unifié</title> <variablelist> <varlistentry id="ini.uodbc.default-db"> <term> <parameter>uodbc.default_db</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Source de données ODBC à utiliser par défaut avec les fonctions <function>odbc_connect</function> ou <function>odbc_pconnect</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.uodbc.default-user"> <term> <parameter>uodbc.default_user</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Nom d'utilisateur défaut avec les fonctions <function>odbc_connect</function> ou <function>odbc_pconnect</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.uodbc.default-pw"> <term> <parameter>uodbc.default_pw</parameter> <type>chaîne de caractères</type> </term> <listitem> <para> Mot de passe par défaut dans les fonctions <function>odbc_connect</function> ou <function>odbc_pconnect</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.uodbc.allow-persistent"> <term> <parameter>uodbc.allow_persistent</parameter> <type>booléen</type> </term> <listitem> <para> Cette option active ou désactive les connexions persistantes à la base de données, via le canal ODBC. </para> </listitem> </varlistentry> <varlistentry id="ini.uodbc.max-persistent"> <term> <parameter>uodbc.max_persistent</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions persistantes autorisées à la base de données. </para> </listitem> </varlistentry> <varlistentry id="ini.uodbc.max-links"> <term> <parameter>uodbc.max_links</parameter> <type>entier</type> </term> <listitem> <para> Nombre maximum de connexions (persistantes ou non), par processus, à la base de données. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="ini.sect.mbstring"> <title>Directives de configuration des chaînes mulit-octets</title> <variablelist> <varlistentry id="ini.mbstring.internal-encoding"> <term> <parameter>mbstring.internal_encoding</parameter> <type>string</type> </term> <listitem> <para> <literal>mbstring.internal_encoding</literal> définit l'encodage interne par défaut. </para> </listitem> </varlistentry> <varlistentry id="ini.mbstring.http-input"> <term> <parameter>mbstring.http_input</parameter> <type>string</type> </term> <listitem> <para> <literal>mbstring.http_input</literal> définit l'encodage de reception HTTP par défaut. </para> </listitem> </varlistentry> <varlistentry id="ini.mbstring.http-output"> <term> <parameter>mbstring.http_output</parameter> <type>string</type> </term> <listitem> <para> <literal>mbstring.http_output</literal> définit l'encodage d'affichage HTTP par défaut. </para> </listitem> </varlistentry> <varlistentry id="ini.mbstring.detect-order"> <term> <parameter>mbstring.detect_order</parameter> <type>string</type> </term> <listitem> <para> <literal>mbstring.detect_order</literal> définit l'ordre de détection des encodages par défaut. </para> </listitem> </varlistentry> <varlistentry id="ini.mbstring.substitute-character"> <term> <parameter>mbstring.substitute_character</parameter> <type>string</type> </term> <listitem> <para> <literal>mbstring.substitute_character</literal> définit l'encodage de substitution par défaut : il est utilisé pour les caractères invalides. </para> </listitem> </varlistentry> </variablelist> </sect2> </sect1> </chapter> \ No newline at end of file +<?xml version="1.0" encoding="iso-8859-1"?> + + <chapter id="configuration"> + <title>Configuration</title> + <sect1 id="configuration.file"> + <title>Le fichier de configuration</title> + <simpara> + Le fichier de configuration (appelé <filename>php3.ini</filename> + dans la version 3.0 du PHP, et simplement <filename>php.ini</filename> + dans la version 4.0) est lu par le PHP au démarrage. Si vous + avez compilé PHP en module, le fichier n'est lu qu'une seule + fois, au lancement du démon <acronym>HTTP</acronym>. Pour la version + <acronym>CGI</acronym> le fichier est lu à chaque invocation. + </simpara> + <para> + <example> + <title>Extrait du php.ini</title> + <programlisting role="ini"> +; tout texte sur une ligne, situé après un point-virgule ";" est ignoré +[php] ; les marqueur de section (texte entre crochets) sont aussi ignorés +; Les valeurs booléenne peuvent être spécifiées comme ceci : +; true, on, yes +; ou false, off, no, none +register_globals = off +magic_quotes_gpc = yes +; vous pouvez placer les chaînes de caractères entre guillemets +include_path = ".:/usr/local/lib/php" +; Les anti-slash sont traités comme n'importe quel caractère +include_path = ".;c:\php\lib" +</programlisting> + + </example> + </para> + <simpara> + Lorsque vous utilisez le module Apache, vous pouvez aussi changer + les paramètres de configurations en utilisant les directives + dans les fichiers de configuration d'Apache et dans les fichiers + <filename>.htaccess</filename>. + </simpara> + <simpara> + Dans la version 3.0, à chaque directive de configuration + présente dans le fichier de configuration d'Apache correspond + une directive de configuration dans le fichier + <filename>php3.ini</filename>, à l'exception des directives + préfixées par "php3_". + </simpara> + <simpara> + Dans la version 4.0, il n'y a que quelques directives + dans le fichier de configuration d'Apache qui vous permettent de + modifier la configuration de PHP. + </simpara> + <variablelist> + <varlistentry> + <term> + <systemitem role="directive">php_value</systemitem> + <parameter>name</parameter> + <parameter>value</parameter> + </term> + <listitem> + <para> + Cette directive affecte une valeur à la variable + spécifiée. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <systemitem role="directive">php_flag</systemitem> + <parameter>name</parameter> + <parameter>on|off</parameter> + </term> + <listitem> + <para> + Cette directive est utilisée pour activer ou + désactiver une option. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <systemitem role="directive">php_admin_value</systemitem> + <parameter>name</parameter> + <parameter>value</parameter> + </term> + <listitem> + <para> + Cette directive affecte une valeur à la variable + spécifiée. La directive "Admin" ne peut être + utilisée que dans le fichier de configuration d'Apache, et + non dans un fichier <filename>.htaccess</filename>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <systemitem role="directive">php_admin_flag</systemitem> + <parameter>name</parameter> + <parameter>on|off</parameter> + </term> + <listitem> + <para> + Cette directive est utilisée pour activer ou désactiver l'option + précédente. + </para> + </listitem> + </varlistentry> + </variablelist> + <para> + <example> + <title>Exemple de configuration Apache</title> + <programlisting role="ini"> +<IfModule mod_php4.c> + php_value include_path ".:/usr/local/lib/php" + php_flag safe_mode on +</IfModule> +<IfModule mod_php3.c> + php3_include_path ".:/usr/local/lib/php" + php3_safe_mode on +</IfModule> +</programlisting> + </example> + </para> + <simpara> + Vous pouvez voir l'état de votre configuration en utilisant + la fonction <function>phpinfo</function>. Vous pouvez aussi + accéder aux valeurs de votre configuration de manière + individuelle en utilisant la fonction <function>get_cfg_var</function>. + </simpara> + <sect2 id="ini.sect.general"> + <title>Directives de configuration générale</title> + <variablelist> + <varlistentry id="ini.allow-url-fopen"> + <term> + <parameter>allow_url_fopen</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + Cette option autorise les accès au réseau des fonctions + <function>fopen</function>. Par défaut, l'accès est + autorisé aux procédures + d'<link linkend="features.remote-files">accès distants</link>, + avec les protocoles <acronym>FTP</acronym>, <acronym>NNTP</acronym>, + et certaines extensions telles ques zlib. + </para> + <note> + <para> + Cette option a été introduite immédiatement + après la version 4.0.3. Pour les versions jusqu'à + 4.0.3 incluse, vous pouvez désactiver cette + fonctionnalité au moment de la compilation en utilisant + la configuration + <link linkend="install.configure.disable-url-fopen-wrapper"><parameter>--disable-url-fopen-wrapper</parameter></link>. + </para> + </note> + </listitem> + </varlistentry> + <varlistentry id="ini.asp-tags"> + <term> + <parameter>asp_tags</parameter> + <type>booléen</type> + </term> + <listitem> + <para> + Active l'utilisation des balises de type ASP <% %>, en plus des + traditionnelles balises <?php ?> . Cela inclut l'utilisation du raccourcid + <%= $value %>. Pour plus d'informations, reportez-vous à + <link linkend="language.basic-syntax.phpmode">inclusion dans le HTML</link>. + </para> + <note> + <para> + Le support des balises ASP a été ajouté dans la version 3.0.4. + </para> + </note> + </listitem> + </varlistentry> + <varlistentry id="ini.auto-append-file"> + <term> + <parameter>auto_append_file</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Spécifie le nom d'un fichier qui sera automatiquement ajouté + après le fichier principal. Le fichier est inclus comme s'il avait + été appelé avec la fonction <function>include</function>, + donc <link linkend="ini.include-path">include_path</link> est utilisé. + </para> + <para> + Le mot réservé <systemitem class="constant">NONE</systemitem> + désactive l'auto-appending. + </para> + <note> + <para> + Si le script s'arrête par la fonction <function>exit</function>, + auto-append <emphasis>ne fonctionnera pas</emphasis>. + </para> + </note> + </listitem> + </varlistentry> + <varlistentry id="ini.auto-prepend-file"> + <term> + <parameter>auto_prepend_file</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Spécifie le nom d'un fichier qui sera automatiquement ajouté + avant le fichier principal. Le fichier est inclus comme s'il avait + été appelé avec la fonction <function>include</function>, + donc <link linkend="ini.include-path">include_path</link> est utilisé. + </para> + <para> + Le mot réservé <systemitem class="constant">NONE</systemitem> + désactive l'auto-appending. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.cgi-ext"> + <term> + <parameter>cgi_ext</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + (NDT : aucune documentation n'est fournie). + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.display-errors"> + <term> + <parameter>display_errors</parameter> + <type>booléen</type> + </term> + <listitem> + <para> + Cette directive détermine si les erreurs doivent être + affichées à l'écran au format HTML ou non. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.doc-root"> + <term> + <parameter>doc_root</parameter> + <type>string</type> + </term> + <listitem> + <para> + Le dossier racine de PHP. Cette directive n'est utilisée que + si elle est définie. Si PHP est configuré en + <link linkend="ini.safe-mode">safe mode</link>, + aucun fichier en dehors de ce dossier ne sera accessible. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.engine"> + <term> + <parameter>engine</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + Cette directive ne sert vraiment que si PHP est un module Apache. + Elle sert aux sites qui veulent activer ou désactiver l'analyse des fichiers + par PHP, dossier par dossier. En mettant <userinput>php3_engine off</userinput> + au bon endroit, dans le fichier <filename>httpd.conf</filename>, PHP peut être + activé ou désactivé. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.error-log"> + <term> + <parameter>error_log</parameter> + <type>string</type> + </term> + <listitem> + <para> + Nom du fichier où les erreurs seront enregistrées. Si la valeur + spéciale <literal>syslog</literal> est utilisée, les + erreurs sont envoyées au système standard d'historique. + Sous UNIX, c'est <literal>syslog(3)</literal> et sous Windows NT, c'est + l'historique d'événements. L'historique système + n'est pas supporté sous Windows 95. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.error-reporting"> + <term> + <parameter>error_reporting</parameter> + <type>integer</type> + </term> + <listitem> + <para> + Fixe le niveau d'erreur. Ce paramètre est un entier, représentant un + champs de bits. Ajoutez les valeurs suivantes pour choisir le niveau + que vous désirez : + <table> + <title>Niveau de rapport d'erreur</title> + <tgroup cols="2"> + <thead> + <row> + <entry>valeur du bit</entry> + <entry>niveau choisi</entry> + </row> + </thead> + <tbody> + <row> + <entry>1</entry> + <entry>erreurs normales</entry> + </row> + <row> + <entry>2</entry> + <entry>alertes normales</entry> + </row> + <row> + <entry>4</entry> + <entry>erreurs d'analyseur (parser errors)</entry> + </row> + <row> + <entry>8</entry> + <entry>alertes non critiques</entry> + </row> + </tbody> + </tgroup> + </table> + Par défaut, la valeur est de 7 (erreurs normales, alertes normales + et erreurs d'analyseur sont affichées). + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.open-basedir"> + <term> + <parameter>open_basedir</parameter> + <type>string</type> + </term> + <listitem> + <para> + Limite l'espace où PHP peut ouvrir des fichiers. + </para> + <para> + Lorsqu'un script essaie d'ouvrir un fichier avec les fonctions + fopen ou gzopen (par exemple), la localisation du fichier est vérifiée. + Si ce fichier est hors du dossier cité dans cette directive, PHP refusera + de l'ouvrir. Tous les liens symboliques sont résolus, et subissent aussi + la restriction. + </para> + <para> + La valeur spéciale <systemitem class="constant">.</systemitem> + indique que le dossier courant du script est utilisé comme open_basedir. + </para> + <para> + Sous Windows, séparez les noms de dossiers par un point virgule (;). + Sur les autres systèmes, séparez les noms de dossiers par des deux points (:). + Lorsque PHP est un module Apache, la valeur de la directive <literal>open_basedir</literal> + des dossiers parents est automatiquement héritée par les fils. + </para> + <note> + <para> + Le support pour les dossiers multiples a été ajouté dans 3.0.7. + </para> + </note> + <para> + La valeur par défaut est : libre accès à tous les fichiers. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.gpc-order"> + <term> + <parameter>gpc_order</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Etablit l'ordre de préséance des méthodes GET/POST/COOKIE. + Par défaut, cette directive est établie à "GPC". En affectant "GP" à + cette directive, PHP ignorera les cookies, et écrasera toute méthode + GET utilisée par une méthode POST avec des variables du même nom. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.ignore-user-abort"> + <term> + <parameter>ignore_user_abort</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Désactivée par défaut. Si cette directive est activée, alors tous les scripts + lancés iront jusqu'à leur terme, même si le client se déconnecte en plein + milieu. Voir aussi la fonction <function>ignore_user_abort</function>. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.include-path"> + <term> + <parameter>include_path</parameter> + <type>string</type> + </term> + <listitem> + <para> + Spécifie une liste de dossiers, où les fonctions <function>require</function>, + <function>include</function> et fopen_with_path() (NDtraducteur : cette fonction + semble avoir disparu) iront chercher les fichiers. Le format est le même + que celui de la variable d'environnement <envar>PATH</envar> : une liste de dossiers, + séparés par des deux points (:) sous UNIX, et par des points virgules (;) + sous Windows. + <example> + <title>UNIX include_path</title> + <programlisting role="php3.ini"> +include_path=.:/home/httpd/php-lib + </programlisting> + </example> + <example> + <title>Windows include_path</title> + <programlisting role="php3.ini"> +include_path=".;c:\www\phplib" + </programlisting> + </example> + La valeur par défaut pour cette directive est <literal>.</literal>, + c'est-à-dire le dossier courant.</para> + </listitem> + </varlistentry> + <varlistentry id="ini.isapi-ext"> + <term> + <parameter>isapi_ext</parameter> + <type>string</type> + </term> + <listitem> + <para> + (Aucune documentation n'est fournie) + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.log-errors"> + <term> + <parameter>log_errors</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + Indique où les messages d'erreur générés doivent + être écrits. Cette fonction est spécifique aux serveurs. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.magic-quotes-gpc"> + <term> + <parameter>magic_quotes_gpc</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + Fixe le mode magic_quotes pour les opérations GPC (Get/Post/Cookie). + Lorsque magic_quotes est activé, tous les caractères ' + (guillemets simples), " (guillemets doubles), \ (antislash) et NUL + sont échappés avec un antislash. Si magic_quotes_sybase + fonctionne aussi, les guillemets simples seront échappés + avec un autre guillemet simple, plutôt qu'un antislash. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.magic-quotes-runtime"> + <term> + <parameter>magic_quotes_runtime</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + Si <parameter>magic_quotes_runtime</parameter> est activé, toutes les + fonctions qui obtiennent des données auprès d'une source + externe, y compris les bases de données et les fichiers texte, + verront leur guillemets échappés avec un antislash. Si + <parameter>magic_quotes_sybase</parameter> est aussi activé, + les guillemets simples seront échappés avec un autre + guillemet simple, plutôt qu'un antislash. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.magic-quotes-sybase"> + <term> + <parameter>magic_quotes_sybase</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + Si <parameter>magic_quotes_sybase</parameter> est activé, les guillemets + simples seront échappés avec un autre guillemet simple, plutôt + qu'un antislash, si <parameter>magic_quotes_gpc</parameter> ou + <parameter>magic_quotes_runtime</parameter> est activé. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.max-execution-time"> + <term> + <parameter>max_execution_time</parameter> + <type>integer</type> + </term> + <listitem> + <para> + Fixe le temps maximal d'éxécution d'un script, en secondes. Cela permet + d'éviter que des scripts en boucles infinies saturent le serveur. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.memory-limit"> + <term> + <parameter>memory_limit</parameter> + <type>entier</type> + </term> + <listitem> + <para> + Grâce à cette option, vous pouvez donner la quantité + maximale de mémoire qu'un script peut allouer. Ceci permet + de se prevenir contre des scripts mal codés pouvant consommer toute + la mémoire disponible d'un serveur + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.nsapi-ext"> + <term> + <parameter>nsapi_ext</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Aucune documentation n'est fournie. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.register-globals"> + <term> + <parameter>register_globals</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + Cette option active l'enregistrement des variables EGPCS + (Environnement, GET, POST, Cookie, Serveur), en tant que + variables globales. Vous pouvez désactiver cette fonction + si vous ne voulez pas truffer vos scripts avec des + valeurs utilisateurs. Cette option est surtout utile lorsqu'elle + est utilisée conjointement avec <link + linkend="ini.track-vars">track_vars</link> - dans ce cas, + vous pouvez accéder à toutes les variables EGPCS grâce aux tableaux + <varname>$HTTP_ENV_VARS</varname>, + <varname>$HTTP_GET_VARS</varname>, + <varname>$HTTP_POST_VARS</varname>, + <varname>$HTTP_COOKIE_VARS</varname>, et + <varname>$HTTP_SERVER_VARS</varname>. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.short-open-tag"> + <term> + <parameter>short_open_tag</parameter> + <type>booléen</type> + </term> + <listitem> + <para> + Active ou désactive l'utilisation des balises courtes, + (<userinput><? ?></userinput>). Si vous voulez utiliser PHP et XML en même + temps, vous devez désactiver cette option. Si cette option est + désactivée, vous devez utiliser la forme longue des tags, + (<userinput><?php ?></userinput>).</para> + </listitem> + </varlistentry> + <varlistentry id="ini.sql.safe-mode"> + <term> + <parameter>sql.safe_mode</parameter> + <type>booléen</type> + </term> + <listitem> + <para> + Aucune documentation n'est fournie. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.track-errors"> + <term> + <parameter>track_errors</parameter> + <type>booléen</type> + </term> + <listitem> + <para> + Si cette option est activée, le dernier message d'erreur sera placé dans la + variable globale <symbol>$php_errormsg</symbol>.</para> + </listitem> + </varlistentry> + <varlistentry id="ini.track-vars"> + <term> + <parameter>track_vars</parameter> + <type>booléen</type> + </term> + <listitem> + <para> + Si cette option est activée, lors de l'appel des méthodes GET, POST et + l'utilisation des cookies, les variables sont disponibles dans des tableaux + associatifs globaux appelés respectivement <symbol>$HTTP_GET_VARS</symbol>, + <symbol>$HTTP_POST_VARS</symbol> et <symbol>$HTTP_COOKIE_VARS</symbol>. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.upload-tmp-dir"> + <term> + <parameter>upload_tmp_dir</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Indique le répertoire utilisé lors du chargement d'un fichier sur un + serveur. Ce répertoire doit être accessible en lecture pour + l'utilisateur qui lance le script PHP. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.upload-max-filesize"> + <term> + <parameter>upload_max_filesize</parameter> + <type>entier</type> + </term> + <listitem> + <para> + La taille maximale d'un fichier téléchargé sur le serveur. La valeur + doit être en octets. Par défaut, elle est de 2 méga-octets. + in bytes. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.user-dir"> + <term> + <parameter>user_dir</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Répertoire où sont stockés les fichiers PHP dans le + répertoire d'un utilisateur. Par exemple, <literal>public_html</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.warn-plus-overloading"> + <term> + <parameter>warn_plus_overloading</parameter> + <type>booléen</type> + </term> + <listitem> + <para> + Si cette option est activée, PHP émet une alerte lorsque + l'opérateur plus (<literal>+</literal>) est utilisé sur une + chaîne de caractères. Cela permet de réperer plus + facilement les scripts qui doivent être réécrits en + utilisant l'opérateur de concaténation (<literal>.</literal>) + plutôt que l'opérateur plus. + </para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + <sect2 id="ini.sect.mail"> + <title>Directives de configuration concernant le mail</title> + <variablelist> + <varlistentry id="ini.smtp"> + <term> + <parameter>SMTP</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Sous Windows, adresse IP ou nom que PHP doit utiliser pour envoyer + du mail avec la fonction <function>mail</function>. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.sendmail-from"> + <term> + <parameter>sendmail_from</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Sous Windows, valeur du champs "From:" qui doit être utilisée lors + de l'envoi de mail. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.sendmail-path"> + <term> + <parameter>sendmail_path</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Localisation du programme de <command>sendmail</command> : habituellement + <filename>/usr/sbin/sendmail</filename> ou <filename>/usr/lib/sendmail</filename>. + <command>configure</command> essaye de repérer la présence de sendmail + par lui-même, et affecte ce résultat par défaut. En cas de + problème de localisation, vous pouvez établir une nouvelle valeur + par défaut ici. + </para> + <para> + Tout système n'utilisant pas <command>sendmail</command> doit établir cette + directive à la valeur chemin du programme de substitution qui remplace le + serveur de mail, si celui-ci existe, par exemple, + <ulink url="&url.qmail;">Qmail</ulink>. + Dans ce cas là, vous devez mettre: <filename>/var/qmail/bin/sendmail</filename>. + </para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + <sect2 id="ini.sect.safe-mode"> + <title>Directives de configuration du "Safe Mode"</title> + <variablelist> + <varlistentry id="ini.safe-mode"> + <term> + <parameter>safe_mode</parameter> + <type>booléen</type> + </term> + <listitem> + <para> + Cette directive active ou désactive l'option "safe mode". + Lisez le chapitre <link linkend="security">sécurité </link> pour plus + d'informations. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.safe-mode-exec-dir"> + <term> + <parameter>safe_mode_exec_dir</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Si l'option "SAFE MODE" est activée, <function>system</function> et les + autres fonctions exécutant des programmes systèmes refusent de se lancer + si ces programmes ne sont pas placés dans ce répertoire. + </para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + <sect2 id="ini.sect.debugger"> + <title>Directives de configuration de débugage.</title> + <variablelist> + <varlistentry id="ini.debugger.host"> + <term> + <parameter>debugger.host</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Adresse IP ou nom de l'hôte utilisé pour le débugage. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.debugger.port"> + <term> + <parameter>debugger.port</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Numéro du port utilisé pour le débugage. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.debugger.enabled"> + <term> + <parameter>debugger.enabled</parameter> + <type>booléen</type> + </term> + <listitem> + <para> + Activation ou désactivation du débugueur.</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + <sect2 id="ini.sect.extension"> + <title>Directives de chargement des extensions</title> + <variablelist> + <varlistentry id="ini.enable-dl"> + <term> + <parameter>enable_dl</parameter> + <type>booléen</type> + </term> + <listitem> + <para> + Cette directive n'est réellement utile que dans le cas d'une compilation + comme module Apache. Vous pouvez activer le chargement dynamique des + extensions avec la fonction <function>dl</function>, et cela de manière + locale à chaque serveur virtuel ou à chaque répertoire. + </para> + <para> + La principale raison qui pousse à désactiver le chargement + dynamique est un problème de sécurité. Lorsque le + chargement dynamique est activé, il est possible d'ignorer les + directives <link linkend="ini.safe-mode">safe mode</link> + ou "open_basedir". + </para> + <para> + Par défaut, il est possible d'utiliser le chargement dynamique, sauf + lorsque la directive <link linkend="ini.safe-mode">safe mode</link> est + activée. En effet, il est alors impossible d'utiliser la fonction + <function>dl</function>. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.extension-dir"> + <term> + <parameter>extension_dir</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Définit le répertoire dans lequel le PHP doit chercher les extensions lors + du chargement dynamique. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.extension"> + <term> + <parameter>extension</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Définit les extensions qui doivent être chargées lors du + démarrage du PHP. + </para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + <sect2 id="ini.sect.mysql"> + <title>Directives de configuration MySQL</title> + <variablelist> + <varlistentry id="ini.mysql.allow-persistent"> + <term> + <parameter>mysql.allow_persistent</parameter> + <type>booléen</type> + </term> + <listitem> + <para> + Active ou désactive les connexions persistantes à la base de + données MySQL. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.mysql.default-host"> + <term> + <parameter>mysql.default_host</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Adresse par défaut du serveur, à utiliser lors de la connexion à + un serveur MySQL, si aucun hôte n'est spécifié. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.mysql.default-user"> + <term> + <parameter>mysql.default_user</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Utilisateur par défaut, à utiliser lors de la connexion à un serveur + MySQL, si aucun utilisateur n'est spécifié. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.mysql.default-password"> + <term> + <parameter>mysql.default_password</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Mot de passe par défaut, à utiliser lors de la connexion à un serveur + MySQL, si aucun mot de passe n'est spécifié. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.mysql.default-port"> + <term> + <parameter>mysql.default_port</parameter> + <type>string</type> + </term> + <listitem> + <para> + Le numéro de port TCP par défaut, utilisé pour se connecter + à la base de données, lorsqu'aucun port n'est spécifié. Si aucun + port par défaut est spécifié, le port sera alors obtenu en + lisant la variable d'environnement <literal>MYSQL_TCP_PORT</literal>, + l'entrée <literal>mysql-tcp</literal> dans le fichier + <filename>/etc/services</filename> ou encore la constante + de compilation <literal>MYSQL_PORT</literal>, dans cet order. Win32 + n'utilisera aussi que la constante <literal>MYSQL_PORT</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.mysql.default-socket"> + <term> + <parameter>mysql.default_socket</parameter> + <type>string</type> + </term> + <listitem> + <para> + Le nom par défaut de la socket lorsque l'on se conecte + au serveur local, si aucune autre socket n'est spécifiée. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.mysql.max-persistent"> + <term> + <parameter>mysql.max_persistent</parameter> + <type>entier</type> + </term> + <listitem> + <para> + Nombre maximum de connexions persistantes à une base de données MySQL, + par processus. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.mysql.max-links"> + <term> + <parameter>mysql.max_links</parameter> + <type>entier</type> + </term> + <listitem> + <para> + Nombre de connexions maximum à une base de données MySQL, + par processus, incluant les connexions persistantes + </para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + <sect2 id="ini.sect.msql"> + <title>Directives de configuration mSQL</title> + <variablelist> + <varlistentry id="ini.msql.allow-persistent"> + <term> + <parameter>msql.allow_persistent</parameter> + <type>booléen</type> + </term> + <listitem> + <para> + Active ou désactive les connexions persistantes à la base de données mSQL. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.msql.max-persistent"> + <term> + <parameter>msql.max_persistent</parameter> + <type>entier</type> + </term> + <listitem> + <para> + Nombre maximum de connexions persistantes à une base de données mSQL, + par processus. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.msql.max-links"> + <term> + <parameter>msql.max_links</parameter> + <type>entier</type> + </term> + <listitem> + <para> + Nombre maximum de connexions à une base de données mSQL, + par processus, incluant les connexions persistantes. + </para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + <sect2 id="ini.sect.pgsql"> + <title>Directives de configuration Postgres</title> + <variablelist> + <varlistentry id="ini.pgsql.allow-persistent"> + <term> + <parameter>pgsql.allow_persistent</parameter> + <type>booléen</type> + </term> + <listitem> + <para> + Active ou désactive les connexions persistantes à la base de + données Postgres. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.pgsql.max-persistent"> + <term> + <parameter>pgsql.max_persistent</parameter> + <type>entier</type> + </term> + <listitem> + <para> + Nombre maximum de connexions persistantes à une base de données + Postgres, par processus. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.pgsql.max-links"> + <term> + <parameter>pgsql.max_links</parameter> + <type>entier</type> + </term> + <listitem> + <para> + Nombre maximal de connexions à une base de données Postgres, + par processus, incluant les connexions persistantes. + </para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + <sect2 id="ini.sect.sesam"> + <title>Directives de configuration SESAM</title> + <variablelist> + <varlistentry id="ini.sesam-oml"> + <term> + <parameter>sesam_oml</parameter> + <type>string</type> + </term> + <listitem> + <para> + Nom de la librairieBS2000 PLAM contenant les pilotes de connexion SESAM. + Obligatoire pour les fonctions SESAM. La librairie BS2000 PLAM + doit être configurée avec <literal>ACCESS=READ,SHARE=YES</literal>, + car elle doit être accessible à l'utilisateur Apache. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.sesam-configfile"> + <term> + <parameter>sesam_configfile</parameter> + <type>string</type> + </term> + <listitem> + <para> + Nom du fichier de configuration de l'application SESAM. + Obligatoire pour les fonctions SESAM. Le fichier + BS2000 doit être accessible être accessible à l'utilisateur Apache. + </para> + <para> + Le fichier de configuration de l'application va contenir la configuration + sur le schéma suivant (voir le manuel SESAM) : + <informalexample> + <programlisting role="bs2000"> +CNF=B +NAM=K +NOTYPE</programlisting> + </informalexample> + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.sesam-messagecatalog"> + <term> + <parameter>sesam_messagecatalog</parameter> + <type>string</type> + </term> + <listitem> + <para> + Nom du catalogue de messages SESAM. Dans la plupart des + cas, cette directive n'est pas nécessaire. Seulement, si + le fichier de messages SESAM n'est pas installé dans la + table de messages BS2000, il faut indiquer sa localisation avec + cette directive. + </para> + <para> + Le catalogue de messages doit être paramétré avec + <literal>ACCESS=READ,SHARE=YES</literal>, car il doit être + accessible à l'utilisateur Apache. + </para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + <sect2 id="ini.sect.sybase"> + <title>Directives de configuration Sybase</title> + <variablelist> + <varlistentry id="ini.sybase.allow-persistent"> + <term> + <parameter>sybase.allow_persistent</parameter> + <type>booléen</type> + </term> + <listitem> + <para> + Active ou désactive les connexions persistantes à + la base de données Sybase. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.sybase.max-persistent"> + <term> + <parameter>sybase.max_persistent</parameter> + <type>entier</type> + </term> + <listitem> + <para> + Nombre maximum de connexions persistantes à + une base de données Sybase par processus. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.sybase.max-links"> + <term> + <parameter>sybase.max_links</parameter> + <type>entier</type> + </term> + <listitem> + <para> + Nombre maximum de connexions à une base de données Sybase, par processus, + incluant les connexions persistantes. + </para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + <sect2 id="ini.sect.sybct"> + <title>Directives de configuration Sybase-CT</title> + <variablelist> + <varlistentry id="ini.sybct.allow-persistent"> + <term> + <parameter>sybct.allow_persistent</parameter> + <type>booléen</type> + </term> + <listitem> + <para> + Active ou désactive les connexions persistantes à la base de données + Sybase-CT. Par défaut, cette option est activée. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.sybct.max-persistent"> + <term> + <parameter>sybct.max_persistent</parameter> + <type>entier</type> + </term> + <listitem> + <para> + Nombre maximum de connexions persistantes à une base de données Sybase-CT par + processus. Par défaut, cette option est à -1, ce qui signifie que le nombre de + connexion est illimité. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.sybct.max-links"> + <term> + <parameter>sybct.max_links</parameter> + <type>entier</type> + </term> + <listitem> + <para> + Nombre maximum de connexions à une base de données Sybase-CT, par processus, + incluant les connexions persistantes. Par défaut, cette option est à -1, + ce qui signifie que le nombre de connexions est illimité. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.sybct.min-server-severity"> + <term> + <parameter>sybct.min_server_severity</parameter> + <type>entier</type> + </term> + <listitem> + <para> + Les messages en provenance du serveur d'un niveau d'erreur égal à + sybct.min_server_severity seront considérés comme des alertes (warnings). + Cette valeur peut être modifiée à l'intérieur du script en appelant la fonction + sybase_min_server_severity (NDtraducteur : cette fonction semble ne pas exister). + Par défaut, cette valeur vaut 10. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.sybct.min-client-severity"> + <term> + <parameter>sybct.min_client_severity</parameter> + <type>entier</type> + </term> + <listitem> + <para> + Les messages en provenance de la librairie client avec un niveau d'erreur égal + ou supérieur à sybct.min_client_severity seront considérés comme des alertes. + Cette valeur peut être modifiée à l'intérieur du script en appelant la + fonction sybase_min_client_severity (NDtraducteur : cette fonction semble ne pas exister). + Par défaut, cette valeur vaut 10, ce qui annule tout rapport d'erreur. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.sybct.login-timeout"> + <term> + <parameter>sybct.login_timeout</parameter> + <type>entier</type> + </term> + <listitem> + <para> + Délai de validité d'une tentative de connexion. Il est à + noter que si max_execution_time est dépassé avant que la connexion + n'expire, le script sera terminé avant le message d'erreur. + Par défaut, cette valeur vaut 1 minute. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.sybct.timeout"> + <term> + <parameter>sybct.timeout</parameter> + <type>entier</type> + </term> + <listitem> + <para> + Temps maximum en secondes avant qu'une tentative de requête "select_db" ou + "query" non aboutie renvoie une erreur. Il est à noter que si + max_execution_time est dépassé avant que la requête + n'expire, votre script sera terminé avant le message d'erreur. + Par défaut, il n'y a pas de limite. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.sybct.hostname"> + <term> + <parameter>sybct.hostname</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Nom de l'hôte à partir duquel vous vous connectez, afin d'être affiché par + la fonction sp_who (NDtraducteur : cette fonction semble ne pas exister). + Par défaut, cette valeur égale à 0. + </para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + <sect2 id="ini.sect.informix"> + <title>Directives de configuration Informix</title> + <variablelist> + <varlistentry id="ini.ifx.allow-persistent"> + <term> + <parameter>ifx.allow_persistent</parameter> + <type>booléen</type> + </term> + <listitem> + <para> + Active les connexions persistantes à une base de données Informix. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.ifx.max-persistent"> + <term> + <parameter>ifx.max_persistent</parameter> + <type>entier</type> + </term> + <listitem> + <para> + Nombre maximum de connexions persistantes à une base de données Informix, + par processus. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.ifx.max-links"> + <term> + <parameter>ifx.max_links</parameter> + <type>entier</type> + </term> + <listitem> + <para> + Nombre maximum de connexions à une base de données Informix par processus, + en incluant les connexions persistantes. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.ifx.default-host"> + <term> + <parameter>ifx.default_host</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Hôte par défaut où se connecter si aucun hôte n'est spécifié par les + fonctions <function>ifx_connect</function> ou <function>ifx_pconnect</function>. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.ifx.default-user"> + <term> + <parameter>ifx.default_user</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Utilisateur par défaut si aucun utilisateur n'est spécifié par les fonctions + <function>ifx_connect</function> ou <function>ifx_pconnect</function>. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.ifx.default-password"> + <term> + <parameter>ifx.default_password</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Mot de passe par défaut si aucun mot de passe n'est spécifié par les fonctions + <function>ifx_connect</function> ou <function>ifx_pconnect</function>. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.ifx.blobinfile"> + <term> + <parameter>ifx.blobinfile</parameter> + <type>booléen</type> + </term> + <listitem> + <para> + Lorsque cette option est activée, les colonnes de type "blob" seront retournées + dans un fichier. Par défaut, elles seront retournées en mémoire. Il est possible + de modifier dynamiquement cette valeur grâce à la fonction + <function>ifx_blobinfile_mode</function>. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.ifx.textasvarchar"> + <term> + <parameter>ifx.textasvarchar</parameter> + <type>booléen</type> + </term> + <listitem> + <para> + Lorsque cette option est activée, les colonnes de type "TEXT" seront retournées + dans une chaîne de caractères. Par défaut, elles seront retournées en mémoire. Il est possible + de modifier dynamiquement cette valeur grâce à la fonction + <function>ifx_textasvarchar</function>. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.ifx.byteasvarchar"> + <term> + <parameter>ifx.byteasvarchar</parameter> + <type>booléen</type> + </term> + <listitem> + <para> + Lorsque cette option est activée, les colonnes de type "BYTE" + seront retournées dans une chaîne de caractères. Par + défaut, elles seront retournées en mémoire. + Il est possible de modifier dynamiquement cette valeur grâce + à la fonction <function>ifx_textasvarchar</function>. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.ifx.charasvarchar"> + <term> + <parameter>ifx.charasvarchar</parameter> + <type>booléen</type> + </term> + <listitem> + <para> + Lorsque cette option est activée, les espaces en fin de + chaîne de caractères seront conservés lors d'une + commande FETCH. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.ifx.nullformat"> + <term> + <parameter>ifx.nullformat</parameter> + <type>booléen</type> + </term> + <listitem> + <para> + Lorsque cette option est activée, les colonnes de valeur &null; + seront retournées comme des chaînes de caractères + vides. Il est possible de modifier dynamiquement cette valeur + grâce à la fonction <function>ifx_nullformat</function>. + </para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + <sect2 id="ini.sect.bcmath"> + <title> + Directives de configuration pour les calculs mathématiques. + </title> + <variablelist> + <varlistentry id="ini.bcmath.scale"> + <term> + <parameter>bcmath.scale</parameter> + <type>entier</type> + </term> + <listitem> + <para> + Nombre de chiffres après la virgule pour toutes les fonctions de + précision mathématique arbitraire. + </para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + <sect2 id="ini.sect.browscap"> + <title>Directives de configuration du navigateur.</title> + <variablelist> + <varlistentry id="ini.browscap"> + <term> + <parameter>browscap</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Nom du fichier de descriptif des clients HTML. + Voir aussi <function>get_browser</function>. + </para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + <sect2 id="ini.sect.uodbc"> + <title>Directives de configuration du pilote ODBC unifié</title> + <variablelist> + <varlistentry id="ini.uodbc.default-db"> + <term> + <parameter>uodbc.default_db</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Source de données ODBC à utiliser par défaut avec les fonctions + <function>odbc_connect</function> ou <function>odbc_pconnect</function>. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.uodbc.default-user"> + <term> + <parameter>uodbc.default_user</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Nom d'utilisateur défaut avec les fonctions <function>odbc_connect</function> ou + <function>odbc_pconnect</function>. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.uodbc.default-pw"> + <term> + <parameter>uodbc.default_pw</parameter> + <type>chaîne de caractères</type> + </term> + <listitem> + <para> + Mot de passe par défaut dans les fonctions <function>odbc_connect</function> ou + <function>odbc_pconnect</function>. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.uodbc.allow-persistent"> + <term> + <parameter>uodbc.allow_persistent</parameter> + <type>booléen</type> + </term> + <listitem> + <para> + Cette option active ou désactive les connexions persistantes à la base de + données, via le canal ODBC. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.uodbc.max-persistent"> + <term> + <parameter>uodbc.max_persistent</parameter> + <type>entier</type> + </term> + <listitem> + <para> + Nombre maximum de connexions persistantes autorisées à la base de données. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.uodbc.max-links"> + <term> + <parameter>uodbc.max_links</parameter> + <type>entier</type> + </term> + <listitem> + <para> + Nombre maximum de connexions (persistantes ou non), par processus, + à la base de données. + </para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + <sect2 id="ini.sect.mbstring"> + <title>Directives de configuration des chaînes mulit-octets</title> + <variablelist> + <varlistentry id="ini.mbstring.internal-encoding"> + <term> + <parameter>mbstring.internal_encoding</parameter> + <type>string</type> + </term> + <listitem> + <para> + <literal>mbstring.internal_encoding</literal> définit l'encodage + interne par défaut. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.mbstring.http-input"> + <term> + <parameter>mbstring.http_input</parameter> + <type>string</type> + </term> + <listitem> + <para> + <literal>mbstring.http_input</literal> définit l'encodage + de reception HTTP par défaut. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.mbstring.http-output"> + <term> + <parameter>mbstring.http_output</parameter> + <type>string</type> + </term> + <listitem> + <para> + <literal>mbstring.http_output</literal> définit l'encodage + d'affichage HTTP par défaut. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.mbstring.detect-order"> + <term> + <parameter>mbstring.detect_order</parameter> + <type>string</type> + </term> + <listitem> + <para> + <literal>mbstring.detect_order</literal> définit l'ordre de + détection des encodages par défaut. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.mbstring.substitute-character"> + <term> + <parameter>mbstring.substitute_character</parameter> + <type>string</type> + </term> + <listitem> + <para> + <literal>mbstring.substitute_character</literal> définit l'encodage + de substitution par défaut : il est utilisé pour les caractères invalides. + </para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + </sect1> + </chapter> + +