Upyun PHP SDK (Unofficial Fork for PHP 8.3 & Laravel 12)

⚠️ 免责声明 / DISCLAIMER：本仓库为非官方维护版本

本项目基于官方 upyun/php-sdk 进行修改，主要用于适配：

• PHP 8.3+
• Laravel 12+
• Guzzle 7+

📝 查看完整更新日志：CHANGELOG.md

本项目与又拍云官方无直接关系，不代表官方立场或技术支持。请谨慎用于生产环境。 如需官方版本请访问：https://github.com/upyun/php-sdk

---

又拍云 PHP SDK，封装了又拍云功能丰富的开放 API ，帮助开发者快速对接文件云端存储、图片音视频云处理、智能鉴黄等功能

• 功能列表
• 使用说明
  • 安装
  • 文档
  • 示例
• 贡献代码
• 社区
• 许可证

功能列表

SDK 包含如下功能

• 基于 rest api
  • 文件上传下载、目录创建删除等云存储基本操作
  • 断点续传
• 基于 form api
  • 文件客户端上传 见examples/client-upload
  • 上传预处理操作
    • 同步音频处理
    • 文档转换
    • 异步图片音视频处理
    • 异步图片智能鉴黄
• 异步云处理
  • 视频音频异步转码、切片、截图、水印、剪辑、拼接等功能
  • 文件异步解压缩
  • 文件异步拉取
  • 异步图片拼接
• 同步视频处理：m3u8 文件同步拼接剪辑、其他视频文件同步截图功能
• 缓存刷新

功能列表中的异步操作，均可以设置异步回调通知地址，接收异步处理结果 如果需要测试回调功能，可以通过又拍云回调服务创建一个临时回调地址

使用说明

安装

PHP >= 8.3

1.使用 composer 安装

推荐使用该方法安装，成为优雅的 PHPer 🔥

建议使用速度很快的国内全量镜像(又拍云赞助)

composer require ltqio/upyun-php-sdk

文档

详细文档见 doc.md

示例

先初始化又拍云服务配置：

require_once('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);

贡献代码

1. Fork
2. 为新特性创建一个新的分支
3. 发送一个 pull request 到 master 分支

社区

• 问答社区
• 微博

许可证

UPYUN PHP-SDK 基于 MIT 开源协议

http://www.opensource.org/licenses/MIT

🛡️ 关于本 Fork

• 本项目由社区开发者 fork 并适配新版本 PHP 及 Laravel；
• 不承诺完全兼容官方 API，如有疑问请优先参考官方文档；
• 欢迎 Issues 或 PR 协助维护。

---