cvs: phpdoc /fr/appendices commandline.xml
| From: | Damien Seguy | Date: | Thu, 25 Oct 2001 14:08:05 +0000 |
| Subject: | cvs: phpdoc /fr/appendices commandline.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969338213@lists.php.net to get a copy of this message | ||
dams Thu Oct 25 10:08:05 2001 EDT
Added files:
/phpdoc/fr/appendices commandline.xml
Log:
commandline translated
updated intro.
Index: phpdoc/fr/appendices/commandline.xml +++ phpdoc/fr/appendices/commandline.xml <?xml encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- TODO: The command line options not in the list, but in the -h output below: -f, -e, -z, -l It would be best to document these, and collect more info about -c and -d! --> <appendix id="commandline"> <title>Utiliser PHP en ligne de commande</title> <para> Les options de ligne de commande de PHP sont pratiques si vous souhaitez dbugger ou tester votre installation PHP, mais elles sont aussi utiles si vous voulez utilisr PHP pour d'autres tches que les scripts web. </para> <para> Notez, que vous pouvez toujours rediriger le rsultat d'un script PHP avec le caractre suprieur ( > ) : par exemple, <literal>php -q test.php > test.html</literal> crira le rsultat du script <filename>test.php</filename> sans les enttes HTTP dans le fichier <filename>test.html</filename>, dans le mme dossier. </para> <para> Vous ne pouvez utiliser les options de ligne de commande que si vous avez install PHP comme excutable. Si vous avez cr un module Serveur, et que vous n'avez aucune version CGI disponible sur votre serveur, vous n'avez aucune chance de pouvoir utiliser ces options. Pour les utilisateurs Windows, les deux versions de PHP sont disponibles dans la distribution binaire, et l'excutable s'appelle <filename>php.exe</filename>. </para> <para> Cette liste d'options est valable pour PHP 4.0.6. Vous pouvez connatre la liste relle et avoir un peu d'aide avec l'option <literal>-h</literal>. Le rsultat de la commande <literal>php -h</literal> ressemblera peut prs a : <programlisting> <![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 ]]> </programlisting> </para> <para> Voici une liste des options les plus importantes, avec leur explication. </para> <para> <table> <title>Option de ligne de commande</title> <tgroup cols="2"> <thead> <row> <entry>Option</entry> <entry>Description</entry> </row> </thead> <tbody> <row> <entry>-q</entry> <entry> Supprime les enttes HTTP. Normalement, PHP affiche les enttes HTTP pour le serveur web qui l'utilise pour les transmettre au client web. Lorsque vous creez des scripts en ligne de commande, ces enttes sont inutiles. </entry> </row> <row> <entry>-s</entry> <entry> Affiche le source en couleur du fichier dont le nom est fourni aprs. Cela revient utiliser la fonction <function>highlight_file</function> dans un script PHP. </entry> </row> <row> <entry>-v</entry> <entry> Affiche la version du PHP courant. Par exemple, 4.0.6. </entry> </row> <row> <entry>-C</entry> <entry> Normalement, PHP change le dossier de travail par celui d'excution des scripts. Cela permet d'ouvrir des fichiers dans ce dernier dossier, sans avoir faire le dplacement. Si vous voulez inactiver cette fonctionnalit, utilisez cette option. </entry> </row> <row> <entry>-c</entry> <entry> Utilisez cette option pour spcifier un chemin diffrent pour le fichier <filename>php.ini</filename>. PHP ira chercher sa configuration dans ce dossier, au lieu de ses dossiers par dfaut. </entry> </row> <row> <entry>-d</entry> <entry> Avec cette option, vous pouvez modifier ces paramtrage particulier du <filename>php.ini</filename>, durant l'excution du script. </entry> </row> <row> <entry>-m</entry> <entry> En utilisant cette option, PHP affiche les modules de PHP et de Zend, leurs versions et le copyright de Zend. </entry> </row> <row> <entry>-i</entry> <entry> Cette option appelle la fonction <function>phpinfo</function>, et affiche le rsultat. Si PHP ne fonctionne pas correctement,m il est conseill d'utiliser la commande <literal>php -i</literal> et de voir si un message d'erreur est disponible, affich la place des tables d'options habituelles. </entry> </row> <row> <entry>-h</entry> <entry> Avec cette option, vous obtenez de l'aide sur les options de ligne de commande. </entry> </row> </tbody> </tgroup> </table> </para> <para> L'excutable PHP peut tre utilis pour excuter des scripts PHP indpendamment du serveur web. Si vous tes sous Unix, il vous faut ajouter une premire ligne vos scripts, et le rendre excutable. Sous Windows, vous pouvez associer <literal>php.exe -q</literal> avec un double clic sur les fichiers en <literal>.php</literal>, ou bien vous pouvez faire un fichier batch pour excuter ces scripts via PHP. La premire ligne ajoute au script sous Unix ne posera pas de problme sous Windows, et vos scripts resteront parfaitement portable d'un systme l'autre. Un exemple simple de script en ligne de commande est disponible ci-dessous. </para> <example> <title>Script excuter en ligne de commande (script.php)</title> <programlisting role="php"> #!/usr/bin/php -q <?php if ($argc != 2 || in_array($argv[1], array('--help', '-help', '-h', '-?'))) { ?> This is a command line PHP script with one option. Usage: <?php echo $argv[0]; ?> <option> <option> can be some word you would like to print out. With the --help, -help, -h, or -? options, you can get this help. <?php } else { echo $argv[1]; } ?> </programlisting> </example> <para> Dans ce script, nous avons utilis la premire ligne pour indiquer aue ce fichier doit tre excut par PHP, et ne doit pas afficher les enttes HTTP. Il y a deux variables que vous pouvez utiliser pour crire des scripts de ligne de commande : <varname>$argc</varname> et <varname>$argv</varname>. Le premier est le nombre d'argument plus un (qui est le nom du fichier excut). Le second est un tableau contenant les arguments pass en ligne de commande, en commencant par le nom du script lui-mme comme numro zro (<varname>$argv[0]</varname>). </para> <para> Dans ce programme ci-dessus, nous vrifions qu'il y a plus ou moins d'un argument. Si cet argument vaut <literal>--help</literal>, <literal>-help</literal>, <literal>-h</literal> ou <literal>-?</literal>, alors on affiche le message d'aide, en affichant le nom du programme dynamiquement. Si on reoit d'autres arguments, on les affiche simplement. </para> <para> Si vous voulez excuter le script ci-dessus sous Unix, vous devez le rendre excutable, puis l'appeler sous cette forme : <literal>script.php echothis</literal> ou <literal>script.php -h</literal>. Sous Windows, vous pouvez faire un fichier batch comme ceci : </para> <example> <title>Fichier batch a pour excuter en ligne de commande un script PHP (script.bat)</title> <programlisting> @c:\php\php.exe -q script.php %1 %2 %3 %4 </programlisting> </example> <para> En supposant que vous avez nomm le programme ci-dessus <filename>script.php</filename>, et que votre excutable PHP est <filename>php.exe</filename> dans le dossier <filename>c:\php\php.exe</filename>, ce fichier batch excutera votre script, avec vos options. <literal>script.bat echothis</literal> ou <literal>script.bat -h</literal>. </para> </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 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 +++ phpdoc/fr/appendices/commandline.xml <?xml encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- TODO: The command line options not in the list, but in the -h output below: -f, -e, -z, -l It would be best to document these, and collect more info about -c and -d! --> <appendix id="commandline"> <title>Utiliser PHP en ligne de commande</title> <para> Les options de ligne de commande de PHP sont pratiques si vous souhaitez dbugger ou tester votre installation PHP, mais elles sont aussi utiles si vous voulez utilisr PHP pour d'autres tches que les scripts web. </para> <para> Notez, que vous pouvez toujours rediriger le rsultat d'un script PHP avec le caractre suprieur ( > ) : par exemple, <literal>php -q test.php > test.html</literal> crira le rsultat du script <filename>test.php</filename> sans les enttes HTTP dans le fichier <filename>test.html</filename>, dans le mme dossier. </para> <para> Vous ne pouvez utiliser les options de ligne de commande que si vous avez install PHP comme excutable. Si vous avez cr un module Serveur, et que vous n'avez aucune version CGI disponible sur votre serveur, vous n'avez aucune chance de pouvoir utiliser ces options. Pour les utilisateurs Windows, les deux versions de PHP sont disponibles dans la distribution binaire, et l'excutable s'appelle <filename>php.exe</filename>. </para> <para> Cette liste d'options est valable pour PHP 4.0.6. Vous pouvez connatre la liste relle et avoir un peu d'aide avec l'option <literal>-h</literal>. Le rsultat de la commande <literal>php -h</literal> ressemblera peut prs a : <programlisting> <![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 ]]> </programlisting> </para> <para> Voici une liste des options les plus importantes, avec leur explication. </para> <para> <table> <title>Option de ligne de commande</title> <tgroup cols="2"> <thead> <row> <entry>Option</entry> <entry>Description</entry> </row> </thead> <tbody> <row> <entry>-q</entry> <entry> Supprime les enttes HTTP. Normalement, PHP affiche les enttes HTTP pour le serveur web qui l'utilise pour les transmettre au client web. Lorsque vous creez des scripts en ligne de commande, ces enttes sont inutiles. </entry> </row> <row> <entry>-s</entry> <entry> Affiche le source en couleur du fichier dont le nom est fourni aprs. Cela revient utiliser la fonction <function>highlight_file</function> dans un script PHP. </entry> </row> <row> <entry>-v</entry> <entry> Affiche la version du PHP courant. Par exemple, 4.0.6. </entry> </row> <row> <entry>-C</entry> <entry> Normalement, PHP change le dossier de travail par celui d'excution des scripts. Cela permet d'ouvrir des fichiers dans ce dernier dossier, sans avoir faire le dplacement. Si vous voulez inactiver cette fonctionnalit, utilisez cette option. </entry> </row> <row> <entry>-c</entry> <entry> Utilisez cette option pour spcifier un chemin diffrent pour le fichier <filename>php.ini</filename>. PHP ira chercher sa configuration dans ce dossier, au lieu de ses dossiers par dfaut. </entry> </row> <row> <entry>-d</entry> <entry> Avec cette option, vous pouvez modifier ces paramtrage particulier du <filename>php.ini</filename>, durant l'excution du script. </entry> </row> <row> <entry>-m</entry> <entry> En utilisant cette option, PHP affiche les modules de PHP et de Zend, leurs versions et le copyright de Zend. </entry> </row> <row> <entry>-i</entry> <entry> Cette option appelle la fonction <function>phpinfo</function>, et affiche le rsultat. Si PHP ne fonctionne pas correctement,m il est conseill d'utiliser la commande <literal>php -i</literal> et de voir si un message d'erreur est disponible, affich la place des tables d'options habituelles. </entry> </row> <row> <entry>-h</entry> <entry> Avec cette option, vous obtenez de l'aide sur les options de ligne de commande. </entry> </row> </tbody> </tgroup> </table> </para> <para> L'excutable PHP peut tre utilis pour excuter des scripts PHP indpendamment du serveur web. Si vous tes sous Unix, il vous faut ajouter une premire ligne vos scripts, et le rendre excutable. Sous Windows, vous pouvez associer <literal>php.exe -q</literal> avec un double clic sur les fichiers en <literal>.php</literal>, ou bien vous pouvez faire un fichier batch pour excuter ces scripts via PHP. La premire ligne ajoute au script sous Unix ne posera pas de problme sous Windows, et vos scripts resteront parfaitement portable d'un systme l'autre. Un exemple simple de script en ligne de commande est disponible ci-dessous. </para> <example> <title>Script excuter en ligne de commande (script.php)</title> <programlisting role="php"> #!/usr/bin/php -q <?php if ($argc != 2 || in_array($argv[1], array('--help', '-help', '-h', '-?'))) { ?> This is a command line PHP script with one option. Usage: <?php echo $argv[0]; ?> <option> <option> can be some word you would like to print out. With the --help, -help, -h, or -? options, you can get this help. <?php } else { echo $argv[1]; } ?> </programlisting> </example> <para> Dans ce script, nous avons utilis la premire ligne pour indiquer aue ce fichier doit tre excut par PHP, et ne doit pas afficher les enttes HTTP. Il y a deux variables que vous pouvez utiliser pour crire des scripts de ligne de commande : <varname>$argc</varname> et <varname>$argv</varname>. Le premier est le nombre d'argument plus un (qui est le nom du fichier excut). Le second est un tableau contenant les arguments pass en ligne de commande, en commencant par le nom du script lui-mme comme numro zro (<varname>$argv[0]</varname>). </para> <para> Dans ce programme ci-dessus, nous vrifions qu'il y a plus ou moins d'un argument. Si cet argument vaut <literal>--help</literal>, <literal>-help</literal>, <literal>-h</literal> ou <literal>-?</literal>, alors on affiche le message d'aide, en affichant le nom du programme dynamiquement. Si on reoit d'autres arguments, on les affiche simplement. </para> <para> Si vous voulez excuter le script ci-dessus sous Unix, vous devez le rendre excutable, puis l'appeler sous cette forme : <literal>script.php echothis</literal> ou <literal>script.php -h</literal>. Sous Windows, vous pouvez faire un fichier batch comme ceci : </para> <example> <title>Fichier batch a pour excuter en ligne de commande un script PHP (script.bat)</title> <programlisting> @c:\php\php.exe -q script.php %1 %2 %3 %4 </programlisting> </example> <para> En supposant que vous avez nomm le programme ci-dessus <filename>script.php</filename>, et que votre excutable PHP est <filename>php.exe</filename> dans le dossier <filename>c:\php\php.exe</filename>, ce fichier batch excutera votre script, avec vos options. <literal>script.bat echothis</literal> ou <literal>script.bat -h</literal>. </para> </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 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 -->