|
|
|
|
# Qiniu Cloud SDK for PHP
|
|
|
|
|
[](LICENSE)
|
|
|
|
|
[](https://travis-ci.org/qiniu/php-sdk)
|
|
|
|
|
[](https://github.com/qiniu/php-sdk/releases)
|
|
|
|
|
[](https://packagist.org/packages/qiniu/php-sdk)
|
|
|
|
|
[](https://packagist.org/packages/qiniu/php-sdk)
|
|
|
|
|
[](https://scrutinizer-ci.com/g/qiniu/php-sdk/?branch=master)
|
|
|
|
|
[](https://codecov.io/gh/qiniu/php-sdk)
|
|
|
|
|
[](https://gitter.im/qiniu/php-sdk?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
|
|
|
|
[](http://weibo.com/qiniutek)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 安装
|
|
|
|
|
|
|
|
|
|
* 推荐使用 `composer` 进行安装。可以使用 composer.json 声明依赖，或者运行下面的命令。SDK 包已经放到这里 [`qiniu/php-sdk`][install-packagist] 。
|
|
|
|
|
```bash
|
|
|
|
|
$ composer require qiniu/php-sdk
|
|
|
|
|
```
|
|
|
|
|
* 直接下载安装，SDK 没有依赖其他第三方库，但需要参照 composer 的 autoloader，增加一个自己的 autoloader 程序。
|
|
|
|
|
|
|
|
|
|
## 运行环境
|
|
|
|
|
|
|
|
|
|
| Qiniu SDK版本 | PHP 版本 |
|
|
|
|
|
|:--------------------:|:---------------------------:|
|
|
|
|
|
| 7.x | cURL extension, 5.3 - 5.6,7.0 |
|
|
|
|
|
| 6.x | cURL extension, 5.2 - 5.6 |
|
|
|
|
|
|
|
|
|
|
## 使用方法
|
|
|
|
|
|
|
|
|
|
### 上传
|
|
|
|
|
```php
|
|
|
|
|
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');
|
|
|
|
|
...
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## 测试
|
|
|
|
|
|
|
|
|
|
``` bash
|
|
|
|
|
$ ./vendor/bin/phpunit tests/Qiniu/Tests/
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## 常见问题
|
|
|
|
|
|
|
|
|
|
- `$error` 保留了请求响应的信息，失败情况下 `ret` 为 `none`, 将 `$error` 可以打印出来，提交给我们。
|
|
|
|
|
- API 的使用 demo 可以参考 [examples](https://github.com/qiniu/php-sdk/tree/master/examples)。
|
|
|
|
|
|
|
|
|
|
## 代码贡献
|
|
|
|
|
|
|
|
|
|
详情参考[代码提交指南](https://github.com/qiniu/php-sdk/blob/master/CONTRIBUTING.md)。
|
|
|
|
|
|
|
|
|
|
## 贡献记录
|
|
|
|
|
|
|
|
|
|
- [所有贡献者](https://github.com/qiniu/php-sdk/contributors)
|
|
|
|
|
|
|
|
|
|
## 联系我们
|
|
|
|
|
|
|
|
|
|
- 如果需要帮助，请提交工单（在portal右侧点击咨询和建议提交工单，或者直接向 support@qiniu.com 发送邮件）
|
|
|
|
|
- 如果有什么问题，可以到问答社区提问，[问答社区](https://qiniu.segmentfault.com/)
|
|
|
|
|
- 更详细的文档，见[官方文档站](https://developer.qiniu.com/)
|
|
|
|
|
- 如果发现了 bug， 欢迎提交 [issue](https://github.com/qiniu/php-sdk/issues)
|
|
|
|
|
- 如果有功能需求，欢迎提交 [issue](https://github.com/qiniu/php-sdk/issues)
|
|
|
|
|
- 如果要提交代码，欢迎提交 pull request
|
|
|
|
|
- 欢迎关注我们的[微信](https://www.qiniu.com/#weixin) [微博](https://weibo.com/qiniutek)，及时获取动态信息。
|
|
|
|
|
|
|
|
|
|
## 代码许可
|
|
|
|
|
|
|
|
|
|
The MIT License (MIT).详情见 [License文件](https://github.com/qiniu/php-sdk/blob/master/LICENSE).
|
|
|
|
|
|
|
|
|
|
[packagist]: http://packagist.org
|
|
|
|
|
[install-packagist]: https://packagist.org/packages/qiniu/php-sdk
|
