cvs: phpdoc /fr/functions info.xml
| From: | Damien Seguy | Date: | Thu, 19 Jul 2001 09:23:24 +0000 |
| Subject: | cvs: phpdoc /fr/functions info.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969336317@lists.php.net to get a copy of this message | ||
dams Thu Jul 19 05:23:24 2001 EDT
Modified files:
/phpdoc/fr/functions info.xml
Log:
Simplified phpinfo
Index: phpdoc/fr/functions/info.xml diff -u phpdoc/fr/functions/info.xml:1.15 phpdoc/fr/functions/info.xml:1.16 --- phpdoc/fr/functions/info.xml:1.15 Sat Jul 7 18:22:12 2001 +++ phpdoc/fr/functions/info.xml Thu Jul 19 05:23:24 2001 @@ -1,978 +1,1024 @@ - <reference id="ref.info"> - <title>Options PHP & informations</title> - <titleabbrev>Options et informations PHP</titleabbrev> - <refentry id="function.assert"> - <refnamediv> - <refname>assert</refname> - <refpurpose>Vérifie si une assertion est fausse</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>assert</function></funcdef> - <paramdef>string|bool <parameter>assertion</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>assert</function> va vérfier l'assertion - <parameter>assertion</parameter> et prendre la mesure appropriée - si le résultat est &false;. - </para> - <para> - Si <parameter>assertion</parameter> est donnée sous la forme - d'une chaîne, elle sera évaluée comme un code PHP - par la fonction <function>assert</function>. Les avantages de ce type - d'assertion sont d'être moins lourd si la vérification - d'assertion est désactivée, et le contenu des messages - lorsque l'assertion échoue. - </para> - <para> - Il est recommandé de n'utiliser les assertions que comme outil de - débuggage. Vous pouvez les utiliser pour les vérifications - d'usage : ces conditions doivent normalement être vraie, et indiquer - une erreur de programmation si ce n'est pas le cas. Vous pouvez aussi - vérifier la présence de certaines extensions ou - limitations du système. - </para> - <para> - Les assertions ne doivent pas être utilisées pour faire des - opérations de vérifications en production, comme par exemple - des vérfications de valeur d'arguments. En conditions normales, - votre code doit être en état de fonctionner si la - vérification d'assertion est désactivée. - </para> - <para> - Le comportement de <function>assert</function> peut être configuré - par <function>assert_options</function> ou par .ini-settings. - </para> - </refsect1> - </refentry> - <refentry id="function.assert-options"> - <refnamediv> - <refname>assert-options</refname> - <refpurpose>Fixe et lit différentes options d'assertions</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>mixed <function>assert_options</function></funcdef> - <paramdef>int <parameter>what</parameter></paramdef> - <paramdef>mixed - <parameter><optional>value</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - Avec <function>assert_options</function> vous pouvez modifier les diverses - options de la fonction <function>assert</function>, ou simplement - connaître la configuration actuelle. - </para> - <table> - <title>options d'assert</title> - <tgroup cols="4"> - <thead> - <row> - <entry>option</entry> - <entry>paramètre d'ini</entry> - <entry>valeur par défaut</entry> - <entry>description</entry> - </row> - </thead> - <tbody> - <row> - <entry>ASSERT_ACTIVE</entry> - <entry>assert.active</entry> - <entry>1</entry> - <entry>active l'évaluation de la fonction <function>assert</function></entry> - </row> - <row> - <entry>ASSERT_WARNING</entry> - <entry>assert.warning</entry> - <entry>1</entry> - <entry>génère une alerte PHP pour chaque assertion fausse</entry> - </row> - <row> - <entry>ASSERT_BAIL</entry> - <entry>assert.bail</entry> - <entry>0</entry> - <entry>terminer l'exécution en cas d'assertion fausse</entry> - </row> - <row> - <entry>ASSERT_QUIET_EVAL</entry> - <entry>assert.quiet_eval</entry> - <entry>0</entry> - <entry> - inactive le rapprot d'erreur durant l'évaluation d'une assertion - </entry> - </row> - <row> - <entry>ASSERT_CALLBACK</entry> - <entry>assert_callback</entry> - <entry>(&null;)</entry> - <entry>fonction utilisateur de traitement des assertions fausses</entry> - </row> - </tbody> - </tgroup> - </table> - <para> - <function>assert_options</function> retourne la valeur originale - de l'option, ou bien &false; en cas d'erreur. - </para> - </refsect1> - </refentry> - <refentry id="function.extension-loaded"> - <refnamediv> - <refname>extension_loaded</refname> - <refpurpose> - Détermine si une extension est chargée ou non. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>bool <function>extension_loaded</function></funcdef> +<reference id="ref.info"> + <title>Options PHP & informations</title> + <titleabbrev>Options et informations PHP</titleabbrev> + <refentry id="function.assert"> + <refnamediv> + <refname>assert</refname> + <refpurpose>Vérifie si une assertion est fausse</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>assert</function></funcdef> + <paramdef>string|boolean <parameter>assertion</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>assert</function> va vérifier l'assertion + <parameter>assertion</parameter> et prendre la mesure appropriée + si le résultat est <literal>FALSE</literal>. + </para> + <para> + Si <parameter>assertion</parameter> est donnée sous la forme + d'une chaîne, elle sera évaluée comme un code PHP + par la fonction <function>assert</function>. Les avantages de ce type + d'assertion sont d'être moins lourd si la vérification + d'assertion est désactivée, et le contenu des messages + lorsque l'assertion échoue. + </para> + <para> + Il est recommandé de n'utiliser les assertions que comme outil de + débuggage. Vous pouvez les utiliser pour les vérifications + d'usage : ces conditions doivent normalement être vraies, et indiquer + une erreur de programmation si ce n'est pas le cas. Vous pouvez aussi + vérifier la présence de certaines extensions ou + limitations du système. + </para> + <para> + Les assertions ne doivent pas être utilisées pour faire des + opérations de vérifications en production, comme par exemple + des vérifications de valeur d'argument. En conditions normales, + votre code doit être en état de fonctionner si la + vérification d'assertion est désactivée. + </para> + <para> + Le comportement de <function>assert</function> peut être configuré + par <function>assert_options</function> ou par .ini-settings. + </para> + </refsect1> + </refentry> + <refentry id="function.assert-options"> + <refnamediv> + <refname>assert-options</refname> + <refpurpose>Fixe et lit différentes options d'assertions</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>assert_options</function></funcdef> + <paramdef>int <parameter>what</parameter></paramdef> + <paramdef>mixed + <parameter><optional>value</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Avec <function>assert_options</function> vous pouvez modifier les diverses + options de la fonction <function>assert</function>, ou simplement + connaître la configuration actuelle. + </para> + <table> + <title>options d'assert</title> + <tgroup cols="4"> + <thead> + <row> + <entry>Option</entry> + <entry>Paramètre d'ini</entry> + <entry>Valeur par défaut</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>ASSERT_ACTIVE</entry> + <entry>assert.active</entry> + <entry>1</entry> + <entry>active l'évaluation de la fonction <function>assert</function></entry> + </row> + <row> + <entry>ASSERT_WARNING</entry> + <entry>assert.warning</entry> + <entry>1</entry> + <entry>génère une alerte PHP pour chaque assertion fausse</entry> + </row> + <row> + <entry>ASSERT_BAIL</entry> + <entry>assert.bail</entry> + <entry>0</entry> + <entry>termine l'exécution en cas d'assertion fausse</entry> + </row> + <row> + <entry>ASSERT_QUIET_EVAL</entry> + <entry>assert.quiet_eval</entry> + <entry>0</entry> + <entry> + inactive le rapport d'erreur durant l'évaluation d'une assertion + </entry> + </row> + <row> + <entry>ASSERT_CALLBACK</entry> + <entry>assert_callback</entry> + <entry>(null)</entry> + <entry>fonction utilisateur de traitement des assertions fausses</entry> + </row> + </tbody> + </tgroup> + </table> + <para> + <function>assert_options</function> retourne la valeur originale + de l'option, ou bien <literal>FALSE</literal> en cas d'erreur. + </para> + </refsect1> + </refentry> + <refentry id="function.extension-loaded"> + <refnamediv> + <refname>extension_loaded</refname> + <refpurpose> + Détermine si une extension est chargée ou non. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>extension_loaded</function></funcdef> <paramdef>string <parameter>name</parameter></paramdef> - </funcsynopsis> - <simpara> - <function>extension_loaded</function> retourne vraie si l'extension - <parameter>name</parameter> a été chargée. - Vous pouvez voir les différents noms des extensions, en - utilisant la fonction <function>phpinfo</function>. - </simpara> - <para> - Voir aussi <function>phpinfo</function>. - <note> - <para> - Cette fonction a été ajoutée dans 3.0.10. - </para> - </note> - </para> - </refsect1> - </refentry> -<refentry id="function.dl"> - <refnamediv> - <refname>dl</refname> - <refpurpose>Charge une extension PHP à la volée</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>dl</function></funcdef> - <paramdef>string <parameter>library</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Charge l'extension PHP <parameter>library</parameter> à la volée . - Voir aussi la directive de configuration - <link linkend="ini.extension-dir">extension_dir</link>. - </para> - </refsect1> - </refentry> - <refentry id="function.getenv"> - <refnamediv> - <refname>getenv</refname> - <refpurpose>Retourne la valeur de la variable d'environnement.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <simpara> + <function>extension_loaded</function> retourne <literal>TRUE</literal> si l'extension + <parameter>name</parameter> a été chargée. + Vous pouvez voir les différents noms des extensions, en + utilisant la fonction <function>phpinfo</function>. + </simpara> + <para> + Voir aussi + <function>phpinfo</function>. + <note> + <para> + Cette fonction a été ajoutée dans 3.0.10. + </para> + </note> + </para> + </refsect1> + </refentry> + <refentry id="function.dl"> + <refnamediv> + <refname>dl</refname> + <refpurpose>Charge une extension PHP à la volée</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>dl</function></funcdef> + <paramdef>string <parameter>library</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dl</function> charge l'extension PHP <parameter>library</parameter> + à la volée . Voir aussi la directive de configuration + <link linkend="ini.extension-dir">extension_dir</link>. + </para> + </refsect1> + </refentry> + <refentry id="function.getenv"> + <refnamediv> + <refname>getenv</refname> + <refpurpose>Retourne la valeur de la variable d'environnement.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>string <function>getenv</function></funcdef> <paramdef>string <parameter>varname</parameter></paramdef> - </funcsynopsis> - <para> - <function>getenv</function> retourne la valeur de la variable - d'environnement <parameter>varname</parameter>, - ou &false; en cas d'erreur. - <informalexample> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <function>getenv</function> retourne la valeur de la variable + d'environnement <parameter>varname</parameter>, + ou <literal>FALSE</literal> en cas d'erreur. + <informalexample> + <programlisting role="php"> <?php -$ip = getenv("REMOTE_ADDR"); // retourne l'adresse IP de l'utilisateur + $ip = getenv("REMOTE_ADDR"); // retourne l'adresse IP de l'utilisateur ?> - </programlisting> - </informalexample> - </para> - <para> - Vous pouvez voir une liste complète des variables d'environnement en - utilisant la fonction <function>phpinfo</function>. Vous pouvez trouvez - la signification de chacune d'entre elles en consultant le site concernant - <ulink url="&url.cgispecs;">CGI specification</ulink> (en anglais>, et - particulièment la page concernant les - <ulink url="&url.cgispec;">variables d'environnement.</ulink>. - </para> - </refsect1> - </refentry> - <refentry id="function.get-cfg-var"> - <refnamediv> - <refname>get_cfg_var</refname> - <refpurpose>Retourne la valeur d'une option de PHP</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </programlisting> + </informalexample> + </para> + <para> + Vous pouvez voir une liste complète des variables d'environnement en + utilisant la fonction <function>phpinfo</function>. Vous pouvez trouver + la signification de chacune d'entre elles en consultant le site concernant + <ulink url="&url.cgispecs;">CGI specification</ulink> (en anglais>, et + particulièment la page concernant les + <ulink url="&url.cgispec;">variables d'environnement.</ulink>. + </para> + <para> + Voir aussi + <function>putenv</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.get-cfg-var"> + <refnamediv> + <refname>get_cfg_var</refname> + <refpurpose>Retourne la valeur d'une option de PHP</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>string <function>get_cfg_var</function></funcdef> <paramdef>string <parameter>varname</parameter></paramdef> - </funcsynopsis> - <simpara> - <function>get_cfg_var</function> retourne la valeur courante de - l'option PHP <parameter>varname</parameter>, ou bien - &false; en cas d'erreur. - </simpara> - <simpara> - <function>get_cfg_var</function> ne retourne pas les options qui - ont été choisies lors de la compilation de PHP, ni - ne lit dans le fichier de configuration d'Apache. - </simpara> - <simpara> - Pour vérifier si le système utilise le - <link linkend="configuration.file">fichier de configuration</link>, - essayez de lire la valeur de cfg_file_path. Si cette valeur est - disponible, alors le fichier de configuration est utilisé. - </simpara> - </refsect1> - </refentry> - <refentry id="function.get-current-user"> - <refnamediv> - <refname>get_current_user</refname> - <refpurpose> - Retourne le nom du possesseur du script courant. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <simpara> + <function>get_cfg_var</function> retourne la valeur courante de + l'option PHP <parameter>varname</parameter>, ou bien + <literal>FALSE</literal> en cas d'erreur. + </simpara> + <simpara> + <function>get_cfg_var</function> ne retourne pas les options qui + ont été choisies lors de la compilation de PHP, ni + ne lit dans le fichier de configuration d'Apache. + </simpara> + <simpara> + Pour vérifier si le système utilise le + <link linkend="configuration.file">fichier de configuration</link>, + essayez de lire la valeur de cfg_file_path. Si cette valeur est + disponible, alors le fichier de configuration est utilisé. + </simpara> + </refsect1> + </refentry> + <refentry id="function.get-current-user"> + <refnamediv> + <refname>get_current_user</refname> + <refpurpose> + Retourne le nom du possesseur du script courant. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>string <function>get_current_user</function></funcdef> <paramdef>void</paramdef> - </funcsynopsis> - <simpara> - <function>get_current_user</function> retourne le nom du possesseur - du script courant. - </simpara> - <simpara> - Voir aussi <function>getmyuid</function>, <function>getmypid</function>, - <function>getmyinode</function>, et <function>getlastmod</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.get-magic-quotes-gpc"> - <refnamediv> - <refname>get_magic_quotes_gpc</refname> - <refpurpose> - Retourne le configuration actuelle de l'option magic_quotes_gpc. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <simpara> + <function>get_current_user</function> retourne le nom du possesseur + du script courant. + </simpara> + <simpara> + Voir aussi + <function>getmyuid</function>, + <function>getmypid</function>, + <function>getmyinode</function> et + <function>getlastmod</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.get-magic-quotes-gpc"> + <refnamediv> + <refname>get_magic_quotes_gpc</refname> + <refpurpose> + Retourne la configuration actuelle de l'option magic_quotes_gpc. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>long <function>get_magic_quotes_gpc</function></funcdef> <paramdef>void</paramdef> - </funcsynopsis> - <simpara> - <function>get_magic_quotes_gpc</function> retourne le configuration actuelle - de l'option <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> - (0 pour l'option désactivée, 1 pour l'option activée). - </simpara> - <simpara> - Voir aussi <function>get_magic_quotes_runtime</function>, - <function>set_magic_quotes_runtime</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.get-magic-quotes-runtime"> - <refnamediv> - <refname>get_magic_quotes_runtime</refname> - <refpurpose> - Retourne la configuration actuelle de l'option magic_quotes_runtime. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>long - <function>get_magic_quotes_runtime</function> - </funcdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>get_magic_quotes_gpc</function> retourne la configuration actuelle + de l'option <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> + (0 pour l'option désactivée, 1 pour l'option activée). + </simpara> + <simpara> + Voir aussi + <function>get_magic_quotes_runtime</function> et + <function>set_magic_quotes_runtime</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.get-magic-quotes-runtime"> + <refnamediv> + <refname>get_magic_quotes_runtime</refname> + <refpurpose> + Retourne la configuration actuelle de l'option magic_quotes_runtime. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>long <function>get_magic_quotes_runtime</function></funcdef> <paramdef>void</paramdef> - </funcsynopsis> - <simpara> - <function>get_magic_quotes_runtime</function> retourne la configuration - actuelle de l'option - <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>. - (0 pour option desactivée, 1 pour option sactivée). - </simpara> - <simpara> - Voir aussi <function>get_magic_quotes_gpc</function>, - <function>set_magic_quotes_runtime</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.getlastmod"> - <refnamediv> - <refname>getlastmod</refname> - <refpurpose> - Retourne la date de dernière modification de la page. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <simpara> + <function>get_magic_quotes_runtime</function> retourne la configuration + actuelle de l'option + <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>. + (0 pour option désactivée, 1 pour option activée). + </simpara> + <simpara> + Voir aussi + <function>get_magic_quotes_gpc</function> et + <function>set_magic_quotes_runtime</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.getlastmod"> + <refnamediv> + <refname>getlastmod</refname> + <refpurpose> + Retourne la date de dernière modification de la page. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>getlastmod</function></funcdef> <paramdef>void</paramdef> - </funcsynopsis> - <para> - <function>getlastmod</function> retourne la date de dernière - modification de la page. La valeur retournée est - un marqueur de temps UNIX, utilisable comme paramètre avec - la fonction <function>date</function>. - <function>getlastmod</function> retourne &false; en - cas d'erreur. - <example> - <title>Exemple avec <function>getlastmod</function></title> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <function>getlastmod</function> retourne la date de dernière + modification de la page. La valeur retournée est + un marqueur de temps UNIX, utilisable comme paramètre avec + la fonction <function>date</function>. + <function>getlastmod</function> retourne <literal>FALSE</literal> en + cas d'erreur. + <example> + <title>Exemple avec <function>getlastmod</function></title> + <programlisting role="php"> <?php // affiche 'Dernière modification: March 04 1998 20:43:59.' -echo "Dernière modification: ".date( "F d Y H:i:s.", getlastmod() ); + echo "Dernière modification: ".date( "F d Y H:i:s.", getlastmod() ); ?> - </programlisting> - </example> - </para> - <para> - Voir aussi <function>date</function>, <function>getmyuid</function>, - <function>get_current_user</function>, <function>getmyinode</function> et - <function>getmypid</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.getmyinode"> - <refnamediv> - <refname>getmyinode</refname> - <refpurpose>Retourne l'inode du script.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>date</function>, + <function>getmyuid</function>, + <function>get_current_user</function>, + <function>getmyinode</function> et + <function>getmypid</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.getmyinode"> + <refnamediv> + <refname>getmyinode</refname> + <refpurpose>Retourne l'inode du script.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>getmyinode</function></funcdef> <paramdef>void</paramdef> - </funcsynopsis> - <para> - <function>getmyinode</function> retourne l'inode du script, - ou &false; en cas d'erreur. - </para> - <para> - Voir aussi <function>getmyuid</function>, - <function>get_current_user</function>, - <function>getmypid</function>, et - <function>getlastmod</function>. - </para> - <note> - <simpara> + </funcprototype> + </funcsynopsis> + <para> + <function>getmyinode</function> retourne l'inode du script, + ou <literal>FALSE</literal> en cas d'erreur. + </para> + <para> + Voir aussi + <function>getmyuid</function>, + <function>get_current_user</function>, + <function>getmypid</function> et + <function>getlastmod</function>. + </para> + <note> + <simpara> <function>getmyinode</function> est inopérante sur les systèmes Windows. - </simpara> - </note> - </refsect1> - </refentry> - <refentry id="function.getmypid"> - <refnamediv> - <refname>getmypid</refname> - <refpurpose>Retourne le numéro de processus courant.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </simpara> + </note> + </refsect1> + </refentry> + <refentry id="function.getmypid"> + <refnamediv> + <refname>getmypid</refname> + <refpurpose>Retourne le numéro de processus courant.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>getmypid</function></funcdef> <paramdef>void</paramdef> - </funcsynopsis> - <para> - <function>getmypid</function> retourne le numéro de processus - actuel ou &false; en cas d'erreur. - </para> - <para> - Il est à noter que si vous utilisez PHP comme module Apache, - il n'est pas guarantit que deux invocations distinctes de la fonction - donnent des résultats différents. - </para> - <warning> - <para> - Les identifiants de processus ne sont pas uniques, - et forment une source d'entropie faible. Nous recommandons - de ne pas utiliser les pid pour assurer la sécurité d'un - système. - </para> - </warning> - <para> - Voir aussi <function>getmyuid</function>, <function>get_current_user</function>, - <function>getmyinode</function>, et <function>getlastmod</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.getmyuid"> - <refnamediv> - <refname>getmyuid</refname> - <refpurpose>Retourne l'UID du propriétaire du script actuel.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <para> + <function>getmypid</function> retourne le numéro de processus + actuel ou <literal>FALSE</literal> en cas d'erreur. + </para> + <para> + Il est à noter que si vous utilisez PHP comme module Apache, + il n'est pas garanti que deux invocations distinctes de la fonction + donnent des résultats différents. + </para> + <warning> + <para> + Les identifiants de processus ne sont pas uniques, + et forment une source d'entropie faible. Nous recommandons + de ne pas utiliser les pid pour assurer la sécurité d'un + système. + </para> + </warning> + <para> + Voir aussi + <function>getmyuid</function>, + <function>get_current_user</function>, + <function>getmyinode</function> et + <function>getlastmod</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.getmyuid"> + <refnamediv> + <refname>getmyuid</refname> + <refpurpose>Retourne l'UID du propriétaire du script actuel.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>getmyuid</function></funcdef> <paramdef>void</paramdef> - </funcsynopsis> - <simpara> - <function>getmyuid</function> retourne l'UID du propriétaire - du script actuel ou &false; en cas d'erreur. - </simpara> - <simpara> - Voir aussi <function>getmypid</function>, <function>get_current_user</function>, - <function>getmyinode</function>, et <function>getlastmod</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.getrusage"> - <refnamediv> - <refname>getrusage</refname> - <refpurpose>Retourne le niveau d'utilisation des ressources.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <simpara> + <function>getmyuid</function> retourne l'UID du propriétaire + du script actuel ou <literal>FALSE</literal> en cas d'erreur. + </simpara> + <simpara> + Voir aussi + <function>getmypid</function>, + <function>get_current_user</function>, + <function>getmyinode</function> et + <function>getlastmod</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.getrusage"> + <refnamediv> + <refname>getrusage</refname> + <refpurpose>Retourne le niveau d'utilisation des ressources.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>array <function>getrusage</function></funcdef> <paramdef>int <parameter><optional>who</optional></parameter> </paramdef> - </funcsynopsis> - <para> - <function>getrusage</function> est une interface à - la fonction system getrusage(2). - Elle retourne un tableau associatif contenant les informations - renvoyées par cet appel système. Si "who is 1", - getrusage sera appelé avec le paramètre RUSAGE_CHILDREN. - </para> - <para> - Toutes les valeurs du tableau sont accessibles en utilisant leur nom dans le - tableau. - <example> - <title>Exemple getrusage</title> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <function>getrusage</function> est une interface à + la fonction system getrusage(2). + Elle retourne un tableau associatif contenant les informations + renvoyées par cet appel système. Si "who is 1", + getrusage sera appelé avec le paramètre RUSAGE_CHILDREN. + </para> + <para> + Toutes les valeurs du tableau sont accessibles en utilisant leur nom dans le + tableau. + <example> + <title>Exemple getrusage</title> + <programlisting role="php"> <?php -$dat = getrusage(); -echo $dat["ru_nswap"]; # Taille de la mémoire swap -echo $dat["ru_majflt"]; # Nombre de page mémoires utilisées -echo $dat["ru_utime.tv_sec"]; # temps utilisateur (en secondes) -echo $dat["ru_utime.tv_usec"]; # temps utilisateur (en microsecondes) + $dat = getrusage(); + echo $dat["ru_nswap"]; # Taille de la mémoire swap + echo $dat["ru_majflt"]; # Nombre de page mémoires utilisées + echo $dat["ru_utime.tv_sec"]; # Temps utilisateur (en secondes) + echo $dat["ru_utime.tv_usec"]; # Temps utilisateur (en microsecondes) ?> - </programlisting> - </example> - Consultez le manuel "man" pour plus de détails. - </para> - </refsect1> - </refentry> - <refentry id="function.ini-alter"> - <refnamediv> - <refname>ini_alter</refname> - <refpurpose>Change la valeur d'une option de configuration</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>ini_alter</function></funcdef> - <paramdef>string <parameter>varname</parameter></paramdef> - <paramdef>string <parameter>newvalue</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ini_alter</function> change la valeur de l'option de - configuration <parameter>varname</parameter> - et lui donne la valeur de <parameter>newvalue</parameter>. - <function>ini_alter</function> retourne &false; - en cas d'échec, et la valeur précédente en - cas de succès. - </para> - <note> - <para> - <function>ini_alter</function> est un alias de <function>ini_set</function> - </para> - </note> - <para> - Voir aussi <function>ini_get</function>, - <function>ini_restore</function> et - <function>ini_set</function> - </para> - </refsect1> - </refentry> - <refentry id="function.ini-get"> - <refnamediv> - <refname>ini_get</refname> - <refpurpose>Lit la valeur d'une option de configuration.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>ini_get</function></funcdef> - <paramdef>string <parameter>varname</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ini_get</function> retourne la valeur de l'option de - configuration <parameter>varname</parameter> en cas de succès, et - &false;. - </para> - <para> - Voir aussi <function>ini_alter</function>, - <function>ini_restore</function> et - <function>ini_set</function> - </para> - </refsect1> - </refentry> - <refentry id="function.ini-restore"> - <refnamediv> - <refname>ini_restore</refname> - <refpurpose>Restaure la valeur de l'option de configuration</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>ini_restore</function></funcdef> - <paramdef>string <parameter>varname</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ini_restore</function> restaure la valeur originale de - l'option de configuration <parameter>varname</parameter>. - </para> - <para> - Voir aussi <function>ini_alter</function>, - <function>ini_get</function>, - <function>ini_set</function> - </para> - </refsect1> - </refentry> -<refentry id="function.ini-set"> - <refnamediv> - <refname>ini_set</refname> - <refpurpose>Change la valeur d'une option de configuration</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>ini_set</function></funcdef> - <paramdef>string <parameter>varname</parameter></paramdef> - <paramdef>string <parameter>newvalue</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ini_set</function> change la valeur de l'option de - configuration <parameter>varname</parameter> - et lui donne la valeur de <parameter>newvalue</parameter>. - <function>ini_set</function> retourne &false; - en cas d'échec, et la valeur - précédente en cas de succès. - </para> - <para> - Toutes les options disponibles ne peuvent pas être toutes - modifiées avec <function>ini_set</function>. Ci-dessous, vous - trouverez une liste de toutes les options (disponibles - en PHP 4.0.5-dev), et si elles peuvent être modifiées. - <table> - <title>Options de configuration</title> - <tgroup cols="3"> - <thead> - <row> - <entry>Nom</entry> - <entry>Par défaut</entry> - <entry>Modifiable</entry> - </row> - </thead> - <tbody> - <row> - <entry>define_syslog_variables</entry> - <entry>"0"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>highlight.bg</entry> - <entry>HL_BG_COLOR</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>highlight.comment</entry> - <entry>HL_COMMENT_COLOR</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>highlight.default</entry> - <entry>HL_DEFAULT_COLOR</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>highlight.html</entry> - <entry>HL_HTML_COLOR</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>highlight.keyword</entry> - <entry>HL_KEYWORD_COLOR</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>highlight.string</entry> - <entry>HL_STRING_COLOR</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>allow_call_time_pass_reference</entry> - <entry>"1"</entry> - <entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry> - </row> - <row> - <entry>asp_tags</entry> - <entry>"0"</entry> - <entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry> - </row> - <row> - <entry>display_errors</entry> - <entry>"1"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>display_startup_errors</entry> - <entry>"0"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>enable_dl</entry> - <entry>"1"</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>error_append_string</entry> - <entry>&null;</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>error_prepend_string</entry> - <entry>&null;</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>expose_php</entry> - <entry>"1"</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>html_errors</entry> - <entry>"1"</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>ignore_user_abort</entry> - <entry>"0"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>implicit_flush</entry> - <entry>"0"</entry> - <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>log_errors</entry> - <entry>"0"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>magic_quotes_gpc</entry> - <entry>"1"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>magic_quotes_runtime</entry> - <entry>"0"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>magic_quotes_sybase</entry> - <entry>"0"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>output_buffering</entry> - <entry>"0"</entry> - <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>output_handler</entry> - <entry>&null;</entry> - <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>register_argc_argv</entry> - <entry>"1"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>register_globals</entry> - <entry>"1"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>safe_mode</entry> - <entry>"0"</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>short_open_tag</entry> - <entry>"1"</entry> - <entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry> - </row> - <row> - <entry>sql.safe_mode</entry> - <entry>"0"</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>track_errors</entry> - <entry>"0"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>y2k_compliance</entry> - <entry>"0"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>arg_separator</entry> - <entry>"&"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>auto_append_file</entry> - <entry>&null;</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>auto_prepend_file</entry> - <entry>&null;</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>doc_root</entry> - <entry>&null;</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>default_charset</entry> - <entry>SAPI_DEFAULT_CHARSET</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>default_mimetype</entry> - <entry>SAPI_DEFAULT_MIMETYPE</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>error_log</entry> - <entry>&null;</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>extension_dir</entry> - <entry>PHP_EXTENSION_DIR</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>gpc_order</entry> - <entry>"GPC"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>include_path</entry> - <entry>PHP_INCLUDE_PATH</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>max_execution_time</entry> - <entry>"30"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>open_basedir</entry> - <entry>&null;</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>safe_mode_exec_dir</entry> - <entry>"1"</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>upload_max_filesize</entry> - <entry>"2M"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>file_uploads</entry> - <entry>"1"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>post_max_size</entry> - <entry>"8M"</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>upload_tmp_dir</entry> - <entry>&null;</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>user_dir</entry> - <entry>&null;</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>variables_order</entry> - <entry>&null;</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>SMTP</entry> - <entry>"localhost"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>browscap</entry> - <entry>&null;</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>error_reporting</entry> - <entry>&null;</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>memory_limit</entry> - <entry>"8M"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>precision</entry> - <entry>"14"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>sendmail_from</entry> - <entry>&null;</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>sendmail_path</entry> - <entry>DEFAULT_SENDMAIL_PATH</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>disable_functions</entry> - <entry>""</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>allow_url_fopen</entry> - <entry>"1"</entry> - <entry>PHP_INI_ALL</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - <para> - <table> - <title>Définition des constantes PHP_INI_*</title> - <tgroup cols="3"> - <thead> - <row> - <entry>Constante</entry> - <entry>Valeur</entry> - <entry>Signification</entry> - </row> - </thead> - <tbody> - <row> - <entry>PHP_INI_USER</entry> - <entry>1</entry> - <entry>La valeur peut être modifiée dans un script</entry> - </row> - <row> - <entry>PHP_INI_PERDIR</entry> - <entry>2</entry> - <entry>La valeur peut être modifiée dans le fichier <filename>.htaccess</filename></entry> - </row> - <row> - <entry>PHP_INI_SYSTEM</entry> - <entry>4</entry> - <entry>La valeur peut être modifiée dans <filename>php.ini</filename> ou - <filename>httpd.conf</filename></entry> - </row> - <row> - <entry>PHP_INI_ALL</entry> - <entry>7</entry> - <entry>La valeur peut être modifiée n'importe où</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - <para> - Voir aussi - <function>ini_alter</function>, - <function>ini_get</function>, - <function>ini_restore</function> - </para> - </refsect1> - </refentry> - <refentry id="function.phpcredits"> - <refnamediv> - <refname>phpcredits</refname> - <refpurpose>Imprime les crédits de PHP.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>void <function>phpcredits</function></funcdef> - <paramdef>int <parameter>flag</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>phpcredits</function> affiche la liste des développeurs PHP, - des modules, etc... Elle génère le code HTML - approprié pour insérer les informations dans une page. - Le paramètre <parameter>flag</parameter> indique les informations - qui doivent être affichées. Par exemple, pour afficher - les crédits généraux, vous pouvez utiliser le - code suivant : - <informalexample> - <programlisting role="php"> + </programlisting> + </example> + Consultez le manuel "man" pour plus de détails. + </para> + </refsect1> + </refentry> + <refentry id="function.ini-alter"> + <refnamediv> + <refname>ini_alter</refname> + <refpurpose>Change la valeur d'une option de configuration</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ini_alter</function></funcdef> + <paramdef>string <parameter>varname</parameter></paramdef> + <paramdef>string <parameter>newvalue</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ini_alter</function> change la valeur de l'option de + configuration <parameter>varname</parameter> + et lui donne la valeur de <parameter>newvalue</parameter>. + <function>ini_alter</function> retourne <literal>FALSE</literal> + en cas d'échec, et la valeur précédente en + cas de succès. + </para> + <note> + <para> + <function>ini_alter</function> est un alias de <function>ini_set</function> + </para> + </note> + <para> + Voir aussi + <function>ini_get</function>, + <function>ini_restore</function> et + <function>ini_set</function> + </para> + </refsect1> + </refentry> + <refentry id="function.ini-get"> + <refnamediv> + <refname>ini_get</refname> + <refpurpose>Lit la valeur d'une option de configuration.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ini_get</function></funcdef> + <paramdef>string <parameter>varname</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ini_get</function> retourne la valeur de l'option de + configuration <parameter>varname</parameter> en cas de succès, et + <literal>FALSE</literal>. + </para> + <para> + Voir aussi + <function>ini_alter</function>, + <function>ini_restore</function> et + <function>ini_set</function> + </para> + </refsect1> + </refentry> + <refentry id="function.ini-restore"> + <refnamediv> + <refname>ini_restore</refname> + <refpurpose>Restaure la valeur de l'option de configuration</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ini_restore</function></funcdef> + <paramdef>string <parameter>varname</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ini_restore</function> restaure la valeur originale de + l'option de configuration <parameter>varname</parameter>. + </para> + <para> + Voir aussi + <function>ini_alter</function>, + <function>ini_get</function> et + <function>ini_set</function> + </para> + </refsect1> + </refentry> + <refentry id="function.ini-set"> + <refnamediv> + <refname>ini_set</refname> + <refpurpose>Change la valeur d'une option de configuration</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ini_set</function></funcdef> + <paramdef>string <parameter>varname</parameter></paramdef> + <paramdef>string <parameter>newvalue</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ini_set</function> change la valeur de l'option de + configuration <parameter>varname</parameter> + et lui donne la valeur de <parameter>newvalue</parameter>. + <function>ini_set</function> retourne <literal>FALSE</literal> + en cas d'échec, et la valeur + précédente en cas de succès. + La valeur de l'option de configuration sera modifiée durant toute + l'exécution du script et pour ce script spécifiquement. Elle reprendra + sa valeur par défaut dès la fin du script. + </para> + <para> + Toutes les options disponibles ne peuvent pas être toutes + modifiées avec <function>ini_set</function>. Ci-dessous, vous + trouverez une liste de toutes les options (disponibles + en PHP 4.0.5-dev), et si elles peuvent être modifiées. + <table> + <title>Options de configuration</title> + <tgroup cols="3"> + <thead> + <row> + <entry>Nom</entry> + <entry>Par défaut</entry> + <entry>Modifiable</entry> + </row> + </thead> + <tbody> + <row> + <entry>define_syslog_variables</entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>highlight.bg</entry> + <entry>HL_BG_COLOR</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>highlight.comment</entry> + <entry>HL_COMMENT_COLOR</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>highlight.default</entry> + <entry>HL_DEFAULT_COLOR</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>highlight.html</entry> + <entry>HL_HTML_COLOR</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>highlight.keyword</entry> + <entry>HL_KEYWORD_COLOR</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>highlight.string</entry> + <entry>HL_STRING_COLOR</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>allow_call_time_pass_reference</entry> + <entry>"1"</entry> + <entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry> + </row> + <row> + <entry>asp_tags</entry> + <entry>"0"</entry> + <entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry> + </row> + <row> + <entry>display_errors</entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>display_startup_errors</entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>enable_dl</entry> + <entry>"1"</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>error_append_string</entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>error_prepend_string</entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>expose_php</entry> + <entry>"1"</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>html_errors</entry> + <entry>"1"</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>ignore_user_abort</entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>implicit_flush</entry> + <entry>"0"</entry> + <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>log_errors</entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>magic_quotes_gpc</entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>magic_quotes_runtime</entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>magic_quotes_sybase</entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>output_buffering</entry> + <entry>"0"</entry> + <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>output_handler</entry> + <entry>NULL</entry> + <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>register_argc_argv</entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>register_globals</entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>safe_mode</entry> + <entry>"0"</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>short_open_tag</entry> + <entry>"1"</entry> + <entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry> + </row> + <row> + <entry>sql.safe_mode</entry> + <entry>"0"</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>track_errors</entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>y2k_compliance</entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>arg_separator</entry> + <entry>"&"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>auto_append_file</entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>auto_prepend_file</entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>doc_root</entry> + <entry>NULL</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>default_charset</entry> + <entry>SAPI_DEFAULT_CHARSET</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>default_mimetype</entry> + <entry>SAPI_DEFAULT_MIMETYPE</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>error_log</entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>extension_dir</entry> + <entry>PHP_EXTENSION_DIR</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>gpc_order</entry> + <entry>"GPC"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>include_path</entry> + <entry>PHP_INCLUDE_PATH</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>max_execution_time</entry> + <entry>"30"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>open_basedir</entry> + <entry>NULL</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>safe_mode_exec_dir</entry> + <entry>"1"</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>upload_max_filesize</entry> + <entry>"2M"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>file_uploads</entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>post_max_size</entry> + <entry>"8M"</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>upload_tmp_dir</entry> + <entry>NULL</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>user_dir</entry> + <entry>NULL</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>variables_order</entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>SMTP</entry> + <entry>"localhost"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>browscap</entry> + <entry>NULL</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>error_reporting</entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>memory_limit</entry> + <entry>"8M"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>precision</entry> + <entry>"14"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>sendmail_from</entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>sendmail_path</entry> + <entry>DEFAULT_SENDMAIL_PATH</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>disable_functions</entry> + <entry>""</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>allow_url_fopen</entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + <table> + <title>Définition des constantes PHP_INI_*</title> + <tgroup cols="3"> + <thead> + <row> + <entry>Constante</entry> + <entry>Valeur</entry> + <entry>Signification</entry> + </row> + </thead> + <tbody> + <row> + <entry>PHP_INI_USER</entry> + <entry>1</entry> + <entry>La valeur peut être modifiée dans un script</entry> + </row> + <row> + <entry>PHP_INI_PERDIR</entry> + <entry>2</entry> + <entry>La valeur peut être modifiée dans le fichier <filename>.htaccess</filename></entry> + </row> + <row> + <entry>PHP_INI_SYSTEM</entry> + <entry>4</entry> + <entry>La valeur peut être modifiée dans <filename>php.ini</filename> ou + <filename>httpd.conf</filename></entry> + </row> + <row> + <entry>PHP_INI_ALL</entry> + <entry>7</entry> + <entry>La valeur peut être modifiée n'importe où</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + Voir aussi + <function>ini_alter</function>, + <function>ini_get</function> et + <function>ini_restore</function> + </para> + </refsect1> + </refentry> + <refentry id="function.phpcredits"> + <refnamediv> + <refname>phpcredits</refname> + <refpurpose>Imprime les crédits de PHP.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>phpcredits</function></funcdef> + <paramdef>int <parameter>flag</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>phpcredits</function> affiche la liste des développeurs PHP, + des modules, etc... Elle génère le code HTML + approprié pour insérer les informations dans une page. + Le paramètre <parameter>flag</parameter> indique les informations + qui doivent être affichées. Par exemple, pour afficher + les crédits généraux, vous pouvez utiliser le + code suivant : + <informalexample> + <programlisting role="php"> <?php -phpcredits(CREDITS_GENERAL); + phpcredits(CREDITS_GENERAL); ?> - </programlisting> - </informalexample> - Et pour afficher la liste des développeurs et du groupe - de documentation dans une page séparée, vous - utiliserez - <informalexample> - <programlisting role="php"> + </programlisting> + </informalexample> + Et pour afficher la liste des développeurs et du groupe + de documentation dans une page séparée, vous + utiliserez + <informalexample> + <programlisting role="php"> <?php phpcredits(CREDITS_GROUP + CREDITS_DOCS + CREDITS_FULLPAGE); ?> - </programlisting> - </informalexample> - Si vous vous sentez l'envie de placer tous les crédits dans votre page, - vous pouvez utiliser ceci : - <informalexample> - <programlisting role="php"> + </programlisting> + </informalexample> + Si vous vous sentez l'envie de placer tous les crédits dans votre page, + vous pouvez utiliser ceci : + <informalexample> + <programlisting role="php"> <html> <head> <title>Ma page de crédits</title> @@ -985,196 +1031,204 @@ ?> </body> </html> - </programlisting> - </informalexample> - </para> - <para> - </para> - <para> + </programlisting> + </informalexample> + </para> + <para> + </para> + <para> <table> - <title> - Paramètre prédéfinis de <function>phpcredits</function> - </title> - <tgroup cols="2"> - <thead> - <row> - <entry>Nom</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>CREDITS_ALL</entry> - <entry> - Tous les crédits, équivalent à : - CREDITS_DOCS + CREDITS_GENERAL + CREDITS_GROUP + CREDITS_MODULES + - CREDITS_FULLPAGE. La fonction génère - alors une page HTML complète. - </entry> - </row> - <row> - <entry>CREDITS_DOCS</entry> - <entry>Les crédits du groupe de documentation</entry> - </row> - <row> - <entry>CREDITS_FULLPAGE</entry> - <entry> - En général, ce paramètre est utilisé avec d'autres - constantes. Il indique que la page ainsi générée doit - être une page HTML complète, avec toutes les balises - nécessaires. - </entry> - </row> - <row> - <entry>CREDITS_GENERAL</entry> - <entry> - Crédits Généraux : conception et design du langage, - auteurs de PHP 4.0, module SAPI. - </entry> - </row> - <row> - <entry>CREDITS_GROUP</entry> - <entry>Une liste des développeurs principaux</entry> - </row> - <row> - <entry>CREDITS_MODULES</entry> - <entry>Une liste des extensions de PHP, et leurs auteurs</entry> - </row> - <row> - <entry>CREDITS_SAPI</entry> - <entry>Cette constante est définie, mais elle n'est toujours pas - utilisée sous PHP 4.0.1pl2. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - <para> - Voir aussi <function>phpinfo</function>, - <function>phpversion</function>, - <function>php_logo_guid</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.phpinfo"> - <refnamediv> - <refname>phpinfo</refname> - <refpurpose>Affiche de nombreuses informations sur le PHP.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>phpinfo</function></funcdef> - <paramdef>int <parameter><optional>what</optional></parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Affiche de nombreuses informations sur le PHP, concernant sa - configuration courante : options de compilation, extensions, - version, informations sur le serveur, et environnement (lorsque - compilé comme module), environnement PHP, chemins, utilisateur, - entêtes HTTP, et licence GNU Public License. - </para> - <para> - Les affichages peuvent être personnalisés en passant une - ou plusieurs valeurs parmis les suivantes, comme paramètre - optionnel <parameter>what</parameter> : - <itemizedlist> - <listitem><simpara>INFO_GENERAL</simpara></listitem> - <listitem><simpara>INFO_CREDITS</simpara></listitem> - <listitem><simpara>INFO_CONFIGURATION</simpara></listitem> - <listitem><simpara>INFO_MODULES</simpara></listitem> - <listitem><simpara>INFO_ENVIRONMENT</simpara></listitem> - <listitem><simpara>INFO_VARIABLES</simpara></listitem> - <listitem><simpara>INFO_LICENSE</simpara></listitem> - <listitem><simpara>INFO_ALL</simpara></listitem> - </itemizedlist> - </para> - <para> - Voir aussi <function>phpversion</function>, - <function>phpcredits</function> et <function>php_logo_guid</function> - </para> - </refsect1> - </refentry> - <refentry id="function.phpversion"> - <refnamediv> - <refname>phpversion</refname> - <refpurpose> - Retourne le numéro de la version courante de PHP. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + <title> + Paramètre prédéfinis de <function>phpcredits</function> + </title> + <tgroup cols="2"> + <thead> + <row> + <entry>Nom</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>CREDITS_ALL</entry> + <entry> + Tous les crédits, équivalent à : + CREDITS_DOCS + CREDITS_GENERAL + CREDITS_GROUP + CREDITS_MODULES + + CREDITS_FULLPAGE. La fonction génère + alors une page HTML complète. + </entry> + </row> + <row> + <entry>CREDITS_DOCS</entry> + <entry>Les crédits du groupe de documentation</entry> + </row> + <row> + <entry>CREDITS_FULLPAGE</entry> + <entry> + En général, ce paramètre est utilisé avec d'autres + constantes. Il indique que la page ainsi générée doit + être une page HTML complète, avec toutes les balises + nécessaires. + </entry> + </row> + <row> + <entry>CREDITS_GENERAL</entry> + <entry> + Crédits Généraux : conception et design du langage, + auteurs de PHP 4.0, module SAPI. + </entry> + </row> + <row> + <entry>CREDITS_GROUP</entry> + <entry>Une liste des développeurs principaux</entry> + </row> + <row> + <entry>CREDITS_MODULES</entry> + <entry>Une liste des extensions de PHP, et leurs auteurs</entry> + </row> + <row> + <entry>CREDITS_SAPI</entry> + <entry>Cette constante est définie, mais elle n'est toujours pas + utilisée sous PHP 4.0.1pl2. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + Voir aussi + <function>phpinfo</function>, + <function>phpversion</function> et + <function>php_logo_guid</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.phpinfo"> + <refnamediv> + <refname>phpinfo</refname> + <refpurpose>Affiche de nombreuses informations sur le PHP.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>phpinfo</function></funcdef> + <paramdef>int <parameter><optional>what</optional></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>phpinfo</function> affiche de nombreuses informations sur le PHP, concernant sa + configuration courante : options de compilation, extensions, + version, informations sur le serveur, et environnement (lorsque + compilé comme module), environnement PHP, chemins, utilisateur, + en-têtes HTTP, et licence GNU Public License. + </para> + <para> + Les affichages peuvent être personnalisés en passant une + ou plusieurs valeurs parmi les suivantes, comme paramètre + optionnel <parameter>what</parameter> : + <itemizedlist> + <listitem><simpara>INFO_GENERAL</simpara></listitem> + <listitem><simpara>INFO_CREDITS</simpara></listitem> + <listitem><simpara>INFO_CONFIGURATION</simpara></listitem> + <listitem><simpara>INFO_MODULES</simpara></listitem> + <listitem><simpara>INFO_ENVIRONMENT</simpara></listitem> + <listitem><simpara>INFO_VARIABLES</simpara></listitem> + <listitem><simpara>INFO_LICENSE</simpara></listitem> + <listitem><simpara>INFO_ALL</simpara></listitem> + </itemizedlist> + </para> + <para> + Voir aussi + <function>phpversion</function>, + <function>phpcredits</function> et + <function>php_logo_guid</function> + </para> + </refsect1> + </refentry> + <refentry id="function.phpversion"> + <refnamediv> + <refname>phpversion</refname> + <refpurpose> + Retourne le numéro de la version courante de PHP. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>string <function>phpversion</function></funcdef> <paramdef>void</paramdef> - </funcsynopsis> - <para> - <function>phpversion</function> retourne le numéro de - la version courante de PHP. - <example> - <title>example de la fonction phpversion()</title> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <function>phpversion</function> retourne le numéro de + la version courante de PHP. + <example> + <title>Exemple avec <function>phpversion</function></title> + <programlisting role="php"> <?php // affiche le numéro de version courante du PHP. -echo "PHP Version: ".phpversion(); + echo "PHP Version: ".phpversion(); ?> - </programlisting> - </example> - </para> - <para> - Voir aussi <function>phpinfo</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.php-logo-guid"> - <refnamediv> - <refname>php_logo_guid</refname> - <refpurpose>Retourne le logo</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>phpinfo</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.php-logo-guid"> + <refnamediv> + <refname>php_logo_guid</refname> + <refpurpose>Retourne le logo</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>string <function>php_logo_guid</function></funcdef> <paramdef>void</paramdef> - </funcsynopsis> - <para> - <note> - <para> - Cette fonctionnalité a été ajoutée dans - PHP 4 Beta 4. - </para> - </note> - </para> - </refsect1> - </refentry> - <refentry id="function.php-sapi-name"> - <refnamediv> - <refname>php_sapi_name</refname> - <refpurpose> - Retourne le type d'interface utilisée entre le serveur web et PHP - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>php_sapi_name</function></funcdef> - <paramdef>void</paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>php_sapi_name</function> retourne une chaîne en minuscule - qui décrit le type d'interface utilisé en le serveur web et PHP - (Server API, SAPI). En CGI PHP, cette chaîne est "cgi", en - mod_php pour Apache, cette chaîne est "apache", etc... - </simpara> - <para> - <example> - <title>Exemple <function>php_sapi_name</function></title> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <note> + <para> + Cette fonctionnalité a été ajoutée dans + PHP 4 Beta 4. + </para> + </note> + </para> + </refsect1> + </refentry> + <refentry id="function.php-sapi-name"> + <refnamediv> + <refname>php_sapi_name</refname> + <refpurpose> + Retourne le type d'interface utilisé entre le serveur web et PHP + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>php_sapi_name</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>php_sapi_name</function> retourne une chaîne en minuscule + qui décrit le type d'interface utilisé en le serveur web et PHP + (Server API, SAPI). En CGI PHP, cette chaîne est "CGI", en + mod_php pour Apache, cette chaîne est "apache", etc... + </simpara> + <para> + <example> + <title>Exemple <function>php_sapi_name</function></title> + <programlisting role="php"> <?php $inter_type = php_sapi_name(); if ($inter_type == "cgi") @@ -1182,323 +1236,413 @@ else print "Vous n'utilisez pas CGI PHP\n"; ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> -<refentry id="function.php-uname"> - <refnamediv> - <refname>php_uname</refname> - <refpurpose> - Retourne les informations sur le système d'exploitation - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>php_uname</function></funcdef> - <paramdef>void</paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>php_uname</function> retourne les informations sur le système - d'exploitation sur lequel tourne PHP. - </simpara> - <para> - <example> - <title>Exemple <function>php_uname</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.php-uname"> + <refnamediv> + <refname>php_uname</refname> + <refpurpose> + Retourne les informations sur le système d'exploitation + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>php_uname</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>php_uname</function> retourne les informations sur le système + d'exploitation sur lequel tourne PHP. + </simpara> + <para> + <example> + <title>Exemple <function>php_uname</function></title> + <programlisting role="php"> <?php if (substr(php_uname(), 0, 7) == "Windows") { die("Désolé, ce script ne fonctionne pas sous Windows.\n"); } ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.putenv"> - <refnamediv> - <refname>putenv</refname> - <refpurpose>Fixe la valeur d'une variable d'environnement.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.putenv"> + <refnamediv> + <refname>putenv</refname> + <refpurpose>Fixe la valeur d'une variable d'environnement.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>void <function>putenv</function></funcdef> <paramdef>string <parameter>setting</parameter></paramdef> - </funcsynopsis> - <para> - Fixe la valeur d'une variable d'environnement. - </para> - <para> - <example> - <title>Fixer la valeur d'une variable d'environnement</title> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <function>putenv</function> fixe la valeur d'une variable d'environnement. + Cette valeur n'existera que durant la vie du script courant, et l'environnement + initial sera restauré lorsque le script sera terminé. + </para> + <para> + Modifier la valeur de certaines variables système peut être un trou + de sécurité considérable. La directive de configuration + <literal>safe_mode_allowed_env_vars</literal> contient une liste de + préfixes, séparés par des virgules. Lorsque le Safe Mode est actif, + l'utilisateur ne peut que modifier les variables qui dont le nom + commence par les préfixes fournis par cette directive. + Par défaut, les utilisateurs ne peuvent modifier que les variables qui + commencent par <literal>PHP_</literal> + (i.e. <literal>PHP_FOO=BAR</literal>). Note: si cette directive est vide, + PHP autorisera la modification de TOUTES les variables d'environnement!. + </para> + <para> + La directive de configuration <literal>safe_mode_protected_env_vars</literal> + contient une liste de variables d'environnement, séparées par des virgules. + Les utilisateurs ne pourront pas modifier ces variables avec la fonction + <function>putenv</function>. Ces variables seront protégées même si + <literal>safe_mode_allowed_env_vars</literal> permet leur modification. + </para> + <para> + <example> + <title>Modification d'une variable d'environnement</title> + <programlisting role="php"> <?php putenv("UNIQID=$uniqid"); ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.set-magic-quotes-runtime"> - <refnamediv> - <refname>set_magic_quotes_runtime</refname> - <refpurpose> - Active/désactive l'option magic_quotes_runtime. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>long - <function>set_magic_quotes_runtime</function> - </funcdef> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>getenv</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.set-magic-quotes-runtime"> + <refnamediv> + <refname>set_magic_quotes_runtime</refname> + <refpurpose> + Active/désactive l'option magic_quotes_runtime. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>long <function>set_magic_quotes_runtime</function></funcdef> <paramdef>int <parameter>new_setting</parameter></paramdef> - </funcsynopsis> - <simpara> - Active/désactive l'option - <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>. - (0 l'option est désactivée, 1 l'option est activée). - </simpara> - <simpara> - Voir aussi <function>get_magic_quotes_gpc</function> et - <function>get_magic_quotes_runtime</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.set-time-limit"> - <refnamediv> - <refname>set_time_limit</refname> - <refpurpose>Fixe le temps maximum d'exécution d'un script.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <simpara> + <function>set_magic_quotes_runtime</function> active/désactive l'option + <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>. + (0 l'option est désactivée, 1 l'option est activée). + </simpara> + <simpara> + Voir aussi + <function>get_magic_quotes_gpc</function> et + <function>get_magic_quotes_runtime</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.set-time-limit"> + <refnamediv> + <refname>set_time_limit</refname> + <refpurpose>Fixe le temps maximum d'exécution d'un script.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>void <function>set_time_limit</function></funcdef> <paramdef>int <parameter>seconds</parameter></paramdef> - </funcsynopsis> - <simpara> - <function>set_time_limit</function> fixe le délai d'éxpiration - d'un script, en secondes. Si cette limite est atteinte, le script s'interrompt, et - renvoie une erreur fatale. La valeur par défaut est 30 secondes ou, si - c'est le cas, la valeur de la directive max_execution_time définie dans le - <link linkend="configuration.file">fichier de configuration</link>. - Si la valeur est zéro, il n'y a alors aucune limite imposée. - </simpara> - <simpara> - Lorsqu'elle est appelée, la fonction - <function>set_time_limit</function> remet le compteur - de zéro. En d'autres termes, si la limite par - défaut est à 30 secondes, et qu'après - 25 secondes d'exécution du script l'appel - set_time_limit(20) est fait, alors le script tournera - pendant un total de 45 secondes avant de finir. - </simpara> - <simpara> - Notez que <function>set_time_limit</function> n'a pas - d'effet lorsque PHP fonctionne en mode <link linkend="ini.safe-mode">safe mode</link>. Il - n'y a pas d'autre solution que de changer de - mode, ou de modifier la durée maximale - d'exécution dans le <link linkend="configuration.file"> - fichier de configuration</link>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.zend-logo-guid"> - <refnamediv> - <refname>zend_logo_guid</refname> - <refpurpose>Retourne le logo de Zend</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <simpara> + <function>set_time_limit</function> fixe le délai d'expiration + d'un script, en secondes. Si cette limite est atteinte, le script s'interrompt, et + renvoie une erreur fatale. La valeur par défaut est 30 secondes ou, si + c'est le cas, la valeur de la directive max_execution_time définie dans le + <link linkend="configuration.file">fichier de configuration</link>. + Si la valeur est zéro, il n'y a alors aucune limite imposée. + </simpara> + <simpara> + Lorsqu'elle est appelée, la fonction + <function>set_time_limit</function> remet le compteur + de zéro. En d'autres termes, si la limite par + défaut est à 30 secondes, et qu'après + 25 secondes d'exécution du script l'appel + set_time_limit(20) est fait, alors le script tournera + pendant un total de 45 secondes avant de finir. + </simpara> + <simpara> + Notez que <function>set_time_limit</function> n'a pas + d'effet lorsque PHP fonctionne en mode <link linkend="ini.safe-mode">safe mode</link>. Il + n'y a pas d'autre solution que de changer de + mode, ou de modifier la durée maximale + d'exécution dans le <link linkend="configuration.file"> + fichier de configuration</link>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.zend-logo-guid"> + <refnamediv> + <refname>zend_logo_guid</refname> + <refpurpose>Retourne le logo de Zend</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>string <function>zend_logo_guid</function></funcdef> <paramdef>void</paramdef> - </funcsynopsis> - <para> - <note> - <para> - Cette fonctionnalité a été ajouté en PHP 4 Beta 4. - </para> - </note> - </para> - </refsect1> - </refentry> - <refentry id="function.get-loaded-extensions"> - <refnamediv> - <refname>get_loaded_extensions</refname> - <refpurpose> - Retourne un tableau contenant les noms de tous les modules compilés - et chargés - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>get_loaded_extensions</function></funcdef> - <paramdef>void </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>get_loaded_extensions</function> retourne un tableau contenant - les noms de tous les modules compilés et chargés sur - l'interpreteur PHP courant. - </para> - <para> - Par exemple, la ligne ci dessous - <informalexample> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <note> + <para> + Cette fonctionnalité a été ajoutée en PHP 4 Beta 4. + </para> + </note> + </para> + </refsect1> + </refentry> + <refentry id="function.get-defined-constants"> + <refnamediv> + <refname>get_defined_constants</refname> + <refpurpose> + Retourne la liste des constantes et leur valeur + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>get_defined_constants</function></funcdef> + <void/> + </funcprototype> + </funcsynopsis> + <para> + <function>get_defined_constants</function> retourne les noms et + valeurs des constantes déjà définies. Cela inclus les constantes créées + par les extensions, et celles créées avec la fonction <function>define</function>. + </para> + <para> + Par exemple : + <informalexample> + <programlisting> +<?php +print_r (get_defined_constants()); +?> + </programlisting> + </informalexample> + affichera + <informalexample> + <programlisting> +Array +( + [E_ERROR] => 1 + [E_WARNING] => 2 + [E_PARSE] => 4 + [E_NOTICE] => 8 + [E_CORE_ERROR] => 16 + [E_CORE_WARNING] => 32 + [E_COMPILE_ERROR] => 64 + [E_COMPILE_WARNING] => 128 + [E_USER_ERROR] => 256 + [E_USER_WARNING] => 512 + [E_USER_NOTICE] => 1024 + [E_ALL] => 2047 + [TRUE] => 1 +) + </programlisting> + </informalexample> + </para> + <para> + Voir aussi + <function>get_loaded_extensions</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.get-loaded-extensions"> + <refnamediv> + <refname>get_loaded_extensions</refname> + <refpurpose> + Retourne la liste de tous les modules compilés et chargés + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>get_loaded_extensions</function></funcdef> + <paramdef>void </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>get_loaded_extensions</function> retourne un tableau contenant + les noms de tous les modules compilés et chargés sur + l'interpreteur PHP courant. + </para> + <para> + Par exemple, la ligne ci-dessous + <informalexample> + <programlisting role="php"> <?php print_r(get_loaded_extensions()); ?> - </programlisting> - </informalexample> - affichera la liste suivante : - <informalexample> - <literallayout> + </programlisting> + </informalexample> + affichera la liste suivante : + <informalexample> + <literallayout> <computeroutput> Array ( [0] => xml [1] => wddx [2] => standard - [3] => session - [4] => posix - [5] => pgsql - [6] => pcre - [7] => gd - [8] => ftp - [9] => db - [10] => Calendar - [11] => bcmath + [3] => session + [4] => posix + [5] => pgsql + [6] => pcre + [7] => gd + [8] => ftp + [9] => db + [10] => Calendar + [11] => bcmath ) </computeroutput> - </literallayout> - </informalexample> - </para> - <para> - Voir aussi: <function>get_extension_funcs</function>. - </para> - </refsect1> - </refentry> -<refentry id="function.get-extension-funcs"> - <refnamediv> - <refname>get_extension_funcs</refname> - <refpurpose> - Liste les fonctions d'une extension - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>get_extension_funcs</function></funcdef> - <paramdef>string <parameter>module_name</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>get_extension_funcs</function> retourne le nom des des fonctions - définies dans le module <parameter>module_name</parameter>. - </para> - <para> - Par exemple, les lignes suivantes : - <informalexample> - <programlisting role="php"> + </literallayout> + </informalexample> + </para> + <para> + Voir aussi + <function>get_extension_funcs</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.get-extension-funcs"> + <refnamediv> + <refname>get_extension_funcs</refname> + <refpurpose> + Liste les fonctions d'une extension + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>get_extension_funcs</function></funcdef> + <paramdef>string <parameter>module_name</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>get_extension_funcs</function> retourne le nom des fonctions + définies dans le module <parameter>module_name</parameter>. + </para> + <para> + Par exemple, les lignes suivantes : + <informalexample> + <programlisting role="php"> <?php print_r(get_extension_funcs("xml")); print_r(get_extension_funcs("gd")); ?> - </programlisting> - </informalexample> - vont afficher la liste des fonctions disponibles avec les modules - <varname>xml</varname> et <varname>gd</varname>. - </para> - <para> - Voir aussi: <function>get_loaded_extensions</function> - </para> - </refsect1> - </refentry> - <refentry id="function.get-required-files"> - <refnamediv> - <refname>get_required_files</refname> - <refpurpose> - Retourne un tableau avec les noms des fichiers qui sont requis - et inclus dans un script - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>get_required_files</function></funcdef> - <paramdef>void </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>get_required_files</function> retourne un tableau - contenant les noms de tous les fichiers qui ont été - chargés dans un script avec la fonction - <function>require_once</function> ou <function>include_once</function>. - Les index de ces tableaux sont les noms des fichiers - utilisés dans les fonctions <function>require_once</function> - ou <function>include_once</function>. + </programlisting> + </informalexample> + vont afficher la liste des fonctions disponibles avec les modules + <varname>xml</varname> et <varname>gd</varname>. + </para> + <para> + Voir aussi + <function>get_loaded_extensions</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.get-required-files"> + <refnamediv> + <refname>get_required_files</refname> + <refpurpose> + Retourne un tableau avec les noms des fichiers qui sont requis + et inclus dans un script + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>get_required_files</function></funcdef> + <paramdef>void </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>get_required_files</function> retourne un tableau + contenant les noms de tous les fichiers qui ont été + chargés dans un script avec la fonction + <function>require_once</function> ou <function>include_once</function>. + Les index de ces tableaux sont les noms des fichiers + utilisés dans les fonctions <function>require_once</function> + ou <function>include_once</function>. + </para> + <note> + <para> + En PHP 4.0.1pl2, cette fonction supposait que + <varname>required_once</varname> utilisait l'extension + ".php" : les autres extensions ne fonctionnaient pas. + Par ailleurs, dans cette version, le tableau retourné était + un tableau associatif, et cette fonction n'était pas + un alias de <function>get_included_files</function> </para> - <note> - <para> - En PHP 4.0.1pl2, cette fonction supposait que - <varname>required_once</varname> utilisait l'extension - ".php" : les autres extensions ne fonctionnaient pas. - Par ailleurs, dans cette version, le tableau retourné était - un tableau associatif, et cette fonction n'était pas - un alias de <function>get_included_files</function> - </para> - <para> - Depuis PHP 4.0.4, cette fonction est un alias de - <function>get_included_files</function> - </para> - </note> <para> - Voir aussi - <function>require_once</function>, - <function>include_once</function> et + Depuis PHP 4.0.4, cette fonction est un alias de <function>get_included_files</function> </para> - </refsect1> - </refentry> - <refentry id="function.get-included-files"> - <refnamediv> - <refname>get_included_files</refname> - <refpurpose> - Retourne un tableau avec les noms des fichiers qui sont inclus - dans un script - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>get_included_files</function></funcdef> - <paramdef>void </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>get_included_files</function> retourne un tableau - contenant les noms de tous les fichiers qui ont été - ajoutés au script avec les fonctions <function>require_once</function> ou - <function>include_once</function>. - </para> - <para> - L'exemple ci-dessous - <example> - <title>Affichage des fichirs inclus et requis</title> - <programlisting> + </note> + <para> + Voir aussi + <function>require_once</function>, + <function>include_once</function> et + <function>get_included_files</function> + </para> + </refsect1> + </refentry> + <refentry id="function.get-included-files"> + <refnamediv> + <refname>get_included_files</refname> + <refpurpose> + Retourne un tableau avec les noms des fichiers qui sont inclus + dans un script + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>get_included_files</function></funcdef> + <paramdef>void </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>get_included_files</function> retourne un tableau + contenant les noms de tous les fichiers qui ont été + ajoutés au script avec les fonctions <function>require_once</function> ou + <function>include_once</function>. + </para> + <para> + L'exemple ci-dessous + <example> + <title>Affichage des fichiers inclus et requis</title> + <programlisting> <?php require_once("local.php"); require_once("../inc/global.php"); @@ -1507,11 +1651,11 @@ echo "Fichiers appelés avec required_once/included_once\n"; print_r(get_required_files()); ?> - </programlisting> - </example> - va afficher : - <informalexample> - <programlisting> + </programlisting> + </example> + va afficher : + <informalexample> + <programlisting> Fichiers appelés avec required_once/included_once Array ( @@ -1522,63 +1666,64 @@ [4] => util3.php [5] => util4.php ) - </programlisting> - </informalexample> - </para> - <note> - <para> - En PHP 4.0.1pl2, cette fonction supposait que - <varname>required_once</varname> utilisait l'extension - ".php" : les autres extensions ne fonctionnaient pas. - Par ailleurs, dans cette version, le tableau retourné était - un tableau associatif, et cette fonction n'était pas - un alias de <function>get_included_files</function> - </para> - </note> - <para> - Voir aussi - <function>require_once</function>, - <function>include_once</function> et - <function>get_required_files</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.zend-version"> - <refnamediv> - <refname>zend_version</refname> - <refpurpose>Lit la version courante du moteur Zend.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>zend_version</function></funcdef> - <paramdef>void<parameter></parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>zend_version</function> retourne une chaîne contenant le - numéro de version du moteur d'analyse Zend, pour l'exécutable - PHP courant. - <example> - <title>Exemple <function>zend_version</function></title> - <programlisting role="php"> + </programlisting> + </informalexample> + </para> + <note> + <para> + En PHP 4.0.1pl2, cette fonction supposait que + <varname>required_once</varname> utilisait l'extension + ".php" : les autres extensions ne fonctionnaient pas. + Par ailleurs, dans cette version, le tableau retourné était + un tableau associatif, et cette fonction n'était pas + un alias de <function>get_included_files</function> + </para> + </note> + <para> + Voir aussi + <function>require_once</function>, + <function>include_once</function> et + <function>get_required_files</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.zend-version"> + <refnamediv> + <refname>zend_version</refname> + <refpurpose>Lit la version courante du moteur Zend.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>zend_version</function></funcdef> + <paramdef>void<parameter></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>zend_version</function> retourne une chaîne contenant le + numéro de version du moteur d'analyse Zend, pour l'exécutable + PHP courant. + <example> + <title>Exemple <function>zend_version</function></title> + <programlisting role="php"> <?php // affiche e.g. 'Version du moteur Zend: 1.0.4' -// ou bien quelquechose d'approchant si votre version de PHP date -echo "Version du moteur Zend: ".zend_version(); +// ou bien quelque chose d'approchant si votre version de PHP date un peu + echo "Version du moteur Zend: ".zend_version(); ?> - </programlisting> - </example> - </para> - <para> - Voir aussi <function>phpinfo</function>, - <function>phpcredits</function>, - <function>php_logo_guid</function> et - <function>phpversion</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>phpinfo</function>, + <function>phpcredits</function>, + <function>php_logo_guid</function> et + <function>phpversion</function>. + </para> + </refsect1> + </refentry> </reference> <!-- Keep this comment at the end of the file Local variables:
Index: phpdoc/fr/functions/info.xml diff -u phpdoc/fr/functions/info.xml:1.15 phpdoc/fr/functions/info.xml:1.16 --- phpdoc/fr/functions/info.xml:1.15 Sat Jul 7 18:22:12 2001 +++ phpdoc/fr/functions/info.xml Thu Jul 19 05:23:24 2001 @@ -1,978 +1,1024 @@ - <reference id="ref.info"> - <title>Options PHP & informations</title> - <titleabbrev>Options et informations PHP</titleabbrev> - <refentry id="function.assert"> - <refnamediv> - <refname>assert</refname> - <refpurpose>Vérifie si une assertion est fausse</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>assert</function></funcdef> - <paramdef>string|bool <parameter>assertion</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>assert</function> va vérfier l'assertion - <parameter>assertion</parameter> et prendre la mesure appropriée - si le résultat est &false;. - </para> - <para> - Si <parameter>assertion</parameter> est donnée sous la forme - d'une chaîne, elle sera évaluée comme un code PHP - par la fonction <function>assert</function>. Les avantages de ce type - d'assertion sont d'être moins lourd si la vérification - d'assertion est désactivée, et le contenu des messages - lorsque l'assertion échoue. - </para> - <para> - Il est recommandé de n'utiliser les assertions que comme outil de - débuggage. Vous pouvez les utiliser pour les vérifications - d'usage : ces conditions doivent normalement être vraie, et indiquer - une erreur de programmation si ce n'est pas le cas. Vous pouvez aussi - vérifier la présence de certaines extensions ou - limitations du système. - </para> - <para> - Les assertions ne doivent pas être utilisées pour faire des - opérations de vérifications en production, comme par exemple - des vérfications de valeur d'arguments. En conditions normales, - votre code doit être en état de fonctionner si la - vérification d'assertion est désactivée. - </para> - <para> - Le comportement de <function>assert</function> peut être configuré - par <function>assert_options</function> ou par .ini-settings. - </para> - </refsect1> - </refentry> - <refentry id="function.assert-options"> - <refnamediv> - <refname>assert-options</refname> - <refpurpose>Fixe et lit différentes options d'assertions</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>mixed <function>assert_options</function></funcdef> - <paramdef>int <parameter>what</parameter></paramdef> - <paramdef>mixed - <parameter><optional>value</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - Avec <function>assert_options</function> vous pouvez modifier les diverses - options de la fonction <function>assert</function>, ou simplement - connaître la configuration actuelle. - </para> - <table> - <title>options d'assert</title> - <tgroup cols="4"> - <thead> - <row> - <entry>option</entry> - <entry>paramètre d'ini</entry> - <entry>valeur par défaut</entry> - <entry>description</entry> - </row> - </thead> - <tbody> - <row> - <entry>ASSERT_ACTIVE</entry> - <entry>assert.active</entry> - <entry>1</entry> - <entry>active l'évaluation de la fonction <function>assert</function></entry> - </row> - <row> - <entry>ASSERT_WARNING</entry> - <entry>assert.warning</entry> - <entry>1</entry> - <entry>génère une alerte PHP pour chaque assertion fausse</entry> - </row> - <row> - <entry>ASSERT_BAIL</entry> - <entry>assert.bail</entry> - <entry>0</entry> - <entry>terminer l'exécution en cas d'assertion fausse</entry> - </row> - <row> - <entry>ASSERT_QUIET_EVAL</entry> - <entry>assert.quiet_eval</entry> - <entry>0</entry> - <entry> - inactive le rapprot d'erreur durant l'évaluation d'une assertion - </entry> - </row> - <row> - <entry>ASSERT_CALLBACK</entry> - <entry>assert_callback</entry> - <entry>(&null;)</entry> - <entry>fonction utilisateur de traitement des assertions fausses</entry> - </row> - </tbody> - </tgroup> - </table> - <para> - <function>assert_options</function> retourne la valeur originale - de l'option, ou bien &false; en cas d'erreur. - </para> - </refsect1> - </refentry> - <refentry id="function.extension-loaded"> - <refnamediv> - <refname>extension_loaded</refname> - <refpurpose> - Détermine si une extension est chargée ou non. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>bool <function>extension_loaded</function></funcdef> +<reference id="ref.info"> + <title>Options PHP & informations</title> + <titleabbrev>Options et informations PHP</titleabbrev> + <refentry id="function.assert"> + <refnamediv> + <refname>assert</refname> + <refpurpose>Vérifie si une assertion est fausse</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>assert</function></funcdef> + <paramdef>string|boolean <parameter>assertion</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>assert</function> va vérifier l'assertion + <parameter>assertion</parameter> et prendre la mesure appropriée + si le résultat est <literal>FALSE</literal>. + </para> + <para> + Si <parameter>assertion</parameter> est donnée sous la forme + d'une chaîne, elle sera évaluée comme un code PHP + par la fonction <function>assert</function>. Les avantages de ce type + d'assertion sont d'être moins lourd si la vérification + d'assertion est désactivée, et le contenu des messages + lorsque l'assertion échoue. + </para> + <para> + Il est recommandé de n'utiliser les assertions que comme outil de + débuggage. Vous pouvez les utiliser pour les vérifications + d'usage : ces conditions doivent normalement être vraies, et indiquer + une erreur de programmation si ce n'est pas le cas. Vous pouvez aussi + vérifier la présence de certaines extensions ou + limitations du système. + </para> + <para> + Les assertions ne doivent pas être utilisées pour faire des + opérations de vérifications en production, comme par exemple + des vérifications de valeur d'argument. En conditions normales, + votre code doit être en état de fonctionner si la + vérification d'assertion est désactivée. + </para> + <para> + Le comportement de <function>assert</function> peut être configuré + par <function>assert_options</function> ou par .ini-settings. + </para> + </refsect1> + </refentry> + <refentry id="function.assert-options"> + <refnamediv> + <refname>assert-options</refname> + <refpurpose>Fixe et lit différentes options d'assertions</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>assert_options</function></funcdef> + <paramdef>int <parameter>what</parameter></paramdef> + <paramdef>mixed + <parameter><optional>value</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Avec <function>assert_options</function> vous pouvez modifier les diverses + options de la fonction <function>assert</function>, ou simplement + connaître la configuration actuelle. + </para> + <table> + <title>options d'assert</title> + <tgroup cols="4"> + <thead> + <row> + <entry>Option</entry> + <entry>Paramètre d'ini</entry> + <entry>Valeur par défaut</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>ASSERT_ACTIVE</entry> + <entry>assert.active</entry> + <entry>1</entry> + <entry>active l'évaluation de la fonction <function>assert</function></entry> + </row> + <row> + <entry>ASSERT_WARNING</entry> + <entry>assert.warning</entry> + <entry>1</entry> + <entry>génère une alerte PHP pour chaque assertion fausse</entry> + </row> + <row> + <entry>ASSERT_BAIL</entry> + <entry>assert.bail</entry> + <entry>0</entry> + <entry>termine l'exécution en cas d'assertion fausse</entry> + </row> + <row> + <entry>ASSERT_QUIET_EVAL</entry> + <entry>assert.quiet_eval</entry> + <entry>0</entry> + <entry> + inactive le rapport d'erreur durant l'évaluation d'une assertion + </entry> + </row> + <row> + <entry>ASSERT_CALLBACK</entry> + <entry>assert_callback</entry> + <entry>(null)</entry> + <entry>fonction utilisateur de traitement des assertions fausses</entry> + </row> + </tbody> + </tgroup> + </table> + <para> + <function>assert_options</function> retourne la valeur originale + de l'option, ou bien <literal>FALSE</literal> en cas d'erreur. + </para> + </refsect1> + </refentry> + <refentry id="function.extension-loaded"> + <refnamediv> + <refname>extension_loaded</refname> + <refpurpose> + Détermine si une extension est chargée ou non. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>extension_loaded</function></funcdef> <paramdef>string <parameter>name</parameter></paramdef> - </funcsynopsis> - <simpara> - <function>extension_loaded</function> retourne vraie si l'extension - <parameter>name</parameter> a été chargée. - Vous pouvez voir les différents noms des extensions, en - utilisant la fonction <function>phpinfo</function>. - </simpara> - <para> - Voir aussi <function>phpinfo</function>. - <note> - <para> - Cette fonction a été ajoutée dans 3.0.10. - </para> - </note> - </para> - </refsect1> - </refentry> -<refentry id="function.dl"> - <refnamediv> - <refname>dl</refname> - <refpurpose>Charge une extension PHP à la volée</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>dl</function></funcdef> - <paramdef>string <parameter>library</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Charge l'extension PHP <parameter>library</parameter> à la volée . - Voir aussi la directive de configuration - <link linkend="ini.extension-dir">extension_dir</link>. - </para> - </refsect1> - </refentry> - <refentry id="function.getenv"> - <refnamediv> - <refname>getenv</refname> - <refpurpose>Retourne la valeur de la variable d'environnement.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <simpara> + <function>extension_loaded</function> retourne <literal>TRUE</literal> si l'extension + <parameter>name</parameter> a été chargée. + Vous pouvez voir les différents noms des extensions, en + utilisant la fonction <function>phpinfo</function>. + </simpara> + <para> + Voir aussi + <function>phpinfo</function>. + <note> + <para> + Cette fonction a été ajoutée dans 3.0.10. + </para> + </note> + </para> + </refsect1> + </refentry> + <refentry id="function.dl"> + <refnamediv> + <refname>dl</refname> + <refpurpose>Charge une extension PHP à la volée</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>dl</function></funcdef> + <paramdef>string <parameter>library</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dl</function> charge l'extension PHP <parameter>library</parameter> + à la volée . Voir aussi la directive de configuration + <link linkend="ini.extension-dir">extension_dir</link>. + </para> + </refsect1> + </refentry> + <refentry id="function.getenv"> + <refnamediv> + <refname>getenv</refname> + <refpurpose>Retourne la valeur de la variable d'environnement.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>string <function>getenv</function></funcdef> <paramdef>string <parameter>varname</parameter></paramdef> - </funcsynopsis> - <para> - <function>getenv</function> retourne la valeur de la variable - d'environnement <parameter>varname</parameter>, - ou &false; en cas d'erreur. - <informalexample> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <function>getenv</function> retourne la valeur de la variable + d'environnement <parameter>varname</parameter>, + ou <literal>FALSE</literal> en cas d'erreur. + <informalexample> + <programlisting role="php"> <?php -$ip = getenv("REMOTE_ADDR"); // retourne l'adresse IP de l'utilisateur + $ip = getenv("REMOTE_ADDR"); // retourne l'adresse IP de l'utilisateur ?> - </programlisting> - </informalexample> - </para> - <para> - Vous pouvez voir une liste complète des variables d'environnement en - utilisant la fonction <function>phpinfo</function>. Vous pouvez trouvez - la signification de chacune d'entre elles en consultant le site concernant - <ulink url="&url.cgispecs;">CGI specification</ulink> (en anglais>, et - particulièment la page concernant les - <ulink url="&url.cgispec;">variables d'environnement.</ulink>. - </para> - </refsect1> - </refentry> - <refentry id="function.get-cfg-var"> - <refnamediv> - <refname>get_cfg_var</refname> - <refpurpose>Retourne la valeur d'une option de PHP</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </programlisting> + </informalexample> + </para> + <para> + Vous pouvez voir une liste complète des variables d'environnement en + utilisant la fonction <function>phpinfo</function>. Vous pouvez trouver + la signification de chacune d'entre elles en consultant le site concernant + <ulink url="&url.cgispecs;">CGI specification</ulink> (en anglais>, et + particulièment la page concernant les + <ulink url="&url.cgispec;">variables d'environnement.</ulink>. + </para> + <para> + Voir aussi + <function>putenv</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.get-cfg-var"> + <refnamediv> + <refname>get_cfg_var</refname> + <refpurpose>Retourne la valeur d'une option de PHP</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>string <function>get_cfg_var</function></funcdef> <paramdef>string <parameter>varname</parameter></paramdef> - </funcsynopsis> - <simpara> - <function>get_cfg_var</function> retourne la valeur courante de - l'option PHP <parameter>varname</parameter>, ou bien - &false; en cas d'erreur. - </simpara> - <simpara> - <function>get_cfg_var</function> ne retourne pas les options qui - ont été choisies lors de la compilation de PHP, ni - ne lit dans le fichier de configuration d'Apache. - </simpara> - <simpara> - Pour vérifier si le système utilise le - <link linkend="configuration.file">fichier de configuration</link>, - essayez de lire la valeur de cfg_file_path. Si cette valeur est - disponible, alors le fichier de configuration est utilisé. - </simpara> - </refsect1> - </refentry> - <refentry id="function.get-current-user"> - <refnamediv> - <refname>get_current_user</refname> - <refpurpose> - Retourne le nom du possesseur du script courant. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <simpara> + <function>get_cfg_var</function> retourne la valeur courante de + l'option PHP <parameter>varname</parameter>, ou bien + <literal>FALSE</literal> en cas d'erreur. + </simpara> + <simpara> + <function>get_cfg_var</function> ne retourne pas les options qui + ont été choisies lors de la compilation de PHP, ni + ne lit dans le fichier de configuration d'Apache. + </simpara> + <simpara> + Pour vérifier si le système utilise le + <link linkend="configuration.file">fichier de configuration</link>, + essayez de lire la valeur de cfg_file_path. Si cette valeur est + disponible, alors le fichier de configuration est utilisé. + </simpara> + </refsect1> + </refentry> + <refentry id="function.get-current-user"> + <refnamediv> + <refname>get_current_user</refname> + <refpurpose> + Retourne le nom du possesseur du script courant. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>string <function>get_current_user</function></funcdef> <paramdef>void</paramdef> - </funcsynopsis> - <simpara> - <function>get_current_user</function> retourne le nom du possesseur - du script courant. - </simpara> - <simpara> - Voir aussi <function>getmyuid</function>, <function>getmypid</function>, - <function>getmyinode</function>, et <function>getlastmod</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.get-magic-quotes-gpc"> - <refnamediv> - <refname>get_magic_quotes_gpc</refname> - <refpurpose> - Retourne le configuration actuelle de l'option magic_quotes_gpc. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <simpara> + <function>get_current_user</function> retourne le nom du possesseur + du script courant. + </simpara> + <simpara> + Voir aussi + <function>getmyuid</function>, + <function>getmypid</function>, + <function>getmyinode</function> et + <function>getlastmod</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.get-magic-quotes-gpc"> + <refnamediv> + <refname>get_magic_quotes_gpc</refname> + <refpurpose> + Retourne la configuration actuelle de l'option magic_quotes_gpc. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>long <function>get_magic_quotes_gpc</function></funcdef> <paramdef>void</paramdef> - </funcsynopsis> - <simpara> - <function>get_magic_quotes_gpc</function> retourne le configuration actuelle - de l'option <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> - (0 pour l'option désactivée, 1 pour l'option activée). - </simpara> - <simpara> - Voir aussi <function>get_magic_quotes_runtime</function>, - <function>set_magic_quotes_runtime</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.get-magic-quotes-runtime"> - <refnamediv> - <refname>get_magic_quotes_runtime</refname> - <refpurpose> - Retourne la configuration actuelle de l'option magic_quotes_runtime. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>long - <function>get_magic_quotes_runtime</function> - </funcdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>get_magic_quotes_gpc</function> retourne la configuration actuelle + de l'option <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> + (0 pour l'option désactivée, 1 pour l'option activée). + </simpara> + <simpara> + Voir aussi + <function>get_magic_quotes_runtime</function> et + <function>set_magic_quotes_runtime</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.get-magic-quotes-runtime"> + <refnamediv> + <refname>get_magic_quotes_runtime</refname> + <refpurpose> + Retourne la configuration actuelle de l'option magic_quotes_runtime. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>long <function>get_magic_quotes_runtime</function></funcdef> <paramdef>void</paramdef> - </funcsynopsis> - <simpara> - <function>get_magic_quotes_runtime</function> retourne la configuration - actuelle de l'option - <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>. - (0 pour option desactivée, 1 pour option sactivée). - </simpara> - <simpara> - Voir aussi <function>get_magic_quotes_gpc</function>, - <function>set_magic_quotes_runtime</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.getlastmod"> - <refnamediv> - <refname>getlastmod</refname> - <refpurpose> - Retourne la date de dernière modification de la page. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <simpara> + <function>get_magic_quotes_runtime</function> retourne la configuration + actuelle de l'option + <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>. + (0 pour option désactivée, 1 pour option activée). + </simpara> + <simpara> + Voir aussi + <function>get_magic_quotes_gpc</function> et + <function>set_magic_quotes_runtime</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.getlastmod"> + <refnamediv> + <refname>getlastmod</refname> + <refpurpose> + Retourne la date de dernière modification de la page. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>getlastmod</function></funcdef> <paramdef>void</paramdef> - </funcsynopsis> - <para> - <function>getlastmod</function> retourne la date de dernière - modification de la page. La valeur retournée est - un marqueur de temps UNIX, utilisable comme paramètre avec - la fonction <function>date</function>. - <function>getlastmod</function> retourne &false; en - cas d'erreur. - <example> - <title>Exemple avec <function>getlastmod</function></title> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <function>getlastmod</function> retourne la date de dernière + modification de la page. La valeur retournée est + un marqueur de temps UNIX, utilisable comme paramètre avec + la fonction <function>date</function>. + <function>getlastmod</function> retourne <literal>FALSE</literal> en + cas d'erreur. + <example> + <title>Exemple avec <function>getlastmod</function></title> + <programlisting role="php"> <?php // affiche 'Dernière modification: March 04 1998 20:43:59.' -echo "Dernière modification: ".date( "F d Y H:i:s.", getlastmod() ); + echo "Dernière modification: ".date( "F d Y H:i:s.", getlastmod() ); ?> - </programlisting> - </example> - </para> - <para> - Voir aussi <function>date</function>, <function>getmyuid</function>, - <function>get_current_user</function>, <function>getmyinode</function> et - <function>getmypid</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.getmyinode"> - <refnamediv> - <refname>getmyinode</refname> - <refpurpose>Retourne l'inode du script.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>date</function>, + <function>getmyuid</function>, + <function>get_current_user</function>, + <function>getmyinode</function> et + <function>getmypid</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.getmyinode"> + <refnamediv> + <refname>getmyinode</refname> + <refpurpose>Retourne l'inode du script.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>getmyinode</function></funcdef> <paramdef>void</paramdef> - </funcsynopsis> - <para> - <function>getmyinode</function> retourne l'inode du script, - ou &false; en cas d'erreur. - </para> - <para> - Voir aussi <function>getmyuid</function>, - <function>get_current_user</function>, - <function>getmypid</function>, et - <function>getlastmod</function>. - </para> - <note> - <simpara> + </funcprototype> + </funcsynopsis> + <para> + <function>getmyinode</function> retourne l'inode du script, + ou <literal>FALSE</literal> en cas d'erreur. + </para> + <para> + Voir aussi + <function>getmyuid</function>, + <function>get_current_user</function>, + <function>getmypid</function> et + <function>getlastmod</function>. + </para> + <note> + <simpara> <function>getmyinode</function> est inopérante sur les systèmes Windows. - </simpara> - </note> - </refsect1> - </refentry> - <refentry id="function.getmypid"> - <refnamediv> - <refname>getmypid</refname> - <refpurpose>Retourne le numéro de processus courant.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </simpara> + </note> + </refsect1> + </refentry> + <refentry id="function.getmypid"> + <refnamediv> + <refname>getmypid</refname> + <refpurpose>Retourne le numéro de processus courant.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>getmypid</function></funcdef> <paramdef>void</paramdef> - </funcsynopsis> - <para> - <function>getmypid</function> retourne le numéro de processus - actuel ou &false; en cas d'erreur. - </para> - <para> - Il est à noter que si vous utilisez PHP comme module Apache, - il n'est pas guarantit que deux invocations distinctes de la fonction - donnent des résultats différents. - </para> - <warning> - <para> - Les identifiants de processus ne sont pas uniques, - et forment une source d'entropie faible. Nous recommandons - de ne pas utiliser les pid pour assurer la sécurité d'un - système. - </para> - </warning> - <para> - Voir aussi <function>getmyuid</function>, <function>get_current_user</function>, - <function>getmyinode</function>, et <function>getlastmod</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.getmyuid"> - <refnamediv> - <refname>getmyuid</refname> - <refpurpose>Retourne l'UID du propriétaire du script actuel.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <para> + <function>getmypid</function> retourne le numéro de processus + actuel ou <literal>FALSE</literal> en cas d'erreur. + </para> + <para> + Il est à noter que si vous utilisez PHP comme module Apache, + il n'est pas garanti que deux invocations distinctes de la fonction + donnent des résultats différents. + </para> + <warning> + <para> + Les identifiants de processus ne sont pas uniques, + et forment une source d'entropie faible. Nous recommandons + de ne pas utiliser les pid pour assurer la sécurité d'un + système. + </para> + </warning> + <para> + Voir aussi + <function>getmyuid</function>, + <function>get_current_user</function>, + <function>getmyinode</function> et + <function>getlastmod</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.getmyuid"> + <refnamediv> + <refname>getmyuid</refname> + <refpurpose>Retourne l'UID du propriétaire du script actuel.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>getmyuid</function></funcdef> <paramdef>void</paramdef> - </funcsynopsis> - <simpara> - <function>getmyuid</function> retourne l'UID du propriétaire - du script actuel ou &false; en cas d'erreur. - </simpara> - <simpara> - Voir aussi <function>getmypid</function>, <function>get_current_user</function>, - <function>getmyinode</function>, et <function>getlastmod</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.getrusage"> - <refnamediv> - <refname>getrusage</refname> - <refpurpose>Retourne le niveau d'utilisation des ressources.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <simpara> + <function>getmyuid</function> retourne l'UID du propriétaire + du script actuel ou <literal>FALSE</literal> en cas d'erreur. + </simpara> + <simpara> + Voir aussi + <function>getmypid</function>, + <function>get_current_user</function>, + <function>getmyinode</function> et + <function>getlastmod</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.getrusage"> + <refnamediv> + <refname>getrusage</refname> + <refpurpose>Retourne le niveau d'utilisation des ressources.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>array <function>getrusage</function></funcdef> <paramdef>int <parameter><optional>who</optional></parameter> </paramdef> - </funcsynopsis> - <para> - <function>getrusage</function> est une interface à - la fonction system getrusage(2). - Elle retourne un tableau associatif contenant les informations - renvoyées par cet appel système. Si "who is 1", - getrusage sera appelé avec le paramètre RUSAGE_CHILDREN. - </para> - <para> - Toutes les valeurs du tableau sont accessibles en utilisant leur nom dans le - tableau. - <example> - <title>Exemple getrusage</title> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <function>getrusage</function> est une interface à + la fonction system getrusage(2). + Elle retourne un tableau associatif contenant les informations + renvoyées par cet appel système. Si "who is 1", + getrusage sera appelé avec le paramètre RUSAGE_CHILDREN. + </para> + <para> + Toutes les valeurs du tableau sont accessibles en utilisant leur nom dans le + tableau. + <example> + <title>Exemple getrusage</title> + <programlisting role="php"> <?php -$dat = getrusage(); -echo $dat["ru_nswap"]; # Taille de la mémoire swap -echo $dat["ru_majflt"]; # Nombre de page mémoires utilisées -echo $dat["ru_utime.tv_sec"]; # temps utilisateur (en secondes) -echo $dat["ru_utime.tv_usec"]; # temps utilisateur (en microsecondes) + $dat = getrusage(); + echo $dat["ru_nswap"]; # Taille de la mémoire swap + echo $dat["ru_majflt"]; # Nombre de page mémoires utilisées + echo $dat["ru_utime.tv_sec"]; # Temps utilisateur (en secondes) + echo $dat["ru_utime.tv_usec"]; # Temps utilisateur (en microsecondes) ?> - </programlisting> - </example> - Consultez le manuel "man" pour plus de détails. - </para> - </refsect1> - </refentry> - <refentry id="function.ini-alter"> - <refnamediv> - <refname>ini_alter</refname> - <refpurpose>Change la valeur d'une option de configuration</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>ini_alter</function></funcdef> - <paramdef>string <parameter>varname</parameter></paramdef> - <paramdef>string <parameter>newvalue</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ini_alter</function> change la valeur de l'option de - configuration <parameter>varname</parameter> - et lui donne la valeur de <parameter>newvalue</parameter>. - <function>ini_alter</function> retourne &false; - en cas d'échec, et la valeur précédente en - cas de succès. - </para> - <note> - <para> - <function>ini_alter</function> est un alias de <function>ini_set</function> - </para> - </note> - <para> - Voir aussi <function>ini_get</function>, - <function>ini_restore</function> et - <function>ini_set</function> - </para> - </refsect1> - </refentry> - <refentry id="function.ini-get"> - <refnamediv> - <refname>ini_get</refname> - <refpurpose>Lit la valeur d'une option de configuration.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>ini_get</function></funcdef> - <paramdef>string <parameter>varname</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ini_get</function> retourne la valeur de l'option de - configuration <parameter>varname</parameter> en cas de succès, et - &false;. - </para> - <para> - Voir aussi <function>ini_alter</function>, - <function>ini_restore</function> et - <function>ini_set</function> - </para> - </refsect1> - </refentry> - <refentry id="function.ini-restore"> - <refnamediv> - <refname>ini_restore</refname> - <refpurpose>Restaure la valeur de l'option de configuration</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>ini_restore</function></funcdef> - <paramdef>string <parameter>varname</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ini_restore</function> restaure la valeur originale de - l'option de configuration <parameter>varname</parameter>. - </para> - <para> - Voir aussi <function>ini_alter</function>, - <function>ini_get</function>, - <function>ini_set</function> - </para> - </refsect1> - </refentry> -<refentry id="function.ini-set"> - <refnamediv> - <refname>ini_set</refname> - <refpurpose>Change la valeur d'une option de configuration</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>ini_set</function></funcdef> - <paramdef>string <parameter>varname</parameter></paramdef> - <paramdef>string <parameter>newvalue</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ini_set</function> change la valeur de l'option de - configuration <parameter>varname</parameter> - et lui donne la valeur de <parameter>newvalue</parameter>. - <function>ini_set</function> retourne &false; - en cas d'échec, et la valeur - précédente en cas de succès. - </para> - <para> - Toutes les options disponibles ne peuvent pas être toutes - modifiées avec <function>ini_set</function>. Ci-dessous, vous - trouverez une liste de toutes les options (disponibles - en PHP 4.0.5-dev), et si elles peuvent être modifiées. - <table> - <title>Options de configuration</title> - <tgroup cols="3"> - <thead> - <row> - <entry>Nom</entry> - <entry>Par défaut</entry> - <entry>Modifiable</entry> - </row> - </thead> - <tbody> - <row> - <entry>define_syslog_variables</entry> - <entry>"0"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>highlight.bg</entry> - <entry>HL_BG_COLOR</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>highlight.comment</entry> - <entry>HL_COMMENT_COLOR</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>highlight.default</entry> - <entry>HL_DEFAULT_COLOR</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>highlight.html</entry> - <entry>HL_HTML_COLOR</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>highlight.keyword</entry> - <entry>HL_KEYWORD_COLOR</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>highlight.string</entry> - <entry>HL_STRING_COLOR</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>allow_call_time_pass_reference</entry> - <entry>"1"</entry> - <entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry> - </row> - <row> - <entry>asp_tags</entry> - <entry>"0"</entry> - <entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry> - </row> - <row> - <entry>display_errors</entry> - <entry>"1"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>display_startup_errors</entry> - <entry>"0"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>enable_dl</entry> - <entry>"1"</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>error_append_string</entry> - <entry>&null;</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>error_prepend_string</entry> - <entry>&null;</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>expose_php</entry> - <entry>"1"</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>html_errors</entry> - <entry>"1"</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>ignore_user_abort</entry> - <entry>"0"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>implicit_flush</entry> - <entry>"0"</entry> - <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>log_errors</entry> - <entry>"0"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>magic_quotes_gpc</entry> - <entry>"1"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>magic_quotes_runtime</entry> - <entry>"0"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>magic_quotes_sybase</entry> - <entry>"0"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>output_buffering</entry> - <entry>"0"</entry> - <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>output_handler</entry> - <entry>&null;</entry> - <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>register_argc_argv</entry> - <entry>"1"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>register_globals</entry> - <entry>"1"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>safe_mode</entry> - <entry>"0"</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>short_open_tag</entry> - <entry>"1"</entry> - <entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry> - </row> - <row> - <entry>sql.safe_mode</entry> - <entry>"0"</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>track_errors</entry> - <entry>"0"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>y2k_compliance</entry> - <entry>"0"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>arg_separator</entry> - <entry>"&"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>auto_append_file</entry> - <entry>&null;</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>auto_prepend_file</entry> - <entry>&null;</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>doc_root</entry> - <entry>&null;</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>default_charset</entry> - <entry>SAPI_DEFAULT_CHARSET</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>default_mimetype</entry> - <entry>SAPI_DEFAULT_MIMETYPE</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>error_log</entry> - <entry>&null;</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>extension_dir</entry> - <entry>PHP_EXTENSION_DIR</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>gpc_order</entry> - <entry>"GPC"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>include_path</entry> - <entry>PHP_INCLUDE_PATH</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>max_execution_time</entry> - <entry>"30"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>open_basedir</entry> - <entry>&null;</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>safe_mode_exec_dir</entry> - <entry>"1"</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>upload_max_filesize</entry> - <entry>"2M"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>file_uploads</entry> - <entry>"1"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>post_max_size</entry> - <entry>"8M"</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>upload_tmp_dir</entry> - <entry>&null;</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>user_dir</entry> - <entry>&null;</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>variables_order</entry> - <entry>&null;</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>SMTP</entry> - <entry>"localhost"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>browscap</entry> - <entry>&null;</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>error_reporting</entry> - <entry>&null;</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>memory_limit</entry> - <entry>"8M"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>precision</entry> - <entry>"14"</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>sendmail_from</entry> - <entry>&null;</entry> - <entry>PHP_INI_ALL</entry> - </row> - <row> - <entry>sendmail_path</entry> - <entry>DEFAULT_SENDMAIL_PATH</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>disable_functions</entry> - <entry>""</entry> - <entry>PHP_INI_SYSTEM</entry> - </row> - <row> - <entry>allow_url_fopen</entry> - <entry>"1"</entry> - <entry>PHP_INI_ALL</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - <para> - <table> - <title>Définition des constantes PHP_INI_*</title> - <tgroup cols="3"> - <thead> - <row> - <entry>Constante</entry> - <entry>Valeur</entry> - <entry>Signification</entry> - </row> - </thead> - <tbody> - <row> - <entry>PHP_INI_USER</entry> - <entry>1</entry> - <entry>La valeur peut être modifiée dans un script</entry> - </row> - <row> - <entry>PHP_INI_PERDIR</entry> - <entry>2</entry> - <entry>La valeur peut être modifiée dans le fichier <filename>.htaccess</filename></entry> - </row> - <row> - <entry>PHP_INI_SYSTEM</entry> - <entry>4</entry> - <entry>La valeur peut être modifiée dans <filename>php.ini</filename> ou - <filename>httpd.conf</filename></entry> - </row> - <row> - <entry>PHP_INI_ALL</entry> - <entry>7</entry> - <entry>La valeur peut être modifiée n'importe où</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - <para> - Voir aussi - <function>ini_alter</function>, - <function>ini_get</function>, - <function>ini_restore</function> - </para> - </refsect1> - </refentry> - <refentry id="function.phpcredits"> - <refnamediv> - <refname>phpcredits</refname> - <refpurpose>Imprime les crédits de PHP.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>void <function>phpcredits</function></funcdef> - <paramdef>int <parameter>flag</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>phpcredits</function> affiche la liste des développeurs PHP, - des modules, etc... Elle génère le code HTML - approprié pour insérer les informations dans une page. - Le paramètre <parameter>flag</parameter> indique les informations - qui doivent être affichées. Par exemple, pour afficher - les crédits généraux, vous pouvez utiliser le - code suivant : - <informalexample> - <programlisting role="php"> + </programlisting> + </example> + Consultez le manuel "man" pour plus de détails. + </para> + </refsect1> + </refentry> + <refentry id="function.ini-alter"> + <refnamediv> + <refname>ini_alter</refname> + <refpurpose>Change la valeur d'une option de configuration</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ini_alter</function></funcdef> + <paramdef>string <parameter>varname</parameter></paramdef> + <paramdef>string <parameter>newvalue</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ini_alter</function> change la valeur de l'option de + configuration <parameter>varname</parameter> + et lui donne la valeur de <parameter>newvalue</parameter>. + <function>ini_alter</function> retourne <literal>FALSE</literal> + en cas d'échec, et la valeur précédente en + cas de succès. + </para> + <note> + <para> + <function>ini_alter</function> est un alias de <function>ini_set</function> + </para> + </note> + <para> + Voir aussi + <function>ini_get</function>, + <function>ini_restore</function> et + <function>ini_set</function> + </para> + </refsect1> + </refentry> + <refentry id="function.ini-get"> + <refnamediv> + <refname>ini_get</refname> + <refpurpose>Lit la valeur d'une option de configuration.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ini_get</function></funcdef> + <paramdef>string <parameter>varname</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ini_get</function> retourne la valeur de l'option de + configuration <parameter>varname</parameter> en cas de succès, et + <literal>FALSE</literal>. + </para> + <para> + Voir aussi + <function>ini_alter</function>, + <function>ini_restore</function> et + <function>ini_set</function> + </para> + </refsect1> + </refentry> + <refentry id="function.ini-restore"> + <refnamediv> + <refname>ini_restore</refname> + <refpurpose>Restaure la valeur de l'option de configuration</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ini_restore</function></funcdef> + <paramdef>string <parameter>varname</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ini_restore</function> restaure la valeur originale de + l'option de configuration <parameter>varname</parameter>. + </para> + <para> + Voir aussi + <function>ini_alter</function>, + <function>ini_get</function> et + <function>ini_set</function> + </para> + </refsect1> + </refentry> + <refentry id="function.ini-set"> + <refnamediv> + <refname>ini_set</refname> + <refpurpose>Change la valeur d'une option de configuration</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ini_set</function></funcdef> + <paramdef>string <parameter>varname</parameter></paramdef> + <paramdef>string <parameter>newvalue</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ini_set</function> change la valeur de l'option de + configuration <parameter>varname</parameter> + et lui donne la valeur de <parameter>newvalue</parameter>. + <function>ini_set</function> retourne <literal>FALSE</literal> + en cas d'échec, et la valeur + précédente en cas de succès. + La valeur de l'option de configuration sera modifiée durant toute + l'exécution du script et pour ce script spécifiquement. Elle reprendra + sa valeur par défaut dès la fin du script. + </para> + <para> + Toutes les options disponibles ne peuvent pas être toutes + modifiées avec <function>ini_set</function>. Ci-dessous, vous + trouverez une liste de toutes les options (disponibles + en PHP 4.0.5-dev), et si elles peuvent être modifiées. + <table> + <title>Options de configuration</title> + <tgroup cols="3"> + <thead> + <row> + <entry>Nom</entry> + <entry>Par défaut</entry> + <entry>Modifiable</entry> + </row> + </thead> + <tbody> + <row> + <entry>define_syslog_variables</entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>highlight.bg</entry> + <entry>HL_BG_COLOR</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>highlight.comment</entry> + <entry>HL_COMMENT_COLOR</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>highlight.default</entry> + <entry>HL_DEFAULT_COLOR</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>highlight.html</entry> + <entry>HL_HTML_COLOR</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>highlight.keyword</entry> + <entry>HL_KEYWORD_COLOR</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>highlight.string</entry> + <entry>HL_STRING_COLOR</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>allow_call_time_pass_reference</entry> + <entry>"1"</entry> + <entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry> + </row> + <row> + <entry>asp_tags</entry> + <entry>"0"</entry> + <entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry> + </row> + <row> + <entry>display_errors</entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>display_startup_errors</entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>enable_dl</entry> + <entry>"1"</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>error_append_string</entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>error_prepend_string</entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>expose_php</entry> + <entry>"1"</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>html_errors</entry> + <entry>"1"</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>ignore_user_abort</entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>implicit_flush</entry> + <entry>"0"</entry> + <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>log_errors</entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>magic_quotes_gpc</entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>magic_quotes_runtime</entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>magic_quotes_sybase</entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>output_buffering</entry> + <entry>"0"</entry> + <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>output_handler</entry> + <entry>NULL</entry> + <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>register_argc_argv</entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>register_globals</entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>safe_mode</entry> + <entry>"0"</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>short_open_tag</entry> + <entry>"1"</entry> + <entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry> + </row> + <row> + <entry>sql.safe_mode</entry> + <entry>"0"</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>track_errors</entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>y2k_compliance</entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>arg_separator</entry> + <entry>"&"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>auto_append_file</entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>auto_prepend_file</entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>doc_root</entry> + <entry>NULL</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>default_charset</entry> + <entry>SAPI_DEFAULT_CHARSET</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>default_mimetype</entry> + <entry>SAPI_DEFAULT_MIMETYPE</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>error_log</entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>extension_dir</entry> + <entry>PHP_EXTENSION_DIR</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>gpc_order</entry> + <entry>"GPC"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>include_path</entry> + <entry>PHP_INCLUDE_PATH</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>max_execution_time</entry> + <entry>"30"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>open_basedir</entry> + <entry>NULL</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>safe_mode_exec_dir</entry> + <entry>"1"</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>upload_max_filesize</entry> + <entry>"2M"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>file_uploads</entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>post_max_size</entry> + <entry>"8M"</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>upload_tmp_dir</entry> + <entry>NULL</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>user_dir</entry> + <entry>NULL</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>variables_order</entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>SMTP</entry> + <entry>"localhost"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>browscap</entry> + <entry>NULL</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>error_reporting</entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>memory_limit</entry> + <entry>"8M"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>precision</entry> + <entry>"14"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>sendmail_from</entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>sendmail_path</entry> + <entry>DEFAULT_SENDMAIL_PATH</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>disable_functions</entry> + <entry>""</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>allow_url_fopen</entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + <table> + <title>Définition des constantes PHP_INI_*</title> + <tgroup cols="3"> + <thead> + <row> + <entry>Constante</entry> + <entry>Valeur</entry> + <entry>Signification</entry> + </row> + </thead> + <tbody> + <row> + <entry>PHP_INI_USER</entry> + <entry>1</entry> + <entry>La valeur peut être modifiée dans un script</entry> + </row> + <row> + <entry>PHP_INI_PERDIR</entry> + <entry>2</entry> + <entry>La valeur peut être modifiée dans le fichier <filename>.htaccess</filename></entry> + </row> + <row> + <entry>PHP_INI_SYSTEM</entry> + <entry>4</entry> + <entry>La valeur peut être modifiée dans <filename>php.ini</filename> ou + <filename>httpd.conf</filename></entry> + </row> + <row> + <entry>PHP_INI_ALL</entry> + <entry>7</entry> + <entry>La valeur peut être modifiée n'importe où</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + Voir aussi + <function>ini_alter</function>, + <function>ini_get</function> et + <function>ini_restore</function> + </para> + </refsect1> + </refentry> + <refentry id="function.phpcredits"> + <refnamediv> + <refname>phpcredits</refname> + <refpurpose>Imprime les crédits de PHP.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>phpcredits</function></funcdef> + <paramdef>int <parameter>flag</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>phpcredits</function> affiche la liste des développeurs PHP, + des modules, etc... Elle génère le code HTML + approprié pour insérer les informations dans une page. + Le paramètre <parameter>flag</parameter> indique les informations + qui doivent être affichées. Par exemple, pour afficher + les crédits généraux, vous pouvez utiliser le + code suivant : + <informalexample> + <programlisting role="php"> <?php -phpcredits(CREDITS_GENERAL); + phpcredits(CREDITS_GENERAL); ?> - </programlisting> - </informalexample> - Et pour afficher la liste des développeurs et du groupe - de documentation dans une page séparée, vous - utiliserez - <informalexample> - <programlisting role="php"> + </programlisting> + </informalexample> + Et pour afficher la liste des développeurs et du groupe + de documentation dans une page séparée, vous + utiliserez + <informalexample> + <programlisting role="php"> <?php phpcredits(CREDITS_GROUP + CREDITS_DOCS + CREDITS_FULLPAGE); ?> - </programlisting> - </informalexample> - Si vous vous sentez l'envie de placer tous les crédits dans votre page, - vous pouvez utiliser ceci : - <informalexample> - <programlisting role="php"> + </programlisting> + </informalexample> + Si vous vous sentez l'envie de placer tous les crédits dans votre page, + vous pouvez utiliser ceci : + <informalexample> + <programlisting role="php"> <html> <head> <title>Ma page de crédits</title> @@ -985,196 +1031,204 @@ ?> </body> </html> - </programlisting> - </informalexample> - </para> - <para> - </para> - <para> + </programlisting> + </informalexample> + </para> + <para> + </para> + <para> <table> - <title> - Paramètre prédéfinis de <function>phpcredits</function> - </title> - <tgroup cols="2"> - <thead> - <row> - <entry>Nom</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>CREDITS_ALL</entry> - <entry> - Tous les crédits, équivalent à : - CREDITS_DOCS + CREDITS_GENERAL + CREDITS_GROUP + CREDITS_MODULES + - CREDITS_FULLPAGE. La fonction génère - alors une page HTML complète. - </entry> - </row> - <row> - <entry>CREDITS_DOCS</entry> - <entry>Les crédits du groupe de documentation</entry> - </row> - <row> - <entry>CREDITS_FULLPAGE</entry> - <entry> - En général, ce paramètre est utilisé avec d'autres - constantes. Il indique que la page ainsi générée doit - être une page HTML complète, avec toutes les balises - nécessaires. - </entry> - </row> - <row> - <entry>CREDITS_GENERAL</entry> - <entry> - Crédits Généraux : conception et design du langage, - auteurs de PHP 4.0, module SAPI. - </entry> - </row> - <row> - <entry>CREDITS_GROUP</entry> - <entry>Une liste des développeurs principaux</entry> - </row> - <row> - <entry>CREDITS_MODULES</entry> - <entry>Une liste des extensions de PHP, et leurs auteurs</entry> - </row> - <row> - <entry>CREDITS_SAPI</entry> - <entry>Cette constante est définie, mais elle n'est toujours pas - utilisée sous PHP 4.0.1pl2. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - <para> - Voir aussi <function>phpinfo</function>, - <function>phpversion</function>, - <function>php_logo_guid</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.phpinfo"> - <refnamediv> - <refname>phpinfo</refname> - <refpurpose>Affiche de nombreuses informations sur le PHP.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>phpinfo</function></funcdef> - <paramdef>int <parameter><optional>what</optional></parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Affiche de nombreuses informations sur le PHP, concernant sa - configuration courante : options de compilation, extensions, - version, informations sur le serveur, et environnement (lorsque - compilé comme module), environnement PHP, chemins, utilisateur, - entêtes HTTP, et licence GNU Public License. - </para> - <para> - Les affichages peuvent être personnalisés en passant une - ou plusieurs valeurs parmis les suivantes, comme paramètre - optionnel <parameter>what</parameter> : - <itemizedlist> - <listitem><simpara>INFO_GENERAL</simpara></listitem> - <listitem><simpara>INFO_CREDITS</simpara></listitem> - <listitem><simpara>INFO_CONFIGURATION</simpara></listitem> - <listitem><simpara>INFO_MODULES</simpara></listitem> - <listitem><simpara>INFO_ENVIRONMENT</simpara></listitem> - <listitem><simpara>INFO_VARIABLES</simpara></listitem> - <listitem><simpara>INFO_LICENSE</simpara></listitem> - <listitem><simpara>INFO_ALL</simpara></listitem> - </itemizedlist> - </para> - <para> - Voir aussi <function>phpversion</function>, - <function>phpcredits</function> et <function>php_logo_guid</function> - </para> - </refsect1> - </refentry> - <refentry id="function.phpversion"> - <refnamediv> - <refname>phpversion</refname> - <refpurpose> - Retourne le numéro de la version courante de PHP. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + <title> + Paramètre prédéfinis de <function>phpcredits</function> + </title> + <tgroup cols="2"> + <thead> + <row> + <entry>Nom</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>CREDITS_ALL</entry> + <entry> + Tous les crédits, équivalent à : + CREDITS_DOCS + CREDITS_GENERAL + CREDITS_GROUP + CREDITS_MODULES + + CREDITS_FULLPAGE. La fonction génère + alors une page HTML complète. + </entry> + </row> + <row> + <entry>CREDITS_DOCS</entry> + <entry>Les crédits du groupe de documentation</entry> + </row> + <row> + <entry>CREDITS_FULLPAGE</entry> + <entry> + En général, ce paramètre est utilisé avec d'autres + constantes. Il indique que la page ainsi générée doit + être une page HTML complète, avec toutes les balises + nécessaires. + </entry> + </row> + <row> + <entry>CREDITS_GENERAL</entry> + <entry> + Crédits Généraux : conception et design du langage, + auteurs de PHP 4.0, module SAPI. + </entry> + </row> + <row> + <entry>CREDITS_GROUP</entry> + <entry>Une liste des développeurs principaux</entry> + </row> + <row> + <entry>CREDITS_MODULES</entry> + <entry>Une liste des extensions de PHP, et leurs auteurs</entry> + </row> + <row> + <entry>CREDITS_SAPI</entry> + <entry>Cette constante est définie, mais elle n'est toujours pas + utilisée sous PHP 4.0.1pl2. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + Voir aussi + <function>phpinfo</function>, + <function>phpversion</function> et + <function>php_logo_guid</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.phpinfo"> + <refnamediv> + <refname>phpinfo</refname> + <refpurpose>Affiche de nombreuses informations sur le PHP.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>phpinfo</function></funcdef> + <paramdef>int <parameter><optional>what</optional></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>phpinfo</function> affiche de nombreuses informations sur le PHP, concernant sa + configuration courante : options de compilation, extensions, + version, informations sur le serveur, et environnement (lorsque + compilé comme module), environnement PHP, chemins, utilisateur, + en-têtes HTTP, et licence GNU Public License. + </para> + <para> + Les affichages peuvent être personnalisés en passant une + ou plusieurs valeurs parmi les suivantes, comme paramètre + optionnel <parameter>what</parameter> : + <itemizedlist> + <listitem><simpara>INFO_GENERAL</simpara></listitem> + <listitem><simpara>INFO_CREDITS</simpara></listitem> + <listitem><simpara>INFO_CONFIGURATION</simpara></listitem> + <listitem><simpara>INFO_MODULES</simpara></listitem> + <listitem><simpara>INFO_ENVIRONMENT</simpara></listitem> + <listitem><simpara>INFO_VARIABLES</simpara></listitem> + <listitem><simpara>INFO_LICENSE</simpara></listitem> + <listitem><simpara>INFO_ALL</simpara></listitem> + </itemizedlist> + </para> + <para> + Voir aussi + <function>phpversion</function>, + <function>phpcredits</function> et + <function>php_logo_guid</function> + </para> + </refsect1> + </refentry> + <refentry id="function.phpversion"> + <refnamediv> + <refname>phpversion</refname> + <refpurpose> + Retourne le numéro de la version courante de PHP. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>string <function>phpversion</function></funcdef> <paramdef>void</paramdef> - </funcsynopsis> - <para> - <function>phpversion</function> retourne le numéro de - la version courante de PHP. - <example> - <title>example de la fonction phpversion()</title> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <function>phpversion</function> retourne le numéro de + la version courante de PHP. + <example> + <title>Exemple avec <function>phpversion</function></title> + <programlisting role="php"> <?php // affiche le numéro de version courante du PHP. -echo "PHP Version: ".phpversion(); + echo "PHP Version: ".phpversion(); ?> - </programlisting> - </example> - </para> - <para> - Voir aussi <function>phpinfo</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.php-logo-guid"> - <refnamediv> - <refname>php_logo_guid</refname> - <refpurpose>Retourne le logo</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>phpinfo</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.php-logo-guid"> + <refnamediv> + <refname>php_logo_guid</refname> + <refpurpose>Retourne le logo</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>string <function>php_logo_guid</function></funcdef> <paramdef>void</paramdef> - </funcsynopsis> - <para> - <note> - <para> - Cette fonctionnalité a été ajoutée dans - PHP 4 Beta 4. - </para> - </note> - </para> - </refsect1> - </refentry> - <refentry id="function.php-sapi-name"> - <refnamediv> - <refname>php_sapi_name</refname> - <refpurpose> - Retourne le type d'interface utilisée entre le serveur web et PHP - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>php_sapi_name</function></funcdef> - <paramdef>void</paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>php_sapi_name</function> retourne une chaîne en minuscule - qui décrit le type d'interface utilisé en le serveur web et PHP - (Server API, SAPI). En CGI PHP, cette chaîne est "cgi", en - mod_php pour Apache, cette chaîne est "apache", etc... - </simpara> - <para> - <example> - <title>Exemple <function>php_sapi_name</function></title> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <note> + <para> + Cette fonctionnalité a été ajoutée dans + PHP 4 Beta 4. + </para> + </note> + </para> + </refsect1> + </refentry> + <refentry id="function.php-sapi-name"> + <refnamediv> + <refname>php_sapi_name</refname> + <refpurpose> + Retourne le type d'interface utilisé entre le serveur web et PHP + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>php_sapi_name</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>php_sapi_name</function> retourne une chaîne en minuscule + qui décrit le type d'interface utilisé en le serveur web et PHP + (Server API, SAPI). En CGI PHP, cette chaîne est "CGI", en + mod_php pour Apache, cette chaîne est "apache", etc... + </simpara> + <para> + <example> + <title>Exemple <function>php_sapi_name</function></title> + <programlisting role="php"> <?php $inter_type = php_sapi_name(); if ($inter_type == "cgi") @@ -1182,323 +1236,413 @@ else print "Vous n'utilisez pas CGI PHP\n"; ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> -<refentry id="function.php-uname"> - <refnamediv> - <refname>php_uname</refname> - <refpurpose> - Retourne les informations sur le système d'exploitation - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>php_uname</function></funcdef> - <paramdef>void</paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>php_uname</function> retourne les informations sur le système - d'exploitation sur lequel tourne PHP. - </simpara> - <para> - <example> - <title>Exemple <function>php_uname</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.php-uname"> + <refnamediv> + <refname>php_uname</refname> + <refpurpose> + Retourne les informations sur le système d'exploitation + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>php_uname</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>php_uname</function> retourne les informations sur le système + d'exploitation sur lequel tourne PHP. + </simpara> + <para> + <example> + <title>Exemple <function>php_uname</function></title> + <programlisting role="php"> <?php if (substr(php_uname(), 0, 7) == "Windows") { die("Désolé, ce script ne fonctionne pas sous Windows.\n"); } ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.putenv"> - <refnamediv> - <refname>putenv</refname> - <refpurpose>Fixe la valeur d'une variable d'environnement.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.putenv"> + <refnamediv> + <refname>putenv</refname> + <refpurpose>Fixe la valeur d'une variable d'environnement.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>void <function>putenv</function></funcdef> <paramdef>string <parameter>setting</parameter></paramdef> - </funcsynopsis> - <para> - Fixe la valeur d'une variable d'environnement. - </para> - <para> - <example> - <title>Fixer la valeur d'une variable d'environnement</title> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <function>putenv</function> fixe la valeur d'une variable d'environnement. + Cette valeur n'existera que durant la vie du script courant, et l'environnement + initial sera restauré lorsque le script sera terminé. + </para> + <para> + Modifier la valeur de certaines variables système peut être un trou + de sécurité considérable. La directive de configuration + <literal>safe_mode_allowed_env_vars</literal> contient une liste de + préfixes, séparés par des virgules. Lorsque le Safe Mode est actif, + l'utilisateur ne peut que modifier les variables qui dont le nom + commence par les préfixes fournis par cette directive. + Par défaut, les utilisateurs ne peuvent modifier que les variables qui + commencent par <literal>PHP_</literal> + (i.e. <literal>PHP_FOO=BAR</literal>). Note: si cette directive est vide, + PHP autorisera la modification de TOUTES les variables d'environnement!. + </para> + <para> + La directive de configuration <literal>safe_mode_protected_env_vars</literal> + contient une liste de variables d'environnement, séparées par des virgules. + Les utilisateurs ne pourront pas modifier ces variables avec la fonction + <function>putenv</function>. Ces variables seront protégées même si + <literal>safe_mode_allowed_env_vars</literal> permet leur modification. + </para> + <para> + <example> + <title>Modification d'une variable d'environnement</title> + <programlisting role="php"> <?php putenv("UNIQID=$uniqid"); ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.set-magic-quotes-runtime"> - <refnamediv> - <refname>set_magic_quotes_runtime</refname> - <refpurpose> - Active/désactive l'option magic_quotes_runtime. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>long - <function>set_magic_quotes_runtime</function> - </funcdef> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>getenv</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.set-magic-quotes-runtime"> + <refnamediv> + <refname>set_magic_quotes_runtime</refname> + <refpurpose> + Active/désactive l'option magic_quotes_runtime. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>long <function>set_magic_quotes_runtime</function></funcdef> <paramdef>int <parameter>new_setting</parameter></paramdef> - </funcsynopsis> - <simpara> - Active/désactive l'option - <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>. - (0 l'option est désactivée, 1 l'option est activée). - </simpara> - <simpara> - Voir aussi <function>get_magic_quotes_gpc</function> et - <function>get_magic_quotes_runtime</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.set-time-limit"> - <refnamediv> - <refname>set_time_limit</refname> - <refpurpose>Fixe le temps maximum d'exécution d'un script.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <simpara> + <function>set_magic_quotes_runtime</function> active/désactive l'option + <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>. + (0 l'option est désactivée, 1 l'option est activée). + </simpara> + <simpara> + Voir aussi + <function>get_magic_quotes_gpc</function> et + <function>get_magic_quotes_runtime</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.set-time-limit"> + <refnamediv> + <refname>set_time_limit</refname> + <refpurpose>Fixe le temps maximum d'exécution d'un script.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>void <function>set_time_limit</function></funcdef> <paramdef>int <parameter>seconds</parameter></paramdef> - </funcsynopsis> - <simpara> - <function>set_time_limit</function> fixe le délai d'éxpiration - d'un script, en secondes. Si cette limite est atteinte, le script s'interrompt, et - renvoie une erreur fatale. La valeur par défaut est 30 secondes ou, si - c'est le cas, la valeur de la directive max_execution_time définie dans le - <link linkend="configuration.file">fichier de configuration</link>. - Si la valeur est zéro, il n'y a alors aucune limite imposée. - </simpara> - <simpara> - Lorsqu'elle est appelée, la fonction - <function>set_time_limit</function> remet le compteur - de zéro. En d'autres termes, si la limite par - défaut est à 30 secondes, et qu'après - 25 secondes d'exécution du script l'appel - set_time_limit(20) est fait, alors le script tournera - pendant un total de 45 secondes avant de finir. - </simpara> - <simpara> - Notez que <function>set_time_limit</function> n'a pas - d'effet lorsque PHP fonctionne en mode <link linkend="ini.safe-mode">safe mode</link>. Il - n'y a pas d'autre solution que de changer de - mode, ou de modifier la durée maximale - d'exécution dans le <link linkend="configuration.file"> - fichier de configuration</link>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.zend-logo-guid"> - <refnamediv> - <refname>zend_logo_guid</refname> - <refpurpose>Retourne le logo de Zend</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <simpara> + <function>set_time_limit</function> fixe le délai d'expiration + d'un script, en secondes. Si cette limite est atteinte, le script s'interrompt, et + renvoie une erreur fatale. La valeur par défaut est 30 secondes ou, si + c'est le cas, la valeur de la directive max_execution_time définie dans le + <link linkend="configuration.file">fichier de configuration</link>. + Si la valeur est zéro, il n'y a alors aucune limite imposée. + </simpara> + <simpara> + Lorsqu'elle est appelée, la fonction + <function>set_time_limit</function> remet le compteur + de zéro. En d'autres termes, si la limite par + défaut est à 30 secondes, et qu'après + 25 secondes d'exécution du script l'appel + set_time_limit(20) est fait, alors le script tournera + pendant un total de 45 secondes avant de finir. + </simpara> + <simpara> + Notez que <function>set_time_limit</function> n'a pas + d'effet lorsque PHP fonctionne en mode <link linkend="ini.safe-mode">safe mode</link>. Il + n'y a pas d'autre solution que de changer de + mode, ou de modifier la durée maximale + d'exécution dans le <link linkend="configuration.file"> + fichier de configuration</link>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.zend-logo-guid"> + <refnamediv> + <refname>zend_logo_guid</refname> + <refpurpose>Retourne le logo de Zend</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>string <function>zend_logo_guid</function></funcdef> <paramdef>void</paramdef> - </funcsynopsis> - <para> - <note> - <para> - Cette fonctionnalité a été ajouté en PHP 4 Beta 4. - </para> - </note> - </para> - </refsect1> - </refentry> - <refentry id="function.get-loaded-extensions"> - <refnamediv> - <refname>get_loaded_extensions</refname> - <refpurpose> - Retourne un tableau contenant les noms de tous les modules compilés - et chargés - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>get_loaded_extensions</function></funcdef> - <paramdef>void </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>get_loaded_extensions</function> retourne un tableau contenant - les noms de tous les modules compilés et chargés sur - l'interpreteur PHP courant. - </para> - <para> - Par exemple, la ligne ci dessous - <informalexample> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <note> + <para> + Cette fonctionnalité a été ajoutée en PHP 4 Beta 4. + </para> + </note> + </para> + </refsect1> + </refentry> + <refentry id="function.get-defined-constants"> + <refnamediv> + <refname>get_defined_constants</refname> + <refpurpose> + Retourne la liste des constantes et leur valeur + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>get_defined_constants</function></funcdef> + <void/> + </funcprototype> + </funcsynopsis> + <para> + <function>get_defined_constants</function> retourne les noms et + valeurs des constantes déjà définies. Cela inclus les constantes créées + par les extensions, et celles créées avec la fonction <function>define</function>. + </para> + <para> + Par exemple : + <informalexample> + <programlisting> +<?php +print_r (get_defined_constants()); +?> + </programlisting> + </informalexample> + affichera + <informalexample> + <programlisting> +Array +( + [E_ERROR] => 1 + [E_WARNING] => 2 + [E_PARSE] => 4 + [E_NOTICE] => 8 + [E_CORE_ERROR] => 16 + [E_CORE_WARNING] => 32 + [E_COMPILE_ERROR] => 64 + [E_COMPILE_WARNING] => 128 + [E_USER_ERROR] => 256 + [E_USER_WARNING] => 512 + [E_USER_NOTICE] => 1024 + [E_ALL] => 2047 + [TRUE] => 1 +) + </programlisting> + </informalexample> + </para> + <para> + Voir aussi + <function>get_loaded_extensions</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.get-loaded-extensions"> + <refnamediv> + <refname>get_loaded_extensions</refname> + <refpurpose> + Retourne la liste de tous les modules compilés et chargés + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>get_loaded_extensions</function></funcdef> + <paramdef>void </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>get_loaded_extensions</function> retourne un tableau contenant + les noms de tous les modules compilés et chargés sur + l'interpreteur PHP courant. + </para> + <para> + Par exemple, la ligne ci-dessous + <informalexample> + <programlisting role="php"> <?php print_r(get_loaded_extensions()); ?> - </programlisting> - </informalexample> - affichera la liste suivante : - <informalexample> - <literallayout> + </programlisting> + </informalexample> + affichera la liste suivante : + <informalexample> + <literallayout> <computeroutput> Array ( [0] => xml [1] => wddx [2] => standard - [3] => session - [4] => posix - [5] => pgsql - [6] => pcre - [7] => gd - [8] => ftp - [9] => db - [10] => Calendar - [11] => bcmath + [3] => session + [4] => posix + [5] => pgsql + [6] => pcre + [7] => gd + [8] => ftp + [9] => db + [10] => Calendar + [11] => bcmath ) </computeroutput> - </literallayout> - </informalexample> - </para> - <para> - Voir aussi: <function>get_extension_funcs</function>. - </para> - </refsect1> - </refentry> -<refentry id="function.get-extension-funcs"> - <refnamediv> - <refname>get_extension_funcs</refname> - <refpurpose> - Liste les fonctions d'une extension - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>get_extension_funcs</function></funcdef> - <paramdef>string <parameter>module_name</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>get_extension_funcs</function> retourne le nom des des fonctions - définies dans le module <parameter>module_name</parameter>. - </para> - <para> - Par exemple, les lignes suivantes : - <informalexample> - <programlisting role="php"> + </literallayout> + </informalexample> + </para> + <para> + Voir aussi + <function>get_extension_funcs</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.get-extension-funcs"> + <refnamediv> + <refname>get_extension_funcs</refname> + <refpurpose> + Liste les fonctions d'une extension + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>get_extension_funcs</function></funcdef> + <paramdef>string <parameter>module_name</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>get_extension_funcs</function> retourne le nom des fonctions + définies dans le module <parameter>module_name</parameter>. + </para> + <para> + Par exemple, les lignes suivantes : + <informalexample> + <programlisting role="php"> <?php print_r(get_extension_funcs("xml")); print_r(get_extension_funcs("gd")); ?> - </programlisting> - </informalexample> - vont afficher la liste des fonctions disponibles avec les modules - <varname>xml</varname> et <varname>gd</varname>. - </para> - <para> - Voir aussi: <function>get_loaded_extensions</function> - </para> - </refsect1> - </refentry> - <refentry id="function.get-required-files"> - <refnamediv> - <refname>get_required_files</refname> - <refpurpose> - Retourne un tableau avec les noms des fichiers qui sont requis - et inclus dans un script - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>get_required_files</function></funcdef> - <paramdef>void </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>get_required_files</function> retourne un tableau - contenant les noms de tous les fichiers qui ont été - chargés dans un script avec la fonction - <function>require_once</function> ou <function>include_once</function>. - Les index de ces tableaux sont les noms des fichiers - utilisés dans les fonctions <function>require_once</function> - ou <function>include_once</function>. + </programlisting> + </informalexample> + vont afficher la liste des fonctions disponibles avec les modules + <varname>xml</varname> et <varname>gd</varname>. + </para> + <para> + Voir aussi + <function>get_loaded_extensions</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.get-required-files"> + <refnamediv> + <refname>get_required_files</refname> + <refpurpose> + Retourne un tableau avec les noms des fichiers qui sont requis + et inclus dans un script + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>get_required_files</function></funcdef> + <paramdef>void </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>get_required_files</function> retourne un tableau + contenant les noms de tous les fichiers qui ont été + chargés dans un script avec la fonction + <function>require_once</function> ou <function>include_once</function>. + Les index de ces tableaux sont les noms des fichiers + utilisés dans les fonctions <function>require_once</function> + ou <function>include_once</function>. + </para> + <note> + <para> + En PHP 4.0.1pl2, cette fonction supposait que + <varname>required_once</varname> utilisait l'extension + ".php" : les autres extensions ne fonctionnaient pas. + Par ailleurs, dans cette version, le tableau retourné était + un tableau associatif, et cette fonction n'était pas + un alias de <function>get_included_files</function> </para> - <note> - <para> - En PHP 4.0.1pl2, cette fonction supposait que - <varname>required_once</varname> utilisait l'extension - ".php" : les autres extensions ne fonctionnaient pas. - Par ailleurs, dans cette version, le tableau retourné était - un tableau associatif, et cette fonction n'était pas - un alias de <function>get_included_files</function> - </para> - <para> - Depuis PHP 4.0.4, cette fonction est un alias de - <function>get_included_files</function> - </para> - </note> <para> - Voir aussi - <function>require_once</function>, - <function>include_once</function> et + Depuis PHP 4.0.4, cette fonction est un alias de <function>get_included_files</function> </para> - </refsect1> - </refentry> - <refentry id="function.get-included-files"> - <refnamediv> - <refname>get_included_files</refname> - <refpurpose> - Retourne un tableau avec les noms des fichiers qui sont inclus - dans un script - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>get_included_files</function></funcdef> - <paramdef>void </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>get_included_files</function> retourne un tableau - contenant les noms de tous les fichiers qui ont été - ajoutés au script avec les fonctions <function>require_once</function> ou - <function>include_once</function>. - </para> - <para> - L'exemple ci-dessous - <example> - <title>Affichage des fichirs inclus et requis</title> - <programlisting> + </note> + <para> + Voir aussi + <function>require_once</function>, + <function>include_once</function> et + <function>get_included_files</function> + </para> + </refsect1> + </refentry> + <refentry id="function.get-included-files"> + <refnamediv> + <refname>get_included_files</refname> + <refpurpose> + Retourne un tableau avec les noms des fichiers qui sont inclus + dans un script + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>get_included_files</function></funcdef> + <paramdef>void </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>get_included_files</function> retourne un tableau + contenant les noms de tous les fichiers qui ont été + ajoutés au script avec les fonctions <function>require_once</function> ou + <function>include_once</function>. + </para> + <para> + L'exemple ci-dessous + <example> + <title>Affichage des fichiers inclus et requis</title> + <programlisting> <?php require_once("local.php"); require_once("../inc/global.php"); @@ -1507,11 +1651,11 @@ echo "Fichiers appelés avec required_once/included_once\n"; print_r(get_required_files()); ?> - </programlisting> - </example> - va afficher : - <informalexample> - <programlisting> + </programlisting> + </example> + va afficher : + <informalexample> + <programlisting> Fichiers appelés avec required_once/included_once Array ( @@ -1522,63 +1666,64 @@ [4] => util3.php [5] => util4.php ) - </programlisting> - </informalexample> - </para> - <note> - <para> - En PHP 4.0.1pl2, cette fonction supposait que - <varname>required_once</varname> utilisait l'extension - ".php" : les autres extensions ne fonctionnaient pas. - Par ailleurs, dans cette version, le tableau retourné était - un tableau associatif, et cette fonction n'était pas - un alias de <function>get_included_files</function> - </para> - </note> - <para> - Voir aussi - <function>require_once</function>, - <function>include_once</function> et - <function>get_required_files</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.zend-version"> - <refnamediv> - <refname>zend_version</refname> - <refpurpose>Lit la version courante du moteur Zend.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>zend_version</function></funcdef> - <paramdef>void<parameter></parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>zend_version</function> retourne une chaîne contenant le - numéro de version du moteur d'analyse Zend, pour l'exécutable - PHP courant. - <example> - <title>Exemple <function>zend_version</function></title> - <programlisting role="php"> + </programlisting> + </informalexample> + </para> + <note> + <para> + En PHP 4.0.1pl2, cette fonction supposait que + <varname>required_once</varname> utilisait l'extension + ".php" : les autres extensions ne fonctionnaient pas. + Par ailleurs, dans cette version, le tableau retourné était + un tableau associatif, et cette fonction n'était pas + un alias de <function>get_included_files</function> + </para> + </note> + <para> + Voir aussi + <function>require_once</function>, + <function>include_once</function> et + <function>get_required_files</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.zend-version"> + <refnamediv> + <refname>zend_version</refname> + <refpurpose>Lit la version courante du moteur Zend.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>zend_version</function></funcdef> + <paramdef>void<parameter></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>zend_version</function> retourne une chaîne contenant le + numéro de version du moteur d'analyse Zend, pour l'exécutable + PHP courant. + <example> + <title>Exemple <function>zend_version</function></title> + <programlisting role="php"> <?php // affiche e.g. 'Version du moteur Zend: 1.0.4' -// ou bien quelquechose d'approchant si votre version de PHP date -echo "Version du moteur Zend: ".zend_version(); +// ou bien quelque chose d'approchant si votre version de PHP date un peu + echo "Version du moteur Zend: ".zend_version(); ?> - </programlisting> - </example> - </para> - <para> - Voir aussi <function>phpinfo</function>, - <function>phpcredits</function>, - <function>php_logo_guid</function> et - <function>phpversion</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>phpinfo</function>, + <function>phpcredits</function>, + <function>php_logo_guid</function> et + <function>phpversion</function>. + </para> + </refsect1> + </refentry> </reference> <!-- Keep this comment at the end of the file Local variables: