README

一个处理您论坛文件上传的智能扩展。

功能

• 对于图像
  • 自动水印。
  • 自动调整大小。
• MIME 类型到上传适配器映射。
• 白名单 MIME 类型。
• 在不同的存储服务上上传（例如本地、imgur、AWS S3）。
• 拖放上传。
• 一次上传多个文件（按钮和拖放都支持此功能）。
• 易于扩展，该扩展大量依赖事件。
• 扩展器接口用于禁用或强制特定适配器（见下文）

安装

使用 composer 手动安装

composer require fof/upload

更新

composer require fof/upload
php flarum migrate
php flarum cache:clear

从 Flagrow 更新

此扩展替换了 Flagrow Upload。

要从旧扩展升级到新扩展

• 备份您的数据！ 您应该备份数据库和上传的文件。

• 确保已安装 Flagrow upload 的最新版本且已运行迁移。

composer require flagrow/upload
composer show flagrow/upload # You should see "versions: * 0.7.1" on the 4th line of output
php flarum migrate

• 在管理员面板中禁用 Upload 扩展。

• 运行

composer require fof/upload

Composer 应该会通知您 flagrow/upload 已自动删除。

• 在管理员面板中启用新扩展。

• 您现有的配置和上传元数据将自动迁移到 FoF Upload。

• FoF Upload 使用与磁盘上相同的文件位置，这意味着不需要移动文件。

配置

启用扩展，左侧将出现一个新标签页。此独立的设置页面允许您进一步配置扩展。

请确保您还在权限页面上配置了上传权限。

MIME 类型正则表达式

正则表达式提供了很多自由度，但它们也很难理解。以下是一些提示，但您可以在官方 Flarum 论坛上寻求帮助。

如果您想允许包括视频、音乐、压缩文件和图像在内的所有常规文件类型，请使用此

(video\/(3gpp|mp4|mpeg|quicktime|webm))|(audio\/(aiff|midi|mpeg|mp4))|(image\/(gif|jpeg|png))|(application\/(x-(7z|rar|zip)-compressed|zip|arj|x-(bzip2|gzip|lha|stuffit|tar)|pdf))

MIME 类型由主要类型和次要类型组成。主要类型可以是 image、video 和 application 等。次要类型是一个更详细的说明，例如 png、pdf 等。这两个类型由一个 / 分隔，在正则表达式中您需要通过使用 \/ 来转义此字符。

禁用或强制特定适配器

在某些情况下，您可能希望禁用适配器或强制使用一个适配器。这可以在您的根 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'),

当前可用的适配器名称

• local
• imgur
• qiniu
• aws-s3

常见问题解答

• AWS S3：阅读 AWS S3 配置页面。
• 添加模板：阅读 自定义模板维基页面。

链接

• 
• Flarum Discuss 帖子
• GitHub 上的源代码
• 报告问题
• 通过 Packagist 下载

由 FriendsOfFlarum 开发的扩展