PHPackages jasonmann/flysystem-aliyun-oss - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [File & Storage](/categories/file-storage) 4. / 5. jasonmann/flysystem-aliyun-oss ActiveLibrary[File & Storage](/categories/file-storage) jasonmann/flysystem-aliyun-oss ============================== Flysystem adapter for the Aliyun OSS SDK 1.0.1(4y ago)0631MITPHPPHP ^7.0 || ^8.0 Since Dec 16Pushed 4y ago1 watchersCompare [ Source](https://github.com/JasonMann1993/flysystem-aliyun-oss)[ Packagist](https://packagist.org/packages/jasonmann/flysystem-aliyun-oss)[ RSS](/packages/jasonmann-flysystem-aliyun-oss/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (2)Dependencies (3)Versions (6)Used By (1) flysystem-aliyun-oss ====================== [](#-flysystem-aliyun-oss-) Flysystem adapter for the Aliyun OSS SDK. [![StyleCI](https://camo.githubusercontent.com/355b25901ae2b2ca15dceb4e8ee3d1871b79a994e4ebe23217392b51ee5d2918/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3433383839303537332f736869656c643f6272616e63683d6d6173746572)](https://camo.githubusercontent.com/355b25901ae2b2ca15dceb4e8ee3d1871b79a994e4ebe23217392b51ee5d2918/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3433383839303537332f736869656c643f6272616e63683d6d6173746572) [![](https://camo.githubusercontent.com/89f6d9ad3e0d0a6dd7fb385e9ad12b93f556e2c503a9787eec7003ef2e3122ea/687474703a2f2f706f7365722e707567782e6f72672f6a61736f6e6d616e6e2f666c7973797374656d2d616c6979756e2d6f73732f6c6963656e7365)](https://github.com/JasonMann1993/flysystem-aliyun-oss) 扩展包要求 ----- [](#扩展包要求) - PHP >= 7.0 安装命令 ---- [](#安装命令) ``` $ composer require jasonmann/flysystem-aliyun-oss -vvv ``` 使用 -- [](#使用) ``` use League\Flysystem\Filesystem; use Jasonmann\Flysystem\Aliyun\OssAdapter; use Jasonmann\Flysystem\Aliyun\Plugins\FileUrl; $prefix = ''; $accessKeyId = 'xxxxxx'; $accessKeySecret = 'xxxxxx'; $endpoint= 'oss.jasonmann.top'; $bucket = 'bucket'; $isCName = true; $adapter = new OssAdapter($accessKeyId, $accessKeySecret, $endpoint, $bucket, $isCName, $prefix); $flysystem = new Filesystem($adapter); ``` 方法 -- [](#方法) ``` bool $flysystem->write('file.md', 'contents'); bool $flysystem->write('file.md', 'http://httpbin.org/robots.txt', ['options' => ['xxxxx' => 'application/redirect302']]); bool $flysystem->writeStream('file.md', fopen('path/to/your/local/file.jpg', 'r')); bool $flysystem->update('file.md', 'new contents'); bool $flysystem->updateStream('file.md', fopen('path/to/your/local/file.jpg', 'r')); void $flysystem->rename('foo.md', 'bar.md'); void $flysystem->copy('foo.md', 'foo2.md'); void $flysystem->delete('file.md'); bool $flysystem->has('file.md'); string|false $flysystem->read('file.md'); array $flysystem->listContents(); array $flysystem->getMetadata('file.md'); array $flysystem->getSize('file.md'); string $flysystem->getAdapter()->getUrl('file.md'); array $flysystem->getMimetype('file.md'); array $flysystem->getTimestamp('file.md'); ``` 插件扩展 ---- [](#插件扩展) ``` use Jasonmann\Flysystem\Aliyun\Plugins\FileUrl; use Jasonmann\Flysystem\Aliyun\Plugins\SignUrl; use Jasonmann\Flysystem\Aliyun\Plugins\TemporaryUrl; use Jasonmann\Flysystem\Aliyun\Plugins\Kernel; $flysystem->addPlugin(new FileUrl()); string $flysystem->getUrl('file.md'); $flysystem->addPlugin(new SignUrl()); string $flysystem->signUrl('file.md', $timeout, ['x-oss-process' => 'image/circle,r_100']); string $flysystem->signUrl('file.md', $timeout, ['x-oss-process' => 'image/circle,r_100'],'PUT'); $flysystem->addPlugin(new TemporaryUrl()); string $flysystem->getTemporaryUrl('file.md', $expiration); string $flysystem->getTemporaryUrl('file.md', $expiration,[],'PUT'); // 更多功能请查看官方 SDK 手册：https://help.aliyun.com/document_detail/32100.html?spm=a2c4g.11186623.6.1055.66b64a49hkcTHv $flysystem->addPlugin(new Kernel()); $kernel = $flysystem->kernel(); ``` 前端 web 直传配置 ----------- [](#前端-web-直传配置) oss 直传有三种方式，当前扩展包使用的是最完整的 [服务端签名直传并设置上传回调](https://help.aliyun.com/document_detail/31927.html?spm=a2c4g.11186623.2.10.5602668eApjlz3#concept-qp2-g4y-5db) 方式，**扩展包只生成前端页面上传所需的签名参数**，前端上传实现可参考 [官方文档中的实例](https://help.aliyun.com/document_detail/31927.html?spm=a2c4g.11186623.2.10.5602668eApjlz3#concept-qp2-g4y-5db) 或自行搜索 ``` use Jasonmann\Flysystem\Aliyun\Plugins\SignatureConfig; $flysystem->addPlugin(new SignatureConfig()); /** * 1. 前缀如：'images/' * 2. 回调服务器 url * 3. 回调自定义参数，oss 回传应用服务器时会带上 * 4. 当前直传配置链接有效期 * 5. 文件大小限制 * 6. 回调系统参数, 默认值: Jasonmann\Flysystem\Aliyun\OssAdapter::SYSTEM_FIELD */ object $flysystem->signatureConfig($prefix = '/', $callBackUrl = '', $customData = [], $expire = 30, $maxSize = 1024 * 1024 * 2, $systemData = ['etag' => '${etag}', 'filename' => '${object}']); ``` 直传回调验签 ------ [](#直传回调验签) 当设置了直传回调后，可以通过验签插件，验证并获取 oss 传回的数据 [文档](https://help.aliyun.com/document_detail/91771.html?spm=a2c4g.11186623.2.15.7ee07eaeexR7Y1#title-9t0-sge-pfr) 注意事项： - 如果没有 Authorization 头信息导致验签失败需要先在 apache 或者 nginx 中设置 rewrite - 以 apache 为例，修改 httpd.conf 在 DirectoryIndex index.php 这行下面增加「RewriteEngine On」「RewriteRule .\* - \[env=HTTP\_AUTHORIZATION:%{HTTP:Authorization},last\]」 ``` use Jasonmann\Flysystem\Aliyun\Plugins\Verify; $flysystem->addPlugin(new Verify()); list($verify, $data) = $flysystem->verify(); // [$verify, $data] = $flysystem->verify(); // php 7.1 + if (!$verify) { // 验证失败处理，此时 $data 为验签失败提示信息 } // 注意一定要返回 json 格式的字符串，因为 oss 服务器只接收 json 格式，否则给前端报 CallbackFailed header("Content-Type: application/json"); echo json_encode($data); ``` 直传回调验签后返回给前端的数据「包括自定义参数」，例如 ``` { "bucket": "your-bucket", "etag": "D8E8FCA2DC0F896FD7CB4CB0031BA249", "filename": "user/15854050909488182.png", "size": "56039", "mimeType": "image/png", "height": "473", "width": "470", "format": "png", "custom_name": "zhangsan", "custom_age": "24" } ``` > 这其实要看你回调通知方法具体怎么返回，如果直接按照文档给的方法返回是这个样子 前端直传组件分享「vue + element」 ----------------------- [](#前端直传组件分享vue--element) ``` import { getOssPolicy } from '@/api/oss' // 这里就是获取直传配置接口 export default { name: 'Upload', props: { url: { type: String, default: null } }, data() { return { uploadUrl: '', // 上传提交地址 data: {}, // 上传提交额外数据 dialogImageUrl: '', // 预览图片 files: [] // 上传的文件 } }, computed: {}, created() { this.dialogImageUrl = this.url }, methods: { handleChange(file, fileList) { console.log(file, fileList) }, // 上传之前处理动作 async handleBeforeUpload(file) { const fileName = this.makeRandomName(file.name) try { const response = await getOssPolicy() this.uploadUrl = response.host // 组装自定义参数 if (Object.keys(response['callback-var']).length) { for (const [key, value] of Object.entries(response['callback-var'])) { this.data[key] = value } } this.data.policy = response.policy this.data.OSSAccessKeyId = response.accessid this.data.signature = response.signature this.data.host = response.host this.data.callback = response.callback this.data.key = response.dir + fileName } catch (error) { this.$message.error('获取上传配置失败') console.log(error) } }, // 文件上传成功处理 handleSucess(response, file, fileList) { const fileUrl = this.uploadUrl + this.data.key this.dialogImageUrl = fileUrl this.$emit('update:url', fileUrl) this.files.push({ name: this.data.key, url: fileUrl }) }, // 上传失败处理 handleError() { this.$message.error('上传失败') }, // 随机名称 makeRandomName(name) { const randomStr = Math.random().toString().substr(2, 4) const suffix = name.substr(name.lastIndexOf('.')) return Date.now() + randomStr + suffix } } } .avatar-uploader .el-upload { border: 1px dashed #d9d9d9; border-radius: 6px; cursor: pointer; position: relative; overflow: hidden; } .avatar-uploader .el-upload:hover { border-color: #409EFF; } .avatar-uploader-icon { font-size: 28px; color: #8c939d; width: 150px; height: 150px; line-height: 150px; text-align: center; } .avatar { width: 150px; height: 150px; display: block; } ``` Laravel、Lumen适配包 ---------------- [](#laravellumen适配包) - Laravel 5：[jasonmann/laravel-filesystem-ali](https://github.com/JasonMann1993/laravel-filesystem-ali) 参考 -- [](#参考) - [iidestiny/flysystem-oss](https://github.com/iiDestiny/flysystem-oss) License ------- [](#license) [![LICENSE](https://camo.githubusercontent.com/be80b8cb211ceb2263744e99fdb161a40124901906fd7c7f47d6361760dd7e8b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d416e74692532303939362d626c75652e737667)](https://github.com/996icu/996.ICU/blob/master/LICENSE) ### Health Score 27 — LowBetter than 49% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity8 Limited adoption so far Community13 Small or concentrated contributor base Maturity58 Maturing project, gaining track record Bus Factor1 Top contributor holds 73.3% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~33 days Total 2 Last Release 1574d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/49307a9a5a2e44875bc59124a750cb934d2a413cc550baf800e14271536b4bd7?d=identicon)[jasonmann](/maintainers/jasonmann) --- Top Contributors [![JasonMann1993](https://avatars.githubusercontent.com/u/28591132?v=4)](https://github.com/JasonMann1993 "JasonMann1993 (11 commits)")[![Mr-Lee-hc](https://avatars.githubusercontent.com/u/49892525?v=4)](https://github.com/Mr-Lee-hc "Mr-Lee-hc (2 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (2 commits)") --- Tags laravelossali oss ### Embed Badge ![Health badge](/badges/jasonmann-flysystem-aliyun-oss/health.svg) ``` [![Health](https://phpackages.com/badges/jasonmann-flysystem-aliyun-oss/health.svg)](https://phpackages.com/packages/jasonmann-flysystem-aliyun-oss) ``` ### Alternatives [jacobcyl/ali-oss-storage aliyun oss filesystem storage for laravel 5+ 523566.2k7](/packages/jacobcyl-ali-oss-storage)[iidestiny/flysystem-oss Flysystem adapter for the Oss storage. 95607.5k26](/packages/iidestiny-flysystem-oss)[yangyifan/upload 上传 SDK for Laravel 12422.6k3](/packages/yangyifan-upload)[luoyy/ali-oss-storage aliyun oss filesystem storage for laravel 9+ 1529.9k1](/packages/luoyy-ali-oss-storage)[aobozhang/aliyun-oss-adapter Use Aliyun oss as Storage for Laravel 5.0+ 141.0k](/packages/aobozhang-aliyun-oss-adapter) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)