Список основных опций конфигурации
Ниже приведён частичный список опций конфигурации, используемых скриптами
configure при компиляции в Unix-подобных
окружениях. Большинство опций конфигурации приведено в соответствующих
местах на страницах с описанием расширений, а не здесь. Чтобы получить полный
актуальный список опций конфигурации, запустите ./configure --help
в каталоге исходного кода PHP после запуска команды autoconf
(см. также раздел установки PHP).
Вам также может быть интересно почитать документацию команды
» 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
-
Включает правила сборки и зависимости make, неиспользуемые (а иногда запутывающие) в обычном установщике.
- --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-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 по умолчанию.
- --disable-cli
-
Отключает сборку CLI-версии PHP (опция также вызывает --without-pear). Больше информации можно получить в разделе Использование PHP в командной строке.
- --enable-phpdbg
-
Включает поддержку модуля SAPI для интерактивного дебаггера phpdbg в PHP 5.6.x и выше.
- --enable-embed[=TYPE]
-
Включает сборку встроенной библиотеки SAPI. TYPE может принимать значение
shared
илиstatic
, по умолчанию установленоshared
. - --with-nsapi=DIR
-
Указывает путь к установленному Netscape/iPlanet/SunONE веб-серверу.
- --with-servlet[=DIR]
-
Включает поддержку сервлетов. DIR - это базовая директория установки JSDK. SAPI требует java-расширения, может быть собрана как доступная для dl.
- --disable-cgi
-
Отключает сборку CGI-версии PHP.
В 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 5.3.0 этот аргумент не включен по умолчанию и больше не существует. Чтобы отключить эту возможность, ini-директива cgi.fix_pathinfo должна установлена в
0
.