FoF 文件上传 | FoF Upload
Flarum 文件上传的扩展程序,具有令人难以置信的智慧。
功能
- 图片上传
- 文件管理
- 使用 MIME 限定文件上传类型。
- MIME 文件类型白名单。
- 本地、第三方存储服务支持(imgur、AWS S3、S3 兼容、七牛云)。
- 支持拖拽、粘贴上传。
- 支持批量上传文件(按钮、拖拽上传均支持)。
- 易扩展性,本扩展高度依赖于事件。
- 扩展器接口,以禁用或强制使用特定的适配器(祥见下文)
安装
通过巴扎市场或 composer 手动安装:
composer require fof/upload
升级
composer require fof/upload
php flarum migrate
php flarum cache:clear
从 Flagrow 版本升级
本扩展是旧版 Flagrow Upload 的替代。
要从旧扩展升级到当前版本:
设置
启用插件,新选项卡将会出现在左侧菜单栏。此设置页面可以让您进一步配置扩展程序。
请确保同时在权限页面上配置上传权限。
文件模板
文件模板详情请查看插件设置里的说明。这里注意一下,模板是由处理优先级的,同一个 MIME 类型文件,最上层的文件模板会覆盖掉下层设置的文件模板。
Mimetype 正则表达式
正则表达式使您拥有很大的自由度,但是它们也很难理解。这里有一些提示,您随时可以在 Flarum 官方论坛上寻求帮助。
另外请注意,您添加的规则是有优先级的,最先添加的规则,优先级最高。
禁用或强制使用特定适配器
有些情况下,您可能想要禁用某个上传服务,或者强制使用某个上传服务。您可以在 Flarum 安装根目录的 extend.php
中设置。
例如,您可以禁用 imgur
:
(new FoF\Upload\Extend\Adapters())
->disable('imgur'),
也可以链式禁用多个服务:
(new FoF\Upload\Extend\Adapters())
->disable('imgur')
->disable('aws-s3'),
您也可以强制使用服务:
(new FoF\Upload\Extend\Adapters())
->force('imgur'),
当前可用的适配器有:
常见问题
链接
FriendsOfFlarum 制作扩展
本译文仅用于学习和交流目的,转载请务必注明文章译者、原文出处、和本文链接。