cvs: phpdoc-fr /appendices aliases.xml commandline.xml migration4.xml phpdevel.xml reserved.constants.core.xml reserved.constants.standard.xml
reserved.constants.xml reserved.xml transports.xml wrappers.xml

From: Date: Wed, 30 Apr 2003 03:21:01 +0000
Subject: cvs: phpdoc-fr /appendices aliases.xml commandline.xml migration4.xml phpdevel.xml reserved.constants.core.xml reserved.constants.standard.xml
reserved.constants.xml reserved.xml transports.xml wrappers.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-319@lists.php.net to get a copy of this message
dams Tue Apr 29 23:21:01 2003 EDT Added files: /phpdoc-fr/appendices reserved.constants.core.xml reserved.constants.standard.xml reserved.constants.xml transports.xml wrappers.xml Modified files: /phpdoc-fr/appendices commandline.xml aliases.xml migration4.xml phpdevel.xml reserved.xml Log: adding transports and correcting typos

Index: phpdoc-fr/appendices/commandline.xml diff -u /dev/null phpdoc-fr/appendices/commandline.xml:1.8 --- /dev/null Tue Apr 29 23:21:00 2003 +++ phpdoc-fr/appendices/commandline.xml Tue Apr 29 23:21:00 2003 @@ -0,0 +1,1006 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.8 $ --> +<chapter id="appendices.commandline"> + <title>Utiliser PHP en ligne de commande</title> + <!-- NEW DOCUMENTATION STARTS --> + <para> + Depuis la version 4.3, &php; supporte un nouveau type + de <literal>SAPI</literal> (Server Application Programming Interface, + c'est &agrave; dire Interface de Programmation d'Applications Serveur) appel&eacute; + <literal>CLI</literal>, ce qui signifie <emphasis>Command Line Interface</emphasis> + et se traduit par <literal>Interface de Ligne de Commande</literal>. + Comme son nom l'indique, ce type <literal>SAPI</literal> cible les + applications shell (ou desktop), &eacute;crites en PHP. Il y a pas mal de + diff&eacute;rences enter le type <literal>CLI SAPI</literal> et les autres + <literal>SAPI</literal>, qui sont expliqu&eacute;s dans ce chapitre. + </para> + <para> + Le <literal>CLI SAPI</literal> a &eacute;t&eacute; publi&eacute; puor la premi&egrave;re fois avec + la version <literal>PHP 4.2.0</literal>, mais il est rest&eacute; exp&eacute;rimental, + et doit &ecirc;tre explicitement activ&eacute; avec la commande <literal>--enable-cli</literal>, + lorsque vous ex&eacute;cutez le script <literal>./configure</literal>. Depuis + PHP 4.3.0, le <literal>CLI SAPI</literal> n'est plus exp&eacute;rimental, et + est donc <emphasis role="strong">toujours</emphasis> compil&eacute; et + install&eacute; comme binaire PHP (appel&eacute; aussi <filename>php.exe</filename> sous + Windows). + </para> + <para> + Les diff&eacute;rences les plus notables entre le <literal>CLI SAPI</literal> et les + <literal>SAPI</literal> sont : + <itemizedlist> + <listitem> + <para> + Contrairement au <literal>CGI SAPI</literal>, aucun ent&ecirc;te HTTP n'est &eacute;crits + dans le r&eacute;sultat. + </para> + <para> + Bien que le <literal>CGI SAPI</literal> fournisse un moyen de supprimer les + ent&ecirc;tes HTTP, il n'y a pas moyen d'activer les ent&ecirc;tes HTTP dans le + <literal>CLI SAPI</literal>. + </para> + </listitem> + <listitem> + <para> + Il y a plusieurs directives du &php.ini; qui sont ignor&eacute;es par le + <literal>CLI SAPI</literal>, car elles n'ont pas de sens, en environnement + shell : + <table> + <title>Directives &php.ini; ignor&eacute;es</title> + <tgroup cols="3"> + <thead> + <row> + <entry>Directive</entry> + <entry>Valeur par d&eacute;faut pour <literal>CLI SAPI</literal></entry> + <entry>Commentaire</entry> + </row> + </thead> + <tbody> + <row> + <entry><link linkend="ini.html-errors">html_errors</link></entry> + <entry>&false;</entry> + <entry> + Il peut &ecirc;tre bien difficile de lire les messages d'erreur sur un terminal + lorsqu'ils sont noy&eacute;s dans des balises HTML sans grand int&eacute;r&ecirc;ts. Par + cons&eacute;quent, cette directive est forc&eacute;e &agrave; &false;. + </entry> + </row> + <row> + <entry><link linkend="ini.implicit-flush">implicit_flush</link></entry> + <entry>&true;</entry> + <entry> + Il est souhaitable que tout affichage en provenance de + <function>print</function>, <function>echo</function> et consorts soit + imm&eacute;diatement affich&eacute; dans le terminal, et non pas plac&eacute; dans un + buffer quelconque. Vous pouvez toujours utiliser + <link linkend="ref.outcontrol">la bufferisation de sortie</link> + si vous voulez retarder un affichage, ou bien en manipuler ultimement + le contenu. + </entry> + </row> + <row> + <entry><link linkend="ini.max-execution-time">max_execution_time</link></entry> + <entry>0 (unlimited)</entry> + <entry> + Etant donn&eacute; les possibilit&eacute;s infinies de PHP en + environnement shell, le temps d'ex&eacute;cution maximal d'un + script PHP a &eacute;t&eacute; rendu illimit&eacute;. + Alors que les scripts destin&eacute;s au web doivent s'accomplir en une + fraction de seconde, il arrive que les scripts shell requi&egrave;rent + bien plus de temps. + </entry> + </row> + <row> + <entry><link linkend="ini.register-argc-argv">register_argc_argv</link></entry> + <entry>&true;</entry> + <entry> + <para> + En donnant la valeur de &true; &agrave; cette directive, vous aurez toujours + acc&egrave;s &agrave; la variable <emphasis>argc</emphasis> (repr&eacute;sentant le nombre + d'arguments pass&eacute;s &agrave; l'application) et + <emphasis>argv</emphasis> (le tableau contenant les arguments pass&eacute;s) + dans le <literal>CLI SAPI</literal>. + </para> + <para> + Depuis &php; 4.3.0, les variables <varname>$argc</varname> + et <varname>$argv</varname> sont d&eacute;finies et remplies avec les valeurs + appropri&eacute;es, en utilisant <literal>CLI SAPI</literal>. Avant cette version, + la cr&eacute;ation de ces variables &eacute;tait li&eacute;e au comportement des versions + <literal>CGI</literal> et <literal>MODULE</literal>, qui requi&egrave;rent l'activation + de la directive &php; + <link linkend="ini.register-globals">register_globals</link>. + Ind&eacute;pendamment de la version ou de la valeur de register_globals, + vous pouvez toujour acc&eacute;der &agrave; + <link linkend="reserved.variables.server"><varname>$_SERVER</varname></link> et + <varname>$HTTP_SERVER_VARS</varname>. Par exemple: + <varname>$_SERVER['argv']</varname> + </para> + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <note> + <para> + Ces directives ne peuvent pas &ecirc;tre initialis&eacute;es avec d'autres valeurs + dans le fichier &php.ini; ou par une autre m&eacute;thode. C'est une limitation, + car ces valeurs par d&eacute;faut s'appliquent une fois que tous les autres + fichiers de configuration ont &eacute;t&eacute; analys&eacute;s. Cependant, ces + valeurs peuvent &ecirc;tre modifi&eacute;es durant l'ex&eacute;cution (ce qui n'est pas + logique pour certaines directives, comme par exemple + <link linkend="ini.register-argc-argv">register_argc_argv</link>). + </para> + </note> + </listitem> + <listitem> + <para> + Pour faciliter le travail en environnement shell, les constantes suivantes + sont d&eacute;finies : + <table> + <title>Constantes sp&eacute;cifiques au CLI</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Constante</entry> + <entry>D&eacute;scription</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>STDIN</constant></entry> + <entry> + Un descripteur de fichier d&eacute;j&agrave; disponible vers <literal>stdin</literal>. + Cela &eacute;vite de l'ouvrir avec + <programlisting role="php"> +<![CDATA[ +$stdin = fopen('php://stdin', 'r'); +]]> + </programlisting> + </entry> + </row> + <row> + <entry><constant>STDOUT</constant></entry> + <entry> + Un descripteur de fichier d&eacute;j&agrave; disponible vers <literal>stdout</literal>. + Cela &eacute;vite de l'ouvrir avec + <programlisting role="php"> +<![CDATA[ +$stdout = fopen('php://stdout', 'w'); +]]> + </programlisting> + </entry> + </row> + <row> + <entry><constant>STDERR</constant></entry> + <entry> + Un descripteur de fichier d&eacute;j&agrave; disponible vers + <literal>stderr</literal>. Cela &eacute;vite de l'ouvrir avec + <programlisting role="php"> +<![CDATA[ +$stderr = fopen('php://stderr', 'w'); +]]> + </programlisting> + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + Etant donn&eacute; ce qui pr&eacute;c&egrave;de, vous n'avez pas besoin d'ouvrir un fichier + vers <literal>stderr</literal> par vous-m&ecirc;me, mais vous pouvez utiliser + cette constante directement, comme un descripteur de fichier : + <programlisting role="php"> +<![CDATA[ +php -r 'fwrite(STDERR, "stderr\n");' +]]> + </programlisting> + Vous n'avez pas non plus &agrave; fermer explicitement ces fichiers, PHP s'en + chargera automatiquement. + </para> + </listitem> + <listitem> + <para> + <literal>CLI SAPI</literal> <emphasis role="strong">ne transforme pas</emphasis> + le dossier courant en dossier d'ex&eacute;cution du script! + </para> + <para> + Exemple de diff&eacute;rence entre <literal>CGI SAPI</literal> et <literal>CLI SAPI</literal>: + <programlisting role="php"> +<![CDATA[ +<?php + /* Un test simple : affiche le dossier d'ex&eacute;cution */ + echo getcwd(), "\n"; +?> +]]> + </programlisting> + </para> + <para> + Lorsque vous utilisez la version <literal>CGI</literal>, l'affichage pourra &ecirc;tre + <screen> +<![CDATA[ +$ pwd +/tmp + +$ php-cgi -f autre_dossier/test.php +/tmp/autre_dossier +]]> + </screen> + Cela monter clairement que &php; modifie le dossier + courant, et utilise le dossier du script ex&eacute;cut&eacute;. + </para> + <para> + En utilisant le <literal>CLI SAPI</literal>, on obtient : + <screen> +<![CDATA[ +$ pwd +/tmp + +$ php -f autre_dossier/test.php +/tmp +]]> + </screen> + Cela donne beaucoup plus de souplesse lorsque vous r&eacute;digez des + scripts shell avec &php;. + </para> + <note> + <para> + <literal>CGI SAPI</literal> supporte le m&ecirc;me comportement de + <literal>CLI SAPI</literal>, en lui passant l'option + <literal>-C</literal>, lorsque vous l'invoquez en ligne de commmande. + </para> + </note> + </listitem> + </itemizedlist> + </para> + <para> + La liste des options de ligne de commande fournies par &php; + est disponible en ex&eacute;cutant &php; avec l'option <literal>-h</literal> : + <screen> +<![CDATA[ +Usage: php [options] [-f] <file> [args...] + php [options] -r <code> [args...] + php [options] [-- args...] + -s Display colour syntax highlighted source. + -w Display source with stripped comments and whitespace. + -f <file> Parse <file>. + -v Version number + -c <path>|<file> Look for php.ini file in this directory + -a Run interactively + -d foo[=bar] Define INI entry foo with value 'bar' + -e Generate extended information for debugger/profiler + -z <file> Load Zend extension <file>. + -l Syntax check only (lint) + -m Show compiled in modules + -i PHP information + -r <code> Run PHP <code> without using script tags <?..?> + -h This help + + args... Arguments passed to script. Use -- args when first argument + starts with - or script is read from stdin +]]> + </screen> + </para> + <para> + Le <literal>CLI SAPI</literal> dispose de trois moyens pour lire le + code du script PHP que vous voulez ex&eacute;cuter : + <orderedlist> + <listitem> + <para> + Indiquer &agrave; &php; d'ex&eacute;cuter un fichier : + </para> + <para> + <screen> +<![CDATA[ +php mon_script.php + +php -f mon_script.php +]]> + </screen> + Les deux m&eacute;thodes (en utilisant <literal>-f</literal> ou pas) ex&eacute;cute le + script contenu dans le fichier <filename>mon_script.php</filename>. Vous + pouvez choisir n'importe quel fichier, et ces fichiers ne sont pas + tenus d'utiliser l'extension <filename>.php</filename>. N'importe + quelle extension peut faire l'affaire. + </para> + </listitem> + <listitem> + <para> + Donner du code &php; &agrave; ex&eacute;cuter directement en ligne de commande. + </para> + <para> + <screen> +<![CDATA[ +php -r 'print_r(get_defined_constants());' +]]> + </screen> + Une attention particuli&egrave;re doit alors &ecirc;tre apport&eacute;e aux variables d'environnement, + qui seront remplac&eacute;es, et aux guillements, qui ont des significations sp&eacute;ciales en + ligne de commande. + </para> + <note> + <para> + Lisez l'exemple attentivement, il n'y a ni balise d'ouverture, ni balise de fermeture! + L'option <literal>-r</literal> fonctionne sans ces balises, et les ajouter conduira + alors &agrave; une erreur d'analyse. + </para> + </note> + </listitem> + <listitem> + <para> + Donner du code &php; dans l'entr&eacute;e standard + (<literal>stdin</literal>). + </para> + <para> + Cela donne la possibilit&eacute; de cr&eacute;er dynamiquement du code + &php;, puis de le fournir &agrave; PHP, et enfin, + de le traiter &agrave; nouveau en shell. Voici un exemple fictif : + <screen> +<![CDATA[ +$ some_application | some_filter | php | sort -u >final_output.txt +]]> + </screen> + </para> + </listitem> + </orderedlist> + Il n'est pas possible de combiner ces trois modes d'ex&eacute;cution. + </para> + <para> + Comme toute application shell, l'ex&eacute;cutable &php; accepte + des arguments, et votre script peut aussi les recevoirs. Le nombre d'arguments + n'est pas limit&eacute; par PHP, mais par le shell, qui a une limite en terme + de nombre de caract&egrave;res qui peuvent &ecirc;tre pass&eacute;s. G&eacute;n&eacute;ralement, vous n'atteidrez + pas cette limite, mais cela reste possible. Les arguments pass&eacute;s au script seront + transmis via la variable tableau <literal>$argv</literal>. L,index z&eacute;ro + contiendra toujours le nom du script appel&eacute;. Si le code a &eacute;t&eacute; fourni en ligne + de commande, ou via <literal>stdin</literal>, ce premier &eacute;l&eacute;ment vaudra + <literal>-</literal>. L'autre variable globale fournie est + <literal>$argc</literal> qui contient le nombre d'&eacute;l&eacute;ments dans le tableau + <literal>$argv</literal> : ce nombre est <emphasis role="strong">diff&eacute;rent</emphasis> + du nombre d'arguments pass&eacute;s au script. + </para> + <para> + Tant que les arguments que vous passez &agrave; votre script ne commencent pas par + le caract&egrave;re <literal>-</literal>, il n'y a rien de sp&eacute;cial &agrave; surveiller. + Si vous passez des arguments &agrave; voter script qui commencent par + <literal>-</literal>, cela posera des probl&egrave;mes car &php; + va penser qu'il doit les interpr&eacute;ter. Pour &eacute;viter cela, utilisez le s&eacute;parateur + <literal>--</literal>. Apr&egrave;s cet argument, tous les arguments suivants seront + pass&eacute;s &agrave; votre script sans &ecirc;tre modifi&eacute; ou analys&eacute; par PHP. + </para> + <screen> +<![CDATA[ +# Cela ne va pas ex&eacute;cuter le code, mais afficher l'aide de PHP +$ php -r 'var_dump($argv);' -h +Usage: php [options] [-f] <file> [args...] +[...] + +# Cela va passer l'argument '-h' &agrave; votre script, et &eacute;viter que PHP ne le traite +$ php -r 'var_dump($argv);' -- -h +array(2) { + [0]=> + string(1) "-" + [1]=> + string(2) "-h" +} +]]> + </screen> + <para> + Cependant, il y a une autre m&eacute;thode pour utiliser PHP en script shell. + Vous pouvez aussi utiliser la ligne <literal>#!/usr/bin/php</literal> + en tout d&eacute;but de votre script, suivi de code PHP compris entre + balise ouvrantes/fermantes. Vous pouvez aussi ajouter apr&egrave;s + <literal>#!/usr/bin/php</literal> les options n&eacute;cessaires. Vous + pouvez aussi le faire en ligne de commande. + De cette mani&egrave;re, le script peut &ecirc;tre ex&eacute;cut&eacute; comme un script + shell habituel : + <programlisting role="php"> +<![CDATA[ +#!/usr/bin/php +<?php + var_dump($argv); +?> +]]> + </programlisting> + En supposant que ce fichier s'appelle<filename>test</filename>, dans le + dossier courant, nous pouvons alors faire ceci : + <screen> +<![CDATA[ +$ chmod 755 test +$ ./test -h -- foo +array(4) { + [0]=> + string(6) "./test" + [1]=> + string(2) "-h" + [2]=> + string(2) "--" + [3]=> + string(3) "foo" +} +]]> + </screen> + Comme vous le voyez, aucune pr&eacute;caution n'est n&eacute;cessaire pour passer des + param&egrave;tres qui commencent par <literal>-</literal> &agrave; votre script. + </para> + <para> + <table> + <title>Options de ligne de commande</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Option</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>-s</entry> + <entry> + <para> + Affiche le code avec la colorisation syntaxique. + </para> + <para> + Cette option utilise le m&eacute;canisme interne pour analyser le fichier, + et produire une version coloris&eacute;e du code source, au format HTML. + Notez que cette option ne fait que g&eacute;n&eacute;rer un bloc + <literal>HTML</literal>, sans les ent&ecirc;tes. + <literal>&lt;code&gt; [...] &lt;/code&gt;</literal> + </para> + <note> + <para> + Cette option ne fonctionne pas avec l'option <literal>-r</literal>. + </para> + </note> + </entry> + </row> + <row> + <entry>-w</entry> + <entry> + <para> + Affiche la source sans les commentaires et les espaces. + </para> + <note> + <para> + Cette option ne fonctionne pas avec l'option <literal>-r</literal>. + </para> + </note> + </entry> + </row> + <row> + <entry>-f</entry> + <entry> + <para> + Analyse et ex&eacute;cute le fichier donn&eacute; apr&egrave;s l'option <literal>-f</literal>. + Cette optione est optionnelle, et peut &ecirc;tre omise. Le seul nom du fichier + est suffisant. + </para> + </entry> + </row> + <row> + <entry>-v</entry> + <entry> + <para> + Affiche les versions de PHP, PHP SAPI, et Zend sur le terminal. Par exemple : + <screen> +<![CDATA[ +$ php -v +PHP 4.3.0-dev (cli), Copyright (c) 1997-2002 The PHP Group +Zend Engine v1.2.1, Copyright (c) 1998-2002 Zend Technologies +]]> + </screen> + </para> + </entry> + </row> + <row> + <entry>-c</entry> + <entry> + <para> + Avec cette option, vous pouvez sp&eacute;cifier le nom du dossier dans lequel + PHP va recherche le fichier &php.ini;, ou encore vous pouvez + sp&eacute;cifier un fichier de configuration directement (qui n'a pas + obligatoirement &agrave; &ecirc;tre appel&eacute; &php.ini;) : + <screen> +<![CDATA[ +$ php -c /custom/directory/ mon_script.php + +$ php -c /custom/directory/custom-file.ini mon_script.php +]]> + </screen> + </para> + </entry> + </row> + <row> + <entry>-a</entry> + <entry> + <para> + Ex&eacute;cute PHP de mani&egrave;re interactive. + <!-- + mfischer, 20020510: Couldn't come up with a decent useful description + of the current implementation of the interactive mode. + --> + </para> + </entry> + </row> + <row> + <entry>-d</entry> + <entry> + <para> + Cette option permet de modifier n'importe quelle directive de configuration + du fichier &php.ini;. La syntaxe est : + <screen> +<![CDATA[ +-d configuration_directive[=value] +]]> + </screen> + </para> + <para> + Exemples: + <screen> +<![CDATA[ +# L'omission de la valeur conduit &agrave; donner la valeur de "1" +$ php -d max_execution_time -r '$foo = ini_get("max_execution_time"); var_dump($foo);' +string(1) "1" + +# Passer une valeur vide conduit &agrave; donner la valeur de "" +php -d max_execution_time= -r '$foo = ini_get("max_execution_time"); var_dump($foo);' +string(0) "" + +# La directive de configuration sera n'importe quelle valeur pass&eacute;e apr&egrave;s le caract&egrave;re '=' +$ php -d max_execution_time=20 -r '$foo = ini_get("max_execution_time"); var_dump($foo);' +string(2) "20" +$ php -d max_execution_time=doesntmakesense -r '$foo = ini_get("max_execution_time"); var_dump($foo);' +string(15) "doesntmakesense" +]]> + </screen> + </para> + </entry> + </row> + <row> + <entry>-e</entry> + <entry> + <para> + G&eacute;n&eacute;re des informations &eacute;tendues pour le profilage et le d&eacute;bogage. + <!-- + mfischer, 20020510: Anyone who can provide more information what it + really does (even if it's only for developers) ? + --> + </para> + </entry> + </row> + <row> + <entry>-z</entry> + <entry> + <para> + Charge une extension Zend. Si seulement un fichier est fourni, PHP + essaie de charger cette extension dans le dossier courant par d&eacute;faut + des librairie sur votre syst&egrave;me (g&eacute;n&eacute;ralement sp&eacute;cifi&eacute; avec + <filename>/etc/ld.so.conf</filename> sous Linux). Passer un nom de + fichier avec le chemin complet fera que PHP utilisera ce fichier, + sans recherche dans les dossiers classiques. Un chemin de dossier + relatif indiquera &agrave; PHP qu'il doit chercher uniquement les extensions + dans ce dossier. + </para> + </entry> + </row> + <row> + <entry>-l</entry> + <entry> + <para> + Cette option permet de faire une v&eacute;rification syntaxique sur le code + PHP fourni. En cas de r&eacute;ussite, le message + <literal>No syntax errors detected in &lt;filename&gt;</literal> + (<literal>Aucune d'erreur de syntaxe n'ont &eacute;t&eacute; d&eacute;tect&eacute;es dans &lt;nom_de_fichier&gt;</literal> + est affich&eacute; sur la sortie standard, et le script shell retourne + <literal>0</literal>. En cas d'erreur, le message + <literal>Errors parsing &lt;filename&gt;</literal> + (<literal>Erreurs d'analyse dans le fichier &lt;filename&gt;</literal>) + est affich&eacute;, en plus des messages d'erreurs d&eacute;tect&eacute;s par l'analyseur + lui m&ecirc;me. Le script shell retourne le code <literal>255</literal>. + </para> + <para> + Cette option ne d&eacute;tecte pas les erreurs fatales (comme par exemple les + fonctions non d&eacute;finies). Utilisez <literal>-f</literal> si vous voulez + tester aussi ces erreurs. + </para> + <note> + <para> + Cette option ne fonctionne pas avec l'option <literal>-r</literal>. + </para> + </note> + </entry> + </row> + <row> + <entry>-m</entry> + <entry> + <para> + Cette option liste les extensions PHP et Zend compil&eacute;es et charg&eacute;es : + <screen> +<![CDATA[ +$ php -m +[PHP Modules] +xml +tokenizer +standard +session +posix +pcre +overload +mysql +mbstring +ctype + +[Zend Modules] +]]> + </screen> + </para> + </entry> + </row> + <row> + <entry>-i</entry> + <entry> + Cette option appelle la fonction <function>phpinfo</function>, et + affiche le r&eacute;sultat. Si &php; ne fonctionne pas + correctement, il est recommand&eacute; d'utiliser la commande <literal>php -i</literal> + et de voir si il n'y a pas d'erreurs affich&eacute;es avant ou apr&egrave;s la + table d'information. N'oubliez pas que le r&eacute;sutltat de cette + option est au format <literal>HTML</literal>, et donc grand + et illisible directement. + </entry> + </row> + <row> + <entry>-r</entry> + <entry> + <para> + Cette option permet l'ex&eacute;cution de &php; directement + dans la ligne de commande. Les balises de &php; + (<literal>&lt;?php</literal> et <literal>?&gt;</literal>) + <emphasis role="strong">ne sont pas</emphasis> demand&eacute;es, et coauseront + une erreur d'analyse. + </para> + <note> + <para> + De l'attention doit &ecirc;tre port&eacute;e lors de l'utilisation de cette option + de &php;, pour qu'il n'y ait pas de collision avec + les substitutions de variables en lignes de commande, r&eacute;alis&eacute;es par le + shell. + </para> + <para> + Exemple conduisant &agrave; une erreur d'analyse : + <screen> +<![CDATA[ +$ php -r "$foo = get_defined_constants();" +Command line code(1) : Parse error - parse error, unexpected '=' +]]> + </screen> + Le probl&egrave;me ici est que le shell (sh/bash) effectue une substitution + de variables, gr&acirc;ce aux guillemets doubles <literal>"</literal>. + puisque la variable <literal>$foo</literal> n'est probablement pas + d&eacute;finie dans le shell, elle est remplac&eacute;e par rien, ce qui fait + que le code pass&eacute; &agrave; PHP pour l'ex&eacute;cution est : + <screen> +<![CDATA[ +$ php -r " = get_defined_constants();" +]]> + </screen> + La solution de ce probl&egrave;me est d'utiliser les guillemets simples + <literal>'</literal>. Les variables de ces cha&icirc;nes ne seront pas + substitu&eacute;es par leurs valeurs par le shell. + <screen> +<![CDATA[ +$ php -r '$foo = get_defined_constants(); var_dump($foo);' +array(370) { + ["E_ERROR"]=> + int(1) + ["E_WARNING"]=> + int(2) + ["E_PARSE"]=> + int(4) + ["E_NOTICE"]=> + int(8) + ["E_CORE_ERROR"]=> + [...] +]]> + </screen> + Si vous utilisez un shell diff&eacute;rent de sh/bash, vous pouvez + rencontrer d'autres probl&egrave;mes. N'h&eacute;sitez pas &agrave; ouvrir un + rapport de bugs, ou d'envoyer un mail &agrave; + phpdoc@lists.php.net. + + Il est toujours tr&egrave;s facile d'avoir des probl&egrave;mes lorsque vous essayez + d'inclure des variables shell dans le code, ou d'utiliser les anti-slash + pour l'&eacute;chappement. Vous aurez &eacute;t&eacute; pr&eacute;venu. + <!-- :-) --> + </para> + </note> + </entry> + </row> + <row> + <entry>-h</entry> + <entry> + Avec cette option, vous pouvez obtenir des informations sur la liste des + options support&eacute; par votre PHP, avec des explications succintes. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <!-- NEW DOCUMENTATION ENDS --> + + <!-- OLD DOCUMENTED STARTS + mfischer, 20020510: I've commented out the start paragraphs of the old + documentation as it is meant to be replaced by the new one. + <para> + The command line options of the PHP executable are useful + if you would like to debug or test your PHP setup, but they + can also be handy, if you would like to use PHP for a + different purpose than web scripting. + </para> + <para> + Note, that you can always direct the output of the PHP + executable to an external file with the &gt; character, + so <literal>php -q test.php > test.html</literal> will + print out the output of <filename>test.php</filename> + without HTTP headers to the <filename>test.html</filename> + file in the same directory. + </para> + <para> + You can only use these command line options if you have + the PHP executable. If you built the server module + version, and you have no CGI version available on your + machine, than you have no chance to use these options. + For Windows users both the PHP executable and the server + modules are in the binary package, the executable is + named <filename>php.exe</filename>. + </para> + <para> + This list of command line options is consistent with PHP 4.0.6. + You can get the actual list and some one line descriptions + with the <literal>-h</literal> option. The output of + <literal>php -h</literal> should be something like this: + <screen> +<![CDATA[ +Usage: php [-q] [-h] [-s [-v] [-i] [-f <file>] | {<file> [args...]} + -q Quiet-mode. Suppress HTTP Header output. + -s Display colour syntax highlighted source. + -f <file> Parse <file>. Implies `-q' + -v Version number + -C Do not chdir to the script's directory + -c <path> Look for php.ini file in this directory + -d foo[=bar] Define INI entry foo with value 'bar' + -e Generate extended information for debugger/profiler + -z <file> Load Zend extension <file>. + -l Syntax check only (lint) + -m Show compiled in modules + -i PHP information + -h This help +]]> + </screen> + </para> + <para> + Here we list some of the most important command line options + with detailed explanations. + </para> + <para> + <table> + <title>Command line options</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Option</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>-q</entry> + <entry> + Suppress HTTP headers output. Normally PHP prints out + HTTP headers for the calling program (ie. webserver) + to hand on to the browser. When writing command line + applications these headers are useless. + </entry> + </row> + <row> + <entry>-s</entry> + <entry> + Display the color highlighted source of the file + given with its name. This is the same as if you were + printing out the source using the + <function>highlight_file</function> function in + a PHP script. + </entry> + </row> + <row> + <entry>-f</entry> + <entry> + Parse the file given, and search for syntactical and + fatal errors. This option implies -q. Use for + debugging purposes. + </entry> + </row> + <row> + <entry>-v</entry> + <entry> + By calling PHP with this option, you can ask + it to print out its version number, ie: 4.0.6. + </entry> + </row> + <row> + <entry>-C</entry> + <entry> + Normally PHP changes the working directory to the + running scripts directory. This makes it possible + for example, to open files in the same directory, + with only specifying the name of the file. If you + would like to disable this directory change, use + this option. + </entry> + </row> + <row> + <entry>-c</entry> + <entry> + Using this option, you can specify an alternative + &php.ini; path, so PHP will + search your configurations file in this path + instead of the default one. + </entry> + </row> + <row> + <entry>-d</entry> + <entry> + With this option, you can set individual + &php.ini; settings in the + time of running a script. + </entry> + </row> + <row> + <entry>-l</entry> + <entry> + Check the file given for syntax errors. This + option implies -q. Use for debugging purposes. + This option won't find fatal errors (like undefined + functions). Use -f if you would like to test + for fatal errors too. + </entry> + </row> + <row> + <entry>-m</entry> + <entry> + Using this option, PHP prints out the built in + (and loaded) PHP and Zend modules, the PHP + and Zend version numbers, and a short Zend + copyright notice. + </entry> + </row> + <row> + <entry>-i</entry> + <entry> + This command line option calls + <function>phpinfo</function>, and prints + out the results. If PHP is not working well, + it is advisable to make a <literal>php -i</literal> + and see if any error messages are printed out + before or in place of the information tables. + </entry> + </row> + <row> + <entry>-h</entry> + <entry> + With this option, you can get information about + the actual list of command line options and some + one line descriptions about what they do. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + --> + <para> + L'ex&eacute;cutable PHP peut &ecirc;tre utilis&eacute; pour ex&eacute;cuter des scripts ind&eacute;pendants du + serveur web. Si vous &ecirc;tes sur un syst&egrave;me Unix, il est recommand&eacute; d'ajouter + la ligne de configuration en d&eacute;but de scripts, de le rendre ex&eacute;cutable de + mani&egrave;re &agrave; ce que le syst&egrave;me sache quel programme doit ex&eacute;cuter le script. + Sous Windows, vous pouvez associer l'ex&eacute;cutable <literal>php.exe</literal> + avec le double-clic sur les fichiers d'extension <literal>.php</literal>, + ou bien vous pouvez faire un fichier batch pour ex&eacute;cuter le script gr&acirc;ce + &agrave; PHP. La premi&egrave;re ligne utilis&eacute;e dans le monde Unix ne perturbera pas + PHP sous Windows, ce qui rend les scripts facilements portables. Un exemple + complet est disponible ci-dessous : + </para> + <example> + <title>Script pr&eacute;vu pour &ecirc;tre ex&eacute;cut&eacute; en ligne de commande (script.php)</title> + <programlisting role="php"> +<![CDATA[ +#!/usr/bin/php +<?php + +if ($argc != 2 || in_array($argv[1], array('--help', '-help', '-h', '-?'))) { +?> + +C'est une ligne de commande &agrave; une option. + + Utilisation : + <?php echo $argv[0]; ?> <option> + + <option> peut &ecirc;tre un mot que vous souhaitez afficher. + Avec les options --help, -help, -h, + et -?, vous obtiendrez cette aide. + +<?php +} else { + echo $argv[1]; +} +?> +]]> + </programlisting> + </example> + <para> + Dans le script ci-dessus, nous utilisons la premi&egrave;re ligne pour indiquer + que le fichier doit &ecirc;tre ex&eacute;cut&eacute; par PHP. Nous travaillons avec une version + CLI, donc il n'y a pas d'ent&ecirc;tes HTTP qui soient affich&eacute;s. Il y a deux + variables que vous pouvez utiliser avec les applications de ligne de commande : + <varname>$argc</varname> et <varname>$argv</varname>. La premi&egrave;re + est le nombre d'arguments plus un (le nom du script qui est + ex&eacute;cut&eacute;). La seconde est un tableau contenant les arguments, commen&ccedil;ant + avec le nom du script en &eacute;l&eacute;ment 0 (<varname>$argv[0]</varname>). + </para> + <para> + Dans notre exemple, nous avnos v&eacute;rifi&eacute; qu'il y a plus ou moins d'un + argument. De plus, si cet argument est <literal>--help</literal>, + <literal>-help</literal>, <literal>-h</literal> ou <literal>-?</literal>, + nous avons affich&eacute; un message d'aide, ainsi que le nom du + script. Nous nous recevons un autre argument, cet argument est affich&eacute; + dans le terminal. + </para> + <para> + Pour ex&eacute;cuter le script ci-dessus sous Unix, vous devez le rendre + ex&eacute;cu&eacute;table, puis l'appeler avec une commande comme : + <literal>script.php echothis</literal> ou + <literal>script.php -h</literal>. Sous Windows, vous pouvez faire un + fichier batch pour cela : + </para> + <example> + <title>Fichier batch pour ex&eacute;cuter un script PHP en ligne de commande (script.bat)</title> + <programlisting role="winbat"> +@c:\php\php.exe script.php %1 %2 %3 %4 + </programlisting> + </example> + <para> + Si vous avez nomm&eacute; le programme ci-dessus + <filename>script.php</filename>, et que vous avez votre ex&eacute;cutable + <filename>php.exe</filename> situ&eacute; &agrave; + <filename>c:\php\php.exe</filename>, ce fichier batch l'ex&eacute;cutera + avec les options que vous lui passez : + <literal>script.bat echothis</literal> ou + <literal>script.bat -h</literal>. + </para> + <para> + Voir aussi l'extension <link linkend="ref.readline">Readline</link>, + qui dispose de nombreuses fonctions pour am&eacute;liorer la convivialit&eacute; + de vos applications en ligne de commande. + </para> +</chapter> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> Index: phpdoc-fr/appendices/aliases.xml diff -u phpdoc-fr/appendices/aliases.xml:1.6 phpdoc-fr/appendices/aliases.xml:1.7 --- phpdoc-fr/appendices/aliases.xml:1.6 Fri Feb 7 13:11:29 2003 +++ phpdoc-fr/appendices/aliases.xml Tue Apr 29 23:21:00 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <appendix id="aliases"> <title>Liste d'alias</title> <para> @@ -1358,7 +1358,7 @@ </row> <row> <entry>show_source</entry> - <entry><function>highlight_file </function></entry> + <entry><function>highlight_file</function></entry> <entry>Base syntax</entry> </row> <row> Index: phpdoc-fr/appendices/migration4.xml diff -u phpdoc-fr/appendices/migration4.xml:1.17 phpdoc-fr/appendices/migration4.xml:1.18 --- phpdoc-fr/appendices/migration4.xml:1.17 Mon Feb 10 22:13:24 2003 +++ phpdoc-fr/appendices/migration4.xml Tue Apr 29 23:21:00 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> +<!-- $Revision: 1.18 $ --> <appendix id="migration4"> <title>Migration de PHP 3.0 &agrave; PHP 4.0</title> <sect1 id="migration4.changes"> @@ -128,7 +128,7 @@ <simpara> Les valeurs Standard ne peuvent pas contr&ocirc;ler certaines directives PHP. Par exemple, le &safemode; (si vous pouviez modifier les configurations dans le fichier - <filename>.htaccess</filename>, cela annulerait toute la s&eacute;curit&eacute; du &safemode;. + &htaccess;, cela annulerait toute la s&eacute;curit&eacute; du &safemode;. A l'inverse, les valeurs Admin peuvent modifier n'importe quelle directive PHP. </simpara> @@ -137,7 +137,7 @@ <simpara> Pour rendre le processus de transition plus agr&eacute;able, PHP 4.0 est distribu&eacute; avec des scripts qui convertissent automatiquement vos - configuration Apache et vos fichiers <filename>.htaccess</filename> + configuration Apache et vos fichiers &htaccess; pour qu'ils puissent fonctionner aussi bien avec PHP 3 que PHP 4. Ces scripts ne convertissent PAS les lignes concernant les types MIME. Vous devez le faire vous-m&ecirc;me. @@ -159,7 +159,7 @@ <filename>httpd.conf.orig</filename>. </simpara> <para> - Pour convertir vos fichiers <filename>.htaccess</filename>, ex&eacute;cutez + Pour convertir vos fichiers &htaccess;, ex&eacute;cutez le script <filename>aphtaccess-conv.sh</filename> (disponible dans le dossier <filename>scripts/apache/</filename>). Par exemple : <informalexample> @@ -171,7 +171,7 @@ </informalexample> </para> <simpara> - De la m&ecirc;me fa&ccedil;on, votre vieux fichier <filename>.htaccess</filename> + De la m&ecirc;me fa&ccedil;on, votre vieux fichier &htaccess; sera sauv&eacute; sous le nom <filename>.htaccess.orig</filename>. </simpara> <simpara> Index: phpdoc-fr/appendices/phpdevel.xml diff -u phpdoc-fr/appendices/phpdevel.xml:1.22 phpdoc-fr/appendices/phpdevel.xml:1.23 --- phpdoc-fr/appendices/phpdevel.xml:1.22 Sun Apr 13 09:27:14 2003 +++ phpdoc-fr/appendices/phpdevel.xml Tue Apr 29 23:21:00 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.22 $ --> +<!-- $Revision: 1.23 $ --> <appendix id="phpdevel"> <title>D&eacute;veloppement PHP</title> <sect1 id="phpdevel-addfunc"> @@ -740,7 +740,7 @@ restrictions RSRC_CONF sont des directives qui ne peuvent &ecirc;tre disponibles que dans le fichier de configuration Apache. Toutes les directives OR_OPTIONS peuvent &ecirc;tre plac&eacute;es n'importe - o&ugrave;, y compris dans un fichier <filename>.htaccess</filename>. + o&ugrave;, y compris dans un fichier &htaccess;. </simpara> </listitem> <listitem> Index: phpdoc-fr/appendices/reserved.xml diff -u phpdoc-fr/appendices/reserved.xml:1.13 phpdoc-fr/appendices/reserved.xml:1.14 --- phpdoc-fr/appendices/reserved.xml:1.13 Fri Feb 7 13:11:29 2003 +++ phpdoc-fr/appendices/reserved.xml Tue Apr 29 23:21:00 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> +<!-- $Revision: 1.14 $ --> <appendix id="reserved"> <title>Mots r&eacute;serv&eacute;s en PHP</title> <para> @@ -490,7 +490,7 @@ Votre serveur web doit &ecirc;tre configur&eacute; pour cr&eacute;er cette variable. Par exemple, pour Apache, vous devez ajouter la directive <literal>HostnameLookups On</literal> dans le fichier - <filename>httpd.conf</filename>, pour que cette variable existe. + &httpd.conf;, pour que cette variable existe. Voyez aussi <function>gethostbyaddr</function>. </simpara> </note> Index: phpdoc-fr/appendices/reserved.constants.core.xml +++ phpdoc-fr/appendices/reserved.constants.core.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="reserved.constants.core"> <refnamediv> <refname>constantes pr&eacute;d&eacute;finies de zend</refname> <refpurpose>Constants d&eacute;finies dans le coeur de PHP, Zend et les modules SAPI</refpurpose> </refnamediv> <refsect1> <title>Description</title> <simpara> Ces constantes sont d&eacute;finies par le coeur de PHP. Cela inclut notamment PHP, le moteur Zend et les modules SAPI. </simpara> <variablelist> <varlistentry> <term> <constant>PHP_VERSION</constant> (&string;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>PHP_OS</constant> (&string;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>DEFAULT_INCLUDE_PATH</constant> (&string;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>PEAR_INSTALL_DIR</constant> (&string;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>PEAR_EXTENSION_DIR</constant> (&string;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>PHP_EXTENSION_DIR</constant> (&string;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>PHP_BINDIR</constant> (&string;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>PHP_LIBDIR</constant> (&string;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>PHP_DATADIR</constant> (&string;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>PHP_SYSCONFDIR</constant> (&string;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>PHP_LOCALSTATEDIR</constant> (&string;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>PHP_CONFIG_FILE_PATH</constant> (&string;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>PHP_OUTPUT_HANDLER_START</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>PHP_OUTPUT_HANDLER_CONT</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>PHP_OUTPUT_HANDLER_END</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>E_ERROR</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>E_WARNING</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>E_PARSE</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>E_NOTICE</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>E_CORE_ERROR</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>E_CORE_WARNING</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>E_COMPILE_ERROR</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>E_COMPILE_WARNING</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>E_USER_ERROR</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>E_USER_WARNING</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>E_USER_NOTICE</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>E_ALL</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> </variablelist> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: --> Index: phpdoc-fr/appendices/reserved.constants.standard.xml +++ phpdoc-fr/appendices/reserved.constants.standard.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- DOCNOTE: some constants listed here are also there at reference/info/constants.xml. Further decision is needed about the place where general constants need to be put, and how they should be presented. Info constants are not deleted from here to have a consistent standard constants list. --> <refentry id="reserved.constants.standard"> <refnamediv> <refname>constantes standards pr&eacute;d&eacute;finies</refname> <refpurpose>Constantes standards dans PHP</refpurpose> </refnamediv> <refsect1> <title>Description</title> <simpara> Ces constantes sont d&eacute;finies par d&eacute;faut dans PHP. </simpara> <variablelist> <varlistentry> <term> <constant>EXTR_OVERWRITE</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>EXTR_SKIP</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>EXTR_PREFIX_SAME</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>EXTR_PREFIX_ALL</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>EXTR_PREFIX_INVALID</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>EXTR_PREFIX_IF_EXISTS</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>EXTR_IF_EXISTS</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>SORT_ASC</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>SORT_DESC</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>SORT_REGULAR</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>SORT_NUMERIC</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>SORT_STRING</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CASE_LOWER</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CASE_UPPER</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>COUNT_NORMAL</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>COUNT_RECURSIVE</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ASSERT_ACTIVE</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ASSERT_CALLBACK</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ASSERT_BAIL</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ASSERT_WARNING</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ASSERT_QUIET_EVAL</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CONNECTION_ABORTED</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CONNECTION_NORMAL</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CONNECTION_TIMEOUT</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>INI_USER</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>INI_PERDIR</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>INI_SYSTEM</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>INI_ALL</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>M_E</constant> (&float;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>M_LOG2E</constant> (&float;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>M_LOG10E</constant> (&float;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>M_LN2</constant> (&float;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>M_LN10</constant> (&float;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>M_PI</constant> (&float;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>M_PI_2</constant> (&float;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>M_PI_4</constant> (&float;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>M_1_PI</constant> (&float;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>M_2_PI</constant> (&float;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>M_2_SQRTPI</constant> (&float;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>M_SQRT2</constant> (&float;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>M_SQRT1_2</constant> (&float;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CRYPT_SALT_LENGTH</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CRYPT_STD_DES</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CRYPT_EXT_DES</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CRYPT_MD5</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CRYPT_BLOWFISH</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>DIRECTORY_SEPARATOR</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>SEEK_SET</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>SEEK_CUR</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>SEEK_END</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOCK_SH</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOCK_EX</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOCK_UN</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOCK_NB</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>HTML_SPECIALCHARS</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>HTML_ENTITIES</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ENT_COMPAT</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ENT_QUOTES</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ENT_NOQUOTES</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>INFO_GENERAL</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>INFO_CREDITS</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>INFO_CONFIGURATION</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>INFO_MODULES</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>INFO_ENVIRONMENT</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>INFO_VARIABLES</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>INFO_LICENSE</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>INFO_ALL</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CREDITS_GROUP</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CREDITS_GENERAL</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CREDITS_SAPI</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CREDITS_MODULES</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CREDITS_DOCS</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CREDITS_FULLPAGE</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CREDITS_QA</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CREDITS_ALL</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>STR_PAD_LEFT</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>STR_PAD_RIGHT</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>STR_PAD_BOTH</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>PATHINFO_DIRNAME</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>PATHINFO_BASENAME</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>PATHINFO_EXTENSION</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CHAR_MAX</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LC_CTYPE</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LC_NUMERIC</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LC_TIME</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LC_COLLATE</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LC_MONETARY</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LC_ALL</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LC_MESSAGES</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ABDAY_1</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ABDAY_2</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ABDAY_3</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ABDAY_4</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ABDAY_5</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ABDAY_6</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ABDAY_7</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>DAY_1</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>DAY_2</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>DAY_3</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>DAY_4</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>DAY_5</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>DAY_6</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>DAY_7</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ABMON_1</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ABMON_2</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ABMON_3</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ABMON_4</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ABMON_5</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ABMON_6</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ABMON_7</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ABMON_8</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ABMON_9</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ABMON_10</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ABMON_11</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ABMON_12</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>MON_1</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>MON_2</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>MON_3</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>MON_4</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>MON_5</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>MON_6</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>MON_7</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>MON_8</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>MON_9</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>MON_10</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>MON_11</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>MON_12</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>AM_STR</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>PM_STR</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>D_T_FMT</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>D_FMT</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>T_FMT</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>T_FMT_AMPM</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ERA</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ERA_YEAR</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ERA_D_T_FMT</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ERA_D_FMT</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ERA_T_FMT</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ALT_DIGITS</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>INT_CURR_SYMBOL</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CURRENCY_SYMBOL</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CRNCYSTR</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>MON_DECIMAL_POINT</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>MON_THOUSANDS_SEP</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>MON_GROUPING</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>POSITIVE_SIGN</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>NEGATIVE_SIGN</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>INT_FRAC_DIGITS</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FRAC_DIGITS</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>P_CS_PRECEDES</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>P_SEP_BY_SPACE</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>N_CS_PRECEDES</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>N_SEP_BY_SPACE</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>P_SIGN_POSN</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>N_SIGN_POSN</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>DECIMAL_POINT</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>RADIXCHAR</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>THOUSANDS_SEP</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>THOUSEP</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>GROUPING</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>YESEXPR</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>NOEXPR</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>YESSTR</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>NOSTR</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CODESET</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_EMERG</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_ALERT</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_CRIT</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_ERR</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_WARNING</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_NOTICE</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_INFO</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_DEBUG</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_KERN</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_USER</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_MAIL</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_DAEMON</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_AUTH</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_SYSLOG</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_LPR</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_NEWS</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_UUCP</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_CRON</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_AUTHPRIV</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_LOCAL0</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_LOCAL1</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_LOCAL2</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_LOCAL3</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_LOCAL4</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_LOCAL5</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_LOCAL6</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_LOCAL7</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_PID</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_CONS</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_ODELAY</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_NDELAY</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_NOWAIT</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LOG_PERROR</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> </variablelist> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: --> Index: phpdoc-fr/appendices/reserved.constants.xml +++ phpdoc-fr/appendices/reserved.constants.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <sect1 id="reserved.constants"> <title>Constantes pr&eacute;d&eacute;finies en PHP</title> &appendices.reserved.constants.core; &appendices.reserved.constants.standard; </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: --> Index: phpdoc-fr/appendices/transports.xml +++ phpdoc-fr/appendices/transports.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <appendix id="transports"> <title>Liste des modes de transports de sockets disponibles</title> <para> Voici la liste des diffŽrents modes de transports, format URL, dont &php; dispose en interne pour les fl™ts qui exploitent les sockets, tels que <function>fsockopen</function> et <function>stream_socket_client</function>. Ces modes de transports <emphasis>ne s'appliquent pas</emphasis> ˆ l'extension <link linkend="ref.sockets">sockets</link>. </para> <para> Pour conna”tre la liste des modes de transports installŽs sur votre version de &php;, utilisez <function>stream_get_transports</function>. </para> <section id="transports.inet"> <title>Domaien Internet : TCP, UDP, SSL et TLS</title> <simpara> PHP 3, PHP 4. <literal>ssl://</literal> &amp; <literal>tls://</literal> depuis PHP 4.3. </simpara> <note> <simpara> Si aucun transport n'est spŽcifiŽ, <literal>tcp://</literal> est utilisŽ. </simpara> </note> <itemizedlist> <listitem><simpara><literal>127.0.0.1</literal></simpara></listitem> <listitem><simpara><literal>fe80::1</literal></simpara></listitem> <listitem><simpara><literal>www.exemple.com</literal></simpara></listitem> <listitem><simpara><literal>tcp://127.0.0.1</literal></simpara></listitem> <listitem><simpara><literal>tcp://fe80::1</literal></simpara></listitem> <listitem><simpara><literal>tcp://www.exemple.com</literal></simpara></listitem> <listitem><simpara><literal>udp://www.exemple.com</literal></simpara></listitem> <listitem><simpara><literal>ssl://www.exemple.com</literal></simpara></listitem> <listitem><simpara><literal>tls://www.exemple.com</literal></simpara></listitem> </itemizedlist> <simpara> Les sockets du domaine Internet utilisent un numŽro de port en plus de l'adresse de l'h™te. Dans le cas de <function>fsockopen</function>, il est spŽcifiŽ en deuxime paramtre, et donc, n'a pas d'impact sur le format du mode de transport. Avec <function>stream_socket_client</function> et les autres fonctions de la mme famille, le numŽro de port est spŽcifiŽ comme un suffix dans l'URL de transport, identifiŽ par un deux-points. </simpara> <itemizedlist> <listitem><simpara><literal>tcp://127.0.0.1:80</literal></simpara></listitem> <listitem><simpara><literal>tcp://[fe80::1]:80</literal></simpara></listitem> <listitem><simpara><literal>tcp://www.exemple.com:80</literal></simpara></listitem> </itemizedlist> <note> <title>Adresse IPv6 et numŽro de port</title> <simpara> Dans le second exemple ci-dessus, les exemples en IPv4 et les noms d'h™tes sont identiques, mais les IPv6 sont placŽes entre crochet, en plus d'avoir le deux-points et le numŽro de port : <literal>[fe80::1]</literal>. Cela permet de distinguer les deux-points utilisŽs en IPv6 et le deux-points utilisŽ pour dŽlimiter le numŽro de port. </simpara> </note> <simpara> Les modes <literal>ssl://</literal> et <literal>tls://</literal> (disponibles uniquement lorsque le support OpenSSl est compilŽ avec &php;) sont des extensions de <literal>tcp://</literal> qui incluent le chiffrement SSL. En &php; 4.3, OpenSll doit tre compilŽ statiquement avec &php;. en &php; 5.0, il peut tre compilŽ en module ou statiquement. </simpara> <para> <table> <title> Les options de contexte de <literal>ssl://</literal> et <literal>tls://</literal> (depuis &php; 4.3.2) </title> <tgroup cols="4"> <thead> <row> <entry>Nom</entry> <entry>Utilisation</entry> <entry>Valeur par dŽfaut</entry> </row> </thead> <tbody> <row> <entry><literal>verify_peer</literal></entry> <entry> &true; ou &false;. Requiert la vŽrification du certificat SSL utilisŽ. </entry> <entry>&false;</entry> </row> <row> <entry><literal>allow_self_signed</literal></entry> <entry> &true; ou &false;. Permet les certificats auto-signŽs. </entry> <entry>&false;</entry> </row> <row> <entry><literal>cafile</literal></entry> <entry> Situation du fichier de l'autoritŽ de certification sur le serveur local, qui doit tre utilisŽ avec <literal>verify_peer</literal> comme option de contexte pour identifier un pair distant. </entry> <entry></entry> </row> <row> <entry><literal>capath</literal></entry> <entry> Si <literal>cafile</literal> n'est pas spŽcifiŽ, ou si le certificat n'est pas trouvŽ, le dossier <literal>capath</literal> est scannŽ pour y trouver un certificat convenable. <literal>capath</literal> doit tre un dossier de certificats corrects. </entry> </row> <row> <entry><literal>local_cert</literal></entry> <entry> Chemin jusqu'au fichier de certificat local. Il doit tre au format PEM, qui contient votre certificat, et la clŽ privŽe. Il peut Žventuellement contenir la cha”ne de certificat de l'Žmetteur. </entry> <entry></entry> </row> <row> <entry><literal>passphrase</literal></entry> <entry> Mot de passe avec lequel votre <literal>local_cert</literal> a ŽtŽ chiffrŽ. </entry> <entry></entry> </row> <row> <entry><literal>CN_match</literal></entry> <entry> Le nom commun (Common Name) que nous attendons. &php; va effectuer une comparaison avec jokers limitŽs. Si le nom commun ne correspond pas ˆ celui attendu, la connexion va Žchouer. </entry> <entry></entry> </row> </tbody> </tgroup> </table> </para> <note> <simpara> Comme <literal>ssl://</literal> est le mode de transport sous-jaent de <link linkend="wrappers.http"><literal>https://</literal></link> et <link linkend="wrappers.ftp"><literal>ftps://</literal></link>, toutes les options de contexte qui s'applique ˆ <literal>ssl://</literal>, s'appliquent aussi ˆ <literal>https://</literal> et <literal>ftps://</literal>. </simpara> </note> </section> <section id="transports.unix"> <title>Domaine Unix : UNIX et UDG</title> <simpara> <literal>unix://</literal> depuis &php; 3, <literal>udg://</literal> depuis &php; 5 </simpara> <itemizedlist> <listitem><simpara><literal>unix:///tmp/mysock</literal></simpara></listitem> <listitem><simpara><literal>udg:///tmp/mysock</literal></simpara></listitem> </itemizedlist> <simpara> <literal>unix://</literal> fournit l'accs ˆ un fl™t de type socket, sur un domaine Unix. <literal>udg://</literal> fournit un mode de transport alternatif, avec un protocole de datagrammes utilisateurs. </simpara> <simpara> Les sockets du domaine Unix, contrairement ˆ celle du domaine Internet, n'utilisent pas de numŽro de port. Dans ce cas, le paramtre de <function>fsockopen</function> <parameter>portno</parameter> doit valoir 0. </simpara> </section> </appendix> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/appendices/wrappers.xml +++ phpdoc-fr/appendices/wrappers.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <appendix id="wrappers"> <title>Liste des protocoles support&eacute;s</title> <para> Cette section recense une liste de protocole g&eacute;rant des URL, qui sont int&eacute;gr&eacute;s dans les fonctions ayant acc&egrave;s aux fichiers, dans PHP. Par exemple, les fonctions <function>fopen</function> et <function>copy</function>. Ces fonctionnalit&eacute;s sont compil&eacute;es comme des pilotes externes, et &agrave; partir de PHP 4.3.0, vous pouvez cr&eacute;er vos propres pilotes, avec la fonction <function>stream_register_wrapper</function>. </para> <section id="wrappers.http"> <title>HTTP et HTTPS</title> <simpara>PHP 3, PHP 4. <filename>https://</filename> depuis PHP 4.3</simpara> <itemizedlist> <listitem><simpara><filename>http://exemple.com</filename></simpara></listitem> <listitem><simpara><filename>http://utilisateur:motdepasse@exemple.com</filename></simpara></listitem> <listitem><simpara><filename>https://exemple.com</filename></simpara></listitem> <listitem><simpara><filename>https://utilisateur:motdepasse@exemple.com</filename></simpara></listitem> </itemizedlist> <simpara> Permet des acc&egrave;s en lecture uniquement, pour des fichiers accessibles sur le r&eacute;seau avec la m&eacute;thode GET de HTTP 1.0. Un ent&ecirc;te <literal>Host:</literal> est envoy&eacute; avec la requ&ecirc;te, pour g&eacute;rer les h&ocirc;tes virtuels, bas&eacute;s sur des noms. Si vous avez configur&eacute; une version de navigateur avec l'option <link linkend="ini.user-agent">user_agent</link> dans votre fichier &php.ini;, ou via le contexte de fl&ocirc;t, il sera aussi utilis&eacute; dans votre requ&ecirc;te. </simpara> <simpara> Les redirections sont support&eacute;es depuis PHP 4.0.5; si vous utilisez une version plus ancienne, vous devrez ajouter vous m&ecirc;me les slash finaux dans vos URL. </simpara> <simpara> Le fl&ocirc;t donne l'acc&egrave;s au corps (<emphasis>body</emphasis>) de la ressource. Les ent&ecirc;tes sont stock&eacute;s dans la variable <varname>$http_response_header</varname>. Depuis PHP 4.3.0, les ent&ecirc;tes sont aussi accessibles avec la fonction <function>stream_get_meta_data</function>. </simpara> <simpara> Les connexions HTTP sont en lecture seule. Vous ne pouvez pas &eacute;crire dans des fichiers ouverts via le protocole HTTP. </simpara> <note> <simpara>HTTPS est support&eacute; depuis PHP 4.3, si vous avez compil&eacute; le support d'OpenSSL. </simpara> </note> </section> <section id="wrappers.ftp"> <title>FTP and FTPS</title> <simpara>PHP 3, PHP 4. <filename>ftps://</filename> depuis PHP 4.3</simpara> <itemizedlist> <listitem><simpara><filename>ftp://example.com/pub/file.txt</filename></simpara></listitem> <listitem><simpara><filename>ftp://user:password@example.com/pub/file.txt</filename></simpara></listitem> <listitem><simpara><filename>ftps://example.com/pub/file.txt</filename></simpara></listitem> <listitem><simpara><filename>ftps://user:password@example.com/pub/file.txt</filename></simpara></listitem> </itemizedlist> <simpara> Permet l'acc&egrave;s aux fichiers existants, et la cr&eacute;ation de fichiers via FTP. Si le serveur ne supporte pas les connexions en mode passif, la connexion &eacute;chouera. </simpara> <simpara> Vous pouvez ouvrir des fichiers en lecture et en &eacute;criture, mais pas les deux en m&ecirc;me temps. Si le fichier distant existe d&eacute;j&agrave; sur le serveur FTP, vous pourrez essayer de l'ouvrir en &eacute;criture, mais la connexion &eacute;chouera. Si vous devez modifier un fichier qui existe d&eacute;j&agrave;, utilisez <function>ftp_connect</function>. </simpara> <simpara> <filename>ftps://</filename> a &eacute;t&eacute; introduit en PHP 4.3. C'est le m&ecirc;me que <filename>ftp://</filename>, mais il tente d'&eacute;tablir une connexion s&eacute;curis&eacute;e avec le serveur FTP. Si le serveur ne le supporte pas, la connexion sera une connexion non s&eacute;curis&eacute;e. </simpara> <note> <simpara> FTPS est support&eacute; depuis PHP 4.3.0, si vous avez compil&eacute; le support d'OpenSSL. </simpara> </note> </section> <section id="wrappers.php"> <title>Fl&ocirc;ts d'entr&eacute;e/sortie</title> <simpara> PHP 3.0.13 et plus r&eacute;scent, <filename>php://output</filename> et <filename>php://input</filename> depuis PHP 4.3 </simpara> <itemizedlist> <listitem><simpara><filename>php://stdin</filename></simpara></listitem> <listitem><simpara><filename>php://stdout</filename></simpara></listitem> <listitem><simpara><filename>php://stderr</filename></simpara></listitem> <listitem><simpara><filename>php://output</filename></simpara></listitem> <listitem><simpara><filename>php://input</filename></simpara></listitem> </itemizedlist> <simpara> <filename>php://stdin</filename>, <filename>php://stdout</filename> et <filename>php://stderr</filename> donne acc&egrave;s au fl&ocirc;t correspondant d'entr&eacute;e ou de sortie du processus PHP. </simpara> <simpara> <filename>php://output</filename> vous permet d'&eacute;crire dans le buffer de sortie, de la m&ecirc;me mani&egrave;re que <function>print</function> et <function>echo</function>. </simpara> <simpara> <filename>php://input</filename> permet de lire des donn&eacute;es POST bruts. C'est moins gourmand en m&eacute;moire que <varname>$HTTP_RAW_POST_DATA</varname> et il n'y a pas de directive sp&eacute;ciale dans &php.ini;. </simpara> <simpara> <filename>php://stdin</filename> et <filename>php://input</filename> sont lecture seule, tandis que <filename>php://stdout</filename>, <filename>php://stderr</filename> et <filename>php://output</filename> sont en &eacute;criture seule. </simpara> <simpara> <filename>php://filter</filename> est une sorte de m&eacute;ta-gestionnaire, pr&eacute;vu pour qui permet l'utilisation de filtre avec les donn&eacute;es d'entr&eacute;e au moment du d&eacute;marrage du script. C'est pratique avec des fonctions compactes comme <function>readfile</function>, <function>file</function> et <function>file_get_contents</function> o&ugrave; il n'y a pas d'opportunit&eacute; d'appliquer un filtre aux donn&eacute;es lues. </simpara> <simpara> Le gestionaire de <filename>php://filter</filename> prend les param&egrave;tres suivants dans le chemin. </simpara> <itemizedlist> <listitem> <para> <literal>/resource=&lt;fl&ocirc;t &agrave; filtrer&gt;</literal> (<emphasis>obligatoire</emphasis>) Ce param&egrave;tre doit &ecirc;tre situ&eacute; &agrave; la fin de votre cha&icirc;ne <filename>php://filter</filename> et doit pointer sur le fl&ocirc;t &agrave; filtrer. <informalexample> <programlisting role="php"> <![CDATA[ <?php /* Ceci est l'&eacute;quivalent de : readfile("http://www.example.com"); puisqu'aucun filtre n'est sp&eacute;cifi&eacute; */ readfile("php://filter/resource=http://www.exemple.com"); ?> ]]> </programlisting> </informalexample> </para> </listitem> <listitem> <para> <literal>/read=&lt;liste de filtres de la cha&icirc;ne de lecture&gt;</literal> (<emphasis>optionnel</emphasis>) Ce param&egrave;tre prend un ou plusieurs noms de filtres, s&eacute;par&eacute;s par le caract&egrave;re pipe <literal>|</literal>. <informalexample> <programlisting role="php"> <![CDATA[ <?php /* Cette ligne va afficher le contenu de www.exemple.com tout en majuscule */ readfile("php://filter/read=string.toupper/resource=http://www.exemple.com"); /* Cela va faire la m&ecirc;me chose que ci-dessus, mais en plus, le r&eacute;sultat sera chiffr&eacute; en ROT13 */ readfile("php://filter/read=string.toupper|string.rot13/resource=http://www.exemple.com"); ?> ]]> </programlisting> </informalexample> </para> </listitem> <listitem> <para> <literal>/write=&lt;liste de filtres de la cha&icirc;ne d'&eacute;criture&gt;</literal> (<emphasis>optionnel</emphasis>) Ce param&egrave;tre prend un ou plusieurs noms de filtres, s&eacute;par&eacute;s par le caract&egrave;re pipe <literal>|</literal>. <informalexample> <programlisting role="php"> <![CDATA[ <?php /* Cette ligne va filtrer la cha&icirc;ne "Bonjour le monde" avec le filtre rot13, puis &eacute;crire le r&eacute;sultat dans le fichier exemple.txt du dossier courant */ file_set_contents("php://filter/write=string.rot13/resource=exemple.txt","Bonjour le monde"); ?> ]]> </programlisting> </informalexample> </para> </listitem> <listitem> <simpara> <literal>/&lt;liste de filtres des deux cha&icirc;nes&gt;</literal> (<emphasis>optionnel</emphasis>) Tous les filtres qui ne sont pas pr&eacute;fix&eacute; avec <literal>read=</literal> ou <literal>write=</literal> seront appliqu&eacute; aux deux cha&icirc;nes de filtres, en lecture et en &eacute;criture. </simpara> </listitem> </itemizedlist> </section> <section id="wrappers.compression"> <title>Fl&ocirc;ts compress&eacute;s</title> <simpara><filename>zlib:</filename> PHP 4.0.4 - PHP 4.2.3 (syst&egrave;mes avec fopencookie uniquement)</simpara> <simpara><filename>compress.zlib://</filename> et <filename>compress.bzip2://</filename> depuis PHP 4.3.0 et plus r&eacute;cent.</simpara> <itemizedlist> <listitem><simpara><filename>zlib:</filename></simpara></listitem> <listitem><simpara><filename>compress.zlib://</filename></simpara></listitem> <listitem><simpara><filename>compress.bzip2://</filename></simpara></listitem> </itemizedlist> <simpara> <filename>zlib:</filename> fonctionne comme <function>gzopen</function>, hormis le fait que le fl&ocirc;t peut &ecirc;tre utilis&eacute; directement avec <function>fread</function> et les autres fonctions de syst&egrave;me de fichier. Cette notation est obsol&egrave;te depuis PHP 4.3.0, &eacute;tant donn&eacute;es les ambiguit&eacute;s dues aux noms de fichiers contenant des deux points ':'. Utilisez plut&ocirc;t <filename>compress.zlib://</filename>. </simpara> <simpara> <filename>compress.zlib://</filename> et <filename>compress.bzip2://</filename> sont &eacute;quivalents &agrave; <function>gzopen</function> et <function>bzopen</function> respectivement, et ils op&egrave;rent m&ecirc;me sur les syst&egrave;mes qui ne supportent pas fopencookie. </simpara> </section> </appendix> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
« previous php.doc.fr (#319) next »