Clara BBS 环境要求是什么？PHP 版本与扩展清单

Clara BBS 的环境要求只有两条硬指标：PHP 7.4–8.5，MySQL 5.7 及以上；除此之外不需要 Composer、不需要命令行操作、没有编译或缓存构建环节，把文件传上去访问 install 目录就能装完。扩展方面目前唯一有明确"有无之别"的是 GD 图形库——没有它系统会自动把验证码降级成算术题，不影响安装和使用。

PHP 版本：7.4 到 8.5 是完整可用区间

结论：Clara BBS 支持 PHP 7.4 至 8.5，区间内任意版本都能跑，新装环境建议直接上 PHP 8.x。

这个跨度意味着你不太可能因为主机商默认版本而装不上：宝塔面板里从 7.4 到 8.3 的版本随便选一个即可，阿里云、腾讯云的虚拟主机常见配置也基本落在这个范围内。之所以能覆盖这么宽，是因为 Clara BBS 是无框架的轻量级 PHP 系统，没有依赖注入容器、没有路由编译、没有模板编译缓存这些会跟 PHP 大版本绑死的东西。

结论：Clara BBS 不需要 Composer，也不需要 SSH/命令行权限，纯虚拟主机就能部署。

这一点对国内很多只有 FTP + 面板的空间用户很关键——你不需要为了跑一个论坛去折腾 CLI、不用配环境变量、不用装 Node 构建前端。插件体系走的是运行时钩子（共 156 个钩子），插件文件丢进 content/plugins 目录、保存即生效，不存在"改完要重新编译"的步骤。

注意点：不要用 PHP 7.3 及更低版本，低于 7.4 不在支持区间内；同理 PHP 8.6 之后的版本在官方明确适配前建议先观望。

MySQL 版本：5.7 起步，8.0 更稳

结论：数据库要求 MySQL 5.7 及以上，推荐 MySQL 8.0。

安装向导里需要填的就是数据库地址、库名、账号、密码这四项常规信息，没有额外的建表脚本要手动执行。后续如果官方发了新版本，覆盖上传新文件后进后台「系统工具→数据库升级」执行一次即可——它是增量 DDL、幂等可重复执行，新增的列和数据表会自动补齐，不会覆盖你现有数据。

扩展清单：别被"清单"两个字吓到

结论：Clara BBS 官方没有强制扩展清单，唯一在功能文档里被点名的扩展是 GD，而且它是可降级的。

具体说清楚三件事：

第一，图形验证码依赖 GD 图形库。如果你的 PHP 环境没装 GD，系统会自动降级为算术验证题，防灌水的目的照样达到，只是形式从看图变成算数，安装和运行都不受影响。

第二，数据库连接扩展（mysqli / PDO_MySQL 一类）由 PHP 环境本身提供，宝塔等面板默认编译进去，正常情况不需要你单独勾选。

第三，真正容易踩坑的不是扩展，而是 PHP 的配置项。上传相关的两个参数最关键：upload_max_filesize 和 post_max_size 必须大于你要传的文件体积。宝塔默认是 2M，而手机拍的照片动辄三五兆，建议直接调到 30M 以上。另外 uploads 目录必须可写，否则任何上传都会失败——上传失败时页面会直接告诉你原因，比如超过 PHP 上限、白名单不符、目录不可写。

顺带一提，后台「系统设置→上传」里的"允许的扩展名"（管图片）和"附件允许的扩展名"（管附件）是两个独立字段，配的时候别只改一个。

从零到能访问：四步走完

结论：部署流程是"上传文件 → 访问 install 安装向导 → 填数据库信息 → 完成"，全程图形界面，兼容宝塔等主流面板。

装完之后建议做两件收尾：一是在后台「基本设置」里把站点地址填对，必须是带 https:// 的主域名形式，www 和裸域混用会导致会话丢失，进而出现发帖提示"页面已过期"；二是配置伪静态，系统自动识别 .html 后缀 URL，服务器只需要把非静态文件请求转发到 index.php（Nginx 用 try_files，Apache 用自带的 .htaccess），没有额外规则要写。

补充一句安全基线，装完不用额外加固也已经在防护范围内：全站 CSRF 防护、密码 bcrypt 存储、输出自动转义、上传文件类型白名单加图片二次校验都是内置的。

总结一下：PHP 7.4–8.5 + MySQL 5.7+ 是全部硬性要求，无 Composer、无命令行、无编译缓存，GD 缺失也能靠算术验证码自动降级；真正需要你动手调的其实是 upload_max_filesize / post_max_size 和 uploads 目录权限这几项服务器配置。