PHP 客户端库符合 PSR-3 日志记录标准,并为 gRPC 调用提供日志记录器。
消息的 PSR-3 日志级别取决于事件是否成功:
| 日志消息 | 成功状态 | 故障状态 |
|---|---|---|
| 摘要(放在一行中) | 信息 | 警告 |
| 调试消息(例如,通话查询) | DEBUG | 通知 |
配置日志记录
默认情况下,每个库记录器都会使用 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();