Список основных опций конфигурации
Ниже приведён частичный список опций конфигурации, используемых скриптами configure при компиляции в Unix-подобных окружениях. Большинство опций конфигурации приведено в соответствующих местах на страницах с описанием расширений, а не здесь. Чтобы получить полный актуальный список опций конфигурации, запустите ./configure --help в каталоге исходного кода PHP после запуска команды autoconf (см. также главу Установка). Вам также может быть интересно почитать документацию команды » GNU configure для получения информации о дополнительных опциях команды configure, таких, как --prefix=PREFIX.
Замечание:
Эти настройки используются только во время компиляции. Если вы хотите изменить конфигурацию PHP во время выполнения, пожалуйста смотрите главу Конфигурация во время выполнения.
Опции конфигурации в PHP
Различные опции
- --enable-debug
-
Компилировать с информацией об отладке.
- --with-layout=TYPE
-
Устанавливает, каким образом установленные файлы будут расположены. TYPE принимает значения PHP (по умолчанию) или GNU.
- --with-pear=DIR
-
Установить PEAR в DIR (по умолчанию PREFIX/lib/php).
- --without-pear
-
Не устанавливать PEAR.
- --enable-sigchild
-
Включить собственный дескриптор SIGCHLD для PHP.
- --disable-rpath
-
Не передавать дополнительные пути для поиска библиотек времени исполнения.
- --enable-libgcc
-
Явно использовать libgcc.
- --enable-php-streams
-
Включить экспериментальный функционал потоков PHP. Используйте только в случае, если вы тестируете код!
- --with-zlib-dir[=DIR]
-
Определить местонахождение библиотеки zlib.
- --with-tsrm-pthreads
-
Использовать нити (threads) POSIX (по умолчанию).
-
Собирать общие библиотеки [по умолчанию=yes].
- --enable-static[=PKGS]
-
Собирать статические библиотеки [по умолчанию=yes].
- --enable-fast-install[=PKGS]
-
Оптимизировать для быстрой установки [по умолчанию=yes].
- --with-gnu-ld
-
Предполагать, что компилятор С использует GNU ld [по умолчанию=no].
- --disable-libtool-lock
-
Избегать блокирования (может испортить параллельные сборки).
- --with-pic
-
Пытаться использовать только 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 опции
- --enable-maintainer-mode
-
Включает правила сборки и зависимости, неиспользуемые (и иногда конфликтующие) в обычном инсталляторе.
- --with-config-file-path=PATH
-
Устанавливает путь для поиска php.ini, значение по умолчанию PREFIX/lib.
- --enable-safe-mode
-
Включает безопасный режим по умолчанию.
ВниманиеДанная возможность была помечена УСТАРЕВШЕЙ начиная с версии PHP 5.3.0 и была УДАЛЕНА в версии PHP 5.4.0.
- --with-exec-dir[=DIR]
-
Разрешает запуск исполняемых файлов только из директории DIR в безопасном режиме, по умолчанию /usr/local/php/bin.
ВниманиеДанная возможность была помечена УСТАРЕВШЕЙ начиная с версии PHP 5.3.0 и была УДАЛЕНА в версии PHP 5.4.0.
- --enable-magic-quotes
-
Включает автоматическое экранирование специальных символов по умолчанию.
ВниманиеДанная возможность была помечена УСТАРЕВШЕЙ начиная с версии PHP 5.3.0 и была УДАЛЕНА в версии PHP 5.4.0.
-
Запрещает использование краткой формы записи начального тега <? по умолчанию.
- --enable-zend-multibyte
-
Включает поддержку многобайтового кода в синтаксическом и лексическом анализаторе языка при запуске. Когда PHP скомпилирован с этой опцией, становится активной также директива encoding в конструкции declare.
ВниманиеДанная возможность была помечена УСТАРЕВШЕЙ начиная с версии PHP 5.3.0 и была УДАЛЕНА в версии PHP 5.4.0.
- --with-libdir
-
Определяет каталог библиотек для сборки 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.
- --disable-cli
-
Доступно с версии 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)
- --disable-cgi
-
Отключает сборку 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.
Коментарии
please somebody tell me how to display configure options used in php actual binary
it was shown in phpinfo() some years before, it was very useful, specially with 'phpize' recompilation and to enable some pecl/pear module :/
please tell me also which ctriteria had php guys used to suddenly decided to hide (or obfuscate) this info :/
thanks in advance
i'll answer myself (FINALLY!)
current "configure options" can be viewed with "php-config" shell script, aside with other compile time options too =D!!! ...
in some distributions it comes with the "php-devel" package... but until in this online manual "php-config" is mentioned in pecl extensions documentation (i couldn't find on pecl site), idk if that "php-devel" has something to do with this
... however i noticed they are literal strings inside the script, i hope the script itself were built together with php compilation o_O
in the previous page "configure options" (link shown above ^), there is an editor note with additional info about it