Branch: master
Clone or download
Latest commit e5b458a Jan 30, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
js extension Jan 30, 2019
migrations extension Jan 30, 2019
resources extension Jan 30, 2019
src extension Jan 30, 2019
CHANGELOG.md extension Jan 30, 2019
CONTRIBUTING.md extension Jan 30, 2019
LICENSE.md extension Jan 30, 2019
README.md 更新说明 Jan 30, 2019
composer.json Update composer.json Jan 30, 2019
extend.php extension Jan 30, 2019
phpunit.xml extension Jan 30, 2019


最近弄一个flarum论坛,图片储存需要用到阿里云oss上传的拓展,看了一下“flagrow/upload”好像暂时没有阿里云,不过作者说稍后会添加。 我暂时等不了那么久,所以自己在原插件基础上增加了阿里云oss的支持。


本插件没有composer安装,所以请自己composer需要的依赖。 使用前提你必须拥有以下拓展:

  • 阿里云oss sdk (不高于2.2的版本,我用的2.2.4) composer require aliyuncs/oss-sdk-php:v2.2.4
  • Flysystem的oss适配器 composer require aliyuncs/aliyun-oss-flysystem

然后下载本插件,覆盖去原插件那里(vendor/flagrow/upload),本插件只增加了模块,没改动原来的东西,原理上是不会影响你原来的插件配置。 (如果你之前没有用过flagrow/upload插件,请先自行composer安装一下原插件,因为会有安装别的依赖,然后再下载本插件去覆盖原插件即可)


可能还需要php flarum cache:clear一下


Upload by Flagrow logo Flagrow

MIT license Latest Stable Version Total Downloads Donate

An extension that handles file uploads intelligently for your forum.


  • For images:
    • Auto watermarks.
    • Auto resizing.
  • Mime type to upload adapter mapping.
  • Whitelisting mime types.
  • Uploading on different storage services (local, imgur, AWS S3 for instance).
  • Drag and drop uploads.
  • Uploading multiple files at once (button and drag and drop both support this).
  • Easily extendable, the extension heavily relies on Events.

For a complete overview of our releases, please visit the milestones tracker on Github.


Use Bazaar or install manually:

composer require "flagrow/upload:*"


composer update flagrow/upload
php flarum cache:clear


Enable the extension, a new tab will appear on the left hand side. This separate settings page allows you to further configure the extension.

Make sure you configure the upload permission on the permissions page as well.

Mimetype regular expression

Regular expressions allow you a lot of freedom, but they are also very difficult to understand. Here are some pointers, but feel free to ask for help on the official Flarum forums.

In case you want to allow all regular file types including video, music, compressed files and images, use this:


A mimetype consists of a primary and secondary type. The primary type can be image, video and application for instance. The secondary is like a more detailed specification, eg png, pdf etc. These two are divided by a /, in regex you have to escape this character by using: \/.


Please visit the thread.

Check future milestones.


If you discover a security vulnerability within Upload, please send an email to the Flagrow team at security@flagrow.io. All security vulnerabilities will be promptly addressed.

Please include as many details as possible. You can use php flarum info to get the PHP, Flarum and extension versions installed.



An extension by Flagrow.