Основные отличия от остальных реализаций SAPI

Основные отличия CLI-версии SAPI-интерфейса от остальных реализаций SAPI:

• В отличие от CGI-версии SAPI-интерфейса, заголовки не пишутся в поток вывода.

  Хотя в CGI-версии SAPI-интерфейса предусмотрели способ подавления HTTP-заголовков, в CLI SAPI заголовки включить нельзя.

  CLI по умолчанию запускается в тихом режиме, тем не менее, ключи -q и --no-header сохранили для обратной совместимости, что разрешает запускать старые CGI-скрипты.

  Текущая директория не изменяется на рабочую директорию скрипта. Ключи -C и --no-chdir сохранили для обратной совместимости.

  Сообщения об ошибках выдаются в текстовом режиме — без HTML-форматирования.

• Отдельные настройки файла php.ini переопределяются CLI SAPI, поскольку в них нет смысла при работе в командной строке:

  Переопределяемые директивы php.ini

  Директива	Значение по умолчанию в CLI-версии SAPI-интерфейса	Комментарий
  html_errors	false	Значение по умолчанию равно false, поскольку в консоли неудобно читать сообщения об ошибке с нагромождением неинтерпретируемых HTML-тегов.
  implicit_flush	true	В консоли часто требуется, чтобы вывод функции print или языковой конструкции echo сбрасывался сразу, а не хранился в буфере. При этом буферизация вывода по-прежнему поддерживается для отложенного вывода или манипуляций с данными буфера.
  max_execution_time	0 (без ограничений)	В консольном режиме средствами PHP часто выполняют расширенный, по сравнению со стандартными веб-скриптами, диапазон задач, и поскольку консольные скрипты часто выполняются долго, для директивы устанавливается значение 0 — бесконечное время выполнения скрипта.
  register_argc_argv	true	При установке значения true скрипты, которые выполняются через CLI SAPI, получают доступ к переменной argc, которая содержит количество переданных приложению аргументов, и к переменной argv с массивом текущих аргументов. При работе в CLI SAPI переменные $argc и $argv автоматически заполняются значениями. Эти значения также доступны в массиве $_SERVER, например: $_SERVER['argv']. Внимание Переменные $argv и $_SERVER['argv'] не относятся к надёжному признаку запуска скрипта из командной строки, поскольку при включённой директиве register_argc_argv переменные могли установить в других контекстах. Вместо этого проверяют значение, которое вернула функция php_sapi_name(). <?php if (php_sapi_name() === 'cli') { echo "Код запускается из командной строки!\n"; } Внимание Начиная с PHP 8.5.0 функциональность УСТАРЕЛА. Полагаться на функциональность настоятельно не рекомендуют.
  output_buffering	false	Хотя для этой опции файла php.ini жёстко установили значение false, функции буферизации вывода по-прежнему доступны.
  max_input_time	false	PHP CLI не поддерживает GET, POST или загрузку файлов.

  Замечание:

  Эти директивы нельзя инициализировать другими значениями из конфигурационного файла php.ini или любого другого, если другой файл указали. Это ограничение связано с тем, что значения применяются после обработки конфигурационных файлов. Тем не менее, эти значения могут быть изменены во время работы скрипта (хотя это не имеет особого смысла для всех них, например register_argc_argv).

  Замечание:

  Рекомендуется установить опцию ignore_user_abort для скриптов, используемых из командной строки. За подробностями обращайтесь к функции ignore_user_abort().

• Для облегчения работы в окружении оболочки определили несколько констант для потоков ввода-вывода.

• CLI SAPI не изменяет текущую директорию на директорию исполняемого скрипта.

  Пример #1 Пример, который показывает разницу с CGI-режимом SAPI-интерфейса:

  <?php

// Базовый тестовый скрипт с названием test.php
echo getcwd(), "\n";

  При работе в CGI-режиме результат работы будет таким:

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

  Это наглядно демонстрирует, что PHP изменяет текущую директорию на директорию исполняемого скрипта.

  Работа через CLI SAPI даёт другой результат:

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

  Это обеспечивает большую гибкость при написании консольных скриптов на PHP.

  Замечание:

  При запуске из командной строки с ключом -C CGI-режим SAPI-интерфейса разрешает получить поведение, которое аналогично поведению при работе через CLI SAPI.