原文： https://discuss.flarum.org/d/4154 FoF 文件上传 | FoF Upload Flarum 文件上传的扩展程序，具有令人难以置信的智慧。 ⚠ 需 PHP 功能 exif 支持功能图片上传自动水印。自动缩放文件管理使用 MIME 限定文件上传类型。 MIME 文件类型白名单。本地、第三方存储服务支持（imgur、AWS S3、S3 兼容、七牛云）。支持拖拽、粘贴上传。支持批量上传文件（按钮、拖拽上传均支持）。易扩展性，本扩展高度依赖于事件。扩展器接口，以禁用或强制使用特定的适配器（祥见下文）安装通过巴扎市场或 composer 手动安装： composer require fof/upload if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 升级 composer require fof/upload php flarum migrate php flarum cache:clear if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 从 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 if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 在后台禁用上传插件。运行： composer require fof/upload if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } Composer 应该会输出 flagrow/upload 已经被自动删除的信息。在后台开启新版上传插件。您此前旧版本的设置、上传元数据将会自动合并到 FoF Upload 旗下。帖子中的文件插入代码会自动更新为 FoF 头，这意味着您不需要删除他们。设置启用插件，新选项卡将会出现在左侧菜单栏。此设置页面可以让您进一步配置扩展程序。请确保同时在权限页面上配置上传权限。文件模板文件模板详情请查看插件设置里的说明。这里注意一下，模板是由处理优先级的，同一个 MIME 类型文件，最上层的文件模板会覆盖掉下层设置的文件模板。 Mimetype 正则表达式正则表达式使您拥有很大的自由度，但是它们也很难理解。这里有一些提示，您随时可以在 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)) if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 如果您需要允许上传所有图片文件，请使用通配符： ^image\/.* if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } MIME 类型由主要类型 + 次要类型组成。主类型可以是 image 、 video 、 application 。次类型是更详细的规范，例如 png 、 pdf 等。两者之间用 / 分隔，在正则表达式中，您必须在斜线前添加转义字符来表示斜线： \/ 。有关 MIME 类型，可以查看 MDN 文档另外请注意，您添加的规则是有优先级的，最先添加的规则，优先级最高。禁用或强制使用特定适配器有些情况下，您可能想要禁用某个上传服务，或者强制使用某个上传服务。您可以在 Flarum 安装根目录的 extend.php 中设置。例如，您可以禁用 imgur ： (new FoF\Upload\Extend\Adapters()) ->disable('imgur'), if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 也可以链式禁用多个服务： (new FoF\Upload\Extend\Adapters()) ->disable('imgur') ->disable('aws-s3'), if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 您也可以强制使用服务： (new FoF\Upload\Extend\Adapters()) ->force('imgur'), if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 当前可用的适配器有： local imgur qiniu aws-s3 常见问题 AWS S3 配置：请阅读 AWS S3 配置页面 MIME 类型表：腾讯文档启用插件、上传图片报错：请检查是否安装了 PHP 的扩展 exif 添加媒体解析模板：自定义模板 Wiki 链接 Flarum 国际社区讨论帖 GitHub 源码报告问题通过 Packagist 下载 FriendsOfFlarum 制作扩展本译文仅用于学习和交流目的，转载请务必注明文章译者、原文出处、和本文链接。

MIME 类型表 Ctrl + F5 搜索文件扩展名【腾讯文档】MIME 类型表 https://docs.qq.com/doc/DV0VKQnhPVVlyUEtU

开启对象存储后，图片正常，但其他类型的附件，实测是经过了原vps服务器代理下载，而不是直接从对象存储下载……去github发了issue也没人理

[未知用户] 对，没问题，网站服务器确实没有文件，但确实走了服务器的流量，应该是网站服务器作为了一个中间代理转发了OSS的流量，因为我的网站服务器设置了限速，我测试下载的时候，速度最大值始终为我网站的最大速度，所以确实走了网站服务器流量，就很烦

qazwsdc 我明早去反馈下这个问题

有没有这个插件的，后台配置的参考图因为是新手所以不知道是怎么弄的

Golden 再往下可不可以再截个图（完整的配置举例），（敏感的信息P掉）

Golden 我感觉好像不是太好解决，其实我的想法可以直接把oss链接暴露出来，就像图片那样

[未知用户] 如果我不想配置cnd对象存储的话；本地OSS存储设置那里怎么填写呢

alexelv2012 使用对象存储时，这个地方才需要配置 CDN 域名，如果是直接上传到服务器，这里就不填

FoF 文件上传

ink

Golden 看样子应该是安装

Golden

sinken 安装这个

composer require fof/upload:0.8.2

sinken

Golden 谢谢您的答复，但结果还是一样的

Golden

sinken 错误提示是说您的当前 flarum 版本与要安装的插件不兼容。但是，您说您的 flarum 版本是 beta.11.1，实际上该插件是支持 beta.11.1 的。您试试安装最新版本 Flarum beta.12 后，再安装文件上传器

Golden

Golden 刚刚想到一个问题，您是不是没有进入 flarum目录执行安装命令呢？

sinken

Golden 我是已经CD到flarum根目录后再执行安装命令的

nil

您好，上传中文名的文件，文件名中的中文字符就会丢失或者变成uuid的值。

Golden

nil 是的，不支持中文名

nil

Golden 感谢，我试图修改源码来解决这个问题了。

啊啊啊低洼地

nil 请问是怎么解决的可以告知一下吗

Golden

发布：clarkwinkelmann

0.8.5 版本发布

修复了一些令人讨厌的错误：

在移动端上传文件后，文本编辑器将不再最小化；
修复无法拖拽文字的问题。

我还添加了一些检查以使文件拖放功能仅在支持这种操作的浏览器中启用。虽然我觉得现在几乎找不到不支持此操作的浏览器了，但是最好还是留一手。

23cxy丶com

上传超过大小限制之后会出现一个alert的错误弹框，并且在点击该弹框的确认按钮会，左下角会出现应有的提示，但是loading状态却无法复原。

不知 alert 的出现是设计如此吗？
loading 的问题似乎正常上传之后也无法复原！

还有，真希望能支持markdown原生图片标签。

感谢作者做出这么优秀的扩展！

哈哈最有有个小奢望，可以调用github的接口上传到github仓库吗….
或者支持附加插件，我可以自己开发子插件来让该插件支持其他的存储方式

Golden

23cxy丶com loading 状态无法复原是这个插件的 bug。
github 接口功能可以自行修改插件源码添加，然后提交 pull request 给作者👍

undo

23cxy丶com mjj你好哇，你的站很久之前访问过，功能太少了

23cxy丶com

undo 现在又来试试看呢，不要只停留在首页哟，其他几个板块多点一点，有惊喜

Xsling_cn

调用七牛和s3都会在试图访问文件时返回500错误，不知道是什么问题呢

Xsling_cn

Xsling_cn 调用七牛和s3都会在试图访问文件时返回500错误，不知道是什么问题呢

查了下是网址格式错误，但是应该在哪里改？

Golden

Xsling_cn OSS外链/CDN域名没写

1756816846

虚拟主机没有exif模块应该怎么办

shisheng

可不可以考虑兼容下OSS啊，OSS学生包用户大哭……
请大佬指导一下怎么用OSS呗（
谢谢啦！

shisheng

shisheng 才疏学浅的莳昇找到解法了，OSS兼容S3协议……

happyvalley-lmx

shisheng
请问您是在哪里设置存储地址的呢
我在"AWS S3 存储设置"中没找到兼容 S3 设置的方法
查了一圈好像只有FlarumChina的才有那个设置
想知道原版Flarum的插件有没有直接设置存储地址的方法x
(用的腾讯云COS)
已解决，直接把FlarumChina的Upload全局覆盖至FoF/Upload里，然后改好对应服务器地址以及key后，将s3扩展里上传的头从私有改成公有读就行了