larva/qiniu-php-sdk

Qiniu Resource (Cloud) Storage SDK for PHP

8.0.0 2026-08-05 02:26 UTC

Requires

• php: ^8.2
• ext-curl: *
• ext-xml: *
• myclabs/php-enum: ^1.8.4

Requires (Dev)

• phpunit/phpunit: ^10.5
• squizlabs/php_codesniffer: ^3.10

MIT

• Qiniu

• storage
• sdk
• cloud
• qiniu

Published on Packagist.org on 2026-08-05 02:27 UTC

README

安装

推荐使用 composer 进行安装。可以使用 composer.json 声明依赖，或者运行下面的命令。SDK 包已经放到这里 larva/qiniu-php-sdk 。

$ composer require larva/qiniu-php-sdk

运行环境

• PHP 8.2+
• 扩展依赖：ext-curl、ext-xml、ext-json

Qiniu SDK 版本	最低 PHP 版本
8.x	8.2+
7.x	cURL extension, 5.3 - 5.6, 7.0 - 7.4, 8.0-8.1
6.x	cURL extension, 5.2 - 5.6

从 8.x 版本起，本 SDK 不再支持 PHP 8.1 及更早版本；生产环境建议使用 PHP 8.2 / 8.3 / 8.4。

主要依赖

• myclabs/php-enum ^1.8.4
• 开发依赖：phpunit/phpunit ^10.5、squizlabs/php_codesniffer ^3.10

使用方法

上传

use Qiniu\Storage\UploadManager;
use Qiniu\Auth;
...
    $uploadMgr = new UploadManager();
    $auth = new Auth($accessKey, $secretKey);
    $token = $auth->uploadToken($bucket);
    list($ret, $error) = $uploadMgr->putFile($token, 'key', 'filePath');
...

测试

运行全部测试需要先配置七牛测试凭证环境变量：

$ export QINIU_ACCESS_KEY=<your-access-key>
$ export QINIU_SECRET_KEY=<your-secret-key>
$ export QINIU_TEST_BUCKET=<your-test-bucket>
$ export QINIU_TEST_DOMAIN=<your-test-domain>

$ composer install
$ ./vendor/bin/phpunit

代码风格检查：

$ ./vendor/bin/phpcs --standard=PSR2 src

常见问题

• $error 保留了请求响应的信息，失败情况下 ret 为 none, 将 $error 可以打印出来，提交给我们。
• API 的使用 demo 可以参考 examples。

代码贡献

详情参考代码提交指南。

贡献记录

• 所有贡献者

联系我们

• 如果需要帮助，请提交工单（在portal右侧点击咨询和建议提交工单，或者直接向 [e-mail] 发送邮件）
• 如果有什么问题，可以到问答社区提问，问答社区
• 更详细的文档，见官方文档站
• 如果发现了 bug， 欢迎提交 issue
• 如果有功能需求，欢迎提交 issue
• 如果要提交代码，欢迎提交 pull request
• 欢迎关注我们的微信 微博，及时获取动态信息。

代码许可

The MIT License (MIT).详情见 License文件.