虚拟主机也能跑的 PHP 7.4 兼容写法：老旧环境适配指南

能不能在老虚拟主机上跑 PHP 程序，关键不在主机配置高低，而在代码有没有守住「PHP 7.4 语法下限 + 零 Composer + 零命令行」这三条线。以 Clara BBS 为例，它官方要求 PHP 7.4-8.5 + MySQL 5.7+，无框架、无编译缓存、上传文件跑一遍 install 向导就能装——也就是说，一台只有 PHP 7.4 和 MySQL 5.7 的共享虚拟主机，完全跑得起来，前提是你写的（或你改的）代码别踩 PHP 8 的语法。

环境底线：7.4 是地板，不是建议值

结论：PHP 7.4 是这套系统的最低支持版本，低于 7.4 别抱侥幸心理，MySQL 必须 5.7 以上。

很多虚拟主机面板（宝塔等主流面板都兼容）里能切换 PHP 版本，切换时注意两点：一是选 7.4 而不是 5.6/7.0，二是把 MySQL 版本确认在 5.7+，因为 utf8mb4 索引长度在老版本 MySQL 上有 767 字节限制，容易在建表阶段就报错。安装流程本身没有门槛：上传文件 → 访问 install 目录 → 按向导填库信息 → 完成，全程不需要 Composer，也不需要 SSH 或 crontab。

语法层：别在 7.4 环境里写 8.0 的新玩具

结论：PHP 8.0 引入的语法糖在老环境里会直接导致「Parse error」，一解析就白屏，排查成本极高。

明确不能用的清单：nullsafe 运算符 `?->`、`match` 表达式、命名参数、构造器属性提升、联合类型（`int|string`）、枚举（8.1）、`readonly`（8.1）、`never` 返回类型（8.1）、属性标注 `#[...]`（8.0）。这些在 7.4 下全部是语法错误。

7.4 自己能放心用的：箭头函数 `fn()`、空合并赋值 `??=`、数组展开 `...$arr`、类型化属性 `public int $id;`。

// PHP 8.0+，7.4 直接报错
$name = $user?->name ?? '游客';

// 7.4 兼容写法
$name = isset($user) ? ($user->name ?? '游客') : '游客';

另一个高频坑是内置函数：`str_contains()`、`str_starts_with()`、`str_ends_with()` 都是 8.0 新增，7.4 里不存在。用之前必须判断，或者统一用旧写法：

if (strpos($text, '关键词') !== false) { /* 含关键词 */ }
if (strncmp($str, 'http', 4) === 0) { /* 以 http 开头 */ }

还要反向排查老坑：字符串下标用花括号 `$s{0}` 在 7.4 已弃用、8.0 直接移除，必须改成 `$s[0]`；`each()`、`create_function()` 这类早就没了，遇到就替换成 `foreach` 和闭包。

扩展层：把「可选依赖」当可选来写

结论：共享主机上 GD、mbstring、curl、zip 都可能没装，代码必须能降级，不能直接 fatal。

判断写法就两句：`extension_loaded('gd')` 和 `function_exists('mb_strlen')`。这一点 Clara BBS 本身给了个参考样本——图形验证码在检测不到 GD 时会自动降级成算术题，而不是直接报错。你自己写插件或改代码时同理：能用 `iconv` 兜底的别硬依赖 `mb_*`，图片处理失败就退回原图，邮件发不出就落库排队。

顺带说一句，Clara BBS 的插件体系是运行时钩子加载、保存即生效，不需要编译、不需要清缓存，公告里那 156 个钩子都是动态执行的——这对虚拟主机特别友好，因为你没有命令行去跑构建脚本。

配置层：改不了 php.ini，还能改 .user.ini

结论：FastCGI/FPM 环境下 `.user.ini` 能覆盖部分 php.ini 指令，是虚拟主机上唯一靠谱的调参入口。

最常调的是上传体积。老面板默认 `upload_max_filesize` 和 `post_max_size` 都是 2M，手机拍一张照片就超，建议调到 30M 以上。两者要一起调，因为 POST 上限比文件上限小的话同样失败。

上传失败时按三步排查，这是官方给的排查路径：一是后台「系统设置→上传」里「允许的扩展名」（管图片）和「附件允许的扩展名」（管附件）是两个独立字段，检查有没有包含对应格式；二是 PHP 的 `upload_max_filesize` / `post_max_size` 是否大于文件体积；三是 `uploads` 目录是否可写。页面失败时会直接提示具体原因，比如「超过 PHP 上限」「白名单不符」「目录不可写」，照着改就行。

另外提醒一句：`mod_php` 模式下 `.user.ini` 是不生效的，这种情况只能从面板切到 FPM，或者找主机商调。

部署层：伪静态和升级

结论：伪静态不需要写复杂规则，把非静态请求转发给 index.php 就够了。

系统会自动识别 `.html` 后缀 URL，Nginx 用 `try_files`、Apache 用 `.htaccess` 兜底即可，不用为每条路由配规则。升级更省事：覆盖上传新文件后，进后台「系统工具→数据库升级」执行一次增量 DDL，幂等可重复执行，新增的列和表会自动补齐，不会覆盖你已有的数据。

最后收一下：虚拟主机适配的核心就四件事——把 PHP 版本卡在 7.4 以上、语法只用 7.4 能解析的、扩展一律做存在性判断加降级、配置走 `.user.ini` 和后台面板而不是命令行。做到这几条，共享主机和 VPS 在运行体验上几乎没有差别。