8-Debugging-zh.md

← 异常处理 | Debug 机制(English) | SDK 集成 →

---

Debug 机制

PHP SDK 支持 Guzzle 线级调试输出。

<?php
require_once(__DIR__ . '/vendor/autoload.php');

$config = \Volcengine\Common\Configuration::getDefaultConfiguration()
    ->setAk("Your ak")
    ->setSk("Your sk")
    ->setRegion('cn-beijing')
    ->setDebug(true)
    ->setDebugFile('/tmp/volcengine-php-sdk-debug.log');

SDK 结构化调试日志可以通过 bitmask 单独开启。HTTP 请求和响应日志不会记录请求体或响应体。

<?php
$config->setLogLevel(
    \Volcengine\Common\SdkLogger::LOG_REQUEST |
    \Volcengine\Common\SdkLogger::LOG_RESPONSE |
    \Volcengine\Common\SdkLogger::LOG_RETRY |
    \Volcengine\Common\SdkLogger::LOG_ENDPOINT
);

也可以追加业务 User-Agent。SDK User-Agent 会始终保留为前缀：

<?php
$config->setUserAgent('my-app/1.0');

同时仍然可以使用 Configuration::toDebugReport() 收集运行环境信息。

---

← 异常处理 | Debug 机制(English) | SDK 集成 →