nopj/flarum-ext-attachments

Flarum paid attachments extension with private backend-proxied downloads.

v0.1.6 2026-02-25 21:51 UTC

Requires

• php: ^8.1
• antoinefr/flarum-ext-money: ^1.3
• aws/aws-sdk-php: ^3.337
• flarum/core: ^1.8

MIT

README

用于 Flarum 的付费附件扩展，支持附件交易与财富变动记录。

功能说明

1. 附件发布与下载

• 支持两种资源类型：上传文件 / 外部链接
• 后端直传对象存储（S3/MinIO），前端不暴露密钥
• 私有下载链路：后端校验权限与购买状态后再签名

1. 付费附件交易

• 附件可设置价格
• 购买后自动扣款，上传者获得收入
• 支持手续费、最低售价、最低手续费
• 购买后可通知上传者（站内通知）

1. 财富记录（个人中心）

• 个人中心新增“xxx记录”（xxx 为你在论坛设置的货币名，例如 No记录）
• 记录变动金额、余额、时间、操作人
• 包含手动调整金额
• 包含附件购买/售出
• 包含 antoinefr-money 自动奖励与回收：
  • 回帖奖励 / 发帖奖励 / 点赞奖励
  • 隐藏、恢复、删除触发的回收或返还
• 自己给自己点赞不计奖励

1. 默认语言

• 扩展文案默认使用中文（zh-Hans），同时提供英文文案键
• 若论坛前台语言为中文，界面将默认展示中文

依赖要求

• Flarum ^1.8
• PHP ^8.1
• antoinefr/flarum-ext-money ^1.3

安装

在 Flarum 根目录执行：

composer require nopj/flarum-ext-attachments
php flarum migrate
php flarum cache:clear

然后到后台扩展管理中启用本扩展。

更新

在 Flarum 根目录执行：

composer update nopj/flarum-ext-attachments
php flarum migrate
php flarum cache:clear

说明：

• 每次更新后都建议执行 migrate 与 cache:clear
• 前台建议浏览器强制刷新（Ctrl+F5）

从 GitHub 安装（未发布到 Packagist 时）

在 Flarum 根目录 composer.json 中添加：

{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/chao2hang/flarum-ext-attachments"
    }
  ]
}

然后执行：

composer require nopj/flarum-ext-attachments:dev-main
php flarum migrate
php flarum cache:clear

后台配置项

1. 存储配置

• bucket、region、access key、secret key、endpoint
• SSL 校验、CA 证书路径、对象 key 前缀、ACL

1. 上传配置

• 最大文件大小
• 默认售价
• 上传权限

1. 交易配置

• 是否启用手续费
• 手续费金额
• 最低手续费
• 最低售价
• 下载签名有效期

安全建议

• 生产环境建议使用 private ACL
• 除非明确知道风险，不要关闭 SSL 校验
• 自定义证书请配置 ca_bundle_path

License

MIT