Index: phpdoc/fr/appendices/commandline.xml +++ phpdoc/fr/appendices/commandline.xml Utiliser PHP en ligne de commande 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. Notez, que vous pouvez toujours rediriger le rŽsultat d'un script PHP avec le caractre supŽrieur ( > ) : par exemple, php -q test.php > test.html Žcrira le rŽsultat du script test.php sans les enttes HTTP dans le fichier test.html, dans le mme dossier. 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 php.exe. 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 -h. Le rŽsultat de la commande php -h ressemblera ˆ peut prs ˆ a : ] | { [args...]} -q Quiet-mode. Suppress HTTP Header output. -s Display colour syntax highlighted source. -f Parse . Implies `-q' -v Version number -C Do not chdir to the script's directory -c 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 Load Zend extension . -l Syntax check only (lint) -m Show compiled in modules -i PHP information -h This help ]]> Voici une liste des options les plus importantes, avec leur explication.

Option de ligne de commande Option Description -q 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. -s Affiche le source en couleur du fichier dont le nom est fourni aprs. Cela revient ˆ utiliser la fonction highlight_file dans un script PHP. -v Affiche la version du PHP courant. Par exemple, 4.0.6. -C 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. -c Utilisez cette option pour spŽcifier un chemin diffŽrent pour le fichier php.ini. PHP ira chercher sa configuration dans ce dossier, au lieu de ses dossiers par dŽfaut. -d Avec cette option, vous pouvez modifier ces paramŽtrage particulier du php.ini, durant l'exŽcution du script. -m En utilisant cette option, PHP affiche les modules de PHP et de Zend, leurs versions et le copyright de Zend. -i Cette option appelle la fonction phpinfo, et affiche le rŽsultat. Si PHP ne fonctionne pas correctement,m il est conseillŽ d'utiliser la commande php -i et de voir si un message d'erreur est disponible, affichŽ ˆ la place des tables d'options habituelles. -h Avec cette option, vous obtenez de l'aide sur les options de ligne de commande.
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 php.exe -q avec un double clic sur les fichiers en .php, 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. Script ˆ exŽcuter en ligne de commande (script.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]; } ?> 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 : $argc et $argv. 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 ($argv[0]). Dans ce programme ci-dessus, nous vŽrifions qu'il y a plus ou moins d'un argument. Si cet argument vaut --help, -help, -h ou -?, alors on affiche le message d'aide, en affichant le nom du programme dynamiquement. Si on reoit d'autres arguments, on les affiche simplement. Si vous voulez exŽcuter le script ci-dessus sous Unix, vous devez le rendre exŽcutable, puis l'appeler sous cette forme : script.php echothis ou script.php -h. Sous Windows, vous pouvez faire un fichier batch comme ceci : Fichier batch a pour exŽcuter en ligne de commande un script PHP (script.bat)  <email protected>:\php\php.exe -q script.php %1 %2 %3 %4 En supposant que vous avez nommŽ le programme ci-dessus script.php, et que votre exŽcutable PHP est php.exe dans le dossier c:\php\php.exe, ce fichier batch exŽcutera votre script, avec vos options. script.bat echothis ou script.bat -h.