Основные директивы конфигурации

Как было ранее сказано, файл конфигурации является средством, которое контролирует многие аспекты поведения РНР. В зависимости от версии РНР он может называться php.ini, php3.ini или по-другому. Интерпретатор РНР ищет эти файлы в текущей рабочей директории, т. е. в пути, обозначенном системной переменной РНРРС, и в пути, определенном в процессе компиляции. Для операционной системы Windows путь во время компиляции устанавливается как путь к каталогу Windows (например, С: /Windows).

Синтаксис файла чрезвычайно прост: строка и необходимая конфигурация, установленная пользователем, либо по умолчанию соответствующее ей значение. Если строка начинается с точки с запятой, то все, что идет после, игнорируется. Квадратные скобки - [ ] - (например, [mail function], [Java] и др.) также игнорируются, несмотря на то что они могли бы значить что-то в будущем.

Директивы определяются использованием следующего синтаксиса:

Directive = value

Направляющие названия зависят от регистра - j ava-bar отличается от JAVA=bar.

Переменная может обозначаться: строка, номер, PHP-константа (например, E_ALL или Р_РI), одной из INI-констант (on, off, true, false, yes, no и none) либо выражением (например, E_ALL & ~E_NOTICE) или цитируемой строкой («Java»).

Выражения в INI-файлах ограничены поразрядными операторами и круглыми скобками:

Булевые флаги можно включить, используя значения 1, on, true или yes. Соответственно, их можно выключить, используя значения 0, off, false или no. Пустая строка может быть обозначена, если вы не запишете ничего после знака «равно» или воспользуетесь ключевым словом попе:

f оо =  ; устанавливает f оо значение пустой строки,

f оо = none устанавливает f оо значение пустой строки,

 foo = "none" устанавливает  оо значение "none".

Если используемые значения константы принадлежат динамически загружаемым распространителям (возможно, PHP-распространителям или Zend-расширениям), вы можете использовать эти константы только после after - строки, которая чи­тает расширения.

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

Опишем наиболее важные директивы, используемые в файле php.ini:

auto_append_file string

определяет имя файла, который автоматически проверяется после основного фай­ла. При вызове функции include () с использованием include_path можно также включить этот файл. Специальное значение поле запрещает автодобавление.

ВНИМАНИЕ

Если сценарий обрывается функцией ex i t(), автодобавление не произойдет. auto_prepend_file string

определяет имя файла, который автоматически проверяется перед основным файлом. Файл включается также, как если бы была вызвана функция include () с использованием include_path. Специальное значение поле запрещает автодобавление.

cgi_ext  string

display_errors   boolean определяют, должны ошибки печататься на экране как часть HTML-вывода или нет.

doc_root string

главный каталог (root directory) PHP на сервере. Используется, только когда он не пустой. Если РНР сконфигурирован при помощи safe mode, то никакие другие файлы за пределами этого каталога не обслуживаются.

engine boolean -

эта директива действительно полезна только в модуле РНР под Apache. Используется на сайтах, где необходимо включать и выключать синтаксический анализ РНР на определенные каталоги и виртуальные серверы. Установкой php3_engine off в допустимом месте файла httpd.conf анализатор РНР можно запрещать и разрешать.

error_log string

имя файла, с которым сохраняется журнал ошибок сценариев (log file). Если используется специальное значение syslog, ошибки отправляются в системный журнал (system logger). В UNIX это syslog (3), а в Windows NT это журнал событий (event log). Системный журнал не поддерживается в Windows 95.

error_reporting integer

устанавливает уровень сообщений об ошибках. Параметр является целым, представляющим битовую область. Добавьте те значения уровней сообщений об ошибках, которые вы хотите (табл. 5.1).

Таблица 5.1. Уровни сообщений об ошибках

open_basedir string

ограничивает файлы, которые могут открываться РНР в определенной директо­рии.

Когда сценарий пытается открыть файл с помощью, например, f open () или gzopen (), наличие/расположение файла проверяется. Когда файл находится за пределами определенной директории, РНР откажется открыть его. Все символьные ссылки определены, так что нет возможности избежать этого ограничения с помощью symlink. Специальное значение показывает, что каталог, в котором находится сценарий, используется как основной каталог. По умолчанию допуска­ется открытие всех файлов.

gpc_order   string

устанавливает допустимость Get/Post/Cookie в анализе. Установка по умолчанию этой директивы - «GPC». Установка ее в «GP», например, вынудит РНР полностью игнорировать Cookies и перезапишет любые переменные метода Get переменными метода Post с одинаковыми именами.

include_path string

определяет список каталогов, в котором будут располагаться файлы для функций require (), include () и f open_with_path (). Формат подобен формату системной переменной окружения PATH: список каталогов разделяется двоеточием в UNIX или точкой с запятой в Windows. Например:

UNIX include_path

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

Windows include_path

include_path=".;с:\www\phplibrary"

Значением по умолчанию этой директивы является только текущий каталог.

isapi ext string

log_errors boolean

обозначают, что независимые сообщения об ошибке сценария должны регистри­роваться в журнале ошибок сервера. Этот выбор является специфичным для сервера.

magic_quotes_gpc boolean

устанавливает состояние magic_quotes для GPC (Get/Post/Cookie) операций. Когда magic_quotes включено (on), все ' (одиночныекавычки), " (двойныекавычки), \ (обратные слеши) и нулевые значения записываются с обратной косой чертой автоматически. Если также включена magic_quotes_sybase, одиночная кавычка записывается с дополнительной одиночной кавычкой вместо обратной косой черты.

magic_quotes_runtime  boolean

если magic_quo'tes_runtime разрешена, большинство функций, которые возвращают данные из любого внешнего источника разной природы, включая базы данных и текстовые файлы, будут иметь кавычки, записанные с обратной косой чертой. Если magic_quotes_sybase также включены, одиночная кавычка записывается с дополнительной одиночной кавычкой вместо обрат­ной косой черты.

magic_quotes_sybase     boolean

если magic_quotes_sybase включена, при включенных magic_quotes_gpc или magic quotes runtime, то одиночная кавычка записывается с дополнительной одиночной кавычкой вместо обратной косой черты.

max_execution_time integer

определяет максимальное время в секундах, допустимое для сценария, прежде чем он будет прекращен анализатором. Это помогает защититься от некорректно написанных сценариев.

memory_limit integer

определяет максимальный размер памяти в байтах, допустимый для этого сценария. Это помогает запретить некорректно написанным сценариям использовать всю доступную память на сервере.

nsapi ext string

short_open_tag boolean

задают допустимость короткой формы тегов РНР (<? ?>). Если вы хотите использовать РНР совместно с XML, эту опцию необходимо отключить. При этом вы должны использовать длинную форму тегов (<?php  ?>).

sql.safe_mode   boolean

track_errors   boolean

если опции разрешены, последнее сообщение об ошибке всегда будет представлено в глобальной переменной $php_errormsg.

track_vars boolean

если опция разрешена, входящая информация Get, Post и Cookie может быть найдена в глобальных ассоциативных массивах $HTTP_GET_VARS, $HTTP_POST_VARS и $HTTP_COOKIE_VARS, соответственно.

upload_tmp_dir   string

временный каталог, используемый для хранения файлов при их загрузке на сервер. Должен допускать запись независимо оттого, каким пользователем РНР применяется.

userjdir   string

основное имя каталога, используемого в домашнем каталоге пользователей для файлов РНР, например public_html.

warn_plus_overloading  boolean

если разрешено, опция выдает при выводе РНР сообщение, когда оператор плюс (+) используется в строке. Это облегчает поиск сценариев, которые должны быть перезаписаны с заменой на (.).