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 d�bugger ou tester votre installation PHP, mais
elles sont aussi utiles si vous voulez utilisr PHP pour
d'autres t�ches que les scripts web.
</para>
<para>
Notez, que vous pouvez toujours rediriger le r�sultat
d'un script PHP avec le caract�re sup�rieur ( > ) :
par exemple, <literal>php -q test.php > test.html</literal>
�crira le r�sultat du script <filename>test.php</filename>
sans les ent�tes HTTP dans le fichier <filename>test.html</filename>,
dans le m�me dossier.
</para>
<para>
Vous ne pouvez utiliser les options de ligne de commande
que si vous avez install� PHP comme ex�cutable. 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'ex�cutable
s'appelle <filename>php.exe</filename>.
</para>
<para>
Cette liste d'options est valable pour PHP 4.0.6.
Vous pouvez conna�tre la liste r��elle et avoir un peu
d'aide avec l'option <literal>-h</literal>. Le r�sultat de
la commande <literal>php -h</literal> ressemblera � peut pr�s
� �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 ent�tes HTTP. Normalement, PHP affiche les
ent�tes HTTP pour le serveur web qui l'utilise pour les
transmettre au client web. Lorsque vous creez des scripts en ligne
de commande, ces ent�tes sont inutiles.
</entry>
</row>
<row>
<entry>-s</entry>
<entry>
Affiche le source en couleur du fichier dont
le nom est fourni apr�s. 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'ex�cution des scripts. Cela permet d'ouvrir
des fichiers dans ce dernier dossier, sans avoir
� faire le d�placement. Si vous voulez inactiver
cette fonctionnalit�, utilisez cette option.
</entry>
</row>
<row>
<entry>-c</entry>
<entry>
Utilisez cette option pour sp�cifier un chemin diff�rent
pour le fichier <filename>php.ini</filename>. PHP ira
chercher sa configuration dans ce dossier, au lieu de
ses dossiers par d�faut.
</entry>
</row>
<row>
<entry>-d</entry>
<entry>
Avec cette option, vous pouvez modifier ces
param�trage particulier du <filename>php.ini</filename>,
durant l'ex�cution 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 r�sultat. 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'ex�cutable PHP peut �tre utilis� pour ex�cuter des scripts
PHP ind�pendamment du serveur web. Si vous �tes sous Unix,
il vous faut ajouter une premi�re ligne � vos scripts, et
le rendre ex�cutable. 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 ex�cuter ces scripts via PHP. La premi�re ligne
ajout�e au script sous Unix ne posera pas de probl�me sous Windows,
et vos scripts resteront parfaitement portable d'un syst�me
� l'autre. Un exemple simple de script en ligne de commande est
disponible ci-dessous.
</para>
<example>
<title>Script � ex�cuter 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 premi�re ligne pour indiquer
aue ce fichier doit �tre ex�cut� par PHP, et ne doit pas afficher
les ent�tes 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
ex�cut�). Le second est un tableau contenant les arguments pass�
en ligne de commande, en commencant par le nom du script lui-m�me
comme num�ro z�ro (<varname>$argv[0]</varname>).
</para>
<para>
Dans ce programme ci-dessus, nous v�rifions 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 re�oit d'autres arguments, on les
affiche simplement.
</para>
<para>
Si vous voulez ex�cuter le script ci-dessus sous Unix, vous
devez le rendre ex�cutable, 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 ex�cuter 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 ex�cutable PHP est
<filename>php.exe</filename> dans le dossier
<filename>c:\php\php.exe</filename>, ce fichier batch
ex�cutera 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
-->
