Flarum：轻量现代化 PHP 论坛安装与扩展使用指南
一、项目官方信息
| 项目 | 信息 |
|---|---|
| GitHub 仓库 | https://github.com/flarum/flarum（骨架应用；核心开发在 https://github.com/flarum/core） |
| 官方网站 | https://flarum.org/ |
| 开源协议 | MIT |
| 主要语言 | PHP（约 100%） |
| Star 数 | 约 14k |
| 前端框架 | Mithril.js（轻量高性能 JS 框架） |
Flarum 是一个“令人愉悦地简单”的讨论平台（a delightfully simple discussion platform），面向你的网站。官方 README 强调它的设计目标：
- 快速简洁：不臃肿、不复杂依赖，用 PHP 编写，部署轻快；前端由体量极小的 Mithril.js 驱动。
- 美观响应式：为“人”设计的论坛软件，开箱即在各平台保持一致、直观的体验。
- 强大可扩展：架构灵活，提供强大的扩展 API（Extension API），可定制、扩展、集成到你的社区。
需要注意：flarum/flarum 这个仓库只是骨架应用（skeleton application），大部分实际开发在 flarum/core 中进行。
二、官方图片
上图为 Flarum 官方首页展示的论坛界面截图，可见其简洁、现代化的讨论流样式。
三、环境要求
按官方安装文档（docs.flarum.org/install）：
- PHP 8.1 及以上，并启用常见扩展（mbstring、pdo、mysql、tokenizer、xml、curl、gd、intl、zip 等）。
- 数据库：MySQL 5.7+ / MariaDB 10.3+（或兼容数据库）。
- Web 服务器：Nginx 或 Apache；Nginx 需配置重写到
index.php。 - Composer（PHP 依赖管理工具）。
- 一个已解析到站点的域名。
四、完整安装步骤
1. 准备 Web 目录与 Composer
确保服务器已装 Composer，Web 根目录可写。
2. 用 Composer 创建项目
官方方式是用 Composer 拉取骨架：
composer create-project flarum/flarum .
（在你的 Web 根目录下执行，. 表示安装到当前目录。）
3. 配置 Web 服务器
- Nginx：站点根目录指向 Flarum 目录的
public/，并把请求重写到index.php；开启 URL 重写（Flarum 推荐的伪静态规则见官方文档）。 - Apache：确保
mod_rewrite开启，Flarum 自带.htaccess。 - 保证
public与后续需要的可写目录权限正确。
4. 运行 Web 安装向导
浏览器访问你的域名，会进入 Flarum 安装向导：
- 填写论坛标题；
- 填写数据库主机、库名、用户名、密码；
- 创建管理员账号（用户名、邮箱、密码）；
- 提交后即完成安装，进入论坛首页。
5. 验证
- 前台可看到默认主题的讨论列表。
- 用管理员账号登录后，右上角进入「管理（Administration）」后台，可看到仪表盘、基本信息、外观、扩展等。
五、使用方法
- 发帖与讨论：用户注册/登录后发起讨论（Discussion）并回复，形成扁平而现代的讨论流。
- 管理后台：管理员面板可设置站点名称、语言、主题、权限，以及管理用户与讨论。
- 扩展机制：Flarum 的核心刻意保持精简，绝大部分功能通过扩展（Extension）实现。在管理后台「扩展」页可启用官方自带扩展（如标签、表情、签名等），也可通过 Composer 安装社区扩展，例如：
bash composer require fof/pages安装后在后台启用。 - 主题外观：在「外观」中切换配色、布局，可安装第三方主题。
- 权限与用户组：通过用户组（Groups）控制谁能发帖、回复、编辑、上传附件等。
- 语言：后台可切换语言包，并支持社区翻译。
六、常见问题 FAQ
-
composer create-project报错或权限不足？ 确认已装 Composer、PHP 版本 ≥ 8.1，且 Web 目录可写；网络需能访问 packagist。必要时用官方要求的 PHP 扩展清单逐项核对。 -
访问后 404 / 链接打不开？ 多为 URL 重写未配置。Nginx 需把请求正确重写到
public/index.php；Apache 需开启mod_rewrite。按官方安装文档的伪静态规则配置。 -
flarum/flarum是完整代码吗？ 它只是骨架。真正的核心在flarum/core，由 Composer 作为依赖安装；日常安装用composer create-project flarum/flarum即可，无需单独 clone core。 -
怎么装第三方扩展？ 用 Composer
composer require 作者/扩展名，然后到管理后台「扩展」页启用。扩展市场可在 Flarum 官方扩展站与社区查找。 -
对 PHP 版本有要求吗？ 需要 PHP 8.1+。过低版本会在安装或运行时出问题，升级 PHP 后重新安装。
-
数据库必须是 MySQL 吗？ 官方支持 MySQL/MariaDB。安装向导里填写对应连接信息即可；不推荐用 SQLite 做生产。
七、跳转链接
- GitHub 仓库：https://github.com/flarum/flarum
- 核心仓库（flarum/core）：https://github.com/flarum/core
- 官方安装指南：https://docs.flarum.org/install
- 官方文档：https://docs.flarum.org
- 社区支持：https://discuss.flarum.org