PHPackages qifen/flysystem-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. qifen/flysystem-oss ActiveLibrary[File & Storage](/categories/file-storage) qifen/flysystem-oss =================== AliYun OSS adapter for flysystem V2. aliyuncs/oss-sdk-php ~2.4 1.0.1(4y ago)025MITPHPPHP >=7.2 Since Feb 11Pushed 4y ago1 watchersCompare [ Source](https://github.com/xsxs89757/filesystem-oss)[ Packagist](https://packagist.org/packages/qifen/flysystem-oss)[ Docs](https://github.com/xsxs89757/filesystem-oss)[ RSS](/packages/qifen-flysystem-oss/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (2)Dependencies (2)Versions (3)Used By (0) \#安装 ``` composer require qifen/flysystem-oss ``` \#感谢 ``` 借鉴了 xxtime/flysystem-aliyun-oss 部分代码，在此表示感谢。 ``` Usage ===== [](#usage) ``` use League\Flysystem\Filesystem; use Qifen\FilesystemOss\OssAdapter; $aliyun = new OssAdapter([ 'accessId' => '', 'accessSecret' => '', 'bucket' => '', 'endpoint' => '', // 'timeout' => 3600, // 'connectTimeout' => 10, // 'isCName' => false, // 'token' => '', ]); $filesystem = new Filesystem($aliyun); // Write Files $filesystem->write('path/to/file.txt', 'contents'); // get RAW data from aliYun OSS $raw = $aliyun->supports->getFlashData(); // Write Use writeStream $stream = fopen('local/path/to/file.txt', 'r+'); $result = $filesystem->writeStream('path/to/file.txt', $stream); if (is_resource($stream)) { fclose($stream); } // Update Files $filesystem->update('path/to/file.txt', 'new contents'); // Check if a file exists $exists = $filesystem->has('path/to/file.txt'); // Read Files $contents = $filesystem->read('path/to/file.txt'); // Delete Files $filesystem->delete('path/to/file.txt'); // Rename Files $filesystem->rename('filename.txt', 'newname.txt'); // Copy Files $filesystem->copy('filename.txt', 'duplicate.txt'); // list the contents (not support recursive now) $filesystem->listContents('path', false); ``` 插件扩展 ---- [](#插件扩展) ``` use Qifen\FilesystemOss\Plugins\FileUrl; use Qifen\FilesystemOss\Plugins\SignUrl; use Qifen\FilesystemOss\Plugins\TemporaryUrl; use Qifen\FilesystemOss\Plugins\SetBucket; // 获取 oss 资源访问链接 $flysystem->addPlugin(new FileUrl()); string $flysystem->getUrl('file.md'); // url 访问有效期 & 图片处理「$timeout 为多少秒过期」 $flysystem->addPlugin(new SignUrl()); // 默认GET string $flysystem->signUrl('file.md', $timeout, ['x-oss-process' => 'image/circle,r_100']); // PUT方式 string $flysystem->signUrl('file.md', $timeout, ['x-oss-process' => 'image/circle,r_100'],'PUT'); // url 访问有效期「$expiration 为未来时间 2019-05-05 17:50:32」 $flysystem->addPlugin(new TemporaryUrl()); // 默认GET string $flysystem->getTemporaryUrl('file.md', $expiration); // PUT方式 string $flysystem->getTemporaryUrl('file.md', $expiration,[],'PUT'); // 多个bucket切换 $flysystem->addPlugin(new SetBucket()); $flysystem->bucket('test')->has('file.md'); ``` 获取官方完整 OSS 处理能力 --------------- [](#获取官方完整-oss-处理能力) 阿里官方 SDK 可能处理了更多的事情，如果你想获取完整的功能可通过此插件获取， 然后你将拥有完整的 oss 处理能力 ``` use Qifen\FilesystemOss\Plugins\Kernel; $flysystem->addPlugin(new Kernel()); $kernel = $flysystem->kernel(); // 例如：防盗链功能 $refererConfig = new RefererConfig(); // 设置允许空Referer。 $refererConfig->setAllowEmptyReferer(true); // 添加Referer白名单。Referer参数支持通配符星号（*）和问号（？）。 $refererConfig->addReferer("www.aliiyun.com"); $refererConfig->addReferer("www.aliiyuncs.com"); $kernel->putBucketReferer($bucket, $refererConfig); ``` > 更多功能请查看官方 SDK 手册：[https://help.aliyun.com/document\_detail/32100.html?spm=a2c4g.11186623.6.1055.66b64a49hkcTHv](https://help.aliyun.com/document_detail/32100.html?spm=a2c4g.11186623.6.1055.66b64a49hkcTHv) 前端 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 Qifen\FilesystemOss\Plugins\SignatureConfig; $flysystem->addPlugin(new SignatureConfig()); /** * 1. 前缀如：'images/' * 2. 回调服务器 url * 3. 回调自定义参数，oss 回传应用服务器时会带上 * 4. 当前直传配置链接有效期 * 5. 文件大小限制 * 6. 回调系统参数, 默认值: Qifen\FilesystemOss\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 Qifen\FilesystemOss\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; } ``` ### Health Score 21 — LowBetter than 19% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity6 Limited adoption so far Community7 Small or concentrated contributor base Maturity45 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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 ~2 days Total 2 Last Release 1552d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/e26d34228dd7885fd40c2f1e33cd967313c27cf5509b831984b6994e00fbba87?d=identicon)[xsxs89757](/maintainers/xsxs89757) --- Top Contributors [![xsxs89757](https://avatars.githubusercontent.com/u/32379836?v=4)](https://github.com/xsxs89757 "xsxs89757 (7 commits)") --- Tags Flysystemaliyun-ossflysystem-aliyun-oss ### Embed Badge ![Health badge](/badges/qifen-flysystem-oss/health.svg) ``` [![Health](https://phpackages.com/badges/qifen-flysystem-oss/health.svg)](https://phpackages.com/packages/qifen-flysystem-oss) ``` ### Alternatives [league/flysystem-aws-s3-v3 AWS S3 filesystem adapter for Flysystem. 1.6k263.6M790](/packages/league-flysystem-aws-s3-v3)[xxtime/flysystem-aliyun-oss AliYun OSS adapter for flysystem. Support PHP8. aliyuncs/oss-sdk-php ~2.6 51505.3k28](/packages/xxtime-flysystem-aliyun-oss)[league/flysystem-local Local filesystem adapter for Flysystem. 226231.8M39](/packages/league-flysystem-local)[league/flysystem-bundle Symfony bundle integrating Flysystem into Symfony applications 40029.5M87](/packages/league-flysystem-bundle)[league/flysystem-sftp-v3 SFTP filesystem adapter for Flysystem. 6129.6M91](/packages/league-flysystem-sftp-v3)[league/flysystem-memory In-memory filesystem adapter for Flysystem. 8533.6M194](/packages/league-flysystem-memory) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)