Flarum在虚拟主机上轻松搭建

在虚拟主机上搭建 Flarum（轻量级论坛）比 VPS 更简单，无需复杂配置。以下是具体步骤（以 cPanel 虚拟主机为例）：

一、准备工作

确认虚拟主机要求：
- PHP ≥ 7.4（推荐 8.0+）
- MySQL ≥ 5.7 或 MariaDB ≥ 10.2
- 支持 URL 重写（mod_rewrite）
- 至少 1GB 存储空间，512MB RAM
获取 Flarum 安装包：
- 从 Flarum 官网下载最新版
- 或通过 Composer 安装（需虚拟主机支持命令行）：
```
composer create-project flarum/flarum ./flarum --stability=beta
```

二、创建数据库

登录 cPanel，找到 MySQL 数据库 或 phpMyAdmin。
创建新数据库（如 flarum_db）和用户（如 flarum_user），并赋予所有权限。
记录数据库信息（主机名、数据库名、用户名、密码）。

三、上传文件

解压文件：
将下载的 Flarum 压缩包解压到本地文件夹。
上传至主机：
- 通过 cPanel 的 文件管理器 上传解压后的所有文件到网站根目录（如 public_html/）。
- 或使用 FTP 工具（如 FileZilla）：
  - 主机：虚拟主机 FTP 地址
  - 用户名：虚拟主机账号
  - 密码：虚拟主机密码
  - 端口：21（或根据主机设置调整）

四、配置 URL 重写

确保虚拟主机支持 URL 重写（Apache 的 .htaccess）：

在 Flarum 根目录（与 index.php 同级）创建 .htaccess 文件，内容如下

<IfModule mod_rewrite.c>
  RewriteEngine On
  RewriteBase /
  RewriteRule ^index\.php$ - [L]
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteRule . /index.php [L]
</IfModule>

若虚拟主机是 Nginx，需联系服务商配置以下规则：

location / {
   try_files $uri $uri/ /index.php?$query_string;
}

五、修改 PHP 设置（若需）

部分虚拟主机需要手动调整 PHP 参数：

在网站根目录创建 php.ini 文件，添加：

memory_limit = 256M
upload_max_filesize = 50M
post_max_size = 50M
max_execution_time = 300

或通过 cPanel 的 PHP 配置编辑器 修改上述参数。

六、运行安装向导

访问 https://your-domain.com（替换为你的域名），进入安装界面。
填写数据库信息：
- 数据库服务器：通常是 localhost 或主机提供的地址
- 数据库名：之前创建的数据库名（如 flarum_db）
- 数据库用户名 / 密码：之前创建的用户信息
- 表前缀：可选（如 fl_）
设置管理员账号：
- 用户名、密码、邮箱（需真实邮箱，用于接收通知）
配置论坛基本信息：
- 论坛标题、URL、时区等。
点击 安装 Flarum，等待完成。

七、安装后优化

设置文件权限：
确保以下目录可写：

storage/
public/assets/

启用 SSL：
通过 cPanel 的 SSL/TLS 管理器 申请免费 SSL 证书，开启 HTTPS。
性能优化：
- 安装缓存扩展（如 flarum/cache）：

composer require flarum/cache

八、常见问题解决

500 内部错误：
- 检查 .htaccess 文件语法
- 确认 PHP 版本符合要求
- 查看 storage/logs/flarum.log 获取详细错误信息
白屏或无法加载：
- 检查数据库连接信息是否正确
- 确保文件上传完整且权限正确
中文乱码：
- 在数据库创建时指定 utf8mb4 字符集
- 安装中文语言包：

composer require flarum-lang/chinese-simplified

九、扩展 Flarum 功能

Flarum 通过扩展插件增强功能，安装方法：

# 示例：安装 Markdown 编辑器
composer require fof/markdown

# 安装后需在后台「扩展」页面启用

推荐扩展：

FoF 系列：提供丰富功能（如 Markdown、用户头像上传等）
Flagrow 系列：增强安全性和用户体验
flarum-lang：多语言支持

通过以上步骤，你可以在虚拟主机上快速搭建一个功能完整的 Flarum 论坛。如果遇到问题，可参考 Flarum 官方文档或社区支持。

原正常使用过规则
在根目录下新建一个名为 .htaccess 的文件，并在其中写入：

<IfModule mod_rewrite.c>
  RewriteEngine on
  RewriteCond %{REQUEST_URI} !^/public/
  RewriteRule ^(.*)$ /public/$1 [L]
</IfModule>

Flarum 轻论坛论坛