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: | Damien Seguy | 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 à dire Interface de Programmation d'Applications Serveur) appelé + <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), écrites en PHP. Il y a pas mal de + différences enter le type <literal>CLI SAPI</literal> et les autres + <literal>SAPI</literal>, qui sont expliqués dans ce chapitre. + </para> + <para> + Le <literal>CLI SAPI</literal> a été publié puor la première fois avec + la version <literal>PHP 4.2.0</literal>, mais il est resté expérimental, + et doit être explicitement activé avec la commande <literal>--enable-cli</literal>, + lorsque vous exécutez le script <literal>./configure</literal>. Depuis + PHP 4.3.0, le <literal>CLI SAPI</literal> n'est plus expérimental, et + est donc <emphasis role="strong">toujours</emphasis> compilé et + installé comme binaire PHP (appelé aussi <filename>php.exe</filename> sous + Windows). + </para> + <para> + Les diffé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ête HTTP n'est écrits + dans le résultat. + </para> + <para> + Bien que le <literal>CGI SAPI</literal> fournisse un moyen de supprimer les + entêtes HTTP, il n'y a pas moyen d'activer les entêtes HTTP dans le + <literal>CLI SAPI</literal>. + </para> + </listitem> + <listitem> + <para> + Il y a plusieurs directives du &php.ini; qui sont ignorées par le + <literal>CLI SAPI</literal>, car elles n'ont pas de sens, en environnement + shell : + <table> + <title>Directives &php.ini; ignorées</title> + <tgroup cols="3"> + <thead> + <row> + <entry>Directive</entry> + <entry>Valeur par dé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 être bien difficile de lire les messages d'erreur sur un terminal + lorsqu'ils sont noyés dans des balises HTML sans grand intérêts. Par + conséquent, cette directive est forcée à &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édiatement affiché dans le terminal, et non pas placé 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é les possibilités infinies de PHP en + environnement shell, le temps d'exécution maximal d'un + script PHP a été rendu illimité. + Alors que les scripts destinés au web doivent s'accomplir en une + fraction de seconde, il arrive que les scripts shell requiè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; à cette directive, vous aurez toujours + accès à la variable <emphasis>argc</emphasis> (représentant le nombre + d'arguments passés à l'application) et + <emphasis>argv</emphasis> (le tableau contenant les arguments passé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éfinies et remplies avec les valeurs + appropriées, en utilisant <literal>CLI SAPI</literal>. Avant cette version, + la création de ces variables était liée au comportement des versions + <literal>CGI</literal> et <literal>MODULE</literal>, qui requièrent l'activation + de la directive &php; + <link linkend="ini.register-globals">register_globals</link>. + Indépendamment de la version ou de la valeur de register_globals, + vous pouvez toujour accéder à + <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 être initialisées avec d'autres valeurs + dans le fichier &php.ini; ou par une autre méthode. C'est une limitation, + car ces valeurs par défaut s'appliquent une fois que tous les autres + fichiers de configuration ont été analysés. Cependant, ces + valeurs peuvent être modifiées durant l'exé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éfinies : + <table> + <title>Constantes spécifiques au CLI</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Constante</entry> + <entry>Déscription</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>STDIN</constant></entry> + <entry> + Un descripteur de fichier déjà disponible vers <literal>stdin</literal>. + Cela é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éjà disponible vers <literal>stdout</literal>. + Cela é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éjà disponible vers + <literal>stderr</literal>. Cela évite de l'ouvrir avec + <programlisting role="php"> +<![CDATA[ +$stderr = fopen('php://stderr', 'w'); +]]> + </programlisting> + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + Etant donné ce qui précède, vous n'avez pas besoin d'ouvrir un fichier + vers <literal>stderr</literal> par vous-mê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 à 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écution du script! + </para> + <para> + Exemple de différence entre <literal>CGI SAPI</literal> et <literal>CLI SAPI</literal>: + <programlisting role="php"> +<![CDATA[ +<?php + /* Un test simple : affiche le dossier d'exécution */ + echo getcwd(), "\n"; +?> +]]> + </programlisting> + </para> + <para> + Lorsque vous utilisez la version <literal>CGI</literal>, l'affichage pourra ê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écuté. + </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édigez des + scripts shell avec &php;. + </para> + <note> + <para> + <literal>CGI SAPI</literal> supporte le mê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é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écuter : + <orderedlist> + <listitem> + <para> + Indiquer à &php; d'exécuter un fichier : + </para> + <para> + <screen> +<![CDATA[ +php mon_script.php + +php -f mon_script.php +]]> + </screen> + Les deux méthodes (en utilisant <literal>-f</literal> ou pas) exé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; à exécuter directement en ligne de commande. + </para> + <para> + <screen> +<![CDATA[ +php -r 'print_r(get_defined_constants());' +]]> + </screen> + Une attention particulière doit alors être apportée aux variables d'environnement, + qui seront remplacées, et aux guillements, qui ont des significations spé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 à une erreur d'analyse. + </para> + </note> + </listitem> + <listitem> + <para> + Donner du code &php; dans l'entrée standard + (<literal>stdin</literal>). + </para> + <para> + Cela donne la possibilité de créer dynamiquement du code + &php;, puis de le fournir à PHP, et enfin, + de le traiter à 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écution. + </para> + <para> + Comme toute application shell, l'exécutable &php; accepte + des arguments, et votre script peut aussi les recevoirs. Le nombre d'arguments + n'est pas limité par PHP, mais par le shell, qui a une limite en terme + de nombre de caractères qui peuvent être passés. Généralement, vous n'atteidrez + pas cette limite, mais cela reste possible. Les arguments passés au script seront + transmis via la variable tableau <literal>$argv</literal>. L,index zéro + contiendra toujours le nom du script appelé. Si le code a été fourni en ligne + de commande, ou via <literal>stdin</literal>, ce premier élément vaudra + <literal>-</literal>. L'autre variable globale fournie est + <literal>$argc</literal> qui contient le nombre d'éléments dans le tableau + <literal>$argv</literal> : ce nombre est <emphasis role="strong">différent</emphasis> + du nombre d'arguments passés au script. + </para> + <para> + Tant que les arguments que vous passez à votre script ne commencent pas par + le caractère <literal>-</literal>, il n'y a rien de spécial à surveiller. + Si vous passez des arguments à voter script qui commencent par + <literal>-</literal>, cela posera des problèmes car &php; + va penser qu'il doit les interpréter. Pour éviter cela, utilisez le séparateur + <literal>--</literal>. Après cet argument, tous les arguments suivants seront + passés à votre script sans être modifié ou analysé par PHP. + </para> + <screen> +<![CDATA[ +# Cela ne va pas exé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' à votre script, et é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éthode pour utiliser PHP en script shell. + Vous pouvez aussi utiliser la ligne <literal>#!/usr/bin/php</literal> + en tout début de votre script, suivi de code PHP compris entre + balise ouvrantes/fermantes. Vous pouvez aussi ajouter après + <literal>#!/usr/bin/php</literal> les options nécessaires. Vous + pouvez aussi le faire en ligne de commande. + De cette manière, le script peut être exécuté 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écaution n'est nécessaire pour passer des + paramètres qui commencent par <literal>-</literal> à 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écanisme interne pour analyser le fichier, + et produire une version colorisée du code source, au format HTML. + Notez que cette option ne fait que générer un bloc + <literal>HTML</literal>, sans les entêtes. + <literal><code> [...] </code></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écute le fichier donné après l'option <literal>-f</literal>. + Cette optione est optionnelle, et peut ê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écifier le nom du dossier dans lequel + PHP va recherche le fichier &php.ini;, ou encore vous pouvez + spécifier un fichier de configuration directement (qui n'a pas + obligatoirement à être appelé &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écute PHP de maniè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 à 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 à 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ée après le caractè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énére des informations étendues pour le profilage et le dé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éfaut + des librairie sur votre système (généralement spécifié 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 à 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érification syntaxique sur le code + PHP fourni. En cas de réussite, le message + <literal>No syntax errors detected in <filename></literal> + (<literal>Aucune d'erreur de syntaxe n'ont été détectées dans <nom_de_fichier></literal> + est affiché sur la sortie standard, et le script shell retourne + <literal>0</literal>. En cas d'erreur, le message + <literal>Errors parsing <filename></literal> + (<literal>Erreurs d'analyse dans le fichier <filename></literal>) + est affiché, en plus des messages d'erreurs détectés par l'analyseur + lui même. Le script shell retourne le code <literal>255</literal>. + </para> + <para> + Cette option ne détecte pas les erreurs fatales (comme par exemple les + fonctions non dé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ées et chargé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ésultat. Si &php; ne fonctionne pas + correctement, il est recommandé d'utiliser la commande <literal>php -i</literal> + et de voir si il n'y a pas d'erreurs affichées avant ou après la + table d'information. N'oubliez pas que le ré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écution de &php; directement + dans la ligne de commande. Les balises de &php; + (<literal><?php</literal> et <literal>?></literal>) + <emphasis role="strong">ne sont pas</emphasis> demandées, et coauseront + une erreur d'analyse. + </para> + <note> + <para> + De l'attention doit être porté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éalisées par le + shell. + </para> + <para> + Exemple conduisant à une erreur d'analyse : + <screen> +<![CDATA[ +$ php -r "$foo = get_defined_constants();" +Command line code(1) : Parse error - parse error, unexpected '=' +]]> + </screen> + Le problème ici est que le shell (sh/bash) effectue une substitution + de variables, grâce aux guillemets doubles <literal>"</literal>. + puisque la variable <literal>$foo</literal> n'est probablement pas + définie dans le shell, elle est remplacée par rien, ce qui fait + que le code passé à PHP pour l'exécution est : + <screen> +<![CDATA[ +$ php -r " = get_defined_constants();" +]]> + </screen> + La solution de ce problème est d'utiliser les guillemets simples + <literal>'</literal>. Les variables de ces chaînes ne seront pas + substitué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érent de sh/bash, vous pouvez + rencontrer d'autres problèmes. N'hésitez pas à ouvrir un + rapport de bugs, ou d'envoyer un mail à + phpdoc@lists.php.net. + + Il est toujours très facile d'avoir des problèmes lorsque vous essayez + d'inclure des variables shell dans le code, ou d'utiliser les anti-slash + pour l'échappement. Vous aurez été prévenu. + <!-- :-) --> + </para> + </note> + </entry> + </row> + <row> + <entry>-h</entry> + <entry> + Avec cette option, vous pouvez obtenir des informations sur la liste des + options supporté 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 > 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écutable PHP peut être utilisé pour exécuter des scripts indépendants du + serveur web. Si vous êtes sur un système Unix, il est recommandé d'ajouter + la ligne de configuration en début de scripts, de le rendre exécutable de + manière à ce que le système sache quel programme doit exécuter le script. + Sous Windows, vous pouvez associer l'exé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écuter le script grâce + à PHP. La première ligne utilisé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évu pour être exécuté 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 à une option. + + Utilisation : + <?php echo $argv[0]; ?> <option> + + <option> peut ê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ère ligne pour indiquer + que le fichier doit être exécuté par PHP. Nous travaillons avec une version + CLI, donc il n'y a pas d'entêtes HTTP qui soient affiché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ère + est le nombre d'arguments plus un (le nom du script qui est + exécuté). La seconde est un tableau contenant les arguments, commençant + avec le nom du script en élément 0 (<varname>$argv[0]</varname>). + </para> + <para> + Dans notre exemple, nous avnos vérifié 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é un message d'aide, ainsi que le nom du + script. Nous nous recevons un autre argument, cet argument est affiché + dans le terminal. + </para> + <para> + Pour exécuter le script ci-dessus sous Unix, vous devez le rendre + exécué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é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é le programme ci-dessus + <filename>script.php</filename>, et que vous avez votre exécutable + <filename>php.exe</filename> situé à + <filename>c:\php\php.exe</filename>, ce fichier batch l'exé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éliorer la convivialité + 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 à PHP 4.0</title> <sect1 id="migration4.changes"> @@ -128,7 +128,7 @@ <simpara> Les valeurs Standard ne peuvent pas contrô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écurité du &safemode;. + &htaccess;, cela annulerait toute la sécurité 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éable, PHP 4.0 est distribué 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ême. @@ -159,7 +159,7 @@ <filename>httpd.conf.orig</filename>. </simpara> <para> - Pour convertir vos fichiers <filename>.htaccess</filename>, exécutez + Pour convertir vos fichiers &htaccess;, exé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ême façon, votre vieux fichier <filename>.htaccess</filename> + De la même façon, votre vieux fichier &htaccess; sera sauvé 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éveloppement PHP</title> <sect1 id="phpdevel-addfunc"> @@ -740,7 +740,7 @@ restrictions RSRC_CONF sont des directives qui ne peuvent être disponibles que dans le fichier de configuration Apache. Toutes les directives OR_OPTIONS peuvent être placées n'importe - où, y compris dans un fichier <filename>.htaccess</filename>. + où, 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éservés en PHP</title> <para> @@ -490,7 +490,7 @@ Votre serveur web doit être configuré pour cré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édéfinies de zend</refname> <refpurpose>Constants définies dans le coeur de PHP, Zend et les modules SAPI</refpurpose> </refnamediv> <refsect1> <title>Description</title> <simpara> Ces constantes sont dé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édéfinies</refname> <refpurpose>Constantes standards dans PHP</refpurpose> </refnamediv> <refsect1> <title>Description</title> <simpara> Ces constantes sont définies par dé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édé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 diffrents modes de transports, format URL, dont &php; dispose en interne pour les flts 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 connatre la liste des modes de transports installs 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> & <literal>tls://</literal> depuis PHP 4.3. </simpara> <note> <simpara> Si aucun transport n'est spcifi, <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 numro de port en plus de l'adresse de l'hte. Dans le cas de <function>fsockopen</function>, il est spcifi en deuxime paramtre, 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 mme famille, le numro de port est spcifi 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 numro de port</title> <simpara> Dans le second exemple ci-dessus, les exemples en IPv4 et les noms d'htes sont identiques, mais les IPv6 sont places entre crochet, en plus d'avoir le deux-points et le numro de port : <literal>[fe80::1]</literal>. Cela permet de distinguer les deux-points utiliss en IPv6 et le deux-points utilis pour dlimiter le numro 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 dfaut</entry> </row> </thead> <tbody> <row> <entry><literal>verify_peer</literal></entry> <entry> &true; ou &false;. Requiert la vrification 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-signs. </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 spcifi, 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 prive. Il peut ventuellement contenir la chane 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 limits. 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-jaent 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'accs un flt 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 numro de port. Dans ce cas, le paramtre 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és</title> <para> Cette section recense une liste de protocole gérant des URL, qui sont intégrés dans les fonctions ayant accès aux fichiers, dans PHP. Par exemple, les fonctions <function>fopen</function> et <function>copy</function>. Ces fonctionnalités sont compilées comme des pilotes externes, et à partir de PHP 4.3.0, vous pouvez cré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ès en lecture uniquement, pour des fichiers accessibles sur le réseau avec la méthode GET de HTTP 1.0. Un entête <literal>Host:</literal> est envoyé avec la requête, pour gérer les hôtes virtuels, basés sur des noms. Si vous avez configuré 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ôt, il sera aussi utilisé dans votre requête. </simpara> <simpara> Les redirections sont supportées depuis PHP 4.0.5; si vous utilisez une version plus ancienne, vous devrez ajouter vous même les slash finaux dans vos URL. </simpara> <simpara> Le flôt donne l'accès au corps (<emphasis>body</emphasis>) de la ressource. Les entêtes sont stockés dans la variable <varname>$http_response_header</varname>. Depuis PHP 4.3.0, les entê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 écrire dans des fichiers ouverts via le protocole HTTP. </simpara> <note> <simpara>HTTPS est supporté depuis PHP 4.3, si vous avez compilé 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ès aux fichiers existants, et la création de fichiers via FTP. Si le serveur ne supporte pas les connexions en mode passif, la connexion échouera. </simpara> <simpara> Vous pouvez ouvrir des fichiers en lecture et en écriture, mais pas les deux en même temps. Si le fichier distant existe déjà sur le serveur FTP, vous pourrez essayer de l'ouvrir en écriture, mais la connexion échouera. Si vous devez modifier un fichier qui existe déjà, utilisez <function>ftp_connect</function>. </simpara> <simpara> <filename>ftps://</filename> a été introduit en PHP 4.3. C'est le même que <filename>ftp://</filename>, mais il tente d'établir une connexion sécurisée avec le serveur FTP. Si le serveur ne le supporte pas, la connexion sera une connexion non sécurisée. </simpara> <note> <simpara> FTPS est supporté depuis PHP 4.3.0, si vous avez compilé le support d'OpenSSL. </simpara> </note> </section> <section id="wrappers.php"> <title>Flôts d'entrée/sortie</title> <simpara> PHP 3.0.13 et plus ré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ès au flôt correspondant d'entrée ou de sortie du processus PHP. </simpara> <simpara> <filename>php://output</filename> vous permet d'écrire dans le buffer de sortie, de la même manière que <function>print</function> et <function>echo</function>. </simpara> <simpara> <filename>php://input</filename> permet de lire des données POST bruts. C'est moins gourmand en mémoire que <varname>$HTTP_RAW_POST_DATA</varname> et il n'y a pas de directive spé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 écriture seule. </simpara> <simpara> <filename>php://filter</filename> est une sorte de méta-gestionnaire, prévu pour qui permet l'utilisation de filtre avec les données d'entrée au moment du démarrage du script. C'est pratique avec des fonctions compactes comme <function>readfile</function>, <function>file</function> et <function>file_get_contents</function> où il n'y a pas d'opportunité d'appliquer un filtre aux données lues. </simpara> <simpara> Le gestionaire de <filename>php://filter</filename> prend les paramètres suivants dans le chemin. </simpara> <itemizedlist> <listitem> <para> <literal>/resource=<flôt à filtrer></literal> (<emphasis>obligatoire</emphasis>) Ce paramètre doit être situé à la fin de votre chaîne <filename>php://filter</filename> et doit pointer sur le flôt à filtrer. <informalexample> <programlisting role="php"> <![CDATA[ <?php /* Ceci est l'équivalent de : readfile("http://www.example.com"); puisqu'aucun filtre n'est spécifié */ readfile("php://filter/resource=http://www.exemple.com"); ?> ]]> </programlisting> </informalexample> </para> </listitem> <listitem> <para> <literal>/read=<liste de filtres de la chaîne de lecture></literal> (<emphasis>optionnel</emphasis>) Ce paramètre prend un ou plusieurs noms de filtres, séparés par le caractè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ême chose que ci-dessus, mais en plus, le résultat sera chiffré en ROT13 */ readfile("php://filter/read=string.toupper|string.rot13/resource=http://www.exemple.com"); ?> ]]> </programlisting> </informalexample> </para> </listitem> <listitem> <para> <literal>/write=<liste de filtres de la chaîne d'écriture></literal> (<emphasis>optionnel</emphasis>) Ce paramètre prend un ou plusieurs noms de filtres, séparés par le caractère pipe <literal>|</literal>. <informalexample> <programlisting role="php"> <![CDATA[ <?php /* Cette ligne va filtrer la chaîne "Bonjour le monde" avec le filtre rot13, puis écrire le ré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>/<liste de filtres des deux chaînes></literal> (<emphasis>optionnel</emphasis>) Tous les filtres qui ne sont pas préfixé avec <literal>read=</literal> ou <literal>write=</literal> seront appliqué aux deux chaînes de filtres, en lecture et en écriture. </simpara> </listitem> </itemizedlist> </section> <section id="wrappers.compression"> <title>Flôts compressés</title> <simpara><filename>zlib:</filename> PHP 4.0.4 - PHP 4.2.3 (systèmes avec fopencookie uniquement)</simpara> <simpara><filename>compress.zlib://</filename> et <filename>compress.bzip2://</filename> depuis PHP 4.3.0 et plus ré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ôt peut être utilisé directement avec <function>fread</function> et les autres fonctions de système de fichier. Cette notation est obsolète depuis PHP 4.3.0, étant données les ambiguités dues aux noms de fichiers contenant des deux points ':'. Utilisez plutôt <filename>compress.zlib://</filename>. </simpara> <simpara> <filename>compress.zlib://</filename> et <filename>compress.bzip2://</filename> sont équivalents à <function>gzopen</function> et <function>bzopen</function> respectivement, et ils opèrent même sur les systè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 -->
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 à dire Interface de Programmation d'Applications Serveur) appelé + <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), écrites en PHP. Il y a pas mal de + différences enter le type <literal>CLI SAPI</literal> et les autres + <literal>SAPI</literal>, qui sont expliqués dans ce chapitre. + </para> + <para> + Le <literal>CLI SAPI</literal> a été publié puor la première fois avec + la version <literal>PHP 4.2.0</literal>, mais il est resté expérimental, + et doit être explicitement activé avec la commande <literal>--enable-cli</literal>, + lorsque vous exécutez le script <literal>./configure</literal>. Depuis + PHP 4.3.0, le <literal>CLI SAPI</literal> n'est plus expérimental, et + est donc <emphasis role="strong">toujours</emphasis> compilé et + installé comme binaire PHP (appelé aussi <filename>php.exe</filename> sous + Windows). + </para> + <para> + Les diffé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ête HTTP n'est écrits + dans le résultat. + </para> + <para> + Bien que le <literal>CGI SAPI</literal> fournisse un moyen de supprimer les + entêtes HTTP, il n'y a pas moyen d'activer les entêtes HTTP dans le + <literal>CLI SAPI</literal>. + </para> + </listitem> + <listitem> + <para> + Il y a plusieurs directives du &php.ini; qui sont ignorées par le + <literal>CLI SAPI</literal>, car elles n'ont pas de sens, en environnement + shell : + <table> + <title>Directives &php.ini; ignorées</title> + <tgroup cols="3"> + <thead> + <row> + <entry>Directive</entry> + <entry>Valeur par dé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 être bien difficile de lire les messages d'erreur sur un terminal + lorsqu'ils sont noyés dans des balises HTML sans grand intérêts. Par + conséquent, cette directive est forcée à &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édiatement affiché dans le terminal, et non pas placé 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é les possibilités infinies de PHP en + environnement shell, le temps d'exécution maximal d'un + script PHP a été rendu illimité. + Alors que les scripts destinés au web doivent s'accomplir en une + fraction de seconde, il arrive que les scripts shell requiè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; à cette directive, vous aurez toujours + accès à la variable <emphasis>argc</emphasis> (représentant le nombre + d'arguments passés à l'application) et + <emphasis>argv</emphasis> (le tableau contenant les arguments passé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éfinies et remplies avec les valeurs + appropriées, en utilisant <literal>CLI SAPI</literal>. Avant cette version, + la création de ces variables était liée au comportement des versions + <literal>CGI</literal> et <literal>MODULE</literal>, qui requièrent l'activation + de la directive &php; + <link linkend="ini.register-globals">register_globals</link>. + Indépendamment de la version ou de la valeur de register_globals, + vous pouvez toujour accéder à + <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 être initialisées avec d'autres valeurs + dans le fichier &php.ini; ou par une autre méthode. C'est une limitation, + car ces valeurs par défaut s'appliquent une fois que tous les autres + fichiers de configuration ont été analysés. Cependant, ces + valeurs peuvent être modifiées durant l'exé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éfinies : + <table> + <title>Constantes spécifiques au CLI</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Constante</entry> + <entry>Déscription</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>STDIN</constant></entry> + <entry> + Un descripteur de fichier déjà disponible vers <literal>stdin</literal>. + Cela é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éjà disponible vers <literal>stdout</literal>. + Cela é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éjà disponible vers + <literal>stderr</literal>. Cela évite de l'ouvrir avec + <programlisting role="php"> +<![CDATA[ +$stderr = fopen('php://stderr', 'w'); +]]> + </programlisting> + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + Etant donné ce qui précède, vous n'avez pas besoin d'ouvrir un fichier + vers <literal>stderr</literal> par vous-mê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 à 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écution du script! + </para> + <para> + Exemple de différence entre <literal>CGI SAPI</literal> et <literal>CLI SAPI</literal>: + <programlisting role="php"> +<![CDATA[ +<?php + /* Un test simple : affiche le dossier d'exécution */ + echo getcwd(), "\n"; +?> +]]> + </programlisting> + </para> + <para> + Lorsque vous utilisez la version <literal>CGI</literal>, l'affichage pourra ê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écuté. + </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édigez des + scripts shell avec &php;. + </para> + <note> + <para> + <literal>CGI SAPI</literal> supporte le mê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é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écuter : + <orderedlist> + <listitem> + <para> + Indiquer à &php; d'exécuter un fichier : + </para> + <para> + <screen> +<![CDATA[ +php mon_script.php + +php -f mon_script.php +]]> + </screen> + Les deux méthodes (en utilisant <literal>-f</literal> ou pas) exé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; à exécuter directement en ligne de commande. + </para> + <para> + <screen> +<![CDATA[ +php -r 'print_r(get_defined_constants());' +]]> + </screen> + Une attention particulière doit alors être apportée aux variables d'environnement, + qui seront remplacées, et aux guillements, qui ont des significations spé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 à une erreur d'analyse. + </para> + </note> + </listitem> + <listitem> + <para> + Donner du code &php; dans l'entrée standard + (<literal>stdin</literal>). + </para> + <para> + Cela donne la possibilité de créer dynamiquement du code + &php;, puis de le fournir à PHP, et enfin, + de le traiter à 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écution. + </para> + <para> + Comme toute application shell, l'exécutable &php; accepte + des arguments, et votre script peut aussi les recevoirs. Le nombre d'arguments + n'est pas limité par PHP, mais par le shell, qui a une limite en terme + de nombre de caractères qui peuvent être passés. Généralement, vous n'atteidrez + pas cette limite, mais cela reste possible. Les arguments passés au script seront + transmis via la variable tableau <literal>$argv</literal>. L,index zéro + contiendra toujours le nom du script appelé. Si le code a été fourni en ligne + de commande, ou via <literal>stdin</literal>, ce premier élément vaudra + <literal>-</literal>. L'autre variable globale fournie est + <literal>$argc</literal> qui contient le nombre d'éléments dans le tableau + <literal>$argv</literal> : ce nombre est <emphasis role="strong">différent</emphasis> + du nombre d'arguments passés au script. + </para> + <para> + Tant que les arguments que vous passez à votre script ne commencent pas par + le caractère <literal>-</literal>, il n'y a rien de spécial à surveiller. + Si vous passez des arguments à voter script qui commencent par + <literal>-</literal>, cela posera des problèmes car &php; + va penser qu'il doit les interpréter. Pour éviter cela, utilisez le séparateur + <literal>--</literal>. Après cet argument, tous les arguments suivants seront + passés à votre script sans être modifié ou analysé par PHP. + </para> + <screen> +<![CDATA[ +# Cela ne va pas exé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' à votre script, et é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éthode pour utiliser PHP en script shell. + Vous pouvez aussi utiliser la ligne <literal>#!/usr/bin/php</literal> + en tout début de votre script, suivi de code PHP compris entre + balise ouvrantes/fermantes. Vous pouvez aussi ajouter après + <literal>#!/usr/bin/php</literal> les options nécessaires. Vous + pouvez aussi le faire en ligne de commande. + De cette manière, le script peut être exécuté 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écaution n'est nécessaire pour passer des + paramètres qui commencent par <literal>-</literal> à 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écanisme interne pour analyser le fichier, + et produire une version colorisée du code source, au format HTML. + Notez que cette option ne fait que générer un bloc + <literal>HTML</literal>, sans les entêtes. + <literal><code> [...] </code></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écute le fichier donné après l'option <literal>-f</literal>. + Cette optione est optionnelle, et peut ê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écifier le nom du dossier dans lequel + PHP va recherche le fichier &php.ini;, ou encore vous pouvez + spécifier un fichier de configuration directement (qui n'a pas + obligatoirement à être appelé &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écute PHP de maniè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 à 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 à 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ée après le caractè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énére des informations étendues pour le profilage et le dé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éfaut + des librairie sur votre système (généralement spécifié 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 à 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érification syntaxique sur le code + PHP fourni. En cas de réussite, le message + <literal>No syntax errors detected in <filename></literal> + (<literal>Aucune d'erreur de syntaxe n'ont été détectées dans <nom_de_fichier></literal> + est affiché sur la sortie standard, et le script shell retourne + <literal>0</literal>. En cas d'erreur, le message + <literal>Errors parsing <filename></literal> + (<literal>Erreurs d'analyse dans le fichier <filename></literal>) + est affiché, en plus des messages d'erreurs détectés par l'analyseur + lui même. Le script shell retourne le code <literal>255</literal>. + </para> + <para> + Cette option ne détecte pas les erreurs fatales (comme par exemple les + fonctions non dé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ées et chargé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ésultat. Si &php; ne fonctionne pas + correctement, il est recommandé d'utiliser la commande <literal>php -i</literal> + et de voir si il n'y a pas d'erreurs affichées avant ou après la + table d'information. N'oubliez pas que le ré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écution de &php; directement + dans la ligne de commande. Les balises de &php; + (<literal><?php</literal> et <literal>?></literal>) + <emphasis role="strong">ne sont pas</emphasis> demandées, et coauseront + une erreur d'analyse. + </para> + <note> + <para> + De l'attention doit être porté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éalisées par le + shell. + </para> + <para> + Exemple conduisant à une erreur d'analyse : + <screen> +<![CDATA[ +$ php -r "$foo = get_defined_constants();" +Command line code(1) : Parse error - parse error, unexpected '=' +]]> + </screen> + Le problème ici est que le shell (sh/bash) effectue une substitution + de variables, grâce aux guillemets doubles <literal>"</literal>. + puisque la variable <literal>$foo</literal> n'est probablement pas + définie dans le shell, elle est remplacée par rien, ce qui fait + que le code passé à PHP pour l'exécution est : + <screen> +<![CDATA[ +$ php -r " = get_defined_constants();" +]]> + </screen> + La solution de ce problème est d'utiliser les guillemets simples + <literal>'</literal>. Les variables de ces chaînes ne seront pas + substitué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érent de sh/bash, vous pouvez + rencontrer d'autres problèmes. N'hésitez pas à ouvrir un + rapport de bugs, ou d'envoyer un mail à + phpdoc@lists.php.net. + + Il est toujours très facile d'avoir des problèmes lorsque vous essayez + d'inclure des variables shell dans le code, ou d'utiliser les anti-slash + pour l'échappement. Vous aurez été prévenu. + <!-- :-) --> + </para> + </note> + </entry> + </row> + <row> + <entry>-h</entry> + <entry> + Avec cette option, vous pouvez obtenir des informations sur la liste des + options supporté 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 > 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écutable PHP peut être utilisé pour exécuter des scripts indépendants du + serveur web. Si vous êtes sur un système Unix, il est recommandé d'ajouter + la ligne de configuration en début de scripts, de le rendre exécutable de + manière à ce que le système sache quel programme doit exécuter le script. + Sous Windows, vous pouvez associer l'exé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écuter le script grâce + à PHP. La première ligne utilisé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évu pour être exécuté 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 à une option. + + Utilisation : + <?php echo $argv[0]; ?> <option> + + <option> peut ê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ère ligne pour indiquer + que le fichier doit être exécuté par PHP. Nous travaillons avec une version + CLI, donc il n'y a pas d'entêtes HTTP qui soient affiché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ère + est le nombre d'arguments plus un (le nom du script qui est + exécuté). La seconde est un tableau contenant les arguments, commençant + avec le nom du script en élément 0 (<varname>$argv[0]</varname>). + </para> + <para> + Dans notre exemple, nous avnos vérifié 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é un message d'aide, ainsi que le nom du + script. Nous nous recevons un autre argument, cet argument est affiché + dans le terminal. + </para> + <para> + Pour exécuter le script ci-dessus sous Unix, vous devez le rendre + exécué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é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é le programme ci-dessus + <filename>script.php</filename>, et que vous avez votre exécutable + <filename>php.exe</filename> situé à + <filename>c:\php\php.exe</filename>, ce fichier batch l'exé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éliorer la convivialité + 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 à PHP 4.0</title> <sect1 id="migration4.changes"> @@ -128,7 +128,7 @@ <simpara> Les valeurs Standard ne peuvent pas contrô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écurité du &safemode;. + &htaccess;, cela annulerait toute la sécurité 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éable, PHP 4.0 est distribué 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ême. @@ -159,7 +159,7 @@ <filename>httpd.conf.orig</filename>. </simpara> <para> - Pour convertir vos fichiers <filename>.htaccess</filename>, exécutez + Pour convertir vos fichiers &htaccess;, exé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ême façon, votre vieux fichier <filename>.htaccess</filename> + De la même façon, votre vieux fichier &htaccess; sera sauvé 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éveloppement PHP</title> <sect1 id="phpdevel-addfunc"> @@ -740,7 +740,7 @@ restrictions RSRC_CONF sont des directives qui ne peuvent être disponibles que dans le fichier de configuration Apache. Toutes les directives OR_OPTIONS peuvent être placées n'importe - où, y compris dans un fichier <filename>.htaccess</filename>. + où, 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éservés en PHP</title> <para> @@ -490,7 +490,7 @@ Votre serveur web doit être configuré pour cré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édéfinies de zend</refname> <refpurpose>Constants définies dans le coeur de PHP, Zend et les modules SAPI</refpurpose> </refnamediv> <refsect1> <title>Description</title> <simpara> Ces constantes sont dé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édéfinies</refname> <refpurpose>Constantes standards dans PHP</refpurpose> </refnamediv> <refsect1> <title>Description</title> <simpara> Ces constantes sont définies par dé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édé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 diffrents modes de transports, format URL, dont &php; dispose en interne pour les flts 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 connatre la liste des modes de transports installs 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> & <literal>tls://</literal> depuis PHP 4.3. </simpara> <note> <simpara> Si aucun transport n'est spcifi, <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 numro de port en plus de l'adresse de l'hte. Dans le cas de <function>fsockopen</function>, il est spcifi en deuxime paramtre, 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 mme famille, le numro de port est spcifi 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 numro de port</title> <simpara> Dans le second exemple ci-dessus, les exemples en IPv4 et les noms d'htes sont identiques, mais les IPv6 sont places entre crochet, en plus d'avoir le deux-points et le numro de port : <literal>[fe80::1]</literal>. Cela permet de distinguer les deux-points utiliss en IPv6 et le deux-points utilis pour dlimiter le numro 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 dfaut</entry> </row> </thead> <tbody> <row> <entry><literal>verify_peer</literal></entry> <entry> &true; ou &false;. Requiert la vrification 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-signs. </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 spcifi, 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 prive. Il peut ventuellement contenir la chane 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 limits. 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-jaent 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'accs un flt 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 numro de port. Dans ce cas, le paramtre 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és</title> <para> Cette section recense une liste de protocole gérant des URL, qui sont intégrés dans les fonctions ayant accès aux fichiers, dans PHP. Par exemple, les fonctions <function>fopen</function> et <function>copy</function>. Ces fonctionnalités sont compilées comme des pilotes externes, et à partir de PHP 4.3.0, vous pouvez cré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ès en lecture uniquement, pour des fichiers accessibles sur le réseau avec la méthode GET de HTTP 1.0. Un entête <literal>Host:</literal> est envoyé avec la requête, pour gérer les hôtes virtuels, basés sur des noms. Si vous avez configuré 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ôt, il sera aussi utilisé dans votre requête. </simpara> <simpara> Les redirections sont supportées depuis PHP 4.0.5; si vous utilisez une version plus ancienne, vous devrez ajouter vous même les slash finaux dans vos URL. </simpara> <simpara> Le flôt donne l'accès au corps (<emphasis>body</emphasis>) de la ressource. Les entêtes sont stockés dans la variable <varname>$http_response_header</varname>. Depuis PHP 4.3.0, les entê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 écrire dans des fichiers ouverts via le protocole HTTP. </simpara> <note> <simpara>HTTPS est supporté depuis PHP 4.3, si vous avez compilé 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ès aux fichiers existants, et la création de fichiers via FTP. Si le serveur ne supporte pas les connexions en mode passif, la connexion échouera. </simpara> <simpara> Vous pouvez ouvrir des fichiers en lecture et en écriture, mais pas les deux en même temps. Si le fichier distant existe déjà sur le serveur FTP, vous pourrez essayer de l'ouvrir en écriture, mais la connexion échouera. Si vous devez modifier un fichier qui existe déjà, utilisez <function>ftp_connect</function>. </simpara> <simpara> <filename>ftps://</filename> a été introduit en PHP 4.3. C'est le même que <filename>ftp://</filename>, mais il tente d'établir une connexion sécurisée avec le serveur FTP. Si le serveur ne le supporte pas, la connexion sera une connexion non sécurisée. </simpara> <note> <simpara> FTPS est supporté depuis PHP 4.3.0, si vous avez compilé le support d'OpenSSL. </simpara> </note> </section> <section id="wrappers.php"> <title>Flôts d'entrée/sortie</title> <simpara> PHP 3.0.13 et plus ré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ès au flôt correspondant d'entrée ou de sortie du processus PHP. </simpara> <simpara> <filename>php://output</filename> vous permet d'écrire dans le buffer de sortie, de la même manière que <function>print</function> et <function>echo</function>. </simpara> <simpara> <filename>php://input</filename> permet de lire des données POST bruts. C'est moins gourmand en mémoire que <varname>$HTTP_RAW_POST_DATA</varname> et il n'y a pas de directive spé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 écriture seule. </simpara> <simpara> <filename>php://filter</filename> est une sorte de méta-gestionnaire, prévu pour qui permet l'utilisation de filtre avec les données d'entrée au moment du démarrage du script. C'est pratique avec des fonctions compactes comme <function>readfile</function>, <function>file</function> et <function>file_get_contents</function> où il n'y a pas d'opportunité d'appliquer un filtre aux données lues. </simpara> <simpara> Le gestionaire de <filename>php://filter</filename> prend les paramètres suivants dans le chemin. </simpara> <itemizedlist> <listitem> <para> <literal>/resource=<flôt à filtrer></literal> (<emphasis>obligatoire</emphasis>) Ce paramètre doit être situé à la fin de votre chaîne <filename>php://filter</filename> et doit pointer sur le flôt à filtrer. <informalexample> <programlisting role="php"> <![CDATA[ <?php /* Ceci est l'équivalent de : readfile("http://www.example.com"); puisqu'aucun filtre n'est spécifié */ readfile("php://filter/resource=http://www.exemple.com"); ?> ]]> </programlisting> </informalexample> </para> </listitem> <listitem> <para> <literal>/read=<liste de filtres de la chaîne de lecture></literal> (<emphasis>optionnel</emphasis>) Ce paramètre prend un ou plusieurs noms de filtres, séparés par le caractè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ême chose que ci-dessus, mais en plus, le résultat sera chiffré en ROT13 */ readfile("php://filter/read=string.toupper|string.rot13/resource=http://www.exemple.com"); ?> ]]> </programlisting> </informalexample> </para> </listitem> <listitem> <para> <literal>/write=<liste de filtres de la chaîne d'écriture></literal> (<emphasis>optionnel</emphasis>) Ce paramètre prend un ou plusieurs noms de filtres, séparés par le caractère pipe <literal>|</literal>. <informalexample> <programlisting role="php"> <![CDATA[ <?php /* Cette ligne va filtrer la chaîne "Bonjour le monde" avec le filtre rot13, puis écrire le ré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>/<liste de filtres des deux chaînes></literal> (<emphasis>optionnel</emphasis>) Tous les filtres qui ne sont pas préfixé avec <literal>read=</literal> ou <literal>write=</literal> seront appliqué aux deux chaînes de filtres, en lecture et en écriture. </simpara> </listitem> </itemizedlist> </section> <section id="wrappers.compression"> <title>Flôts compressés</title> <simpara><filename>zlib:</filename> PHP 4.0.4 - PHP 4.2.3 (systèmes avec fopencookie uniquement)</simpara> <simpara><filename>compress.zlib://</filename> et <filename>compress.bzip2://</filename> depuis PHP 4.3.0 et plus ré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ôt peut être utilisé directement avec <function>fread</function> et les autres fonctions de système de fichier. Cette notation est obsolète depuis PHP 4.3.0, étant données les ambiguités dues aux noms de fichiers contenant des deux points ':'. Utilisez plutôt <filename>compress.zlib://</filename>. </simpara> <simpara> <filename>compress.zlib://</filename> et <filename>compress.bzip2://</filename> sont équivalents à <function>gzopen</function> et <function>bzopen</function> respectivement, et ils opèrent même sur les systè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 -->