PHPackages zh-cn-code/ali-oss-laravel - 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. zh-cn-code/ali-oss-laravel ActiveLibrary zh-cn-code/ali-oss-laravel ========================== aliyun oss filesystem storage for laravel 5+ 0321PHP Since Nov 3Pushed 5y ago1 watchersCompare [ Source](https://github.com/zhCN-code/AliOss-Laravel)[ Packagist](https://packagist.org/packages/zh-cn-code/ali-oss-laravel)[ RSS](/packages/zh-cn-code-ali-oss-laravel/feed)WikiDiscussions master Synced today READMEChangelogDependenciesVersions (1)Used By (0) AliOss-Laravel ============== [](#alioss-laravel) 自身业务需要对优秀的包进行扩展 Inspired By ----------- [](#inspired-by) - [jacobcyl/ali-oss-storage](https://github.com/jacobcyl/Aliyun-oss-storage) Require ------- [](#require) - Laravel 5+ - cURL extension \##Installation In order to install AliOSS-storage, just add ``` "zh-cn-code/ali-oss-laravel": "*" ``` to your composer.json. Then run `composer install` or `composer update`. Or you can simply run below command to install: ``` "composer require jacobcyl/ali-oss-storage:^2.1" ``` Then in your `config/app.php` add this line to providers array: ``` ZhCNCode\AliOSS\AliOssServiceProvider::class, ``` 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 ``` License ------- [](#license) Source code is release under MIT license. Read LICENSE file for more information. ### Health Score 19 — LowBetter than 10% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity12 Limited adoption so far Community9 Small or concentrated contributor base Maturity31 Early-stage or recently created project Bus Factor1 Top contributor holds 83.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. ### Community Maintainers ![](https://www.gravatar.com/avatar/b908a6338feeb5b3f83121537ac882f7e642c13b1e27d6ed7de4984fe47e17e6?d=identicon)[zhCN-code](/maintainers/zhCN-code) --- Top Contributors [![Yang-xiaohui](https://avatars.githubusercontent.com/u/31752743?v=4)](https://github.com/Yang-xiaohui "Yang-xiaohui (5 commits)")[![ms-desing](https://avatars.githubusercontent.com/u/51522575?v=4)](https://github.com/ms-desing "ms-desing (1 commits)") ### Embed Badge ![Health badge](/badges/zh-cn-code-ali-oss-laravel/health.svg) ``` [![Health](https://phpackages.com/badges/zh-cn-code-ali-oss-laravel/health.svg)](https://phpackages.com/packages/zh-cn-code-ali-oss-laravel) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)