安装MCT-PHP-SDK
更新时间：2025-08-21
安装SDK包
- 从官方网站下载PHP SDK压缩包。
-
解压安装包并浏览SDK目录：
Plain Text1BaiduBce.phar 2├──src 3│ └── BaiduBce 4│ ├── Auth //BCE签名相关 5│ ├── Exception //BCE客户端的异常 6│ ├── Http //BCE的Http通信相关 7│ ├── Log //BCE日志 8│ ├── Services 9│ │ └── Media //Media主目录，此目录必须保留 10│ │ └── MediaClient.php //Media操作类，所有操作可以通过MediaClient类可以完成 11│ └── Util //BCE公用工具 12└──vendor //第三方库 -
在脚本文件中添加以下代码并保存：
Plain Text1include 'BaiduBce.phar'; 2require 'YourConf.php';
有关配置文件的引用，请参考配置MediaClient。
安装MediaClient
配置MediaClient
MediaClient是MCT服务的PHP客户端，为开发者与MCT服务进行交互提供了一系列的方法。
在新建MediaClient之前，需要先创建配置文件对MediaClient进行配置，以下将此配置文件命名为YourConf.php，具体配置信息如下所示：
PHP
1// 报告所有 PHP 错误
2error_reporting(-1);
3
4define('__MEDIA_CLIENT_ROOT', dirname(__DIR__));
5
6// 设置MediaClient的Access Key ID、Secret Access Key和ENDPOINT
7$MEDIA_TEST_CONFIG =
8 array(
9 'credentials' => array(
10 'ak' => 'your-access-key-id',
11 'sk' => 'your-secret-access-key',
12 ),
13 'endpoint' => 'http://media.bj.baidubce.com',
14 );
15
16// 设置log的格式和级别
17$__handler = new \Monolog\Handler\StreamHandler(STDERR, \Monolog\Logger::DEBUG);
18$__handler->setFormatter(
19 new \Monolog\Formatter\LineFormatter(null, null, false, true)
20);
21\BaiduBce\Log\LogFactory::setInstance(
22 new \BaiduBce\Log\MonoLogFactory(array($__handler))
23);
24\BaiduBce\Log\LogFactory::setLogLevel(\Psr\Log\LogLevel::DEBUG);注意：
1.在上面的代码中，变量AK与SK是系统分配给用户的，用于标识用户，为访问Media做签名验证。其中AK对应控制台中的“Access Key ID”，SK对应控制台中的“Access Key Secret”，获取方式请参考《操作指南 管理ACCESSKEY》。
2.ENDPOINT参数只能用指定的包含Region的域名来进行定义，目前MCP提供了“华北-北京”、“华南-广州”和“华东-苏州”三个Region。详细的服务域名可以参考：服务域名。随着Region的增加将会开放其他可以支持的域名。
新建MediaClient
在完成上述配置之后，参考如下代码新建一个MediaClient。
PHP
1//使用PHP SDK，并且使用自定义配置文件
2include 'BaiduBce.phar';
3require 'YourConf.php';
4
5use BaiduBce\Services\Media\MediaClient;
6
7//调用配置文件中的参数
8global $MEDIA_TEST_CONFIG;
9//新建MediaClient
10$client = new MediaClient($MEDIA_TEST_CONFIG);参数说明
PHP SDK在\BaiduBce\Bce.php中默认设置了一些基本参数，若用户想要对参数的值进行修改，可以参考此文件创建自身的参数配置函数，并在构造MediaClient的时候传入，传入代码参考如下：
Plain Text
1public function CustomizedConfig() {
2 $customizedConfig = array(
3 BceClientConfigOptions::PROTOCOL => 'http',
4 BceClientConfigOptions::REGION => 'bj',
5 BceClientConfigOptions::CONNECTION_TIMEOUT_IN_MILLIS => 120 * 1000,
6 BceClientConfigOptions::SOCKET_TIMEOUT_IN_MILLIS => 300 * 1000,
7 BceClientConfigOptions::SEND_BUF_SIZE => 5 * 1024 * 1024,
8 BceClientConfigOptions::RECV_BUF_SIZE => 5 * 1024 * 1024,
9 BceClientConfigOptions::CREDENTIALS => array(
10 'ak' => 'your-access-key-id',
11 'sk' => 'your-secret-access-key',
12 ),
13 'endpoint' => 'your-endpoint',
14 );
15
16 //利用自定义配置创建MediaClient
17 $customizedClient = new MediaClient($customizedConfig);
18
19 //通过自定义配置调用方法
20 $options = array('config'=>$customizedConfig);
21 $this->client->listPipelines($options);
22 }参数说明如下：
| 参数 | 说明 | 默认值 |
|---|---|---|
| PROTOCOL | 协议 | http |
| REGION | 区域 | bj（目前只支持北京地区） |
| CONNECTION_TIMEOUT_IN_MILLIS | 请求超时时间（单位：毫秒） | 50 * 1000 |
| SOCKET_TIMEOUT_IN_MILLIS | 通过打开的连接传输数据的超时时间（单位：毫秒） | 0（指的是无限等待，若设置非0数值需要对文件大小和网速进行评估，否则上传大文件时会产生超时） |
| SEND_BUF_SIZE | 发送缓冲区大小 | 1024 * 1024 |
| RECV_BUF_SIZE | 接收缓冲区大小 | 10 ** 1024 1024 |
相关说明
MediaClient将可选的参数封装到$options中，每一个方法具有的可选参数详见具体的接口使用方法介绍，现以createPipeline方法为例，参考如下代码实现设置可选参数：
Plain Text
1//利用options在通过创建Pipeline传入指定可选参数
2$options = array(
3 'description' => 'This is a test pipeline',
4 'pipelineConfig' => array(
5 'capacity' => 15,
6 ),
7);
8$client->createPipeline($pipelineName, $sourceBucket, $targetBucket, $options);注意：不要把null传入$options中，否则调用时会抛出异常。