PHPackages qifen/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. qifen/filesystem ActiveLibrary[File & Storage](/categories/file-storage) qifen/filesystem ================ Flysystem V2 adapter for the webman 1.1.7(3y ago)177MITPHPPHP >=7.2 Since Feb 11Pushed 3y ago1 watchersCompare [ Source](https://github.com/xsxs89757/filesystem)[ Packagist](https://packagist.org/packages/qifen/filesystem)[ RSS](/packages/qifen-filesystem/feed)WikiDiscussions master Synced 1w ago READMEChangelog (10)Dependencies (1)Versions (20)Used By (0) 安装 == [](#安装) ``` composer require qifen/filesystem ``` 请修改 config/plugin/qifen/filesystem 下的配置文件 ``` return [ 'default' => 'local', 'storage' => [ 'local' => [ 'driver' => \Qifen\Filesystem\Adapter\LocalAdapterFactory::class, 'root' => runtime_path(), ], 'ftp' => [ 'driver' => \Qifen\Filesystem\Adapter\FtpAdapterFactory::class, 'host' => 'ftp.example.com', 'username' => 'username', 'password' => 'password', // 'port' => 21, // 'root' => '/path/to/root', // 'passive' => true, // 'ssl' => true, // 'timeout' => 30, // 'ignorePassiveAddress' => false, // 'timestampsOnUnixListingsEnabled' => true, ], 'memory' => [ 'driver' => \Qifen\Filesystem\Adapter\MemoryAdapterFactory::class, ], 's3' => [ 'driver' => \Qifen\Filesystem\Adapter\S3AdapterFactory::class, 'credentials' => [ 'key' => 'S3_KEY', 'secret' => 'S3_SECRET', ], 'region' => 'S3_REGION', 'version' => 'latest', 'bucket_endpoint' => false, 'use_path_style_endpoint' => false, 'endpoint' => 'S3_ENDPOINT', 'bucket_name' => 'S3_BUCKET', ], 'minio' => [ 'driver' => \Qifen\Filesystem\Adapter\S3AdapterFactory::class, 'credentials' => [ 'key' => 'S3_KEY', 'secret' => 'S3_SECRET', ], 'region' => 'S3_REGION', 'version' => 'latest', 'bucket_endpoint' => false, 'use_path_style_endpoint' => true, 'endpoint' => 'S3_ENDPOINT', 'bucket_name' => 'S3_BUCKET', ], 'oss' => [ 'driver' => \Qifen\Filesystem\Adapter\AliyunOssAdapterFactory::class, 'accessId' => 'OSS_ACCESS_ID', 'accessSecret' => 'OSS_ACCESS_SECRET', 'bucket' => 'OSS_BUCKET', 'endpoint' => 'OSS_ENDPOINT', // 'timeout' => 3600, // 'connectTimeout' => 10, // 'isCName' => false, // 'token' => null, // 'proxy' => null, ], 'qiniu' => [ 'driver' => \Qifen\Filesystem\Adapter\QiniuAdapterFactory::class, 'accessKey' => 'QINIU_ACCESS_KEY', 'secretKey' => 'QINIU_SECRET_KEY', 'bucket' => 'QINIU_BUCKET', 'domain' => 'QINBIU_DOMAIN', ], 'cos' => [ 'driver' => \Qifen\Filesystem\Adapter\CosAdapterFactory::class, 'region' => 'COS_REGION', 'app_id' => 'COS_APPID', 'secret_id' => 'COS_SECRET_ID', 'secret_key' => 'COS_SECRET_KEY', // 可选，如果 bucket 为私有访问请打开此项 // 'signed_url' => false, 'bucket' => 'COS_BUCKET', 'read_from_cdn' => false, // 'timeout' => 60, // 'connect_timeout' => 60, // 'cdn' => '', // 'scheme' => 'https', ], ], ]; ``` - 阿里云 OSS 适配器 ``` composer require qifen/flysystem-oss ``` - S3 适配器 ``` composer require "league/flysystem-aws-s3-v3:^2.0" ``` - 七牛云适配器 ``` composer require "overtrue/flysystem-qiniu:^2.0" ``` - 内存适配器 ``` composer require "league/flysystem-memory:^2.0" ``` - 腾讯云 COS 适配器 ``` composer require "overtrue/flysystem-cos:^4.0" ``` 使用 == [](#使用) 通过 FilesystemFactory::get('local') 来调用不同的适配器 ``` use Qifen\Filesystem\FilesystemFactory; public function upload(Request $request) { $file = $request->file('file'); $filesystem = FilesystemFactory::get('local'); $stream = fopen($file->getRealPath(), 'r+'); $filesystem->writeStream( 'uploads/'.$file-getUploadName(), $stream ); if (is_resource($stream)) { @fclose($stream); } // Write Files $filesystem->write('path/to/file.txt', 'contents'); // Add local file $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 $filesystem->listContents('path', false); } ``` 便捷式上传 ===== [](#便捷式上传) ``` use Qifen\Filesystem\Facade\Storage; public function upload(Request $request){ // 适配器 local默认是存储在runtime目录下 public默认是存储在public目录下 // 可访问的静态文件建议public // 默认适配器是local Storage::adapter('public'); //单文件上传 $file = $request->file('file'); $result = Storage::upload($file); //单文件判断 try { $result = Storage::adapter('public')->path('storage/upload/user')->size(1024*1024*5)->extYes(['image/jpeg','image/gif'])->extNo(['image/png'])->upload($file); }catch (\Exception $e){ $e->getMessage(); } //多文件上传 $files = $request->file(); $result = Storage::uploads($files); try { //uploads 第二个参数为限制文件数量 比如设置为10 则只允许上传10个文件 第三个参数为允许上传总大小 则本列表中文件总大小不得超过设定 $result = Storage::adapter('public')->path('storage/upload/user')->size(1024*1024*5)->extYes(['image/jpeg','image/gif'])->extNo(['image/png'])->uploads($files,10,1024*1024*100); }catch (\Exception $e){ $e->getMessage(); } // 指定文件名上传(同文件将被覆盖) try { $files = $request->file(); $fileName = 'storage/upload/user/1.png'; // 文件名中如此带了路径 则下面的path无效 未带路径1.png效果相等 $ext = true; // 文件尾缀是否替换 开启后则$files上传的任意图片 都会转换为$fileName尾缀（示例: .png），默认false $result = Storage::adapter('public')->path('storage/upload/user')->size(1024*1024*5)->extYes(['image/jpeg','image/gif'])->extNo(['image/png'])->reUpload($file,$fileName,$ext); }catch (\Exception $e){ $e->getMessage(); } // base64图片上传 try { $files = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcIAAAHCCAYAAAB8GMlFAAAAAXNSR0IArs4c6QAAAARnQU1BAACx..."; $result = Storage::adapter('public')->path('storage/upload/user')->size(1024*1024*5)->extYes(['image/jpeg','image/gif'])->extNo(['image/png'])->base64Upload($files); }catch (\Exception $e){ $e->getMessage(); } //获取文件外网 $filesName = 'storage/a4bab140776e0c1d57cc316266e1ca05.png'; $fileUrl = Storage::url($filesName); //指定选定器外网 $fileUrl = Storage::adapter('oss')->url($filesName); } ``` \###静态方法（可单独设定） 方法描述默认adapter选定器config 中配置的 defaultsize单文件大小config 中配置的 max\_sizeextYes允许上传文件类型config 中配置的 ext\_yesextNo不允许上传文件类型config 中配置的 ext\_nopath文件存放路径(非完整路径)storage### 响应字段 [](#响应字段) 字段描述示例值origin\_name源文件名称webman.pngfile\_name文件路径及名称storage/a4bab140776e0c1d57cc316266e1ca05.pngstorage\_key文件随机 keya4bab140776e0c1d57cc316266e1ca05file\_url文件访问外网//127.0.0.1:8787/storage/cab473e23b638c2ad2ad58115e28251c.pngsize文件大小22175mime\_type文件类型image/jpegextension文件尾缀jpgwidth图片宽度（图片类型才返回）206height图片高度（图片类型才返回）206 ### Health Score 25 — LowBetter than 37% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity11 Limited adoption so far Community7 Small or concentrated contributor base Maturity53 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 ~21 days Recently: every ~0 days Total 19 Last Release 1181d 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 (25 commits)") --- Tags filesystemqiniuosscoswebman ### Embed Badge ![Health badge](/badges/qifen-filesystem/health.svg) ``` [![Health](https://phpackages.com/badges/qifen-filesystem/health.svg)](https://phpackages.com/packages/qifen-filesystem) ``` ### Alternatives [league/flysystem-aws-s3-v3 AWS S3 filesystem adapter for Flysystem. 1.6k263.6M790](/packages/league-flysystem-aws-s3-v3)[shopwwi/webman-filesystem Flysystem V2 adapter for the webman 2715.4k5](/packages/shopwwi-webman-filesystem)[league/flysystem-sftp-v3 SFTP filesystem adapter for Flysystem. 6129.6M91](/packages/league-flysystem-sftp-v3)[yangyifan/upload 上传 SDK for Laravel 12422.6k3](/packages/yangyifan-upload)[alphasnow/aliyun-oss-flysystem Flysystem adapter for the Aliyun storage 14249.2k4](/packages/alphasnow-aliyun-oss-flysystem)[jerodev/flysystem-v3-smb-adapter SMB adapter for Flysystem v3 1289.9k1](/packages/jerodev-flysystem-v3-smb-adapter) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)