Список основных опций конфигурации
Ниже приведён частичный список опций конфигурации, используемых скриптами configure при компиляции в Unix-подобных окружениях. Большинство опций конфигурации приведено в соответствующих местах на страницах с описанием расширений, а не здесь. Чтобы получить полный актуальный список опций конфигурации, запустите ./configure —help в каталоге исходного кода PHP после запуска команды autoconf (см. также главу Установка). Вам также может быть интересно почитать документацию команды » GNU configure для получения информации о дополнительных опциях команды configure, таких, как —prefix=PREFIX.
Замечание:
Эти настройки используются только во время компиляции. Если вы хотите изменить конфигурацию PHP во время выполнения, пожалуйста смотрите главу Конфигурация во время выполнения.
Опции конфигурации в PHP
Различные опции
Компилировать с информацией об отладке.
—with-layout=TYPE
Устанавливает, каким образом установленные файлы будут расположены. TYPE принимает значения PHP (по умолчанию) или GNU.
—with-pear=DIR
Установить PEAR в DIR (по умолчанию PREFIX/lib/php).
—without-pear
—enable-sigchild
Включить собственный дескриптор SIGCHLD для PHP.
—disable-rpath
Не передавать дополнительные пути для поиска библиотек времени исполнения.
—enable-libgcc
—enable-php-streams
Включить экспериментальный функционал потоков PHP. Используйте только в случае, если вы тестируете код!
—with-zlib-dir[=DIR]
Определить местонахождение библиотеки zlib.
—with-tsrm-pthreads
Использовать нити (threads) POSIX (по умолчанию).
—enable-shared[=PKGS]
Собирать общие библиотеки [по умолчанию=yes].
—enable-static[=PKGS]
Собирать статические библиотеки [по умолчанию=yes].
—enable-fast-install[=PKGS]
Оптимизировать для быстрой установки [по умолчанию=yes].
Предполагать, что компилятор С использует GNU ld [по умолчанию=no].
—disable-libtool-lock
Избегать блокирования (может испортить параллельные сборки).
Пытаться использовать только PIC/не-PIC объекты [по умолчанию=use both (использовать оба)]
—enable-memory-limit
Компилировать с поддержкой ограничения памяти. (не доступно начиная с PHP 5.2.1 — всегда включено)
—disable-url-fopen-wrapper
Отключить обертку fopen с поддержкой URL, которая позволяет получать доступ к файлам через HTTP или FTP. (не доступно начиная с 5.2.5)
—enable-versioning
Экспортировать только необходимую информацию для отладки. см. INSTALL для дополнительной информации.
PHP опции
Включает правила сборки и зависимости, неиспользуемые (и иногда конфликтующие) в обычном инсталляторе.
—with-config-file-path=PATH
Устанавливает путь для поиска php.ini , значение по умолчанию PREFIX/lib.
—enable-safe-mode
Включает безопасный режим по умолчанию.
Данная возможность была помечена УСТАРЕВШЕЙ начиная с версии PHP 5.3.0 и была УДАЛЕНА в версии PHP 5.4.0.
Разрешает запуск исполняемых файлов только из директории DIR в безопасном режиме, по умолчанию /usr/local/php/bin.
Данная возможность была помечена УСТАРЕВШЕЙ начиная с версии PHP 5.3.0 и была УДАЛЕНА в версии PHP 5.4.0.
Включает автоматическое экранирование специальных символов по умолчанию.
Данная возможность была помечена УСТАРЕВШЕЙ начиная с версии PHP 5.3.0 и была УДАЛЕНА в версии PHP 5.4.0.
Запрещает использование краткой формы записи начального тега
—enable-zend-multibyte
Включает поддержку многобайтового кода в синтаксическом и лексическом анализаторе языка при запуске. Когда PHP скомпилирован с этой опцией, становится активной также директива encoding в конструкции declare.
Данная возможность была помечена УСТАРЕВШЕЙ начиная с версии PHP 5.3.0 и была УДАЛЕНА в версии PHP 5.4.0.
Определяет каталог библиотек для сборки PHP в Unix системах. Для 64-битных систем опция требует особого аргумента —with-libdir=lib64 для директории lib64.
SAPI опции
Следующий список включает доступные опции SAPI (Server Application Programming Interface) для PHP.
—with-aolserver=DIR
Определяет путь к установленному AOLserver.
—with-apxs[=FILE]
Собирает динамический модуль для Apache. FILE — это опциональный путь к инструменту Apache apxs; по умолчанию для apxs. Убедитесь в том, что вы указали версию apxs, которая действительно установлена в вашей системе, а не ту, которая находится в исходниках Apache.
—with-apache[=DIR]
Собирает статичный модуль для Apache. DIR — это верхний уровень директории сборки Apache, по умолчанию /usr/local/apache .
—with-mod_charset
Включает таблицы перекодировки для модуля mod_charset (для русской версии Apache).
—with-apxs2[=FILE]
Собирает динамический модуль для Apache 2.0. FILE — это опциональный путь к инструменту Apache apxs; по умолчанию для apxs.
—with-caudium=DIR
Собирает PHP как Pike-модуль для использования с Caudium. DIR — это путь к папке сервера Caudium, по умолчанию значение установлено в /usr/local/caudium/server .
Доступно с версии PHP 4.3.0. Отключает сборку CLI-версии PHP (опция также вызывает —without-pear). Больше информации можно получить в разделе Использование PHP в командной строке.
—enable-embed[=TYPE]
Включает сборку встроенной библиотеки SAPI. TYPE может принимать значение shared или static, по умолчанию установлено shared. Доступно с версии PHP 4.3.0.
—with-fhttpd[=DIR]
Сборка fhttpd модуля. DIR — путь к исходникам fhttpd, по умолчанию /usr/local/src/fhttpd . Опция не доступна после версии PHP 4.3.0.
—with-isapi=DIR
Сборка PHP как модуля ISAPI для использования в Zeus.
—with-nsapi=DIR
Указывает путь к установленному Netscape/iPlanet/SunONE веб-серверу.
—with-phttpd=DIR
—with-pi3web=DIR
Сборка PHP как модуля для использования в Pi3Web.
—with-roxen=DIR
Сборка PHP как Pike-модуля. DIR — это базовая директория Roxen, обычно /usr/local/roxen/server .
—enable-roxen-zts
Сборка модуля Roxen, используя Zend Thread Safety.
—with-servlet[=DIR]
Включает поддержку сервлетов. DIR — это базовая директория установки JSDK. SAPI требует java-расширения, может быть собрана как доступная для dl.
—with-thttpd=SRCDIR
Сборка PHP как thttpd-модуля.
—with-tux=MODULEDIR
Сборка PHP как TUX-модуля (только для Linux).
—with-webjames=SRCDIR
Сборка PHP как WebJames-модуля (только для RISC OS)
Отключает сборку CGI-версии PHP. Доступно с версии PHP 4.3.0.
В PHP 5.3.0 этот аргумент включает FastCGI, который предварительно должен быть включен аргументом —enable-fastcgi.
—enable-force-cgi-redirect
Включает проверку безопасности для внутрисерверных переходов. Вам следует использовать её, если вы запускаете CGI-версию с Apache.
В PHP 5.3.0 эта опция включена по умолчанию и больше не нуждается в установке. Для её отключения необходимо установить ini-директиве cgi.force_redirect значение 0.
—enable-discard-path
Если эта опция включена, PHP CGI может быть безопасно размещен вне веб-дерева, и у пользователей не будет возможности обойти проверку .htaccess .
В PHP 5.3.0 этот аргумент отключен по умолчанию и более не доступен. Для его включения необходимо установить ini-директиве cgi.discard_path значение 1.
—enable-fastcgi
Если эта опция включена, то CGI-модуль будет собран с поддержкой FastCGI.
В PHP 5.3.0 этот параметр больше не доступен. Используйте вместо него —enable-cgi.
—disable-path-info-check
Если опция указана, то пути, подобные /info.php/test?a=b будут вызывать ошибки в работе. Для более детальной информации см. » Руководство Apache.
Php configure command enable
Ниже приведён частичный список опций конфигурации, используемых скриптами configure при компиляции в Unix-подобных окружениях. Большинство опций конфигурации приведено в соответствующих местах на страницах с описанием модулей, а не здесь. Чтобы получить полный актуальный список опций конфигурации, запустите ./configure —help в каталоге исходного кода PHP после запуска команды autoconf (смотрите также раздел установки PHP). Вам также может быть интересно почитать документацию команды » GNU configure для получения информации о дополнительных опциях команды configure, таких, как —prefix=PREFIX .
Замечание:
Эти настройки используются только во время компиляции. Если вы хотите изменить конфигурацию PHP во время выполнения, пожалуйста смотрите главу Конфигурация во время выполнения.
Опции конфигурации в PHP
Различные опции
Компилировать с информацией об отладке.
—with-layout=TYPE
Устанавливает, каким образом установленные файлы будут расположены. TYPE принимает значения PHP (по умолчанию) или GNU.
—with-pear=DIR
Установить PEAR в директорию DIR (по умолчанию PREFIX/lib/php).
—without-pear
—enable-sigchild
Включить собственный дескриптор SIGCHLD для PHP.
—disable-rpath
Не передавать дополнительные пути для поиска библиотек времени исполнения.
—enable-libgcc
—enable-php-streams
Включить экспериментальную функциональность потоков PHP. Используйте только в случае, если вы тестируете код!
—with-zlib-dir[=DIR]
Определить местонахождение библиотеки zlib.
—with-tsrm-pthreads
Использовать потоки (threads) POSIX (по умолчанию).
—enable-shared[=PKGS]
Собирать общие библиотеки [по умолчанию=yes].
—enable-static[=PKGS]
Собирать статические библиотеки [по умолчанию=yes].
—enable-fast-install[=PKGS]
Оптимизировать для быстрой установки [по умолчанию=yes].
Предполагать, что компилятор С использует линкер GNU ld [по умолчанию=no].
—disable-libtool-lock
Избегать блокирования (может испортить параллельные сборки).
Пытаться использовать только PIC/не PIC объекты [по умолчанию=use both (использовать оба)]
—enable-versioning
Экспортировать только необходимую информацию для отладки. Смотрите INSTALL для дополнительной информации.
Опции PHP
Включает правила сборки и зависимости make, неиспользуемые (а иногда запутывающие) в обычном установщике.
—with-config-file-path=PATH
Устанавливает путь для поиска php.ini , значение по умолчанию PREFIX/lib .
—disable-short-tags
Запрещает использование краткой формы записи начального тега
Определяет каталог библиотек для сборки PHP в Unix-системах. Для 64-битных систем опция требует особого аргумента —with-libdir=lib64 для директории lib64 .
Включает безопасность потоков. До версии PHP 8.0.0 на системах, отличных от Windows, эта опция называлась —enable-maintainer-zts.
Опции SAPI
Следующий список включает доступные опции SAPI ( Server Application Programming Interface ) для PHP.
—with-apxs[=FILE]
Собирает динамический модуль для Apache. FILE — это опциональный путь к инструменту «Apache apxs», который используется для apxs по умолчанию. Убедитесь в том, что вы указали версию apxs, которая действительно установлена в вашей системе, а не ту, которая находится в исходниках Apache.
—with-apache[=DIR]
Собирает статичный модуль для Apache. DIR — это верхний уровень директории сборки Apache, по умолчанию /usr/local/apache .
—with-mod_charset
Включает таблицы перекодировки для модуля mod_charset (для русской версии Apache).
—with-apxs2[=FILE]
Собирает динамический модуль для Apache 2.0. FILE — это опциональный путь к инструменту «Apache apxs», который используется для apxs по умолчанию.
Отключает сборку CLI-версии PHP (опция также вызывает —without-pear). Больше информации можно получить в разделе Использование PHP в командной строке.
—enable-phpdbg
Включает поддержку модуля SAPI для интерактивного дебаггера phpdbg.
—enable-embed[=TYPE]
Включает сборку встроенной библиотеки SAPI. TYPE может принимать значение shared или static , по умолчанию установлено shared .
—with-servlet[=DIR]
Включает поддержку сервлетов. DIR — это базовая директория установки JSDK. SAPI требует java-модули, может быть собрана как доступная для dl.
Отключает сборку CGI-версии PHP.
Этот аргумент включает FastCGI, который предварительно должен быть включён аргументом —enable-fastcgi .