配置驱动程序
本主题列出了 SQL Server Driver for PHP 的配置选项,并提供了有关更改配置设置的信息。
若要检索驱动程序当前的配置设置,请使用 sqlsrv_get_config 函数。若要更改配置设置,请使用 sqlsrv_configure 函数或在 php.ini 文件中设置配置设置的值。有关更改配置设置的详细信息,请参阅如何配置错误和警告处理和将活动记入日志。
配置选项
SQL Server Driver for PHP 有三个配置选项:LogSubsystems、LogSeverity 和 WarningsReturnAsErrors。这些设置的默认值分别为 SQLSRV_LOG_SYSTEM_OFF、SQLSRV_LOG_SEVERITY_ERROR(启用日志记录后)和 true (1)。以下部分介绍这些配置选项及其可能的设置。
LogSubsystems 选项
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)启用日志记录。 |
LogSeverity 选项
LogSeverity 设置用于指定启用日志记录后记录的内容。下表列出了此设置的可能值。
值(括号中为等效整数) | 说明 |
---|---|
SQLSRV_LOG_SEVERITY_ALL (-1) |
指定将错误、警告和通知记入日志。 |
SQLSRV_LOG_SEVERITY_ERROR (1) |
指定将错误记入日志。此值为启用日志记录后的默认值。 |
SQLSRV_LOG_SEVERITY_WARNING (2) |
指定将警告记入日志。 |
SQLSRV_LOG_SEVERITY_NOTICE (4) |
指定将通知记入日志。 |
WarningsReturnAsErrors 选项
WarningsReturnAsErrors 选项用于指定是否将调用 sqlsrv 函数生成的警告视为错误。将此选项设置为 1(默认值)表示将警告视为错误。将此选项设置为 0 表示不会将警告视为错误。有关详细信息,请参阅如何处理错误和警告。