2.2 KiB
2.2 KiB
通用配置
了解如何配置 SDK,如日志、重试、服务访问端点(公有云、专有云)等。
配置项清单
配置 | 类型 | 描述 |
---|---|---|
region | string | (必填)服务所在地域,可参考 地域和可用区列表 |
projectId | string | (选填)项目的唯一标识,用于组织资源,大多数资源都需要 ProjectId,如果是主账号或财务账号,默认值为默认 ProjectId,如果是子账号非财务账号,则该字段必须填写。 |
baseUrl | string | (选填) API 服务的访问端点,默认是 https://api.ucloud.cn |
userAgent | string | (选填)UserAgent 是 SDK 客户端特有的属性,用于区分使用 SDK 的版本。User-Agent 的定义请参考 MDN。用户自定义的 UserAgent 将追加到 SDK 版本号的末尾。例如, “MyAPP/0.10.1” -> “PHP/8.0.6 PHP-SDK/0.1.0 MyAPP/0.10.1” |
timeout | int | (选填)请求超时时间,默认 30s |
maxRetries | int | (选填)最大重试次数. 默认重试 3 次。设置该值大于 0 将对网络和服务可用性问题进行自动重试,使用指数退避的重试间隔,并自动跳过资源创建类的接口。 |
logger | LoggerInterface | (选填)自定义 Logger,可参考 PSR-3 Logger Interface 的定义 |
进阶配置选项
修改默认日志
关闭日志:
use UCloud\Core\Client;
use UCloud\Core\Logger\DisabledLogger;
$client = new Client([
// ...
"logger" => new DisabledLogger(),
]);
访问专有云/渠道云或其它网关
use UCloud\Core\Client;
$client = new Client([
// ...
"region" => "专有云地域", // 替换成专有地域
"base_url" => "foo.api.ucloud.cn", // 替换成专有云网关
]);