記錄

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

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

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

設定記錄功能

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

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

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

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

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

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