aoding9 / qiniu-php-sdk

7.14.0 2026-11-04 05:02 UTC

Requires

• php: >=7.1
• ext-curl: *
• ext-xml: *
• myclabs/php-enum: ~1.5.2 || ~1.6.6 || ~1.7.7 || ~1.8.4

Requires (Dev)

• paragonie/random_compat: >=2
• phpunit/phpunit: ^4.8 || ^5.0 || ^6.0 || ^7.0 || ^8.0 || ^9.3.4
• squizlabs/php_codesniffer: ^2.3 || ~3.6

Replaces

• qiniu/php-sdk: 7.14.0

MIT

• Qiniu

• storage
• sdk
• cloud
• qiniu

Published on Packagist.org on 2026-11-04 05:03 UTC

README

基于 qiniu/php-sdk 的维护 fork：修复 PHP 8.4+ 隐式 nullable 等兼容问题，已在 PHP 8.5 验证。通过 replace 可替代官方 qiniu/php-sdk。

安装

$ composer require aoding9/qiniu-php-sdk

运行环境

Qiniu SDK版本	PHP 版本
7.x（本 fork）	cURL extension，composer.json 约束 >=7.1，含 7.1–8.5
官方 7.x	cURL extension，约 5.3–5.6、7.0–7.4、8.0–8.1
6.x	cURL extension，5.2–5.6

使用方法

上传

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');
...

测试

$ ./vendor/bin/phpunit tests/Qiniu/Tests/

常见问题

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

代码贡献

详情参考代码提交指南。

贡献记录

• 所有贡献者

联系我们

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

代码许可

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