原文： 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 文件上传

Tonwed

如何上传自定义后缀的文件，比如bp

dyzdyz010

这个插件和七牛的 Referer防盗链设置怎么一起工作啊？我在七牛里设置了Referer白名单，结果网站上的图片直接被 403 了……

yangjingchuang

那个地方可以上传七牛？？？

suroot

yangjingchuang 需要安扩展

yangjingchuang

suroot 嗷嗷，谢谢了

轻抚三下

音频上传如何实现在线播放？

shelley

支持flarum现在最新版吗？

ink

shelley 当然

Axeho

请问论坛普通用户如何找到自己上传的文件呢。比如传了一张图片，下次想再发这张图，需要再传一次吗？

Golden

Axeho 目前没有查看历史上传的功能，暂时只能重传一次

轻抚三下

Golden 老大，设置了七牛云模式，图片超过1M都上传出错，提示超过限制。

Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate 20480 bytes) in XXX/vendor/intervention/image/src/Intervention/Image/Gd/Decoder.php on line 138

PHP和NGINX都设置了上传最大200M，，求解..

Golden

轻抚三下 PHP 配置 memory_limit 太少了，根据自己的服务器内存，调大点，比如 512 M，

轻抚三下

Golden 真是，可以了，谢谢老大！

轻抚三下

POST https://XXX.cn/api/fof/upload

null

老大，memory_limit设置了1024M，Nginx最大上传190M，php最大上传190M，
现在上传5M的图片debug出现上面这个提示，求解T-T

Golden

补充：
中文社区貌似也上传不了5M的图片….

再补充：
宝塔的From规范协议，拦截了API的请求。
经测试，在宝塔防火墙的api接口设置白名单后。。可以正常上传大于5M图片。。。。

Golden

0.13.0 主要新增：文件管理器

新增多设备响应式文件管理器
简化编辑器的上传按钮
添加编辑器的媒体管理器按钮
添加 /fof/uploads Endpoint
更新 /fof/upload Endpoint
更新 FileSerializer Endpoint
添加 File 前端模态框
添加个人主页文件管理器入口。
新增管理员访问其他用户文件的权限
新增从文件管理器中取消收纳文件的选项（从存储中删除文件的功能即将推出）

** 模态框功能：**
文件管理器具有扩展性。其他扩展可以打开 FileManagerModal 模态框组件并添加自定义参数以自定义需求。

文件管理器是响应式的、支持文件拖拽、支持批量嵌入文件于编辑器中。单击「选择文件」按钮后，文件将以 bbcode 的代码形式插入到编辑器中。

更新编辑器按钮

选择并上传文件

示例：仅允许上传 `image` 文件

夜间模式

移动端预览

FriendsOfFlarum/upload#262
FriendsOfFlarum/upload#271

更新

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

感谢 @JasperVriends 一起完成更新。感谢 @davwheat 帮助完成初步的文件删除功能。

注意：目前仅支持 beta.15，不过会尽快适配 beta.16。

Creepy

您好，在安装时出现以下问题：

Golden

Creepy Beta 16 版本：

composer require fof/upload:*@beta

上面不行的话试试下面的：

composer require fof/upload:0.14.0-beta

Creepy

Golden 完美解决了，非常感谢！

Creepy

请问目前是否完全支持 Beta 16 版本？因为我在设置的时候选择本地上传，但都显示上传失败。

晓慕1

Creepy 已经支持了，没事可以去我的网站试试
😍ba.notstart.com