又拍云 SDK for PHPer
又拍云 PHP SDK,封装了又拍云功能丰富的开放 API ,帮助开发者快速对接文件云端存储、图片音视频云处理、智能鉴黄等功能
功能列表
SDK 包含如下功能
基于 rest api
文件上传下载、目录创建删除等云存储基本操作
基于 form api
文件客户端上传 见examples/client-upload
同步视频处理:m3u8 文件同步拼接剪辑、其他视频文件同步截图功能
功能列表中的异步操作,均可以设置异步回调通知地址,接收异步处理结果
如果需要测试回调功能,可以通过又拍云回调服务创建一个临时回调地址
使用说明
安装
PHP >= 5.5
1.使用 composer 安装
推荐使用该方法安装,成为优雅的 PHPer 🔥
建议使用速度很快的国内全量镜像(又拍云赞助)
composer require upyun/sdk
2.如果不适应 composer 管理,可以直接下载压缩包(注意需要下载 php-sdk-版本号.zip 格式的 zip 压缩包,不是 Source code 源码压缩包),解压后,项目中添加如下代码:
require_once '/path/to/php-sdk/vendor/autoload.php';
文档
示例
先初始化又拍云服务配置:
require_once('vendor/autoload.php'); // 只针对使用 composer 安装
// require_once '/path/to/php-sdk/vendor/autoload.php'; // 针对压缩包安装
use Upyun\Upyun;
use Upyun\Config;
$serviceConfig = new Config('yourServiceName', 'yourOperatorName', 'yourOperatorPwd');
$client = new Upyun($serviceConfig);
字符串写入又拍云服务器
$client->write('/save/path', 'file content');
文件流写入又拍云服务器
$file = fopen('/local/path/file', 'r');
$client->write('/save/path', $file);
使用并行式断点续传上传文件
$serviceConfig->setUploadType('BLOCK_PARALLEL');
$client = new Upyun($serviceConfig);
$file = fopen('/local/path/file', 'r');
$client->write('/save/path', $file);
上传图片并转换格式为 png,详见上传作图
$file = fopen('/local/path/image.jpg', 'r');
$client->write('/save/image.png', $file, array('x-gmkerl-thumb' => '/format/png'));
下载文件并保存到本地
$saveLocal = fopen('/local/path/image.jpg', 'w');
// 第二个参数不传时,read 方法将直接返回文件内容
$client->read('/remote/server/image.png', $saveLocal);
贡献代码
Fork
为新特性创建一个新的分支
发送一个 pull request 到 master 分支
社区
许可证
UPYUN PHP-SDK 基于 MIT 开源协议