日志记录

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