日志记录

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();