hrjy 29dfd4aa99 commit před 2 roky
..
sample 29dfd4aa99 commit před 2 roky
src 29dfd4aa99 commit před 2 roky
.gitignore 29dfd4aa99 commit před 2 roky
.travis.yml 29dfd4aa99 commit před 2 roky
LICENSE 29dfd4aa99 commit před 2 roky
README.md 29dfd4aa99 commit před 2 roky
composer.json 29dfd4aa99 commit před 2 roky
phpunit.xml 29dfd4aa99 commit před 2 roky
sample.php 29dfd4aa99 commit před 2 roky

README.md

COS-PHP-SDK-V5

腾讯云COS-PHP-SDK-V5(XML API

Latest Stable Version Total Downloads Build Status

环境准备

  • PHP 5.3+ 您可以通过php -v命令查看当前的 PHP 版本。
  • cURL 扩展 您可以通过php -m命令查看 cURL 扩展是否已经安装好。
  • Ubuntu 系统中,您可以使用 apt-get 包管理器安装 PHP 的 cURL 扩展,安装命令如下。

    sudo apt-get install php-curl
    
  • CentOS 系统中,您可以使用 yum 包管理器安装 PHP 的 cURL 扩展。

    sudo yum install php-curl
    

SDK 安装

SDK 安装有三种方式:

  • Composer 方式
  • Phar 方式
  • 源码方式

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": "1.*"
    }
    }
    
  4. 使用 Composer 安装,执行以下命令。

    php composer.phar install
    

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

  5. 通过 autoloader 脚本调用 cos-php-sdk-v5。

    require '/path/to/sdk/vendor/autoload.php';
    

现在您的项目已经可以使用 COS 的 V5 版本 SDK 了。

Phar 方式

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

  1. GitHub 发布页面 下载相应的 phar 文件。
  2. 在代码中引入 phar 文件:

    require  '/path/to/cos-sdk-v5.phar';
    

源码方式

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

  1. GitHub 发布页面 下载相应的 zip 文件。
  2. 解压通过 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>')));

上传文件

  • 使用putObject接口上传文件(最大5G)
  • 使用Upload接口分块上传文件 ```php

    上传文件

    putObject(上传接口,最大支持上传5G文件)

    上传内存中的字符串

    //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";

}

设置header和meta

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";

}

Upload(高级上传接口,默认使用分块上传最大支持50T)

上传内存中的字符串

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";

}

设置header和meta

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);
}