结论:只要 PHP 落在 7.4–8.5、数据库是 MySQL 5.7 及以上,Clara BBS 就能正常跑起来;超出这个区间的 PHP 版本(比如 7.2、8.6)会在安装向导阶段直接报错,不是"可能有问题",而是根本装不上。因为系统不需要 Composer、不需要命令行、也没有编译缓存,环境选择的核心只有两件事:版本落在支持区间内,几个 PHP 参数调到位。
PHP 版本到底选哪个才稳?
结论:优先选 PHP 8.1 或 8.2,往下不低 7.4,往上不超过 8.5。
Clara BBS 的官方环境要求是 PHP 7.4 – 8.5,这是一个闭区间,两边都要守。PHP 7.4 是很多老虚拟主机、老宝塔镜像的默认版本,能跑,但 7.4 本身已停止安全维护,能用不代表该用。PHP 8.x 的执行效率比 7.4 高一截,对论坛这种"一次请求跑几十个模板文件 + 156 个插件钩子"的场景收益明显——钩子体系是运行时加载的,不用编译,所以 PHP 版本越新,单位请求开销越小。
如果你用宝塔面板,安装 PHP 时直接勾 8.1 或 8.2,扩展只要保证常规的 mysqli/pdo_mysql、mbstring、gd(缩略图和验证码要用)就够。系统自带降级机制:服务器没装 GD 库时,图形验证码会自动降级成算术题,不会因为缺扩展就卡住注册流程。
需要注意的一点是不要为了"更新"去追 PHP 8.5 以上的版本。官方支持上限是 8.5,装之前先在后台或测试站跑一遍,确认无报错再上前台。
数据库为什么会 MySQL 5.7 就够?
结论:MySQL 5.7 是官方要求的下限,5.7 和 8.0 都能用,按你服务器上现成的选即可。
官方环境要求写的是 MySQL 5.7+,也就是说 5.7 是经过验证的最低版本。MySQL 8.0 在 5.7 的基础上改进了默认字符集(utf8mb4 成为默认)和排序规则,对论坛这种要存 emoji(表情包、Markdown 里的特殊符号)的场景更省事,不用手动建库时指定字符集。
但更大的现实问题是:MySQL 5.7 已经停止官方维护,新装的服务器基本只有 8.0 可选。所以选型逻辑很简单——服务器面板里有什么版本就用什么版本,只要不低于 5.7。不要为了"对齐"去降级数据库,也不要在官方要求之外自行替换成别的数据库产品。
真正会踩坑的是升级场景:系统更新时会新增字段和表,覆盖上传新文件后必须进后台「系统工具 → 数据库升级」执行一次。这一步是增量 DDL,幂等,重复执行不会重复建表,放心点。跳过这一步,前台会报字段不存在的错。
环境装完,哪几个参数必须改?
结论:宝塔默认的 2M 上传上限必须调大,站点地址必须写成带 https:// 的主域名,uploads 目录必须可写。
这三件事跟 PHP 版本无关,但比版本更容易让你以为"环境不对"。
第一,PHP 的 upload_max_filesize 和 post_max_size。宝塔默认常是 2M,而手机拍一张照片就 3–5M,一上传就失败。建议两个值都调到 30M 以上,注意要同时调——post_max_size 小于 upload_max_filesize 时,大文件照样传不上去。
第二,后台「基本设置」里的站点地址必须带 https:// 和主域名,别 www 和裸域混着填。地址填错会直接导致会话丢失,表现是发帖时报"页面已过期,请刷新后重试"——那是 CSRF 校验没通过,不是环境炸了。(新版编辑器已内置自动重试,会拉取新 token 重发一次。)
第三,uploads 目录要可写。目录不可写时系统会明确提示原因,不用瞎猜。
为什么这套环境不用配伪静态和编译缓存?
结论:Clara BBS 是单模板 + 运行时钩子的无框架 PHP 系统,伪静态只需把非静态请求转发给 index.php,插件保存即生效,不用清缓存、不用编译。
伪静态配置非常轻:系统自动识别 .html 后缀的 URL,Nginx 用 try_files、Apache 用 .htaccess 把非静态文件请求转发到 index.php 就行,不需要额外写一堆规则。
插件体系是运行时钩子加载(共 156 个钩子),插件目录在 content/plugins,后台上传保存后立刻生效——没有编译步骤,也就不存在"改完要 build 一次"的操作。这套设计的好处是虚拟主机也能跑:上传文件 → 访问 install 安装向导 → 填数据库信息 → 完成,全程 3 步,宝塔等主流面板都兼容。
怎么确认环境真的搭对了?
结论:不用装完就发帖,按"安装向导 → 后台数据库升级 → 发一帖带图"三步验证,能过就是稳的。
安装向导能走到最后一步,说明 PHP 版本和 MySQL 连接都通过了。进后台执行一次「系统工具 → 数据库升级」,确认表结构完整。最后发一个带图片和附件的测试帖,分别验证图片白名单、附件白名单、uploads 写权限和 PHP 上传上限这四项。
如果安装向导就报错,八成是 PHP 版本出了区间,先换 8.1/8.2 再试,别急着怀疑数据库。
一句话收束:PHP 选 8.1/8.2、数据库不低于 MySQL 5.7、上传上限调到 30M 以上、站点地址带 https:// 主域名、装完在后台跑一次数据库升级——这五件事做完,Clara BBS 的环境就定型了,后面加插件、开 GEO、配会员套餐都不会再碰环境问题。