Ведение журнала

Статья
06/02/2023

По умолчанию ошибки и предупреждения, созданные Драйверы Microsoft SQL Server для PHP, не регистрируются в системном журнале PHP. В этом разделе показано, как настроить ведение журнала драйвера. Дополнительные сведения о настройке параметров обработки ошибок PHP, которые не относятся к драйверам, см. в документации по PHP.

Ведение журнала с помощью драйвера PDO_SQLSRV

Единственной конфигурацией, доступной для драйвера PDO_SQLSRV, является запись pdo_sqlsrv.log_severity в файле php.ini.

Добавьте следующий код в конец файла php.ini:

[pdo_sqlsrv]  
pdo_sqlsrv.log_severity = <number>

log_severity может являться одним из следующих значений:

Значение	Описание
0	Ведение журнала отключено (значение по умолчанию, если не указано иное).
-1	Указывает на регистрацию ошибок, предупреждений и уведомлений.
1	Указывает, что регистрируются ошибки.
2	Указывает, что регистрируются предупреждения.
4	Указывает, что регистрируются уведомления.

Сведения о ведении журнала записываются в файл phperrors.log.

PHP считывает файл конфигурации при инициализации и сохраняет данные в кэш. Он также предоставляет API для обновления этих параметров и оперативного использования, который записывается в файл конфигурации. Этот API позволяет скриптам приложений изменить параметры даже после инициализации PHP.

Ведение журнала с помощью драйвера SQLSRV

Чтобы включить ведение журнала, можно использовать функцию sqlsrv_configure или изменить файл php.ini. Вы можете вести журнал для инициализаций, соединений, инструкций или функций ошибок. Также можно указать, следует ли вести журналы ошибок, предупреждений и (или) уведомлений.

Примечание

Расположение файла журнала можно настроить в файле php.ini. Дополнительные сведения см. в документации по PHP.

Включение ведения журнала

Вы можете включить ведение журнала, воспользовавшись функцией sqlsrv_configure, чтобы указать значение для параметра LogSubsystems. Например, следующая строка кода настраивает драйвер на регистрацию событий для соединений:

sqlsrv_configure("LogSubsystems", SQLSRV_LOG_SYSTEM_CONN);

Следующая таблица содержит константы, которые можно использовать в качестве значения для параметра LogSubsystems :

Значение (целочисленный эквивалент в скобках)	Описание
SQLSRV_LOG_SYSTEM_ALL (-1)	Включает ведения журнала для всех подсистем.
SQLSRV_LOG_SYSTEM_OFF (0)	Отключает ведение журнала. Это значение по умолчанию.
SQLSRV_LOG_SYSTEM_INIT (1)	Включает ведения журнала по инициализации.
SQLSRV_LOG_SYSTEM_CONN (2)	Включает ведения журнала по соединениям.
SQLSRV_LOG_SYSTEM_STMT (4)	Включает ведения журнала по инструкциям.
SQLSRV_LOG_SYSTEM_UTIL (8)	Включает ведение журнала по функция ошибок (таким как handle_error и handle_warning).

Для параметра LogSubsystems можно задать сразу несколько значений, воспользовавшись оператором логического ИЛИ (|). Например, следующая строка кода включает ведение журнала как для соединений, так и для инструкций:

sqlsrv_configure("LogSubsystems", SQLSRV_LOG_SYSTEM_CONN | SQLSRV_LOG_SYSTEM_STMT);

Вы также можете включить ведение журнала, указав целочисленное значение для параметра LogSubsystems в файле php.ini. Например, добавление следующей строки в раздел [sqlsrv] файла php.ini включает ведение журнала для соединений:

sqlsrv.LogSubsystems = 2

Путем сложения целочисленных значений можно указать сразу несколько параметров. Например, добавление следующей строки в раздел [sqlsrv] файла php.ini включает ведение журнала для соединений и инструкций:

sqlsrv.LogSubsystems = 6

Ведение журнала ошибок, предупреждений и уведомлений

После включения ведения журнала необходимо указать, что именно следует регистрировать. Можно записывать в журнал один или несколько следующих элементов: ошибки, предупреждения и уведомления. Например, следующая строка кода указывает, что регистрируются только предупреждения:

sqlsrv_configure("LogSeverity", SQLSRV_LOG_SEVERITY_WARNING);

Примечание

Значением LogSeverity по умолчанию является SQLSRV_LOG_SEVERITY_ERROR. Если ведение журнала включено, а значение для LogSeverity не указано, регистрируются только ошибки.

Следующая таблица содержит константы, которые можно использовать в качестве значения для параметра LogSeverity :

Значение (целочисленный эквивалент в скобках)	Описание
SQLSRV_LOG_SEVERITY_ALL (-1)	Указывает на регистрацию ошибок, предупреждений и уведомлений.
SQLSRV_LOG_SEVERITY_ERROR (1)	Указывает, что регистрируются ошибки. Это значение по умолчанию.
SQLSRV_LOG_SEVERITY_WARNING (2)	Указывает, что регистрируются предупреждения.
SQLSRV_LOG_SEVERITY_NOTICE (4)	Указывает, что регистрируются уведомления.

Для параметра LogSeverity можно задать сразу несколько значений, воспользовавшись оператором логического ИЛИ (|). Например, следующая строка кода задает регистрацию ошибок и предупреждений:

sqlsrv_configure("LogSeverity", SQLSRV_LOG_SEVERITY_ERROR | SQLSRV_LOG_SEVERITY_WARNING);

Примечание

Указание значения для параметра LogSeverity не включает ведение журнала. Необходимо включить ведение журнала, указав значение для параметра LogSubsystems, а затем указать уровень серьезности регистрируемых сведений, задав значение LogSeverity.

Значение для параметра LogSeverity Можно также указать с помощью целочисленных значений в файле php.ini. Например, при добавлении следующей строки в раздел [sqlsrv] файла php.ini ведение журнала включается только для предупреждений:

sqlsrv.LogSeverity = 2

Путем сложения целочисленных значений можно указать сразу несколько параметров. Например, при добавлении следующей строки в раздел [sqlsrv] файла php.ini включается ведение журнала ошибок и предупреждений:

sqlsrv.LogSeverity = 3