PHPackages bestyii/yii2-aliyun-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. bestyii/yii2-aliyun-oss ActiveYii2-extension[File & Storage](/categories/file-storage) bestyii/yii2-aliyun-oss ======================= 阿里云对象存储（OSS）基于flysystem Yii2 扩展 1.0.0(6y ago)02.1kMITPHPPHP >=7.0 Since Apr 21Pushed 6y ago1 watchersCompare [ Source](https://github.com/bestyii/yii2-aliyun-oss)[ Packagist](https://packagist.org/packages/bestyii/yii2-aliyun-oss)[ RSS](/packages/bestyii-yii2-aliyun-oss/feed)WikiDiscussions master Synced yesterday READMEChangelog (1)Dependencies (2)Versions (2)Used By (0) yii2-aliyun-oss =============== [](#yii2-aliyun-oss) 阿里云对象存储（OSS）基于flysystem Yii2 扩展 [![Packagist Version](https://camo.githubusercontent.com/57b5042361033a4134ac7694a50cffa31e68dcc381b409505f05b29a332d3ee3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f626573747969692f796969322d616c6979756e2d6f73732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/bestyii/yii2-aliyun-oss)[![Total Downloads](https://camo.githubusercontent.com/0f302346f34122135f2680af56e40164daa4f45cd059427c3dc555c122a14d8a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f626573747969692f796969322d616c6979756e2d6f73732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/bestyii/yii2-aliyun-oss) 本扩展的文件管理系统，采用 [Flysystem](http://flysystem.thephpleague.com/)，通过 Yii2扩展[creocoder/yii2-flysystem](https://github.com/creocoder/yii2-flysystem)将其集成到Yii2框架中。 通过阿里云OSS的适配器[OssAdapter](https://github.com/xxtime/flysystem-aliyun-oss)，将两者结合在一起。 目的：标准化文件管理的接口，方便迁移到其他云平台。 安装 -- [](#安装) The preferred way to install this extension is through [composer](http://getcomposer.org/download/). 执行安装命令 ``` $ composer require bestyii/yii2-aliyun-oss ``` 或添加以下 ``` "bestyii/yii2-aliyun-oss": "*" ``` 到 `composer.json` 文件的 `require` 部分. 配置 -- [](#配置) 配置Yii的 `components` 如下: ``` return [ //... 'components' => [ //... 'fs' => [ 'class' => 'bestyii\aliyunoss\Filesystem', 'accessId' => OSS_ACCESS_ID, 'accessSecret' => OSS_ACCESS_SECRET, 'region' => OSS_REGION, 'bucket' => OSS_BUCKET, 'endpoint' => OSS_ENDPOINT, // 'timeout' => 3600, // 'connectTimeout' => 10, // 'isCName' => false, // 'token' => '', ], ], ]; ``` 使用 -- [](#使用) ### Writing files [](#writing-files) To write file ``` Yii::$app->fs->write('filename.ext', 'contents'); ``` To write file using stream contents ``` $stream = fopen('/path/to/somefile.ext', 'r+'); Yii::$app->fs->writeStream('filename.ext', $stream); ``` ### Updating files [](#updating-files) To update file ``` Yii::$app->fs->update('filename.ext', 'contents'); ``` To update file using stream contents ``` $stream = fopen('/path/to/somefile.ext', 'r+'); Yii::$app->fs->updateStream('filename.ext', $stream); ``` ### Writing or updating files [](#writing-or-updating-files) To write or update file ``` Yii::$app->fs->put('filename.ext', 'contents'); ``` To write or update file using stream contents ``` $stream = fopen('/path/to/somefile.ext', 'r+'); Yii::$app->fs->putStream('filename.ext', $stream); ``` ### Reading files [](#reading-files) To read file ``` $contents = Yii::$app->fs->read('filename.ext'); ``` To retrieve a read-stream ``` $stream = Yii::$app->fs->readStream('filename.ext'); $contents = stream_get_contents($stream); fclose($stream); ``` ### Checking if a file exists [](#checking-if-a-file-exists) To check if a file exists ``` $exists = Yii::$app->fs->has('filename.ext'); ``` ### Deleting files [](#deleting-files) To delete file ``` Yii::$app->fs->delete('filename.ext'); ``` ### Reading and deleting files [](#reading-and-deleting-files) To read and delete file ``` $contents = Yii::$app->fs->readAndDelete('filename.ext'); ``` ### Renaming files [](#renaming-files) To rename file ``` Yii::$app->fs->rename('filename.ext', 'newname.ext'); ``` ### Getting files mimetype [](#getting-files-mimetype) To get file mimetype ``` $mimetype = Yii::$app->fs->getMimetype('filename.ext'); ``` ### Getting files timestamp [](#getting-files-timestamp) To get file timestamp ``` $timestamp = Yii::$app->fs->getTimestamp('filename.ext'); ``` ### Getting files size [](#getting-files-size) To get file size ``` $timestamp = Yii::$app->fs->getSize('filename.ext'); ``` ### Creating directories [](#creating-directories) To create directory ``` Yii::$app->fs->createDir('path/to/directory'); ``` Directories are also made implicitly when writing to a deeper path ``` Yii::$app->fs->write('path/to/filename.ext'); ``` ### Deleting directories [](#deleting-directories) To delete directory ``` Yii::$app->fs->deleteDir('path/to/filename.ext'); ``` ### Managing visibility [](#managing-visibility) Visibility is the abstraction of file permissions across multiple platforms. Visibility can be either public or private. ``` use League\Flysystem\AdapterInterface; Yii::$app->fs->write('filename.ext', 'contents', [ 'visibility' => AdapterInterface::VISIBILITY_PRIVATE ]); ``` You can also change and check visibility of existing files ``` use League\Flysystem\AdapterInterface; if (Yii::$app->fs->getVisibility('filename.ext') === AdapterInterface::VISIBILITY_PRIVATE) { Yii::$app->fs->setVisibility('filename.ext', AdapterInterface::VISIBILITY_PUBLIC); } ``` ### Listing contents [](#listing-contents) To list contents ``` $contents = Yii::$app->fs->listContents(); foreach ($contents as $object) { echo $object['basename'] . ' is located at' . $object['path'] . ' and is a ' . $object['type']; } ``` By default Flysystem lists the top directory non-recursively. You can supply a directory name and recursive boolean to get more precise results ``` $contents = Yii::$app->fs->listContents('path/to/directory', true); ``` ### Listing paths [](#listing-paths) To list paths ``` $paths = Yii::$app->fs->listPaths(); foreach ($paths as $path) { echo $path; } ``` ### Listing with ensured presence of specific metadata [](#listing-with-ensured-presence-of-specific-metadata) To list with ensured presence of specific metadata ``` $listing = Yii::$app->fs->listWith( ['mimetype', 'size', 'timestamp'], 'optional/path/to/directory', true ); foreach ($listing as $object) { echo $object['path'] . ' has mimetype: ' . $object['mimetype']; } ``` ### Getting file info with explicit metadata [](#getting-file-info-with-explicit-metadata) To get file info with explicit metadata ``` $info = Yii::$app->fs->getWithMetadata('path/to/filename.ext', ['timestamp', 'mimetype']); echo $info['mimetype']; echo $info['timestamp']; ``` ### Health Score 26 — LowBetter than 43% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity15 Limited adoption so far Community7 Small or concentrated contributor base Maturity51 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 Unknown Total 1 Last Release 2212d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/383284?v=4)[Yang](/maintainers/ezsky)[@ezsky](https://github.com/ezsky) --- Top Contributors [![ezsky](https://avatars.githubusercontent.com/u/383284?v=4)](https://github.com/ezsky "ezsky (2 commits)") --- Tags aliyun-ossflysystemossyii2yii2-extensionphpFlysystemyii2yii2-extensionossaliyun-oss ### Embed Badge ![Health badge](/badges/bestyii-yii2-aliyun-oss/health.svg) ``` [![Health](https://phpackages.com/badges/bestyii-yii2-aliyun-oss/health.svg)](https://phpackages.com/packages/bestyii-yii2-aliyun-oss) ``` ### Alternatives [creocoder/yii2-flysystem The flysystem extension for the Yii framework 2931.7M62](/packages/creocoder-yii2-flysystem)[craftcms/aws-s3 Amazon S3 integration for Craft CMS 631.5M26](/packages/craftcms-aws-s3)[xxtime/flysystem-aliyun-oss AliYun OSS adapter for flysystem. Support PHP8. aliyuncs/oss-sdk-php ~2.6 51505.3k28](/packages/xxtime-flysystem-aliyun-oss)[craftcms/google-cloud Google Cloud Storage integration for Craft CMS 11100.7k1](/packages/craftcms-google-cloud) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)