Глава 3. Конфигурирование

Содержание

Файл конфигурации

Файл конфигурации

Файл конфигурации (php3.ini в PHP 3.0 и просто php.ini в PHP 4.0) читается при старте PHP. Для версий серверных модулей PHP это происходит один раз при старте web-сервера. Для CGI и CLI-версий это происходит при каждом вызове.

По умолчанию php.ini размещается как опция времени компиляции (см. FAQ), но местоположение может быть изменено для CGI и CLI-версий ключом командной строки -c (см. главу об использовании PHP из командной строки. Вы можете использовать также переменную окружения PHPRC для добавления пути поиска php.ini.

; любой текст в строке после незакавыченного символа ; игнорируется
[php] ; маркёры раздела (текст в квадратных скобках) также игнорируются
; Boolean-значения могут быть установлены в true, on, yes
; или в false, off, no, none
register_globals = off
magic_quotes_gpc = yes

; вы можете заключать строки в двойные кавычки
include_path = ".:/usr/local/lib/php"

; обратные слэши (\) рассматриваются так же, как любой другой символ
include_path = ".;c:\php\lib"

При использовании PHP как Apache-модуля вы можете также изменить установки конфигурации, используя директивы файлов конфигурации Apache и файлы .htaccess. Вам для этого необходимы привилегии "AllowOverride Options" или "AllowOverride All").

Для PHP 3.0 имеются директивы Apache, которые соответствуют каждому имени установки конфигурации в php3.ini, исключая имена с префиксом "php3_".

Для PHP 4.0 имеются несколько директив Apache, которые позволяют изменять конфигурацию PHP и в самом файле конфигурации Apache.

php_value name value

Устанавливает значение специфицированной переменной.

php_flag name on|off

Используется для установки булевой опции конфигурации.

php_admin_value name value

Устанавливает значение специфицированной переменной. Установки конфигурации "Admin" могут устанавливаться только в главных файлах конфигурации Apache, но не в .htaccess-файлах.

php_admin_flag name on|off

Используется для установки булевой опции конфигурации.

<IfModule mod_php4.c>
php_value include_path ".:/usr/local/lib/php"
php_flag safe_mode on
</IfModule>
<IfModule mod_php3.c>
php3_include_path ".:/usr/local/lib/php"
php3_safe_mode on
</IfModule>

Вы можете увидеть значения конфигурации на выводе phpinfo(). Можно также получить доступ к значениям отдельных установок конфигурации с помощью get_cfg_var().

Главные директивы конфигурации

allow_url_fopen boolean

Эта опция включает знающие об URL fopen-оболочки, которые делают возможным доступ к URL-объектам наподобие файлов. Оболочки по умолчанию предоставляются для доступа к удалённым файлам через использование протокола ftp или http, некоторые расширения наподобие zlib могут регистрировать дополнительные оболочки.

Примечание: эта опция была введена сразу после появления версии 4.0.3. Для версий до 4.0.3 включительно вы можете только отключать эту возможность на этапе компиляции, используя ключ конфигурации --disable-url-fopen-wrapper.

include_path=.:/home/httpd/php-lib

include_path=".;c:\www\phplib"

Директивы конфигурации Безопасного Режима/Safe Mode

safe_mode boolean

Включает/отключает безопасный режим PHP. Дополнительно см. главы Безопасность и Безопасный Режим.

safe_mode_gid boolean

Использовать ли проверку UID (FALSE) или GID (TRUE) после доступа к файлам. См. Безопасный Режим.

safe_mode_exec_dir string

Если PHP используется в безопасном режиме, system() и другие функции, выполняющие системные программы, не стартуют программы, которые находятся вне данной директории.

safe_mode_include_dir string

Проверки UID/GID пропускаются, когда файлы подключаются из данной директории и её поддиректорий (директория также обязана находиться в include_path, или должен вводиться полный путь).

Директивы конфигурации отладчика

debugger.host string

DNS-имя или IP-адрес хоста, используемого отладчиком.

debugger.port string

Номер порта, используемого отладчиком.

debugger.enabled boolean

Включён ли отладчик.

Директивы загрузки расширений

enable_dl boolean

Данная директива реально используется только в версии Apache-модуля PHP. Вы можете включать/выключать динамическую загрузку расширений PHP с помощью dl() на уровне виртуального сервера или директории.

Главной причиной выключения динамической загрузки является безопасность. При динамической загрузке имеется возможность игнорировать все ограничения safe_mode и open_basedir.

По умолчанию динамическая загрузка разрешена, исключая использование safe-mode. В safe-mode всегда отсутствует возможность использования dl().

extension_dir string

В какой директории PHP должен искать динамически загружаемые расширения.

extension string

Какие динамически загружаемые расширения загружать при старте PHP.

Директивы конфигурации mSQL

msql.allow_persistent boolean

Разрешены ли постоянные mSQL-соединения.

msql.max_persistent integer

Максимальное количество постоянных mSQL-соединений на процесс.

msql.max_links integer

Максимальное количество mSQL-соединений на процесс, включая постоянные соединения.

Директивы конфигурации Postgres

pgsql.allow_persistent boolean

Разрешены ли постоянные Postgres-соединения.

pgsql.max_persistent integer

Максимальное количество постоянных Postgres-соединений на процесс.

pgsql.max_links integer

Максимальное количество Postgres-соединений на процесс, включая постоянные соединения.

Директивы конфигурации SESAM

sesam_oml string

Имя BS2000 PLAM-библиотеки, содержащей загружаемые модули драйвера SESAM. Необходимо для использования функций SESAM. Библиотека BS2000 PLAM обязана быть установлена ACCESS=READ,SHARE=YES, поскольку она обязана читаться user id идентификатором Аpache-сервера.

sesam_configfile string

Имя файла конфигурации приложения SESAM. Необходимо для использования SESAM-функций. Файл BS2000 обязан читаться user id идентификатором Аpache-сервера.

Файл конфигурации приложения обычно содержит конфигурацию наподобие (см. учебник-справочник SESAM):

CNF=B NAM=K NOTYPE

sesam_messagecatalog string

Имя файла каталога сообщений SESAM. В большинстве случаев эта директива не нужна. Только если файл сообщений SESAM не установлен в таблице системного файла сообщений BS2000, оно может быть установлено этой директивой.

Каталог сообщений обязан иметь установки ACCESS=READ,SHARE=YES, поскольку он обязан читаться user id идентификатором Аpache-сервера.

Директивы конфигурации Sybase

sybase.allow_persistent boolean

Разрешены ли постоянные Sybase-соединения.

sybase.max_persistent integer

Максимальное количество постоянных Sybase-соединений на процесс.

sybase.max_links integer

Максимальное количество Sybase-соединений на процесс, включая постоянные соединения.

Директивы конфигурации Sybase-CT

sybct.allow_persistent boolean

Разрешены ли постоянные Sybase-CT-соединения. По умолчанию on.

sybct.max_persistent integer

Максимальное количество постоянных Sybase-СТ-соединений на процесс. По умолчанию -1, что означает "без ограничений".

sybct.max_links integer

Максимальное количество Sybase-СТ-соединений на процесс, включая постоянные соединения. По умолчанию -1, что означает "без ограничений".

sybct.min_server_severity integer

Сообщения сервера с уровнем серьёзности более или равном sybct.min_server_severity будут выводиться как предупреждения/warnings. Это значение может также быть установлено из скрипта через вызов sybase_min_server_severity(). По умолчанию 10, что сообщает об ошибках уровня information или выше.

sybct.min_client_severity integer

Сообщения клиентской библиотеки с уровнем серьёзности равным или больше sybct.min_client_severity будут выводиться как предупреждения. Это значение может также быть установлено из скрипта через вызов sybase_min_server_severity(). По умолчанию 10, что отключает сообщения.

sybct.login_timeout integer

Максимальный период в секундах ожидания успешного соединения, до того как возвратить failure/неудачное выполнение. Обратите внимание, что, если max_execution_time истёк при попытке таймаута соединения, выполнение вашего скрипта будет прервано до того как он предпримет действия при неудачной попытке соединения. По умолчанию - одна минута.

sybct.timeout integer

Максимальный период в секундах ожидания успешного выполнения select_db или операции запроса/query, до того как возвратить failure/неудачное выполнение. Обратите внимание, что, если max_execution_time истёк, когда операция взяла таймаут, выполнение вашего скрипта будет прервано до того как он предпримет действия при неудачной попытке соединения. По умолчанию ограничения нет.

sybct.hostname string

Имя хоста, соединения с которым вы требуете, для вывода в sp_who. По умолчанию none.

Директивы конфигурации Informix

ifx.allow_persistent boolean

Разрешены ли постоянные Informix-соединения.

ifx.max_persistent integer

Максимальное количество постоянных Informix-соединений на процесс.

ifx.max_links integer

Максимальное количество Informix-соединений на процесс, включая постоянные соединения.

ifx.default_host string

Хост по умолчанию для соединения, если никакой хост не специфицирован в ifx_connect() или в ifx_pconnect().

ifx.default_user string

Идентификатор user id по умолчанию, если none специфицирован в ifx_connect() или в ifx_pconnect().

ifx.default_password string

Пароль/password для использования по умолчанию, если none специфицирован в ifx_connect() или в ifx_pconnect().

ifx.blobinfile boolean

Установите TRUE, если хотите возвратить blob-столбцы в файле, и FALSE, если возвратить в памяти. Вы можете переопределять эту установку на этапе прогона с помощью ifx_blobinfile_mode().

ifx.textasvarchar boolean

Установите TRUE, если хотите возвратить TEXT-столбцы как нормальные строки в выбранных операторах, и FALSE, если хотите использовать blob id параметры. Вы можете переопределять эту установку на этапе прогона с помощью ifx_textasvarchar().

ifx.byteasvarchar boolean

Установите TRUE, если хотите возвратить BYTE-столбцы как нормальные строки в выбранных запросах/queries, и FALSE, если хотите использовать blob id параметры. Вы можете переопределять эту установку на этапе прогона с помощью ifx_textasvarchar().

ifx.charasvarchar boolean

Установите TRUE, если хотите удалить ведомые пробелы из CHAR-столбцов при их получении.

ifx.nullformat boolean

Установите TRUE, если хотите возвратить NULL-столбцы как литеральные строки "NULL", и FALSE, если хотите возвратить их как пустую строку "". Вы можете переопределять эту установку на этапе прогона с помощью ifx_nullformat().

Директивы конфигурации BC Math

bcmath.scale integer

Количество десятичных цифр для всех bcmath-функций.

Директивы конфигурации Browser Capability

browscap string

Имя browser capabilities-файла. См. также get_browser().

Директивы конфигурации Multi-Byte String

mbstring.internal_encoding string

mbstring.internal_encoding - определяет внутреннюю кодировку символов по умолчанию.

mbstring.http_input string

mbstring.http_input - определяет кодировку символов по умолчанию для HTTP-ввода.

mbstring.http_output string

mbstring.http_output - определяет кодировку символов по умолчанию для HTTP-вывода.

mbstring.detect_order string

mbstring.detect_order - определяет порядок определения кодировки символов по умолчанию.

mbstring.substitute_character string

mbstring.substitute_character - определяет символ для замещения неверных кодов символов.

Директивы конфигурации Exif

Exif поддерживает автоматическую конвертацию кодировок символов Unicode и JIS пользовательских комментариев, когда модуль mbstring доступен. При этом комментарий сначала декодируется с использованием специфицированного набора символов. Затем результат кодируется в другом наборе символов, который должен совпадать с вашим HTTP-выводом.

exif.encode_unicode string

exif.encode_unicode - определяет набор символов UNICODE при обработке пользовательских комментариев. По умолчанию это ISO-8859-15, который должен работать в большинстве не-азиатских стран. Эта установка может быть пустой или обязана быть кодировкой, поддерживаемой mbstring. Если она пустая, используется текущая внутренняя кодировка mbstring.

exif.decode_unicode_motorola string

exif.decode_unicode_motorola - определяет внутреннюю кодировку символов изображения для Unicode-кодированных пользовательских комментариев, если изображение/image имеет байтовый порядок motorola (big-endian). Эта установка не может быть пустой, но вы можете специфицировать список кодировок, поддерживаемых mbstring. По умолчанию UCS-2BE.

exif.decode_unicode_intel string

exif.decode_unicode_intel - определяет внутреннюю кодировку символов изображения для Unicode-кодированных пользовательских комментариев, если изображение имеет байтовый порядок intel (little-endian). Эта установка не может быть пустой, но вы можете специфицировать список кодировок, поддерживаемых mbstring. По умолчанию UCS-2BE. UCS-2LE.

exif.encode_jis string

exif.encode_jis - определяет набор символов JIS для обработки пользовательских комментариев. По умолчанию - пустое значение, которое форсирует использование функцией текущей внутренней кодировки mbstring.

exif.decode_jis_motorola string

exif.decode_jis_motorola - определяет внутреннюю кодировку символов изображения для JIS-кодированных пользовательских комментариев, если изображение имеет байтовый порядок motorola (big-endian). Эта установка не может быть пустой, но вы можете специфицировать список кодировок, поддерживаемых mbstring. По умолчанию JIS.

exif.decode_jis_intel string

exif.decode_jis_intel - определяет внутреннюю кодировку символов изображения для JIS-кодированных пользовательских комментариев, если изображение имеет байтовый порядок intel (little-endian). Эта установка не может быть пустой, но вы можете специфицировать список кодировок, поддерживаемых mbstring. По умолчанию JIS.