hrjy 29dfd4aa99 commit | před 2 roky | |
---|---|---|
.. | ||
sample | před 2 roky | |
src | před 2 roky | |
.gitignore | před 2 roky | |
.travis.yml | před 2 roky | |
LICENSE | před 2 roky | |
README.md | před 2 roky | |
composer.json | před 2 roky | |
phpunit.xml | před 2 roky | |
sample.php | před 2 roky |
腾讯云COS-PHP-SDK-V5(XML API)
php -v
命令查看当前的 PHP 版本。php -m
命令查看 cURL 扩展是否已经安装好。
Ubuntu 系统中,您可以使用 apt-get 包管理器安装 PHP 的 cURL 扩展,安装命令如下。
sudo apt-get install php-curl
CentOS 系统中,您可以使用 yum 包管理器安装 PHP 的 cURL 扩展。
sudo yum install php-curl
SDK 安装有三种方式:
推荐使用 Composer 安装 cos-php-sdk-v5,Composer 是 PHP 的依赖管理工具,允许您声明项目所需的依赖,然后自动将它们安装到您的项目中。
您可以在 Composer 官网 上找到更多关于如何安装 Composer,配置自动加载以及用于定义依赖项的其他最佳实践等相关信息。
下载 Composer,执行以下命令。
curl -sS https://getcomposer.org/installer | php
创建一个名为composer.json
的文件,内容如下。
{
"require": {
"qcloud/cos-sdk-v5": "1.*"
}
}
使用 Composer 安装,执行以下命令。
php composer.phar install
使用该命令后会在当前目录中创建一个 vendor 文件夹,里面包含 SDK 的依赖库和一个 autoload.php 脚本,方便在项目中调用。
通过 autoloader 脚本调用 cos-php-sdk-v5。
require '/path/to/sdk/vendor/autoload.php';
现在您的项目已经可以使用 COS 的 V5 版本 SDK 了。
Phar 方式安装 SDK 的步骤如下:
在代码中引入 phar 文件:
require '/path/to/cos-sdk-v5.phar';
源码方式安装 SDK 的步骤如下:
解压通过 autoload.php 脚本加载 SDK:
require '/path/to/sdk/vendor/autoload.php';
可参照 Demo 程序,详见 sample.php。
php sdk 接口文档,详见https://cloud.tencent.com/document/product/436/12267
$cosClient = new Qcloud\Cos\Client(array('region' => '<Region>',
'credentials'=> array(
'secretId' => '<SecretId>',
'secretKey' => '<SecretKey>')));
若您使用 临时密钥 初始化,请用下面方式创建实例。
$cosClient = new Qcloud\Cos\Client(array('region' => '<Region>',
'credentials'=> array(
'secretId' => '<SecretId>',
'secretKey' => '<SecretKey>',
'token' => '<XCosSecurityToken>')));
使用Upload接口分块上传文件 ```php
//bucket 的命名规则为{name}-{appid} ,此处填写的存储桶名称必须为此格式 try { $result = $cosClient->putObject(array(
'Bucket' => $bucket,
'Key' => $key,
'Body' => 'Hello World!'));
print_r($result); } catch (\Exception $e) { echo "$e\n"; }
try {
$result = $cosClient->putObject(array(
'Bucket' => $bucket,
'Key' => $key,
'Body' => fopen($local_path, 'rb')));
print_r($result);
} catch (\Exception $e) {
echo "$e\n";
}
try {
$result = $cosClient->putObject(array(
'Bucket' => $bucket,
'Key' => $key,
'Body' => fopen($local_path, 'rb'),
'ACL' => 'string',
'CacheControl' => 'string',
'ContentDisposition' => 'string',
'ContentEncoding' => 'string',
'ContentLanguage' => 'string',
'ContentLength' => integer,
'ContentType' => 'string',
'Expires' => 'mixed type: string (date format)|int (unix timestamp)|\DateTime',
'Metadata' => array(
'string' => 'string',
),
'StorageClass' => 'string'));
print_r($result);
} catch (\Exception $e) {
echo "$e\n";
}
try {
$result = $cosClient->Upload(
$bucket = $bucket,
$key = $key,
$body = 'Hello World!');
print_r($result);
} catch (\Exception $e) {
echo "$e\n";
}
try {
$result = $cosClient->Upload(
$bucket = $bucket,
$key = $key,
$body = fopen($local_path, 'rb'));
print_r($result);
} catch (\Exception $e) {
echo "$e\n";
}
try {
$result = $cosClient->Upload(
$bucket= $bucket,
$key = $key,
$body = fopen($local_path, 'rb'),
$options = array(
'ACL' => 'string',
'CacheControl' => 'string',
'ContentDisposition' => 'string',
'ContentEncoding' => 'string',
'ContentLanguage' => 'string',
'ContentLength' => integer,
'ContentType' => 'string',
'Expires' => 'mixed type: string (date format)|int (unix timestamp)|\DateTime',
'Metadata' => array(
'string' => 'string',
),
'StorageClass' => 'string'));
print_r($result);
} catch (\Exception $e) {
echo "$e\n";
}
### 下载文件
* 使用getObject接口下载文件
* 使用getObjectUrl接口获取文件下载URL
```php
# 下载文件
## getObject(下载文件)
### 下载到内存
//bucket 的命名规则为{name}-{appid} ,此处填写的存储桶名称必须为此格式
try {
$result = $cosClient->getObject(array(
'Bucket' => $bucket,
'Key' => $key));
echo($result['Body']);
} catch (\Exception $e) {
echo "$e\n";
}
### 下载到本地
try {
$result = $cosClient->getObject(array(
'Bucket' => $bucket,
'Key' => $key,
'SaveAs' => $local_path));
} catch (\Exception $e) {
echo "$e\n";
}
### 指定下载范围
/*
* Range 字段格式为 'bytes=a-b'
*/
try {
$result = $cosClient->getObject(array(
'Bucket' => $bucket,
'Key' => $key,
'Range' => 'bytes=0-10',
'SaveAs' => $local_path));
} catch (\Exception $e) {
echo "$e\n";
}
### 设置返回header
try {
$result = $cosClient->getObject(array(
'Bucket' => $bucket,
'Key' => $key,
'ResponseCacheControl' => 'string',
'ResponseContentDisposition' => 'string',
'ResponseContentEncoding' => 'string',
'ResponseContentLanguage' => 'string',
'ResponseContentType' => 'string',
'ResponseExpires' => 'mixed type: string (date format)|int (unix timestamp)|\DateTime',
'SaveAs' => $local_path));
} catch (\Exception $e) {
echo "$e\n";
}
## getObjectUrl(获取文件UrL)
try {
$signedUrl = $cosClient->getObjectUrl($bucket, $key, '+10 minutes');
echo $signedUrl;
} catch (\Exception $e) {
print_r($e);
}