PHPackages timeshow/laravel-filesystem - 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. timeshow/laravel-filesystem ActiveLibrary[File & Storage](/categories/file-storage) timeshow/laravel-filesystem =========================== laravel文件上传系统 v0.3.0(2y ago)175MITPHPPHP ^8.1 Since Apr 1Pushed 2y ago1 watchersCompare [ Source](https://github.com/timeshow/laravel-filesystem)[ Packagist](https://packagist.org/packages/timeshow/laravel-filesystem)[ RSS](/packages/timeshow-laravel-filesystem/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (3)Versions (9)Used By (0) Laravel Filesystem ================== [](#laravel-filesystem) Version Compatibility --------------------- [](#version-compatibility) LaravelPackage9.00.2.010.0last versionRequire ------- [](#require) Installation In order to install, just install ``` PHP >=8.0 Laravel >=9.0 ``` Install ------- [](#install) Via Composer ``` $ composer require timeshow/laravel-filesystem ``` Then in your config/app.php add this line to providers array: ``` TimeShow\Filesystem\FilesystemServiceProvider::class, ``` Configuration ------------- [](#configuration) Add the following in app/filesystems.php: ``` 'oss' => [ 'driver' => 'oss', 'root' => '', 'access_key' => env('OSS_ACCESS_KEY'), 'secret_key' => env('OSS_SECRET_KEY'), 'endpoint' => env('OSS_ENDPOINT'), // 使用 ssl 这里设置如: https://oss-cn-beijing.aliyuncs.com 'bucket' => env('OSS_BUCKET'), 'isCName' => env('OSS_IS_CNAME', false), 'securityToken' => null, 'timeout' => '5184000', 'connectTimeout' => '10', 'transport' => 'http',//如果支持https，请填写https，如果不支持请填写http 'max_keys' => 1000,//max-keys用于限定此次返回object的最大数，如果不设定，默认为100，max-keys取值不能大于1000 // 如果有更多的 bucket 需要切换，就添加所有bucket，默认的 bucket 填写到上面，不要加到 buckets 中 'buckets'=>[ 'test'=>[ 'access_key' => env('OSS_ACCESS_KEY'), 'secret_key' => env('OSS_SECRET_KEY'), 'bucket' => env('OSS_TEST_BUCKET'), 'endpoint' => env('OSS_TEST_ENDPOINT'), 'isCName' => env('OSS_TEST_IS_CNAME', false), ], //... ], ], ``` Then in your .env add this lines to the bottom: ``` OSS_ACCESS_KEY = OSS_SECRET_KEY = OSS_ENDPOINT = https://oss-cn-hangzhou.aliyuncs.com OSS_BUCKET = OSS_IS_CNAME = false ``` Then you can set the default driver in app/filesystems.php: ``` 'default' => 'oss', ``` Ok, well! You are finish to configure. Just feel free to use Aliyun OSS like Storage! Base Usage ---------- [](#base-usage) First you must use Storage facade ``` use Illuminate\Support\Facades\Storage; ``` Then You can use all APIs of laravel Storage ``` // if default filesystems driver is oss, you can skip this step $disk = Storage::drive('oss'); $disk->files($directory); $disk->allFiles($directory); void $disk->put('video/2', $file ); void $disk->putFile('path/to/file/file.jpg', 'local/path/to/local_file.jpg'); void $disk->write('file.md', 'contents'); void $disk->write('file.md', 'http://httpbin.org/robots.txt', ['options' => ['xxxxx' => 'application/redirect302']]); void $disk->writeStream('file.md', fopen('path/to/your/local/file.jpg', 'r')); $disk->get('path/to/file/file.jpg'); // get the file object by path $disk->read('path/to/file/file.md'); // get the file object by path bool $disk->exists('path/to/file/file.jpg'); // determine if a given file exists on the storage(OSS) bool $disk->fileExists('path/to/file/file.md'); // determine if a given file exists on the storage(OSS) int $disk->size('path/to/file/file.jpg'); // get the file size (Byte) int $disk->fileSize('path/to/file/file.md'); // get the file size (Byte) int $disk->lastModified('path/to/file/file.jpg'); // get date of last modification $disk->directories($directory); // Get all of the directories within a given directory $disk->allDirectories($directory); // Get all (recursive) of the directories within a given directory void $disk->copy('old/file1.jpg', 'new/file1.jpg'); void $disk->move('old/file1.jpg', 'new/file1.jpg'); $disk->rename('path/to/file1.jpg', 'path/to/file2.jpg'); string $disk->mimeType('path/to/file1.jpg'); $disk->prepend('file.log', 'Prepended Text'); // Prepend to a file. $disk->append('file.log', 'Appended Text'); // Append to a file. bool $disk->delete('file.jpg'); bool $disk->delete(['file1.jpg', 'file2.jpg']); bool $disk->createDirectory($directory); // Create a directory. bool $disk->deleteDirectory($directory); // Recursively delete a directory.It will delete all files within a given directory, SO Use with caution please. $disk->url('path/to/img.jpg') // get the file url ``` Advanced Features ----------------- [](#advanced-features) you must use Adapter ``` use Illuminate\Support\Facades\Storage; array $disk->$adapter()->getMetadata('file.md'); array $disk->$adapter()->listContents(); string $disk->$adapter()->getUrl('file.md'); string $disk->getAdapter()->signatureConfig('path/to/file.png'); // url 访问有效期 & 图片处理「$timeout 为多少秒过期」 string $adapter->getTemporaryUrl('file.md', $timeout, ['x-oss-process' => 'image/circle,r_100']); // get string $adapter->getTemporaryUrl('file.md', $timeout, ['x-oss-process' => 'image/circle,r_100'],'PUT'); // put // 多个bucket切换 $adapter->bucket('test')->has('file.md'); ``` Full AliYun OSS Processing Capabilities --------------------------------------- [](#full-aliyun-oss-processing-capabilities) you can use more processing capabilities ``` $kernel = $adapter->ossKernel(); // 例如：防盗链功能 $refererConfig = new RefererConfig(); // 设置允许空Referer。 $refererConfig->setAllowEmptyReferer(true); // 添加Referer白名单。Referer参数支持通配符星号（*）和问号（？）。 $refererConfig->addReferer("www.aliiyun.com"); $refererConfig->addReferer("www.aliiyuncs.com"); $kernel->putBucketReferer($bucket, $refererConfig); ``` Please refer to the official SDK manual : [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 Configuration ----------------- [](#web-configuration) ``` /** * 1. 前缀如：'images/' * 2. 回调服务器 url * 3. 回调自定义参数，oss 回传应用服务器时会带上 * 4. 当前直传配置链接有效期 * 5. 文件大小限制 * 6. 回调系统参数, 默认值: Iidestiny\Flysystem\Oss\OssAdapter::SYSTEM_FIELD */ $adapter->signatureConfig($prefix = '/', $callBackUrl = '', $customData = [], $expire = 30, $maxSize = 1024 * 1024 * 2, $systemData = ['etag' => '${etag}', 'filename' => '${object}']); ``` Callback Verification --------------------- [](#callback-verification) 当设置了直传回调后，可以通过验签插件，验证并获取 oss 传回的数据 文档 注意事项： 如果没有 Authorization 头信息导致验签失败需要先在 apache 或者 nginx 中设置 rewrite 以 apache 为例，修改 httpd.conf 在 DirectoryIndex index.php 这行下面增加「RewriteEngine On」「RewriteRule .\* - \[env=HTTP\_AUTHORIZATION:%{HTTP:Authorization},last\]」 ``` list($verify, $data) = $adapter->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 24 — LowBetter than 32% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity12 Limited adoption so far Community7 Small or concentrated contributor base Maturity49 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 ~33 days Recently: every ~58 days Total 8 Last Release 903d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/57834562?v=4)[timeshow](/maintainers/timeshow)[@timeshow](https://github.com/timeshow) --- Top Contributors [![timeshow](https://avatars.githubusercontent.com/u/57834562?v=4)](https://github.com/timeshow "timeshow (10 commits)") --- Tags filesystemlaravel ### Embed Badge ![Health badge](/badges/timeshow-laravel-filesystem/health.svg) ``` [![Health](https://phpackages.com/badges/timeshow-laravel-filesystem/health.svg)](https://phpackages.com/packages/timeshow-laravel-filesystem) ``` ### Alternatives [unisharp/laravel-filemanager A file upload/editor intended for use with Laravel 5 to 10 and CKEditor / TinyMCE 2.2k3.3M74](/packages/unisharp-laravel-filemanager)[yoelpc4/laravel-cloudinary Laravel Cloudinary filesystem cloud driver. 3343.0k](/packages/yoelpc4-laravel-cloudinary)[jerodev/flysystem-v3-smb-adapter SMB adapter for Flysystem v3 1289.9k1](/packages/jerodev-flysystem-v3-smb-adapter)[zing/laravel-flysystem-obs Flysystem Adapter for OBS 1211.2k](/packages/zing-laravel-flysystem-obs) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)