初始化
确认Endpoint
在确认您使用SDK时配置的Endpoint时，可先阅读开发人员指南中关于BLB访问域名的部分，理解Endpoint相关的概念。 百度云目前开放了多区域支持，请参考区域选择说明。
目前支持“北京”、“广州”、“苏州”、“香港”、“武汉”、“保定”、“上海”、“新加坡”等区域。
服务域名的对应信息为：
| 访问区域 | 对应Endpoint |
|---|---|
| bj | blb.bj.baidubce.com |
| gz | blb.gz.baidubce.com |
| su | blb.su.baidubce.com |
| hkg | blb.hkg.baidubce.com |
| fwh | blb.fwh.baidubce.com |
| bd | blb.bd.baidubce.com |
| fsh | blb.fsh.baidubce.com |
| sin | blb.sin.baidubce.com |
新建BlbClient
BlbClient是BLB服务的客户端，为开发者与BLB服务进行交互提供了一系列的方法。
在新建BlbClient之前，需要先创建配置文件对BlbClient进行配置，以下将此配置文件命名为YourConf.php，具体配置信息如下所示：
// 报告所有 PHP 错误
error_reporting(-1);
define('__BLB_CLIENT_ROOT', dirname(__DIR__));
// 设置BlbClient的Access Key ID、Secret Access Key和ENDPOINT
$BLB_TEST_CONFIG =
array(
'credentials' => array(
'accessKeyId' => 'your ak',
'secretAccessKey' => 'your sk',
'sessionToken' => 'your session token'
),
'endpoint' => 'http://blb.bj.baidubce.com',
'stsEndpoint' => 'http://sts.bj.baidubce.com',
);
// 设置log的格式和级别
$__handler = new \Monolog\Handler\StreamHandler(STDERR, \Monolog\Logger::DEBUG);
$__handler->setFormatter(
new \Monolog\Formatter\LineFormatter(null, null, false, true)
);
\BaiduBce\Log\LogFactory::setInstance(
new \BaiduBce\Log\MonoLogFactory(array($__handler))
);
\BaiduBce\Log\LogFactory::setLogLevel(\Psr\Log\LogLevel::DEBUG);注意：
1.在上面代码中，ACCESS_KEY_ID对应控制台中的“Access Key ID”，SECRET_ACCESS_KEY对应控制台中的“Access Key Secret”，获取方式请参考《操作指南 获取ACCESSKEY》。
2.如果用户需要自己指定域名，可以通过传入ENDPOINT参数来指定，ENDPOINT参数需要用指定区域的域名来进行定义，如服务所在区域为北京，则为http://blb.bj.baidubce.com。
3.如果不使用STS验证方式，则stsEndpoint和sessionToken可以为空或者删除。
使用AK/SK新建BlbClient
通过AK/SK方式访问BLB，用户可以参考如下代码新建一个BlbClient：
//使用PHP SDK，并且使用自定义配置文件
include 'BaiduBce.phar';
require 'YourConf.php';
use BaiduBce\BceClientConfigOptions;
use BaiduBce\Util\Time;
use BaiduBce\Util\MimeTypes;
use BaiduBce\Http\HttpHeaders;
use BaiduBce\Services\Blb\BlbClient;
//调用配置文件中的参数
global $BLB_TEST_CONFIG;
//新建BlbClient
$client = new BlbClient($BLB_TEST_CONFIG);使用STS创建BlbClient
申请STS token BLB可以通过STS机制实现第三方的临时授权访问。STS（Security Token Service）是百度智能云提供的临时授权服务。通过STS，您可以为第三方用户颁发一个自定义时效和权限的访问凭证。第三方用户可以使用该访问凭证直接调用百度智能云的API或SDK访问百度智能云资源。
通过STS方式访问BLB，用户需要先通过STS的client申请一个认证字符串，申请方式可参见百度智能云STS使用介绍。
用STS token新建BLBClient 申请好STS后，可将STStoken配置到BlbClient中，用户可以参考如下代码新建一个BlbClient： 1.首先进行STS的endpoint配置。STS的配置示例如下：
$BLB_TEST_CONFIG =
array(
'credentials' => array(
'accessKeyId' => 'your ak',
'secretAccessKey' => 'your sk',
),
'stsEndpoint' => 'http://sts.bj.baidubce.com',
);2.StsClient的示例代码如下：
//新建StsClient
$client = new StsClient($BLB_TEST_CONFIG);
$request =
array(
'acl' => $aclArray, //用户定义的acl
'durationSeconds' => 43200, //STS凭证有效时间
);
$response = $client->getSessionToken($request);
$accessKeyID= $response->accessKeyId;
$secretAccessKey= $response->secretAccessKey;
$sessionToken = $response->sessionToken;3.将获取到的accessKeyID/secretAccessKey/sessionToken写入到配置文件YourConf.php中并新建BlbClient。
$BLB_TEST_CONFIG =
array(
'credentials' => array(
'accessKeyId' => 'your ak',
'secretAccessKey' => 'your sk',
'sessionToken' => 'your session token'
),
'endpoint' => 'http://blb.bj.baidubce.com',
);
//新建BlbClient
$client = new BlbClient($BLB_TEST_CONFIG);注意： 目前使用STS配置client时，无论对应BLB服务的endpoint在哪里，endpoint都需配置为http://sts.bj.baidubce.com。
配置BlbClient
PHP SDK在\BaiduBce\Bce.php中默认设置了一些基本参数，若用户想要对参数的值进行修改，可以参考此文件来创建自身的参数配置函数，并在构造BlbClient的时候传入，传入代码参考如下：
public function CustomizedConfig() {
$customizedConfig = array(
BceClientConfigOptions::PROTOCOL => 'http',
BceClientConfigOptions::REGION => 'bj',
BceClientConfigOptions::CONNECTION_TIMEOUT_IN_MILLIS => 120 * 1000,
BceClientConfigOptions::SOCKET_TIMEOUT_IN_MILLIS => 300 * 1000,
BceClientConfigOptions::SEND_BUF_SIZE => 5 * 1024 * 1024,
BceClientConfigOptions::RECV_BUF_SIZE => 5 * 1024 * 1024,
BceClientConfigOptions::CREDENTIALS => array(
'ak' => 'your-access-key-id',
'sk' => 'your-secret-access-key',
),
'endpoint' => 'your-endpoint',
);
//利用自定义配置创建BLBClient
$customizedClient = new BlbClient($customizedConfig);
//通过自定义配置调用方法
$options = array(BlbOptions::CONFIG=>$customizedConfig);
$this->client->listBlbs($options);
}参数说明
| 参数 | 说明 | 默认值 |
|---|---|---|
| PROTOCOL | 协议 | http |
| REGION | 区域 | bj |
| CONNECTION_TIMEOUT_IN_MILLIS | 请求超时时间（单位：毫秒） | 50 * 1000 |
| SOCKET_TIMEOUT_IN_MILLIS | 通过打开的连接传输数据的超时时间（单位：毫秒） | 0（指的是无限等待，若设置非0数值需要对文件大小和网速进行评估，否则上传大文件时会产生超时） |
| SEND_BUF_SIZE | 发送缓冲区大小 | 1024 * 1024 |
| RECV_BUF_SIZE | 协议 | http |
| PROTOCOL | 接收缓冲区大小 | 10 1024 1024 |