快速入门

Prev Next

请输入关键字

Recent Pages

文档

Download PDF

最后更新时间：2022-01-05 14:51:45

下载PDF

下载与安装

环境依赖

PHP 5.6+
您可以通过 php -v 命令查看当前的 PHP 版本。

注意：

如果您的 PHP 版本>=5.3 且<5.6，请使用 v1.3 版本。
cURL 扩展
xml 扩展
dom 扩展
mbstring 扩展
json 扩展
您可以通过 php -m 命令查看以上扩展是否已经安装好。
- Ubuntu 系统中，您可以使用 apt-get 包管理器安装 PHP 的相关扩展，安装命令如下：
```
sudo apt-get install php-curl php-xml php-dom php-mbstring php-json
```
- CentOS 系统中，您可以使用 yum 包管理器安装 PHP 的 cURL 扩展。
```
sudo yum install php-curl php-xml php-dom php-mbstring php-json
```

安装 SDK

SDK 安装有三种方式：Composer 方式、Phar 方式和源码方式。

Composer 方式

推荐使用 Composer 安装 cos-php-sdk-v5，Composer 是 PHP 的依赖管理工具，允许您声明项目所需的依赖，然后自动将它们安装到您的项目中。

说明：

您可以在 Composer 官网上找到更多关于如何安装 Composer，配置自动加载以及用于定义依赖项的其他最佳实践等相关信息。

安装步骤

打开终端。

执行以下命令，下载 Composer。

curl -sS https://getcomposer.org/installer | php

创建一个名为 composer.json的文件，内容如下：

{
"require": {
    "qcloud/cos-sdk-v5": ">=2.0"
}
}

执行以下命令，使用 Composer 安装。
```
php composer.phar install
```

使用该命令后会在当前目录中创建一个 vendor 文件夹，里面包含 SDK 的依赖库和一个 autoload.php 脚本，方便在项目中调用。

注意：

目前已支持 Composer 根据当前 PHP 版本下载 guzzle6 或 guzzle7。guzzle7 版本支持 laravel8 框架。当 PHP 版本 >= 7.2.5时自动下载 guzzle7 版本，反之下载 guzzle6 版本。

通过 autoloader 脚本调用 cos-php-sdk-v5，在代码中引入 autoload.php 文件:
```
require '/path/to/sdk/vendor/autoload.php';
```

注意：

执行 composer 安装后，这里的路径需更改为 autoload.php 文件所对应的路径，否则会调用不到相关方法。如您安装的路径为/Users/username/project，则项目中引用的路径应填写为/Users/username/project/vendor/autoload.php。

至此，您的项目已经可以使用 COS XML PHP SDK 了。

Phar 方式

Phar 方式安装 SDK 的步骤如下：

在 GitHub 发布页面下载相应的 phar 文件。
说明：
- 对于 PHP 版本 >= 5.6 且 <7.2.5 ，请下载cos-sdk-v5-6.phar，以使用 Guzzle6 版本。
- 对于 PHP 版本 >=7.2.5 的请下载 cos-sdk-v5-7.phar，以使用 Guzzle7 版本。
在代码中引入 phar 文件：
```
require  '/path/to/cos-sdk-v5-x.phar';
```

源码方式

源码方式安装 SDK 的步骤如下：

在 SDK 下载页面下载cos-sdk-v5.tar.gz压缩文件。
说明：
- 对于 PHP 版本 >= 5.6 且 <7.2.5 ，请下载cos-sdk-v5-6.tar.gz，以使用 Guzzle6 版本。
- 对于 PHP 版本 >=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包。

开始使用

下面为您介绍如何使用 COS PHP SDK 完成一个基础操作，如初始化客户端、创建存储桶、查询存储桶列表、上传对象、查询对象列表、下载对象和删除对象。关于示例中的参数说明，请参见存储桶操作和对象操作文档。

初始化

若您使用永久密钥初始化 COSClient，可以先在访问管理控制台中的 API 密钥管理页面获取 SecretId、SecretKey，使用永久密钥适用于大部分的应用场景。

// SECRETID和SECRETKEY请登录访问管理控制台进行查看和管理
$secretId = "SECRETID"; //替换为用户的 secretId，请登录访问管理控制台进行查看和管理，https://console.cloud.tencent.com/cam/capi
$secretKey = "SECRETKEY"; //替换为用户的 secretKey，请登录访问管理控制台进行查看和管理，https://console.cloud.tencent.com/cam/capi
$region = "ap-beijing"; //替换为用户的 region，已创建桶归属的region可以在控制台查看，https://console.cloud.tencent.com/cos5/bucket
$cosClient = new Qcloud\Cos\Client(
   array(
       'region' => $region,
       'schema' => 'https', //协议头部，默认为http
       'credentials'=> array(
           'secretId'  => $secretId ,
           'secretKey' => $secretKey)));

注意：

若未配置 HTTPS 证书，则需要删除 schema 参数或填入'schema' => 'http'；若填入 https 会出现 certificate problem。若您需要配置证书，可参考 PHP SDK 常见问题。

若您使用临时密钥初始化，请用下面方式创建实例：

$tmpSecretId = "SECRETID"; //替换为用户的 secretId，请登录访问管理控制台进行查看和管理，https://console.cloud.tencent.com/cam/capi
$tmpSecretKey = "SECRETKEY"; //替换为用户的 secretKey，请登录访问管理控制台进行查看和管理，https://console.cloud.tencent.com/cam/capi
$tmpToken = "COS_TOKEN"; //使用临时密钥需要填入，临时密钥生成和使用指引参见https://intl.cloud.tencent.com/document/product/436/14048
$region = "COS_REGION"; //替换为用户的 region，已创建桶归属的region可以在控制台查看，https://console.cloud.tencent.com/cos5/bucket
$cosClient = new Qcloud\Cos\Client(
   array(
       'region' => $region,
       'schema' => 'https', //协议头部，默认为http
       'credentials'=> array(
           'secretId'  => $tmpSecretId,
           'secretKey' => $tmpSecretKey,
           'token' => $tmpToken)));

创建存储桶

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）。

使用 Upload 接口分块上传文件，Upload 接口为复合上传接口，对小文件进行简单上传，对大文件进行分块上传。

参数说明可参见对象操作文档。

# 上传文件
## 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) {
               // 打印key
               echo($rt['Key'] . "\n");
           }
       }
       $marker = $result['NextMarker']; //设置新的断点
       if (!$result['IsTruncated']) {
           break; //判断是否已经查询完
       }
   }
} catch (\Exception $e) {
   echo($e);
}

下载对象

使用 getObject 接口下载文件。
使用 getObjectUrl 接口获取文件下载 URL。

# 下载文件
## 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
## deleteObject
try {
   $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
## deleteObjects
try {
   $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);
}

联系我们

联系我们，为您的业务提供专属服务。

技术支持

如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

7x24 电话支持

tencent cloud

腾讯云合作伙伴网络

成为合作伙伴

国际合作伙伴学院

Recent Pages

快速入门

下载与安装

相关资源

环境依赖

安装 SDK

Composer 方式

Phar 方式

源码方式

开始使用

初始化

创建存储桶

查询存储桶列表

上传对象

查询对象列表

下载对象

删除对象

本页内容是否解决了您的问题？

本页内容是否解决了您的问题？

关于腾讯云

服务与支持

资源

用户中心

tencent cloud

成为合作伙伴

腾讯云合作伙伴网络

成为合作伙伴

培训与支持

国际合作伙伴学院

注册

登录

Recent Pages

快速入门

下载与安装

相关资源

环境依赖

安装 SDK

Composer 方式

Phar 方式

源码方式

开始使用

初始化

创建存储桶

查询存储桶列表

上传对象

查询对象列表

下载对象

删除对象

本页内容是否解决了您的问题？

本页内容是否解决了您的问题？

关于腾讯云

服务与支持

资源

用户中心