FriendsOfFlarum Upload —— 智能文件附件扩展

admin · 2026-05-13T14:12:16+00:00

FriendsOfFlarum 出品的 Upload 扩展一个智能处理论坛文件上传的扩展。功能特性图片方面：自动添加水印。自动调整尺寸。 MIME 类型到上传适配器的映射。 MIME 类型白名单。支持不同的存储服务（例如本地、Imgur、AWS S3）。拖放上传。一次上传多...

FoFBot

🚀 新版本发布：2.0.0-beta.3

适用于 Flarum 2.x

发布者： @IanM
发布地址： FriendsOfFlarum/upload 发布 2.0.0-beta.3

[2.x] fix: 处理 DefaultDownloader 和 GDPR 导出中本地文件缺失的问题 by @IanM in FriendsOfFlarum/upload#473
[2.x] fix: 在 fof_upload_files.url 上添加索引，防止每次渲染帖子时进行无索引查询 by @IanM in FriendsOfFlarum/upload#476

完整更新日志：FriendsOfFlarum/upload 2.0.0-beta.2 → 2.0.0-beta.3

mafesa

@IanM
我在运行 Flarum，使用 FoF Upload 和 Cloudflare R2 作为存储后端（awss3 驱动）。

当我运行 php flarum fof:upload --map --cleanup 时，命令总是提议删除那些实际上已嵌入到帖子中且运行完全正常的文件——用户可以毫无问题地查看和下载它们。

我通过直接查询 posts 表验证了这一点：

SELECT * FROM posts WHERE content LIKE '%filename%';

帖子存在且包含文件引用，但清理命令仍然标记它要删除。

这是 R2/awss3 的已知问题吗？我是否应该完全避免在这种配置下使用 --cleanup？

谢谢！

6temrepair

大家好，

我在 Flarum 1.8.13 上使用 PHP 8.3.29 和 FoF Upload 1.8.9，有几个问题要问。

我的虚拟主机提供了 GD 和 Imagick 两种选择。但 FoF Upload 在调整图片大小和添加水印时仍然使用 GD。有没有选项可以强制使用 Imagick？如何选择驱动？我在扩展设置中没有看到任何选项。

另外，是否可以配置质量压缩？谢谢！

MaxDob

大家好。我在使用 Flarum 2 时遇到一个问题。当我在论坛上传文件时，会在 assets/files/ 文件夹中创建一个带日期的文件夹。问题是这个文件夹的权限被设置为 700。因此上传的文件在论坛上无法显示，尽管它们确实被上传到了文件夹中。可能是什么问题？

ernestdefoe

MaxDob 我不是专家，但如果你对 assets 文件夹的权限设置正确，这种情况不应该发生。你需要确保该文件夹的权限是递归的，这样添加到该目录的任何文件夹或文件都是可读的。

MaxDob

ernestdefoe 你需要确保该文件夹的权限是递归的，这样添加到该目录的任何文件夹或文件都是可读的。

怎么做？

ernestdefoe

MaxDob 可以使用 SSH 或者 FTP 程序。

esbeeb

esbeeb 🇨🇦 我把 fof/upload 更新到了 2.0.0-beta.3，

composer update fof/upload

这个问题已经消失了。不再需要自定义 CSS：

.Modal-content {

overflow:visible !important;

}

Shortik

Shortik 小小提醒一下。🙂

esymeo

你好，感谢这个超棒的扩展！但我有一个建议：Imgur 自 2025 年 8 月起不允许创建新应用了。所以现在我们只能使用旧的客户端 ID。因此也许可以考虑替换为其他图片托管服务，比如 gyazo、imgbb？

iorGian

大家好，

我目前正在使用这个扩展，我想知道：有没有可能将云存储服务（例如 Proton Drive）与之集成？

具体来说，我想了解：

是否有计划支持 Proton Drive 作为存档/上传的存储后端。
是否有现有的 API 或通过自定义驱动桥接这两项服务的方法。

感谢你们在这个扩展上的辛勤工作！

KBExit

iorGian Proton 的应用不都是封闭的，没有公开的 API 吗？另外，我认为你也不想让上传的文件与你的个人云存储关联吧。而且，如果你真的让它工作了，我相信这也会违反他们的服务条款，你的账号可能会被终止。

krvam

大家好，

我在 PHP 8.3 上运行 Flarum 和 FoF Upload 1.8.11，但在管理面板中找不到缩略图或图片缩放选项。

我的配置：

Flarum 使用 config.php（没有 .env 文件）
PHP 8.3，已安装并启用 GD 和 Imagick
FoF Upload 1.8.11
本地存储

我阅读了文档，其中提到了自动图片缩放和 WebP 缩略图生成，但这些选项在扩展设置页面中根本没有出现。

我注意到 6temrepair 在几帖前报告了类似的问题（使用 1.8.9）——这是已知的 Bug 还是这些选项隐藏在某些条件后面？

另外，既然我不使用 .env 文件，在 PHP-FPM 池配置中设置环境变量（例如 env[FOF_UPLOAD_THUMBNAILS_ENABLED] = true）是否可以作为替代方案？

谢谢！

KBExit

krvam 我可能说错了，但我觉得你说的这些功能只在 2.0 中才有？？

ernestdefoe

KBExit 是的，我刚想说这应该是 Flarum 2 的扩展才有的功能。

krvam

KBExit 我可能说错了。我猜这个选项在我的版本中不可用，所以它不显示。

ernestdefoe

krvam 完全正确。你需要运行 Flarum 2.0（目前还是 Beta 版）以及兼容 2.0 的扩展版本才能获得这些选项。

krvam

ernestdefoe 谢谢，那是我搞错了哈哈。我会等 Flarum 2 正式发布再更新，以免出错。

ernestdefoe

krvam 嗯，可能是个好主意。

krvam

大家好！

我在使用 FoF Upload 上传 .m4v 视频文件时遇到了问题。出现以下错误：

检测到 MIME 类型不匹配：video/mp4 vs video/x-m4v

我当前的 MIME 类型正则表达式配置如下：

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

我已经在正则表达式中添加了 m4v 和 x-m4v，但错误仍然存在。看起来 FoF Upload 检测到同一文件有两种不同的 MIME 类型，并因 PHP Mime Detector 和 PHP Fileinfo 之间的不一致而拒绝。

有没有办法允许这种不匹配，或为同一文件同时白名单两种 MIME 类型？如有帮助，不胜感激！

谢谢！