产品动态
产品公告
php -v 命令查看当前的 PHP 版本。php -m 命令查看以上扩展是否已经安装好。sudo apt-get install php-curl php-xml php-dom php-mbstring php-json
sudo yum install php-curl php-xml php-dom php-mbstring php-json
curl -sS https://getcomposer.org/installer | php
composer.json 的文件，内容如下：{"require": {"qcloud/cos-sdk-v5": ">=2.0"}}
php composer.phar install
>= 7.2.5时自动下载 guzzle7 版本，反之下载 guzzle6 版本。require '/path/to/sdk/vendor/autoload.php';
>= 5.6 且 <7.2.5 ，请下载 cos-sdk-v5-6.phar，以使用 Guzzle6 版本。>=7.2.5 的请下载 cos-sdk-v5-7.phar，以使用 Guzzle7 版本。require '/path/to/cos-sdk-v5-x.phar';
cos-sdk-v5.tar.gz 压缩文件。>= 5.6 且 <7.2.5 ，请下载 cos-sdk-v5-6.tar.gz，以使用 Guzzle6 版本。>=7.2.5 的请下载 cos-sdk-v5-7.tar.gz ,以使用 Guzzle7 版本。autoload.php 脚本加载 SDK，在代码中引入 autoload.php 文件:require '/path/to/sdk/vendor/autoload.php';
Source code 压缩包为 Github 默认打包的代码包，里面不包含 vendor 目录。请注意下载release包（cos-sdk-v5-x.tar.gz包）而不是Source包，也不要直接 clone 整个仓库。否则会缺失index.php以及vendor包。$tmpSecretId = "TmpSecretId"; //临时密钥的 SecretId，临时密钥生成和使用指引参见 https://www.tencentcloud.com/document/product/436/14048$tmpSecretKey = "TmpSecretKey"; //临时密钥的 SecretKey，临时密钥生成和使用指引参见 https://www.tencentcloud.com/document/product/436/14048$tmpToken = "TmpToken"; //临时密钥的 Token，临时密钥生成和使用指引参见 https://www.tencentcloud.com/document/product/436/14048$region = "ap-beijing"; //替换为用户的 region，已创建桶归属的 region 可以在控制台查看，https://console.tencentcloud.com/cos5/bucket$cosClient = new Qcloud\\Cos\\Client(array('region' => $region,'schema' => 'https', //协议头部，默认为http'credentials'=> array('secretId' => $tmpSecretId,'secretKey' => $tmpSecretKey,'token' => $tmpToken)));
// SECRETID 和 SECRETKEY 请登录访问管理控制台进行查看和管理$secretId = getenv('COS_SECRET_ID'); //用户的 SecretId，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参考https://www.tencentcloud.com/document/product/598/32675$secretKey = getenv('COS_SECRET_KEY'); //用户的 SecretKey，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参考https://www.tencentcloud.com/document/product/598/32675$region = "ap-beijing"; //用户的 region，已创建桶归属的 region 可以在控制台查看，https://console.tencentcloud.com/cos5/bucket$cosClient = new Qcloud\\Cos\\Client(array('region' => $region,'schema' => 'https', //协议头部，默认为 http'credentials'=> array('secretId' => $secretId ,'secretKey' => $secretKey)));
'schema' => 'http'；若填入 https 会出现 certificate problem。若您需要配置证书，可参考 PHP SDK 常见问题。try {$bucket = "examplebucket-1250000000"; //存储桶名称 格式：BucketName-APPID$result = $cosClient->createBucket(array('Bucket' => $bucket));//请求成功print_r($result);} catch (\\Exception $e) {//请求失败echo($e);}
try {//请求成功$result = $cosClient->listBuckets();print_r($result);} catch (\\Exception $e) {//请求失败echo($e);}
# 上传文件## putObject(上传接口，最大支持上传5G文件)### 上传内存中的字符串try {$bucket = "examplebucket-1250000000"; //存储桶名称 格式：BucketName-APPID$key = "exampleobject"; //此处的 key 为对象键，对象键是对象在存储桶中的唯一标识$result = $cosClient->putObject(array('Bucket' => $bucket,'Key' => $key,'Body' => 'Hello World!'));print_r($result);} catch (\\Exception $e) {echo "$e\\n";}### 上传文件流try {$bucket = "examplebucket-1250000000"; //存储桶名称 格式：BucketName-APPID$key = "exampleobject"; //此处的 key 为对象键，对象键是对象在存储桶中的唯一标识$srcPath = "path/to/localFile";//本地文件绝对路径$file = fopen($srcPath, "rb");if ($file) {$result = $cosClient->putObject(array('Bucket' => $bucket,'Key' => $key,'Body' => $file));print_r($result);}} catch (\\Exception $e) {echo "$e\\n";}## Upload(高级上传接口，默认使用分块上传最大支持50T)### 上传内存中的字符串try {$bucket = "examplebucket-1250000000"; //存储桶名称 格式：BucketName-APPID$key = "exampleobject"; //此处的 key 为对象键，对象键是对象在存储桶中的唯一标识$result = $cosClient->Upload($bucket = $bucket,$key = $key,$body = 'Hello World!');print_r($result);} catch (\\Exception $e) {echo "$e\\n";}### 上传文件流try {$bucket = "examplebucket-1250000000"; //存储桶名称 格式：BucketName-APPID$key = "exampleobject"; //此处的 key 为对象键，对象键是对象在存储桶中的唯一标识$srcPath = "path/to/localFile";//本地文件绝对路径$file = fopen($srcPath, 'rb');if ($file) {$result = $cosClient->Upload($bucket = $bucket,$key = $key,$body = $file);}print_r($result);} catch (\\Exception $e) {echo "$e\\n";}
try {$bucket = "examplebucket-1250000000"; //存储桶名称 格式：BucketName-APPID$result = $cosClient->listObjects(array('Bucket' => $bucket));// 请求成功if (isset($result['Contents'])) {foreach ($result['Contents'] as $rt) {print_r($rt);}}} catch (\\Exception $e) {// 请求失败echo($e);}
listObjects 接口一次只能查询1000个对象，如需要查询所有的对象，则需要循环调用。try {$bucket = "examplebucket-1250000000"; //存储桶名称 格式：BucketName-APPID$prefix = ''; //列出对象的前缀$marker = ''; //上次列出对象的断点while (true) {$result = $cosClient->listObjects(array('Bucket' => $bucket,'Marker' => $marker,'MaxKeys' => 1000 //设置单次查询打印的最大数量，最大为1000));if (isset($result['Contents'])) {foreach ($result['Contents'] as $rt) {// 打印keyecho($rt['Key'] . "\\n");}}$marker = $result['NextMarker']; //设置新的断点if (!$result['IsTruncated']) {break; //判断是否已经查询完}}} catch (\\Exception $e) {echo($e);}
# 下载文件## getObject(下载文件)### 下载到内存try {$bucket = "examplebucket-1250000000"; //存储桶，格式：BucketName-APPID$key = "exampleobject"; //此处的 key 为对象键，对象键是对象在存储桶中的唯一标识$result = $cosClient->getObject(array('Bucket' => $bucket,'Key' => $key));// 请求成功echo($result['Body']);} catch (\\Exception $e) {// 请求失败echo "$e\\n";}### 下载到本地try {$bucket = "examplebucket-1250000000"; //存储桶，格式：BucketName-APPID$key = "exampleobject"; //此处的 key 为对象键，对象键是对象在存储桶中的唯一标识$localPath = @"path/to/localFile";//下载到本地指定路径$result = $cosClient->getObject(array('Bucket' => $bucket,'Key' => $key,'SaveAs' => $localPath));} catch (\\Exception $e) {// 请求失败echo "$e\\n";}### 指定下载范围/** Range 字段格式为 'bytes=a-b'*/try {$bucket = "examplebucket-1250000000"; //存储桶，格式：BucketName-APPID$key = "exampleobject"; //此处的 key 为对象键，对象键是对象在存储桶中的唯一标识$localPath = @"path/to/localFile";//下载到本地指定路径$result = $cosClient->getObject(array('Bucket' => $bucket,'Key' => $key,'Range' => 'bytes=0-10','SaveAs' => $localPath));} catch (\\Exception $e) {// 请求失败echo "$e\\n";}## getObjectUrl(获取文件 UrL)try {$bucket = "examplebucket-1250000000"; //存储桶，格式：BucketName-APPID$key = "exampleobject"; //此处的 key 为对象键，对象键是对象在存储桶中的唯一标识$signedUrl = $cosClient->getObjectUrl($bucket, $key, '+10 minutes');// 请求成功echo $signedUrl;} catch (\\Exception $e) {// 请求失败print_r($e);}
# 删除 object## deleteObjecttry {$bucket = "examplebucket-1250000000"; //存储桶，格式：BucketName-APPID$key = "exampleobject"; //此处的 key 为对象键，对象键是对象在存储桶中的唯一标识$result = $cosClient->deleteObject(array('Bucket' => $bucket,'Key' => $key,'VersionId' => 'string'));// 请求成功print_r($result);} catch (\\Exception $e) {// 请求失败echo($e);}# 删除多个 object## deleteObjectstry {$bucket = "examplebucket-1250000000"; //存储桶，格式：BucketName-APPID$key1 = "exampleobject1"; //此处的 key 为对象键，对象键是对象在存储桶中的唯一标识$key2 = "exampleobject2"; //此处的 key 为对象键，对象键是对象在存储桶中的唯一标识$result = $cosClient->deleteObjects(array('Bucket' => $bucket,'Objects' => array(array('Key' => $key1,),array('Key' => $key2,),//...),));// 请求成功print_r($result);} catch (\\Exception $e) {// 请求失败echo($e);}
文档反馈