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

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

Shine

希望增加腾讯云支持

AHdark

Anotia 下个ID见 Shine 国内绝大多数对象存储都是使用自由协议和S3协议兼容存储，包括OSS和COS

summerbloom

用不了，按照要求安装了依赖，还是不行，我用的stable版本

Shine

AHdark 谢谢，已成功