記錄

PHP 用戶端程式庫符合 PSR-3 記錄標準,並提供 gRPC 呼叫記錄器。

記錄訊息的 PSR-3 記錄層級取決於事件是否成功:

記錄訊息 成功狀態 失敗狀態
線上摘要 資訊 警告
偵錯訊息 (例如通話查詢) 偵錯 注意事項

設定記錄功能

根據預設,每個程式庫記錄器都會使用 Monolog StreamHandler,在 GoogleAdsClientBuilder 中指定的預設名稱管道上寫入 STDERR。

您可以在 google_ads_php.ini 檔案中設定預設記錄器的選項:

[LOGGING]
; Optional logging settings.
logFilePath = "path/to/your/file.log"
logLevel = "INFO"

請確認執行階段 PHP 程序具備 logFilePath 中指定目錄和檔案的寫入權限。

如需進一步自訂記錄,請提供實作 GoogleAdsClientBuilder 中 LoggerInterface 的記錄器執行個體,指定自己的自訂記錄器:

$googleAdsClient = (new GoogleAdsClientBuilder())
    // ...
    ->withLogger(new MyCustomLogger())
    ->build();