PHPackages hachi-zzq/cos-sdk-v5 - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [File & Storage](/categories/file-storage) 4. / 5. hachi-zzq/cos-sdk-v5 ActiveLibrary[File & Storage](/categories/file-storage) hachi-zzq/cos-sdk-v5 ==================== PHP SDK for QCloud COS v1.3.5(5y ago)05.0k1MITPHPPHP >=5.3.0 Since Sep 1Pushed 5y agoCompare [ Source](https://github.com/hachi-zzq/cos-php-sdk-v5)[ Packagist](https://packagist.org/packages/hachi-zzq/cos-sdk-v5)[ RSS](/packages/hachi-zzq-cos-sdk-v5/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (1)Versions (22)Used By (1) COS-PHP-SDK-V5 ============== [](#cos-php-sdk-v5) 腾讯云COS-PHP-SDK-V5（[XML API](https://cloud.tencent.com/document/product/436/7751)） [![Latest Stable Version](https://camo.githubusercontent.com/9adf1ddf4228709ce56dfe99754e2092b488850e279d793c4c0e38a66191c8fc/68747470733a2f2f706f7365722e707567782e6f72672f71636c6f75642f636f732d73646b2d76352f762f737461626c65)](https://packagist.org/packages/qcloud/cos-sdk-v5)[![Total Downloads](https://camo.githubusercontent.com/a3bc339f6888d2229a3fd4b0653d00c9abba17bbacb1b9849588ebf6018d6b15/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f71636c6f75642f636f732d73646b2d76352e7376673f7374796c653d666c6174)](https://packagist.org/packages/qcloud/cos-sdk-v5)[![Build Status](https://camo.githubusercontent.com/8715db68c0bf45517a85014d2be190e8633de81f760b740dd873036b2b546462/68747470733a2f2f7472617669732d63692e6f72672f74656e63656e7479756e2f636f732d7068702d73646b2d76352e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/tencentyun/cos-php-sdk-v5) 环境准备 ---- [](#环境准备) - 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-安装) SDK 安装有三种方式： - Composer 方式 - Phar 方式 - 源码方式 ### Composer 方式 [](#composer-方式) 推荐使用 Composer 安装 cos-php-sdk-v5，Composer 是 PHP 的依赖管理工具，允许您声明项目所需的依赖，然后自动将它们安装到您的项目中。 > 您可以在 [Composer 官网](https://getcomposer.org/) 上找到更多关于如何安装 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-方式) Phar 方式安装 SDK 的步骤如下： 1. 在 [GitHub 发布页面](https://github.com/tencentyun/cos-php-sdk-v5/releases) 下载相应的 phar 文件。 2. 在代码中引入 phar 文件： ``` require '/path/to/cos-sdk-v5.phar'; ``` ### 源码方式 [](#源码方式) 源码方式安装 SDK 的步骤如下： 1. 在 [GitHub 发布页面](https://github.com/tencentyun/cos-php-sdk-v5/releases) 下载相应的 zip 文件。 2. 解压通过 autoload.php 脚本加载 SDK： ``` require '/path/to/sdk/vendor/autoload.php'; ``` 快速入门 ---- [](#快速入门) 可参照 Demo 程序，详见 [sample.php](https://github.com/tencentyun/cos-php-sdk-v5/blob/master/sample.php)。 接口文档 ---- [](#接口文档) php sdk 接口文档，详见 ### 配置文件 [](#配置文件) ``` $cosClient = new Qcloud\Cos\Client(array('region' => '', 'credentials'=> array( 'secretId' => '', 'secretKey' => ''))); ``` 若您使用 [临时密钥](https://cloud.tencent.com/document/product/436/14048) 初始化，请用下面方式创建实例。 ``` $cosClient = new Qcloud\Cos\Client(array('region' => '', 'credentials'=> array( 'secretId' => '', 'secretKey' => '', 'token' => ''))); ``` ### 上传文件 [](#上传文件) - 使用putObject接口上传文件(最大5G) - 使用Upload接口分块上传文件 ``` # 上传文件 ## 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 ``` # 下载文件 ## 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); } ``` ### Health Score 34 — LowBetter than 77% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity20 Limited adoption so far Community16 Small or concentrated contributor base Maturity67 Established project with proven stability Bus Factor1 Top contributor holds 93% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~60 days Recently: every ~138 days Total 20 Last Release 2021d ago PHP version history (2 changes)v1.0.0PHP >=5.3.3 v1.2.0PHP >=5.3.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/0aa18dab7e8c00e436f73af9f443813bc5fe574b07e25a1a2e753900088f1583?d=identicon)[hachi-zzq](/maintainers/hachi-zzq) --- Top Contributors [![lewzylu](https://avatars.githubusercontent.com/u/25299171?v=4)](https://github.com/lewzylu "lewzylu (146 commits)")[![freyo](https://avatars.githubusercontent.com/u/13034231?v=4)](https://github.com/freyo "freyo (2 commits)")[![konakonall](https://avatars.githubusercontent.com/u/900060?v=4)](https://github.com/konakonall "konakonall (2 commits)")[![yaozongyou](https://avatars.githubusercontent.com/u/590761?v=4)](https://github.com/yaozongyou "yaozongyou (2 commits)")[![krwu](https://avatars.githubusercontent.com/u/364298?v=4)](https://github.com/krwu "krwu (1 commits)")[![hachi-zzq](https://avatars.githubusercontent.com/u/5241713?v=4)](https://github.com/hachi-zzq "hachi-zzq (1 commits)")[![wi1dcard](https://avatars.githubusercontent.com/u/25447002?v=4)](https://github.com/wi1dcard "wi1dcard (1 commits)")[![keacefull](https://avatars.githubusercontent.com/u/8847289?v=4)](https://github.com/keacefull "keacefull (1 commits)")[![wormcy](https://avatars.githubusercontent.com/u/5145974?v=4)](https://github.com/wormcy "wormcy (1 commits)") --- Tags phpqcloudcos ### Embed Badge ![Health badge](/badges/hachi-zzq-cos-sdk-v5/health.svg) ``` [![Health](https://phpackages.com/badges/hachi-zzq-cos-sdk-v5/health.svg)](https://phpackages.com/packages/hachi-zzq-cos-sdk-v5) ``` ### Alternatives [qcloud/cos-sdk-v5 PHP SDK for QCloud COS 2051.5M129](/packages/qcloud-cos-sdk-v5)[blueimp/jquery-file-upload File Upload widget for jQuery. 141.5M18](/packages/blueimp-jquery-file-upload)[qcloud/cos-sdk-v4 PHP SDK for QCloud COS 4121.9k3](/packages/qcloud-cos-sdk-v4)[qcloud_sts/qcloud-sts-sdk PHP SDK for QCloud STS 10173.3k9](/packages/qcloud-sts-qcloud-sts-sdk) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)