PHPackages dgene/ali-oss-storage - 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. dgene/ali-oss-storage ActiveLibrary[File & Storage](/categories/file-storage) dgene/ali-oss-storage ===================== aliyun oss filesystem storage for laravel 5+ V1.2(5y ago)1837MITPHP Since Feb 19Pushed 5y ago2 watchersCompare [ Source](https://github.com/dcnfx/ali-oss-storage)[ Packagist](https://packagist.org/packages/dgene/ali-oss-storage)[ Docs](https://github.com/dcnfx/ali-oss-storage)[ RSS](/packages/dgene-ali-oss-storage/feed)WikiDiscussions master Synced today READMEChangelog (3)Dependencies (1)Versions (4)Used By (0) Aliyun-oss-storage for Laravel 5+ ================================= [](#aliyun-oss-storage-for-laravel-5) Aliyun oss filesystem storage adapter for laravel 5. You can use Aliyun OSS just like laravel Storage as usual. Inspired By ----------- [](#inspired-by) - [jacobcyl/Aliyun-oss-storage](https://github.com/jacobcyl/Aliyun-oss-storage) Require ------- [](#require) - Laravel 5+ - cURL extension \##Installation In order to install AliOSS-storage, just add ``` "dgene/ali-oss-storage": "^1.0" ``` to your composer.json. Then run `composer install` or `composer update`. Or you can simply run below command to install: ``` "composer require dgene/ali-oss-storage" ``` Configuration ------------- [](#configuration) Add the following in app/filesystems.php: ``` 'disks'=>[ ... 'oss' => [ 'driver' => 'oss', 'access_id' => '', 'access_key' => '', 'bucket' => '', 'endpoint'     => '', // OSS 外网节点或自定义外部域名            //'endpoint_internal' => '', // v2.0.4 新增配置属性，如果为空，则默认使用 endpoint 配置(由于内网上传有点小问题未解决，请大家暂时不要使用内网节点上传，正在与阿里技术沟通中) 'cdnDomain'     => '', // 如果isCName为true, getUrl会判断cdnDomain是否设定来决定返回的url，如果cdnDomain未设置，则使用endpoint来生成url，否则使用cdn 'ssl'           => // true to use 'https://' and false to use 'http://'. default is false, 'isCName'       => // 是否使用自定义域名,true: 则Storage.url()会使用自定义的cdn或域名生成文件url， false: 则使用外部节点生成url 'debug'         => ], ... ] ``` Then 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! Usage ----- [](#usage) See [Larave doc for Storage](https://laravel.com/docs/5.2/filesystem#custom-filesystems)Or you can learn here: > First you must use Storage facade ``` use Illuminate\Support\Facades\Storage; ``` > Then You can use all APIs of laravel Storage ``` Storage::disk('oss'); // if default filesystems driver is oss, you can skip this step //fetch all files of specified bucket(see upond configuration) Storage::files($directory); Storage::allFiles($directory); Storage::put('path/to/file/file.jpg', $contents); //first parameter is the target file path, second paramter is file content Storage::putFile('path/to/file/file.jpg', 'local/path/to/local_file.jpg'); // upload file from local path Storage::get('path/to/file/file.jpg'); // get the file object by path Storage::exists('path/to/file/file.jpg'); // determine if a given file exists on the storage(OSS) Storage::size('path/to/file/file.jpg'); // get the file size (Byte) Storage::lastModified('path/to/file/file.jpg'); // get date of last modification Storage::directories($directory); // Get all of the directories within a given directory Storage::allDirectories($directory); // Get all (recursive) of the directories within a given directory Storage::copy('old/file1.jpg', 'new/file1.jpg'); Storage::move('old/file1.jpg', 'new/file1.jpg'); Storage::rename('path/to/file1.jpg', 'path/to/file2.jpg'); Storage::prepend('file.log', 'Prepended Text'); // Prepend to a file. Storage::append('file.log', 'Appended Text'); // Append to a file. Storage::delete('file.jpg'); Storage::delete(['file1.jpg', 'file2.jpg']); Storage::makeDirectory($directory); // Create a directory. Storage::deleteDirectory($directory); // Recursively delete a directory.It will delete all files within a given directory, SO Use with caution please. // upgrade logs // new plugin for v2.0 version Storage::putRemoteFile('target/path/to/file/jacob.jpg', 'http://example.com/jacob.jpg'); //upload remote file to storage by remote url // new function for v2.0.1 version Storage::url('path/to/img.jpg'); // get the file url Storage::signedDownloadUrl('path/to/img.jpg', 'new_name.jpg', 3600); // get the signed file url ``` Documentation ------------- [](#documentation) More development detail see [Aliyun OSS DOC](https://help.aliyun.com/document_detail/32099.html?spm=5176.doc31981.6.335.eqQ9dM) License ------- [](#license) Source code is release under MIT license. Read LICENSE file for more information. ### Health Score 28 — LowBetter than 54% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity16 Limited adoption so far Community14 Small or concentrated contributor base Maturity54 Maturing project, gaining track record Bus Factor1 Top contributor holds 86.7% 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 ~26 days Total 3 Last Release 1853d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/93c918199d05f1e85ceb7311b864902c2d904feeae83e57786aa75ab09b58088?d=identicon)[dcnfx](/maintainers/dcnfx) --- Top Contributors [![jacobcyl](https://avatars.githubusercontent.com/u/906128?v=4)](https://github.com/jacobcyl "jacobcyl (65 commits)")[![dcnfx](https://avatars.githubusercontent.com/u/6057358?v=4)](https://github.com/dcnfx "dcnfx (4 commits)")[![darkicerain](https://avatars.githubusercontent.com/u/6126209?v=4)](https://github.com/darkicerain "darkicerain (2 commits)")[![chuangbo](https://avatars.githubusercontent.com/u/179978?v=4)](https://github.com/chuangbo "chuangbo (1 commits)")[![jyj1993126](https://avatars.githubusercontent.com/u/6315451?v=4)](https://github.com/jyj1993126 "jyj1993126 (1 commits)")[![Kerry-6](https://avatars.githubusercontent.com/u/26839959?v=4)](https://github.com/Kerry-6 "Kerry-6 (1 commits)")[![xsilen](https://avatars.githubusercontent.com/u/59230709?v=4)](https://github.com/xsilen "xsilen (1 commits)") --- Tags laravelstoragefilesystemsaliyunoss ### Embed Badge ![Health badge](/badges/dgene-ali-oss-storage/health.svg) ``` [![Health](https://phpackages.com/badges/dgene-ali-oss-storage/health.svg)](https://phpackages.com/packages/dgene-ali-oss-storage) ``` ### Alternatives [jacobcyl/ali-oss-storage aliyun oss filesystem storage for laravel 5+ 523566.2k7](/packages/jacobcyl-ali-oss-storage) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)