下载与安装
相关资源
说明:
如果您在使用 XML 版本 SDK 时遇到函数或方法不存在等错误,请先将 XML 版本 SDK 升级到最新版再重试。
环境依赖
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
Composer 方式
推荐使用 Composer 安装 cos-php-sdk-v5,Composer 是 PHP 的依赖管理工具,允许您声明项目所需的依赖,然后自动将它们安装到您的项目中。
说明:
您可以在 Composer 官网 上找到更多关于如何安装 Composer,配置自动加载以及用于定义依赖项的其他最佳实践等相关信息。 安装步骤
1. 打开终端。
2. 执行以下命令,下载 Composer。
curl -sS https://getcomposer.org/installer | php
3. 创建一个名为 composer.json
的文件,内容如下:
{
"require": {
"qcloud/cos-sdk-v5": ">=2.0"
}
}
4. 执行以下命令,使用 Composer 安装。
php composer.phar install
使用该命令后会在当前目录中创建一个 vendor 文件夹,里面包含 SDK 的依赖库和一个 autoload.php 脚本,方便在项目中调用。
注意:
目前已支持 Composer 根据当前 PHP 版本下载 guzzle6 或 guzzle7。guzzle7 版本支持 laravel8 框架。当 PHP 版本 >= 7.2.5
时自动下载 guzzle7 版本,反之下载 guzzle6 版本。
5. 通过 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 的步骤如下:
说明:
对于 PHP 版本 >= 5.6
且 <7.2.5
,请下载 cos-sdk-v5-6.phar
,以使用 Guzzle6 版本。
对于 PHP 版本 >=7.2.5
的请下载 cos-sdk-v5-7.phar
,以使用 Guzzle7 版本。
2. 在代码中引入 phar 文件:
require '/path/to/cos-sdk-v5-x.phar';
源码方式
源码方式安装 SDK 的步骤如下:
1. 在 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 版本。
2. 解压后通过 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 完成一个基础操作,如初始化客户端、创建存储桶、查询存储桶列表、上传对象、查询对象列表、下载对象和删除对象。关于示例中的参数说明,请参见 存储桶操作 和 对象操作 文档。 初始化
注意:
建议用户使用子账号密钥 + 环境变量的方式调用 SDK,提高 SDK 使用的安全性。为子账号授权时,请遵循 最小权限指引原则,防止泄漏目标存储桶或对象之外的资源。 如果您一定要使用永久密钥,建议遵循 最小权限指引原则 对永久密钥的权限范围进行限制。 若您使用 临时密钥 初始化,请用下面方式创建实例: $tmpSecretId = "TmpSecretId";
$tmpSecretKey = "TmpSecretKey";
$tmpToken = "TmpToken";
$region = "ap-beijing";
$cosClient = new Qcloud\\Cos\\Client(
array(
'region' => $region,
'schema' => 'https',
'credentials'=> array(
'secretId' => $tmpSecretId,
'secretKey' => $tmpSecretKey,
'token' => $tmpToken)));
若您使用永久密钥初始化 COSClient,可以先在访问管理控制台中的 API 密钥管理页面 获取 SecretId、SecretKey,使用永久密钥适用于大部分的应用场景。
$secretId = getenv('COS_SECRET_ID');
$secretKey = getenv('COS_SECRET_KEY');
$region = "ap-beijing";
$cosClient = new Qcloud\\Cos\\Client(
array(
'region' => $region,
'schema' => 'https',
'credentials'=> array(
'secretId' => $secretId ,
'secretKey' => $secretKey)));
注意:
若未配置 HTTPS 证书,则需要删除 schema 参数或填入 'schema' => 'http'
;若填入 https 会出现 certificate problem。若您需要配置证书,可参考 PHP SDK 常见问题。 创建存储桶
try {
$bucket = "examplebucket-1250000000";
$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 接口为复合上传接口,对小文件进行简单上传,对大文件进行分块上传。
try {
$bucket = "examplebucket-1250000000";
$key = "exampleobject";
$result = $cosClient->putObject(array(
'Bucket' => $bucket,
'Key' => $key,
'Body' => 'Hello World!'));
print_r($result);
} catch (\\Exception $e) {
echo "$e\\n";
}
try {
$bucket = "examplebucket-1250000000";
$key = "exampleobject";
$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";
}
try {
$bucket = "examplebucket-1250000000";
$key = "exampleobject";
$result = $cosClient->Upload(
$bucket = $bucket,
$key = $key,
$body = 'Hello World!');
print_r($result);
} catch (\\Exception $e) {
echo "$e\\n";
}
try {
$bucket = "examplebucket-1250000000";
$key = "exampleobject";
$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";
$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";
$prefix = '';
$marker = '';
while (true) {
$result = $cosClient->listObjects(array(
'Bucket' => $bucket,
'Marker' => $marker,
'MaxKeys' => 1000
));
if (isset($result['Contents'])) {
foreach ($result['Contents'] as $rt) {
echo($rt['Key'] . "\\n");
}
}
$marker = $result['NextMarker'];
if (!$result['IsTruncated']) {
break;
}
}
} catch (\\Exception $e) {
echo($e);
}
下载对象
使用 getObject 接口下载文件。
使用 getObjectUrl 接口获取文件下载 URL。
try {
$bucket = "examplebucket-1250000000";
$key = "exampleobject";
$result = $cosClient->getObject(array(
'Bucket' => $bucket,
'Key' => $key));
echo($result['Body']);
} catch (\\Exception $e) {
echo "$e\\n";
}
try {
$bucket = "examplebucket-1250000000";
$key = "exampleobject";
$localPath = @"path/to/localFile";
$result = $cosClient->getObject(array(
'Bucket' => $bucket,
'Key' => $key,
'SaveAs' => $localPath));
} catch (\\Exception $e) {
echo "$e\\n";
}
try {
$bucket = "examplebucket-1250000000";
$key = "exampleobject";
$localPath = @"path/to/localFile";
$result = $cosClient->getObject(array(
'Bucket' => $bucket,
'Key' => $key,
'Range' => 'bytes=0-10',
'SaveAs' => $localPath));
} catch (\\Exception $e) {
echo "$e\\n";
}
try {
$bucket = "examplebucket-1250000000";
$key = "exampleobject";
$signedUrl = $cosClient->getObjectUrl($bucket, $key, '+10 minutes');
echo $signedUrl;
} catch (\\Exception $e) {
print_r($e);
}
删除对象
try {
$bucket = "examplebucket-1250000000";
$key = "exampleobject";
$result = $cosClient->deleteObject(array(
'Bucket' => $bucket,
'Key' => $key,
'VersionId' => 'string'
));
print_r($result);
} catch (\\Exception $e) {
echo($e);
}
try {
$bucket = "examplebucket-1250000000";
$key1 = "exampleobject1";
$key2 = "exampleobject2";
$result = $cosClient->deleteObjects(array(
'Bucket' => $bucket,
'Objects' => array(
array(
'Key' => $key1,
),
array(
'Key' => $key2,
),
),
));
print_r($result);
} catch (\\Exception $e) {
echo($e);
}
本页内容是否解决了您的问题?