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 caractre supŽrieur ( > ) :
par exemple, <literal>php -q test.php > test.html</literal>
Žcrira le rŽsultat 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 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 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'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 premire 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 premire ligne
ajoutŽe 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 ˆ 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 premire ligne pour indiquer
aue ce fichier doit tre exŽcutŽ 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
exŽcutŽ). Le second est un tableau contenant les arguments passŽ
en ligne de commande, en commencant par le nom du script lui-mme
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 reoit 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
-->
