記錄活動

根據預設，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 可以是下列其中一個值：

記錄資訊會新增至 phperrors.log 檔案。

PHP 會在初始化時讀取組態檔，並將資料儲存在快取中；它也提供 API，以更新這些設定並立即使用，再寫入至組態檔。此 API 讓應用程式指令碼即使在 PHP 初始化之後仍可變更設定。

若要開啟記錄，您可以使用 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 設定值的常數：