配置驱动程序

本主题列出了 SQL Server Driver for PHP 的配置选项,并提供了有关更改配置设置的信息。

若要检索驱动程序当前的配置设置,请使用 sqlsrv_get_config 函数。若要更改配置设置,请使用 sqlsrv_configure 函数或在 php.ini 文件中设置配置设置的值。有关更改配置设置的详细信息,请参阅如何配置错误和警告处理将活动记入日志

配置选项

SQL Server Driver for PHP 有三个配置选项:LogSubsystemsLogSeverityWarningsReturnAsErrors。这些设置的默认值分别为 SQLSRV_LOG_SYSTEM_OFFSQLSRV_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 表示不会将警告视为错误。有关详细信息,请参阅如何处理错误和警告

另请参见

概念

SQLSRV 常量

其他资源

入门
编程指南
API 参考 (SQL Server Driver for PHP)