P°φloha B. Pou╛itφ PHP z p°φkazovΘ °ßdky

Mo╛nosti PHP p°i spou╣t∞nφ z p°φkazovΘ °ßdky p°inß╣ejφ mnoho u╛itku, pokud chcete ladit nebo testovat va╣e nastavenφ PHP, hodφ se v╣ak i pro p°φpady, kdy byste rßdi pou╛ili PHP pro jinΘ ·Φely ne╛ WWW skriptovßnφ.

Uv∞domte si, ╛e m∙╛ete v╛dy sm∞rovat v²stup programu PHP do vn∞j╣φho souboru pomocφ znaku >, tak╛e php -q test.php > test.html vytiskne v²stup test.php bez HTTP hlaviΦek do test.html ve stejnΘm adresß°i.

Mo╛nosti p°φkazovΘ °ßdky m∙╛ete vyu╛φvat pouze tehdy, mßte-li (spustiteln²) program PHP. Pokud jste zkompilovali pouze modul do serveru a nemßte na poΦφtaΦi ╛ßdnou CGI verzi, nem∙╛ete p°φkazovou °ßdku pou╛φvat. Pro u╛ivatele Windows je v binßrnφm balφΦku jak serverov² modul, tak spustiteln² soubor nazvan² php.exe.

Tento seznem voleb pro p°φkazovou °ßdku je konzistentnφ s PHP 4.0.6. Aktußlnφ seznam vΦetn∞ jedno°ßdkov²ch popis∙ m∙╛ete zφskat pomocφ parametru -h. V²stup php -h by m∞l vypadat p°ibli╛n∞ takto:

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

Zde uvßdφme n∞kterΘ z nejd∙le╛it∞j╣φch voleb s detailnφm vysv∞tlenφm.

Spustitelnß verze PHP m∙╛e b²t pou╛ita pro spou╣t∞nφ skript∙ absolutn∞ nezßvisle na webovskΘm serveru. Pokud jste na unixovΘm systΘmu, m∙╛ete do PHP skriptu p°idat specißlnφ prvnφ °ßdek a ud∞lat z n∞j spustiteln² program - systΘm bude v∞d∞t, jak² program by m∞l skript zpracovßvat. Na Windows m∙╛ete asociovat php.exe -q se souborovou p°φponou .php (pro spou╣t∞nφ dvojklikem), nebo m∙╛ete vytvo°it dßvkov² soubor pro spu╣t∞nφ skriptu p°es PHP. Prvnφ °ßdek skriptu pro prßci v Unixu nebude ve Windows vadit, tak╛e tφmto zp∙sobem m∙╛ete psßt programy pro vφce platforem. Jednoduch² p°φklad psanφ PHP programu pro p°φkazovou °ßdku je uveden nφ╛e.

#!/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];
}
?>

Ve v²╣e uvedenΘm skriptu jsme pou╛ili specißlnφ prvnφ °ßdek k indikaci, ╛e by tento soubor m∞l b²t spou╣t∞n pomocφ PHP a nem∞l by vypisovat HTTP hlaviΦky. Jsou zde dv∞ prom∞nnΘ, kterΘ m∙╛ete pou╛φt p°i psanφ aplikacφ pro PHP spou╣t∞n²ch z p°φkazovΘ °ßdky: $argc a $argv. Prvnφ z nich je poΦet argument∙ + 1 (nßzev b∞╛φcφho skriptu). Druhß je pole obsahujφcφ argumenty, poΦφnaje nßzvem skriptu jako Φφslo 0 ($argv[0]).

V ukßzkovΘm programu se testuje, zda je argument∙ vφce Φi mΘn∞ ne╛ jeden. Pokud by argument byl --help, -help, -h nebo -?, vytiskne se nßpov∞da k programu vΦetn∞ skuteΦnΘho nßzvu skriptu. Pokud by byly p°idßny n∞jakΘ dal╣φ argumenty, vytisknou se na v²stup.

Pokud byste cht∞li spou╣t∞t uveden² skript pod Unixem, musφte ho ud∞lat spustiteln²m (nastavit prßva pro spou╣t∞nφ), a pak jednodu╣e napsat script.php vypis_tohle nebo script.php -h. Na Windows musφte pro tento ·kol vytvo°it dßvkov² soubor:

@c:\php\php.exe -q script.php %1 %2 %3 %4

Za p°edpokladu, ╛e jste v²╣e uveden² program nazvali script.php a soubor php.exe mßte ulo╛en² jako c:\php\php.exe, m∙╛ete tento dßvkov² soubor spou╣t∞t takto: script.bat echothis nebo script.bat -h.

Viz takΘ dokumentaci roz╣φ°enφ Readline, kde najdete vφce funkcφ pro pou╛itφ k aplikacφm PHP spou╣t∞n²ch z p°φkazovΘ °ßdky.