负载均衡BLB

    初始化

    确认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
    上一篇
    安装
    下一篇
    普通型blb实例