array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'features.commandline.php', 1 => 'Работа с PHP из командной строки', 2 => 'Работа с PHP из командной строки', ), 'up' => array ( 0 => 'features.php', 1 => 'Особенности', ), 'prev' => array ( 0 => 'features.persistent-connections.php', 1 => 'Постоянные соединения с базами данных', ), 'next' => array ( 0 => 'features.commandline.differences.php', 1 => 'Основные отличия от остальных реализаций SAPI', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'features/commandline.xml', ), 'history' => array ( ), 'extra_header_links' => array ( 'rel' => 'alternate', 'href' => '/manual/en/feeds/features.commandline.atom', 'type' => 'application/atom+xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Работа с PHP из командной строки

Содержание

Введение

Основная цель CLI SAPI — разработка консольных приложений на PHP. CLI SAPI содержит много отличий от других видов SAPI, которые объясняет эта глава. Обратите внимание, что CLI SAPI и CGI — разные SAPI-интерфейсы, хотя в их поведении много общего.

CLI SAPI включается по умолчанию опцией --enable-cli, а отключается опцией --disable-cli при запуске команды ./configure.

Имя, расположение и доступность бинарных модулей CLI или CGI-интерфейса различаются в зависимости от способа установки PHP в систему. По умолчанию при выполнении команды make внутри директории с исходным кодом PHP в каталоге sapi/cgi/php-cgi создаётся модуль CGI, а в каталоге sapi/cli/php модуль CLI. Обратите внимание, что оба файла модулей называются одинаково: php. Что произойдёт при выполнении make install, зависит от того, какие опции указали на стадии конфигурирования. Команда make install скопирует в каталог {PREFIX}/bin/php CLI-модуль, если во время конфигурирования выбрали модуль SAPI наподобие apxs или указали опцию --disable-cgi, иначе команда скопирует в эту директорию CGI-модуль. Например, с опцией --with-apxs команда make install скопирует в каталог {PREFIX}/bin/php CLI-версию. После команды make install запускают команду make install-cli, когда требуется переопределить установку двоичного файла CGI-модуля, или как альтернативу указывают в строке конфигурации опцию --disable-cgi.

Замечание:

Опция --enable-cli в строке конфигурации не означает, что команда make install скопирует CLI в каталог {PREFIX}/bin/php, поскольку опции --enable-cli и --enable-cgi включены по умолчанию.

Бинарный файл CLI лежит в главном каталоге PHP-дистрибутива для Windows в виде файла php.exe, а CGI-версия — в виде файла php-cgi.exe. Кроме того, в дистрибутив входит файл php-win.exe, если PHP сконфигурировали с опцией --enable-cli-win32. Этот файл эквивалентен CLI-версии, за исключением того, что ничего не выводит, и поэтому при запуске файла не открывает окно Командной строки.

Замечание: Как узнать версию SAPI-интерфейса

Вызов в командной оболочке команды php -v выведет информацию о том, запускается двоичный php-файл как CGI- или CLI-версия SAPI-интерфейса. Информацию о SAPI-версии возвращают также функция php_sapi_name() и константа PHP_SAPI.

Замечание:

В Unix-системах страница руководства к интерфейсу CLI доступна при вызове команды man в командной оболочке: man php.