оно наполнено бессмысленными HTML-тегами, поэтому значение

по умолчанию данной опции всегда FALSE.

а также аналогичных функций немедлено отправлялся в стандартный поток вывода,

а не попадал в буфер. Хотя вы все еще можете использовать буферизацию вывода,

если хотите задержать вывод или манипулировать им.

в командной строке максимальное время выполнения скрипта не ограничено.

В то время, как приложения, написанные для веб, выполняются достаточно быстро,

консольные приложения могут выполняться в течении длительного времени.

Благодаря значению TRUE в CLI SAPI вам всегда доступны переменные

argc (количество аргументов при запуске приложения)

и argv (массив текущих аргументов).

Начиная с PHP4.3.0, при использовании CLI SAPI переменные

$argc и and $argv

зарегистрированы и заполнены соответствующими значениями.

В более ранних версиях создание этих переменных, так же, как и для

CGI или модуля веб-сервера, требует

значение on директивы register_globals.

Независимо от версии PHP или статуса опции register_global

они всегда доступны как элементы массива

$_SERVER или

$HTTP_SERVER_VARS. Например:

$_SERVER['argv']

Если вам необходимо прочитать строку из потока stdin, вы можете сделать

это следующим образом:

php -r 'fwrite(STDERR, "stderr\n");'

?>

$ pwd
/tmp
$ php -q another_directory/test.php
/tmp/another_directory

$ pwd
/tmp
$ php -f another_directory/test.php
/tmp

Usage: php [options] [-f] <file> [args...]
php [options] -r <code> [args...]
php [options] [-- args...]
-s Отображает исходный код с цветной подсветкой
-w Отображает исходный текст без комментариев и пробелов
-f <file> Исполняет <file>
-v Выводит информацию о версии PHP
-c <path>|<file> Ищет файл php.ini в указанной директории
-a Интерактивный запуск
-d foo[=bar] Установить конфигурационную опцию foo значением 'bar'
-e Генерация дополнительной информации для отладчика и профайлера
-z <file> Загрузить Zend-расширение <file>.
-l Проверить синтаксис
-m Показать подключенные модули
-i Выводит информацию о PHP
-r <code> Запустить PHP-код без использования <?..?>
-h Текущая справка
args... Аргументы, передаваемые скрипту. Используйте -- args в случае, если
1-й аргумент начинается с '-' или сам скрипт читается из потока STDIN.

# Приведенный пример не выполнит указанный код, а выдаст справку об использовании PHP
$ php -r 'var_dump($argv);' -h
Usage: php [options] [-f] <file> [args...]
[...]
# Аргумент '-h' будет передан скрипту, справка напечатана не будет
$ php -r 'var_dump($argv);' -- -h
array(2){
[0]=>
string(1) "-"
[1]=>
string(2) "-h"
}

?>

$ chmod +x test
$./test -h -- foo
array(4){
[0]=>
string(6) "./test"
[1]=>
string(2) "-h"
[2]=>
string(2) "--"
[3]=>
string(3) "foo"
}

Отображает исходный код с цветной подсветкой

Эта опция использует внутренний механизм разбора файла, генерирует

подсвеченную HTML-версию и записывает ее в

стандартный вывод. Следует заметить, что генерируется только блок

<code> [...] </code> с

HTML-тегами, без HTML-заголовков.

Замечание:

Эта опция не совместима с опцией -r.

Алиас для --syntax-highlight.

Отображает исходный текст без комментариев и пробельных символов.

Замечание:

Эта опция не совместима с опцией -r.

Исполняет указанный файл. Опция -f является не обязательной

и может отсутствовать. Достаточно просто указать имя файла.

Выводит информацию о версии PHP, PHP SAPI и Zend, например:

$ php -v
PHP4.3.0 (cli), Copyright (c) 1997-2002 The PHP Group
Zend Engine v1.3.0, Copyright (c) 1998-2002 Zend Technologies

При помощи этой опции можно указать специфическую директорию для

конфигурационного файла php.ini либо непосредственно

указать на сам INI-файл (название которого может

отличаться от стандартного php.ini), например:

$ php -c /custom/directory/ my_script.php
$ php -c /custom/directory/custom-file.ini my_script.php

В случае, если вы не используете данную опцию, конфигурационный

файл будет взят из директории по умолчанию.

Указывает на необходимость игнорировать конфигурационный файл php.ini,

доступен, начиная с PHP4.3.0.

Эта опция позволяет устанавливать специальное значение для каждой из

конфигурационных переменных, доступных в php.ini. Синтаксис выглядит следующим образом:

-d configuration_directive[=value]

Примеры (переводы строк использованы, чтобы сделать текст более читаемым):

# Если опущено значение, то соответствующей опции будет присвоено значение "1"
$ php -d max_execution_time
-r '$foo = ini_get("max_execution_time"); var_dump($foo);'
string(1) "1"
# Указание пустого значения инициализирует соответствующую опцию значением ""
php -d max_execution_time=
-r '$foo = ini_get("max_execution_time"); var_dump($foo);'
string(0) ""
# Конфигурационная переменная будет установлена любым значением,
# указанным после символа '='
$ php -d max_execution_time=20
-r '$foo = ini_get("max_execution_time"); var_dump($foo);'
string(2) "20"
$ php
-d max_execution_time=doesntmakesense
-r '$foo = ini_get("max_execution_time"); var_dump($foo);'
string(15) "doesntmakesense"

Запускает PHP в интерактивном режиме.

Генерирует дополнительную информацию для отладчика и профайлера.

Подгружает дополнительный модуль Zend. В случае, если указано только

имя файла, PHP ищет модуль в текущем пути к библиотекам по умолчанию

(в Linux-системах он обычно указан в /etc/ld.so.conf).

В случае, если указано имя файла и полный путь к нему, поиск в системных

библиотеках не производится. Указание относительного пути к модулю приведет

к поиску файла по указанному пути относительно текущей директории.

Эта опция предоставляет удобный способ для проверки заданного

PHP-кода на наличие синтаксических ошибок.

В случае успешной проверки будет напечатана следующая фраза:

"No syntax errors detected in <filename>",- и

код возврата будет равен 0. А в случае неудачи - текст "Errors parsing

<filename>" вместе с внутренними сообщениями разборщика и код

возврата 255.

Проверка исходного кода при помощи данной опции не находит фатальных

ошибок (например, таких как вызов неопределенных функций). Используйте

опцию -f, если вы хотите проверить код на наличие

фатальных ошибок.

Замечание:

Эта опция не совместима с опцией -r.

При использовании этой опции PHP напечатает список встроенных

(а также подгруженных) модулей Zend и PHP.

$ php -m
[PHP Modules]
xml
tokenizer
standard
session
posix
pcre
overload
mysql
mbstring
ctype
[Zend Modules]

и выводу результирующей информации. В случае, если PHP работает

некорректно, будет весьма логично выполнить php -i и посмотреть,

выводятся ли сообщения об ошибке до информационных таблиц или даже вместо них.

Учтите, что в случае использования CGI-модуля весь вывод будет в

формате HTML и, как следствие, может выглядеть нечитабельно.

Эта опция позволяет выполнять PHP-код, указанный

непосредственно в командной строке. Открывающие и завершающие PHP-теги (<?php и ?>) не нужны и, более того, приводят к синтаксической ошибке.

Замечание:

При использовании этого ключа следует быть очень осторожным и избегать недоразумений, связанных с автоматической подстановкой переменных окружения.

Вот пример, приводящий к синтаксической ошибке:

$ php -r "$foo = get_defined_constants();"
Command line code(1) : Parse error - parse error, unexpected '='

Проблема заключается в том, что sh/bash выполняет автоматическую

подстановку переменных в случае, если используются двойные кавычки

("). Поскольку переменная $foo

вряд ли определена, она заменяется пустой строкой, так что

передаваемый PHP-код для выполнения выглядит следующим

образом:

$ php -r " = get_defined_constants();"

Правильным решением в данном случае будет использование

одиночных кавычек ', поскольку автоматическая

подстановка переменных, заключенных в одиночные кавычки, в sh/bash не происходит.

$ php -r '$foo = get_defined_constants(); var_dump($foo);'
array(370){
["E_ERROR"]=>
int(1)
["E_WARNING"]=>
int(2)
["E_PARSE"]=>
int(4)
["E_NOTICE"]=>
int(8)
["E_CORE_ERROR"]=>
[...]

Если вы используете оболочку, отличную от sh/bash, у вас могут возникнуть

другие вопросы. В таком случае создайте рапорт о возникшей проблеме на сайте

http://bugs.php.net/ или

напишите письмо по адресу phpdoc@lists.php.net. Вы вполне можете столкнуться

с проблемами при попытке получить доступ к переменным оболочки или

при работе с экранирующими обратными слешами. Мы вас предупредили.

Замечание:

Ключ -r доступен в CLI

SAPI и не доступен в CGI SAPI.

списке опций командной строки и их краткое описание.

Пример 43-1. Скрипт, предназначенный для запуска из командной строки (script.php)

Пример 43-2. Пакетный файл для запуска PHP-скрипта из командной строки (script.bat)

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