分享方式:


記錄活動

下載 PHP 驅動程式

根據預設,Microsoft Drivers for PHP for SQL Server 所產生的錯誤與警告,並不會記錄到 PHP 系統記錄檔。 此主題討論如何設定驅動程式記錄活動。 如需有關如何設定非驅動程式特定之 PHP 錯誤處理設定的詳細資訊,請參閱 PHP 文件 \(英文\)。

使用 PDO_SQLSRV 驅動程式記錄活動

PDO_SQLSRV 驅動程式的唯一特定可用記錄設定是 php.ini 檔案中的 pdo_sqlsrv.log_severity 項目。

在 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) 的記錄。

您可以使用邏輯 OR 運算子 (|),同時為 LogSubsystems 設定設定多個值。 例如,下列程式碼行會同時開啟連接和陳述式活動的記錄:

sqlsrv_configure("LogSubsystems", SQLSRV_LOG_SYSTEM_CONN | SQLSRV_LOG_SYSTEM_STMT);

您也可以在 php.ini 檔案中為 LogSubsystems 設定指定整數值,以開啟記錄。 例如,將下列這一行新增至 php.ini 檔案的 [sqlsrv] 區段,即會開啟連接活動的記錄:

sqlsrv.LogSubsystems = 2

將整數值相加,可以同時指定多個選項。 例如,將下列這一行新增至 php.ini 檔案的 [sqlsrv] 區段,即會開啟連接和陳述式活動的記錄:

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) 指定記錄通知。

您可以使用邏輯 OR 運算子 (|),同時為 LogSeverity 設定設定多個值。 例如,下列程式碼行會指定要記錄錯誤和警告:

sqlsrv_configure("LogSeverity", SQLSRV_LOG_SEVERITY_ERROR | SQLSRV_LOG_SEVERITY_WARNING);

注意

指定 LogSeverity 設定值,並不會開啟記錄。 您必須指定 LogSubsystems 設定的值以開啟記錄,然後設定 LogSeverity 的值,以指定記錄項目的嚴重性。

您也可以在 php.ini 檔案中使用整數值,以指定 LogSeverity 設定。 例如,將下列這一行加入至 php.ini 檔案的 [sqlsrv] 區段,將只會啟用警告的記錄:

sqlsrv.LogSeverity = 2

將整數值相加,可以同時指定多個選項。 例如,將下列這一行新增至 php.ini 檔案的 [sqlsrv] 區段,即會啟用錯誤和警告的記錄:

sqlsrv.LogSeverity = 3

另請參閱

Microsoft Drivers for PHP for SQL Server 的程式設計指南

常數 (Microsoft Drivers for PHP for SQL Server)

sqlsrv_configure

sqlsrv_get_config

SQLSRV 驅動程式 API 參考