ドライバーの構成
このトピックでは、SQL Server Driver for PHP の構成オプションと、構成設定の変更に関する情報を示します。
ドライバの現在の構成設定を取得するには、sqlsrv_get_config 関数を使用します。構成設定を変更するには、sqlsrv_configure 関数を使用するか、php.ini ファイルで構成設定の値を設定します。構成設定の変更の詳細については、「エラーおよび警告の処理を構成する方法」および「アクティビティのログ記録」を参照してください。
構成オプション
SQL Server Driver for PHP には、LogSubsystems、LogSeverity、および WarningsReturnAsErrors という 3 つの構成オプションがあります。これらの設定の既定値は、それぞれ、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 に設定すると、警告はエラーとして扱われません。詳細については、「エラーおよび警告を処理する方法」を参照してください。