cvs: phpdoc-fr /features commandline.xml

From: Date: Sun, 18 Apr 2004 18:26:50 +0000
Subject: cvs: phpdoc-fr /features commandline.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-2198@lists.php.net to get a copy of this message
gui Sun Apr 18 14:26:50 2004 EDT Modified files: /phpdoc-fr/features commandline.xml Log: sync with the en doc

http://cvs.php.net/diff.php/phpdoc-fr/features/commandline.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc-fr/features/commandline.xml diff -u phpdoc-fr/features/commandline.xml:1.9 phpdoc-fr/features/commandline.xml:1.10 --- phpdoc-fr/features/commandline.xml:1.9 Wed Feb 25 09:15:19 2004 +++ phpdoc-fr/features/commandline.xml Sun Apr 18 14:26:50 2004 @@ -1,29 +1,99 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.31 Maintainer: gui Status: ready --> <chapter id="features.commandline"> <title>Utiliser PHP en ligne de commande</title> <!-- NEW DOCUMENTATION STARTS --> <para> - Depuis la version 4.3, &php; supporte un nouveau type + Depuis la version 4.3.0, <literal>PHP</literal> 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. + applications shell (ou desktop), écrites en <literal>PHP</literal>. + Il y a un certain nombre de différences entre le type <literal>CLI SAPI</literal> + et les autres <literal>SAPI</literal> expliqués dans ce chapitre. + Il convient de préciser que <literal>CLI</literal> et + <literal>CGI</literal> sont des SAPI différentes, bien qu'ils partagent + des comportements similaires. </para> <para> Le <literal>CLI SAPI</literal> a été publié pour 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>, + la version <literal>PHP 4.2.0</literal>, mais il était expérimental, + et devait être explicitement activé avec l'option <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). + <literal>PHP 4.3.0</literal>, le <literal>CLI SAPI</literal> n'est plus expérimental, et + l'option <literal>--enable-cli</literal> est activée par défaut. Vous pouvez + utiliser l'option <literal>--disable-cli</literal> pour le désactiver. + </para> + <para> + Depuis PHP 4.3.0, le nom, l'emplacement et l'existence des binaires CLI/CGI + vont dépendre de la façon dont PHP est installé sur votre système. Par + défaut, en exécutant <literal>make</literal>, les deux binaires CGI et CLI + sont compilés et nommés respectivement <literal>sapi/cgi/php</literal> et + <literal>sapi/cli/php</literal> dans votre répertoire source PHP. Vous + remarquerez que les deux se nomment <literal>php</literal>. Ce qui se passe + ensuite pendant le <literal>make install</literal> dépend de votre ligne + de configuration. Si un module SAPI, apxs par exemple, a été choisi pendant la + configuration, ou que l'option <literal> --disable-cgi</literal> a été + activée, le CLI est copié dans <literal>{PREFIX}/bin/php</literal> pendant + le <literal>make install</literal>. Si, par exemple, <literal>--with--apxs + </literal> figure dans votre ligne de configuration, le CLI est copié dans + <literal>{PREFIX}/bin/php</literal> pendant le <literal>make + install</literal>, sinon c'est le CGI qui y est placé. Si vous voulez forcer + l'installation du binaire CGI, lancez <literal>make install-cli</literal> + après le <literal>make install</literal>. Sinon, vous pouvez aussi spécifier + <literal>--disable-cgi</literal> dans votre ligne de configuration. + </para> + <para> + <note> + <para> + Du fait que les deux options <literal>--enable-cli</literal> et <literal> + --enable-cgi</literal> sont activées par défaut, avoir simplement + <literal>--enable-cli</literal> dans votre ligne de configuration + n'implique pas nécessairement que le CLI soit renommé en <literal> + {PREFIX}/bin/php</literal> pendant le <literal>make install</literal>. + </para> + </note> + </para> + <para> + Les paquets Windows entre PHP 4.2.0 et PHP 4.2.3 installaient le CLI en tant + que <filename>php-cli.exe</filename> et laissaient le CGI en tant que + <filename>php-cli.exe</filename> dans le même répertoire. Depuis PHP 4.3.0, + le paquet Windows installe le CLI en tant que <filename>php.exe</filename> + dans un répertoire à part nommé <literal>cli</literal>, donc + <literal>cli/php.exe</literal>. + Depuis PHP 5, le CLI est installé dans le répertoire principal en tant que + <filename>php.exe</filename>. La version CGI est nommée quant à elle + <filename>php-cgi.exe</filename>. + </para> + <para> + Depuis PHP 5, un nouveau fichier <filename>php-win.exe</filename> est + installé. C'est l'équivalent de la version CLI à ceci près qu'il n'affiche + rien et ainsi ne fait pas apparaitre de console (aucune fenêtre "dos" + n'apparait à l'écran). Ce comportement est similaire à celui de php-gtk. + Vous pouvez l'activez avec l'option <literal>--enable-cli-win32</literal>. + </para> + <para> + <note> + <title>Quel SAPI est installé?</title> + <para> + A partir d'un interpréteur de commande, lancer <literal>php -v</literal> + vous dira si <literal>php</literal> est en version CGI ou CLI. Vous pouvez + aussi consulter la fonction <function>php_sapi_name</function> et la + constante <constant>PHP_SAPI</constant>. + </para> + </note> + </para> + <para> + <note> + <para> + Une page <literal>man</literal> de manuel Unix a été ajoutée avec PHP + 4.3.2. Vous pouvez la consulter en tapant <literal>man php</literal> dans + votre interpréteur de commande. + </para> + </note> </para> <para> Les différences les plus notables entre le <literal>CLI SAPI</literal> et les @@ -39,12 +109,26 @@ en-têtes HTTP, il n'y a pas moyen d'activer les en-têtes HTTP dans le <literal>CLI SAPI</literal>. </para> + <para> + CLI est lancé en mode silencieux par défaut, bien que les options + <literal>-q</literal> et <literal>--no-header</literal> soient gardées + pour rester compatible avec les anciennes versions CGI. + </para> + <para> + Il ne change pas le répertoire courant en celui du script. + (les options <literal>-C</literal> et <literal>--no-chdir</literal> sont + gardées par souci de compatibilité) + </para> + <para> + Messages d'erreurs en texte brut (pas de formatage HTML). + </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 : + <literal>CLI SAPI</literal>, car elles n'ont pas de sens, en environnement shell : + </para> + <para> <table> <title>Directives &php.ini; ignorées</title> <tgroup cols="3"> @@ -82,7 +166,7 @@ <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 + Etant donné les possibilités infinies de <literal>PHP</literal> 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 @@ -102,12 +186,12 @@ dans le <literal>CLI SAPI</literal>. </para> <para> - Depuis &php; 4.3.0, les variables <varname>$argc</varname> + 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; + de la directive <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 à @@ -143,7 +227,7 @@ <thead> <row> <entry>Constante</entry> - <entry>Déscription</entry> + <entry>Description</entry> </row> </thead> <tbody> @@ -154,7 +238,11 @@ Cela évite de l'ouvrir avec <programlisting role="php"> <![CDATA[ +<?php + $stdin = fopen('php://stdin', 'r'); + +?> ]]> </programlisting> </entry> @@ -166,7 +254,11 @@ Cela évite de l'ouvrir avec <programlisting role="php"> <![CDATA[ +<?php + $stdout = fopen('php://stdout', 'w'); + +?> ]]> </programlisting> </entry> @@ -178,7 +270,11 @@ <literal>stderr</literal>. Cela évite de l'ouvrir avec <programlisting role="php"> <![CDATA[ +<?php + $stderr = fopen('php://stderr', 'w'); + +?> ]]> </programlisting> </entry> @@ -188,21 +284,22 @@ </table> </para> <para> - Etant donné ce qui précède, vous n'avez pas besoin d'ouvrir un fichier + Etant donné ce qui précède, vous n'avez pas besoin d'ouvrir un flux vers <literal>stderr</literal> par vous-même, mais vous pouvez utiliser cette constante directement, comme un descripteur de fichier : - <programlisting role="php"> + <programlisting role="shell"> <![CDATA[ php -r 'fwrite(STDERR, "stderr\n");' ]]> </programlisting> - Vous n'avez pas non plus à fermer explicitement ces fichiers, PHP s'en - chargera automatiquement. + Vous n'avez pas non plus à fermer explicitement ces fichiers, + <literal>PHP</literal> s'en chargera automatiquement à la fin du script. </para> </listitem> <listitem> <para> - <literal>CLI SAPI</literal> <emphasis role="strong">ne transforme pas</emphasis> + Le <literal>CLI SAPI</literal> <emphasis + role="strong">ne transforme pas</emphasis> le dossier courant en dossier d'exécution du script! </para> <para> @@ -210,14 +307,14 @@ <programlisting role="php"> <![CDATA[ <?php - /* Un test simple : affiche le dossier d'exécution */ - echo getcwd(), "\n"; +// 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 + Lorsque vous utilisez la version <literal>CGI</literal>, l'affichage sera : <screen> <![CDATA[ $ pwd @@ -227,7 +324,7 @@ /tmp/autre_dossier ]]> </screen> - Cela monter clairement que &php; modifie le dossier + Cela montre clairement que <literal>PHP</literal> modifie le dossier courant, et utilise le dossier du script exécuté. </para> <para> @@ -242,11 +339,11 @@ ]]> </screen> Cela donne beaucoup plus de souplesse lorsque vous rédigez des - scripts shell avec &php;. + scripts shell avec <literal>PHP</literal>. </para> <note> <para> - <literal>CGI SAPI</literal> supporte le même comportement de + Le <literal>CGI SAPI</literal> se comporte de la même façon que le <literal>CLI SAPI</literal>, en lui passant l'option <literal>-C</literal>, lorsque vous l'invoquez en ligne de commmande. </para> @@ -256,7 +353,8 @@ </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> : + est disponible à n'importe quel moment en exécutant <literal>PHP</literal> avec l'option + <literal>-h</literal> : <screen> <![CDATA[ Usage: php [options] [-f] <file> [args...] @@ -284,11 +382,11 @@ </para> <para> Le <literal>CLI SAPI</literal> dispose de trois moyens pour lire le - code du script PHP que vous voulez exécuter : + code du script <literal>PHP</literal> que vous voulez exécuter : <orderedlist> <listitem> <para> - Indiquer à &php; d'exécuter un fichier : + Indiquer à <literal>PHP</literal> d'exécuter un fichier donné : </para> <para> <screen> @@ -322,19 +420,19 @@ <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. + L'option <literal>-r</literal> rend caduque l'utilisation de celles-ci, et les ajouter conduirait + alors à une erreur d'analyse syntaxique. </para> </note> </listitem> <listitem> <para> - Donner du code &php; dans l'entrée standard + Alimenter l'entrée standard en code <literal>PHP</literal> (<literal>stdin</literal>). </para> <para> Cela donne la possibilité de créer dynamiquement du code - &php;, puis de le fournir à PHP, et enfin, + <literal>PHP</literal>, puis de le fournir à PHP, et enfin, de le traiter à nouveau en shell. Voici un exemple fictif : <screen> <![CDATA[ @@ -347,29 +445,31 @@ 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 + Comme toute application shell, l'exécutable <literal>PHP</literal> accepte + des arguments, et votre script <literal>PHP</literal> peut aussi les recevoirs. Le nombre d'arguments + n'est pas limité par <literal>PHP</literal> (le shell 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 + pas cette limite). 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. + <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; + Si vous passez des arguments à votre script qui commencent par + <literal>-</literal>, cela posera des problèmes car <literal>PHP</literal> 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. + passés à votre script sans être modifié ou analysé par + <literal>PHP</literal>. </para> - <screen> + <para> + <screen> <![CDATA[ # Cela ne va pas exécuter le code, mais afficher l'aide de PHP $ php -r 'var_dump($argv);' -h @@ -385,21 +485,20 @@ string(2) "-h" } ]]> - </screen> + </screen> + </para> <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 : + en tout début de votre script, suivi de code <literal>PHP</literal> compris entre + balise ouvrantes/fermantes. Après avoir mis les droits d'exécution sur votre + script (<literal>chmod +x test</literal>), il peut être exécuté comme un script + shell ou perl habituel : <programlisting role="php"> <![CDATA[ #!/usr/bin/php <?php - var_dump($argv); +var_dump($argv); ?> ]]> </programlisting> @@ -425,28 +524,31 @@ paramètres qui commencent par <literal>-</literal> à votre script. </para> <para> + Les options longues sont disponibles depuis PHP 4.3.3. <table> <title>Options de ligne de commande</title> <tgroup cols="2"> <thead> <row> <entry>Option</entry> + <entry>Option longue</entry> <entry>Description</entry> </row> </thead> <tbody> <row> <entry>-s</entry> + <entry>--syntax-highlight</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 en-têtes. - <literal>&lt;code&gt; [...] &lt;/code&gt;</literal> + et produire une version colorisée du code source, au format + <literal>HTML</literal>. Notez que cette option ne fait que générer un bloc + <literal>HTML</literal>, avec les balises <literal>HTML</literal> + <literal>&lt;code&gt; [...] &lt;/code&gt;</literal>, sans en-têtes <literal>HTML</literal>. </para> <note> <para> @@ -456,7 +558,17 @@ </entry> </row> <row> + <entry>-s</entry> + <entry>--syntax-highlighting</entry> + <entry> + <para> + Alias de <literal>--syntax-highlight</literal>. + </para> + </entry> + </row> + <row> <entry>-w</entry> + <entry>--strip</entry> <entry> <para> Affiche la source sans les commentaires et les espaces. @@ -470,24 +582,26 @@ </row> <row> <entry>-f</entry> + <entry>--file</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 + Cette option est facultative, et peut être omise. Le seul nom du fichier est suffisant. </para> </entry> </row> <row> <entry>-v</entry> + <entry>--version</entry> <entry> <para> - Affiche les versions de PHP, PHP SAPI, et Zend sur le terminal. Par exemple : + Affiche les versions de PHP, PHP SAPI, et Zend sur la sortie standard. 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 +PHP 4.3.0 (cli), Copyright (c) 1997-2002 The PHP Group +Zend Engine v1.3.0, Copyright (c) 1998-2002 Zend Technologies ]]> </screen> </para> @@ -495,12 +609,13 @@ </row> <row> <entry>-c</entry> + <entry>--php-ini</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;) : + se trouve le fichier &php.ini;, ou encore vous pouvez + spécifier un fichier de configuration (<literal>INI</literal>) + directement (qui ne s'appelle pas obligatoirement &php.ini;) : <screen> <![CDATA[ $ php -c /custom/directory/ mon_script.php @@ -512,19 +627,18 @@ </entry> </row> <row> - <entry>-a</entry> + <entry>-n</entry> + <entry>--no-php-ini</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. - --> + Ignore complètement php.ini. Cette option est disponible depuis PHP + 4.3.0. </para> </entry> </row> <row> <entry>-d</entry> + <entry>--define</entry> <entry> <para> Cette option permet de modifier n'importe quelle directive de configuration @@ -558,7 +672,21 @@ </entry> </row> <row> + <entry>-a</entry> + <entry>--interactive</entry> + <entry> + <para> + Lance PHP de façon 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>-e</entry> + <entry>--profile-info</entry> <entry> <para> Génére des informations étendues pour le profilage et le débogage. @@ -571,25 +699,27 @@ </row> <row> <entry>-z</entry> + <entry>--zend-extension</entry> <entry> <para> - Charge une extension Zend. Si seulement un fichier est fourni, PHP + Charge une extension Zend. Si et seulement si 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. + relatif indiquera à <literal>PHP</literal> qu'il doit chercher les extensions + uniquement dans ce dossier. </para> </entry> </row> <row> <entry>-l</entry> + <entry>--syntax-check</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>PHP</literal> fourni. En cas de réussite, le message <literal>No syntax errors detected in &lt;filename&gt;</literal> (<literal>Aucune d'erreur de syntaxe n'ont été détectées dans &lt;nom_de_fichier&gt;</literal> est affiché sur la sortie standard, et le script shell retourne @@ -613,9 +743,11 @@ </row> <row> <entry>-m</entry> + <entry>--modules</entry> <entry> <para> - Cette option liste les extensions PHP et Zend compilées et chargées : + Cette option liste les extensions PHP et Zend compilées + (et chargées) : <screen> <![CDATA[ $ php -m @@ -639,31 +771,32 @@ </row> <row> <entry>-i</entry> + <entry>--info</entry> <entry> Cette option appelle la fonction <function>phpinfo</function>, et - affiche le résultat. Si &php; ne fonctionne pas + affiche le résultat. Si <literal>PHP</literal> 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. + option est au format <literal>HTML</literal>, et donc de taille conséquente. </entry> </row> <row> <entry>-r</entry> + <entry>--run</entry> <entry> <para> - Cette option permet l'exécution de &php; directement - dans la ligne de commande. Les balises de &php; + Cette option permet l'exécution de <literal>PHP</literal> directement + dans la ligne de commande. Les balises de <literal>PHP</literal> (<literal>&lt;?php</literal> et <literal>?&gt;</literal>) - <emphasis role="strong">ne sont pas</emphasis> demandées, et coauseront - une erreur d'analyse. + <emphasis role="strong">ne sont pas</emphasis> nécessaires, et causeront + une erreur d'analyse si elles sont présentes. </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 + Une attention toute particulière doit être portée lors de l'utilisation de cette option + de <literal>PHP</literal>, pour qu'il n'y ait pas de collision avec + les substitutions de variables en ligne de commande, réalisées par le shell. </para> <para> @@ -675,10 +808,10 @@ ]]> </screen> Le problème ici est que le shell (sh/bash) effectue une substitution - de variables, grâce aux guillemets doubles <literal>"</literal>. + de variables, même avec les 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 : + que le code passé à <literal>PHP</literal> pour l'exécution est : <screen> <![CDATA[ $ php -r " = get_defined_constants();" @@ -704,25 +837,47 @@ ]]> </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 à + 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. - <!-- :-) --> + pour l'échappement. Vous aurez été prévenu. <!-- :-) --> + </para> + </note> + <note> + <para> + <literal>-r</literal> est disponible avec le <emphasis>CLI</emphasis> + SAPI et pas avec le <emphasis>CGI</emphasis> SAPI. </para> </note> </entry> </row> <row> <entry>-h</entry> + <entry>--help</entry> <entry> - Avec cette option, vous pouvez obtenir des informations sur la liste des - options supporté par votre PHP, avec des explications succintes. + Avec cette option, vous pouvez obetnir des informations sur la liste + courante des options de la ligne de commande, ainsi que leur description. </entry> </row> + <row> + <entry>-?</entry> + <entry>--usage</entry> + <entry> + Alias de <literal>--help</literal>. + </entry> + </row> + <!-- + new, not in PHP 4.3.4, but are in php_cli.c 1.102 or cgi_main.c 1.243 + -b <address:port>|<port> bindpath Bind Path for external FASTCGI Server mode, only CGI, no Windows + -B <begin_code> process-begin Run PHP <begin_code> before processing input lines + -R <code> process-code Run PHP <code> for every input line + -F <file> process-file Parse and execute <file> for every input line + -E <end_code> process-end Run PHP <end_code> after processing all input lines + -H hide-args Hide any passed arguments from external tools. + -g global Define global variables on command line + --> </tbody> </tgroup> </table> @@ -741,7 +896,7 @@ <para> Note, that you can always direct the output of the PHP executable to an external file with the &gt; character, - so <literal>php -q test.php > test.html</literal> will + so <literal>php -q test.php &gt; 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. @@ -902,18 +1057,19 @@ <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 + la ligne spéciale (dîte "shebang") en début de script, 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 + l'exécution sous Windows, ce qui rend les scripts facilement 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"> + <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 @@ -929,19 +1085,20 @@ <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> + </programlisting> + </example> + </para> <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'en-têtes HTTP qui soient affichés. Il y a deux + CLI, donc aucun en-tête HTTP n'est affiché. 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 @@ -966,14 +1123,17 @@ <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> +<![CDATA[ +@c:\php\cli\php.exe script.php %1 %2 %3 %4 +]]> + </programlisting> + </example> + </para> <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 + <filename>c:\php\cli\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>.
« previous php.doc.fr (#2198) next »