PHP 7.1 的可空类型（如 ?array、?string）在 PHP 7.0 及更早版本中无法解析，会直接触发 Parse error 导致脚本加载失败；必须移除 ? 前缀并改用运行时空值判断或文档注释替代。
PHP 7.1 引入的可空类型声明（如 ?array、?string）在 PHP 7.0 及更早版本中**根本无法解析**，会直接触发 Parse error: syntax error，导致脚本加载失败——不是运行时报错，而是连文件都读不进去。
哪些写法在旧版本里会直接崩溃
以下语法在 PHP 7.0 或更低版本中属于非法 token，解析器不认识 ? 前缀：
function foo(?array $data): ?int { ... }-
public ?string $name;（类属性声明） function bar(): ?User { return null; }
只要源码里出现 ?type，PHP 7.0 解析器就会报错退出，不会执行任何后续逻辑。
如何快速识别是否踩了这个坑
遇到这类报错，先确认三点：
立即学习“PHP免费学习笔记（深入）”；
- 错误信息含
Parse error且定位到某行有?符号（比如?array） - 当前 PHP 版本用
php -v查，确认低于 7.1 - 项目用了 ThinkPHP 6 或其他现代框架，但部署环境仍是 PHP 7.0
特别注意：ThinkPHP 6 默认要求 PHP ≥ 7.1，但有些运维误配环境，导致代码写对了、环境跑不动。
向下兼容的改写方案
若必须支持 PHP 7.0 或更老版本，需彻底移除可空类型语法，并手动做空值判断：
- 把
function process(?array $items): ?array改为function process($items): array，开头加if ($items === null) { return []; } - 返回值不再声明
?string，改用string类型声明 + 文档注释@return string|null，靠 IDE 和静态分析工具辅助提示 - 类属性去掉
?array，改用普通array类型 + 构造函数赋默认值，或用 getter/setter 控制赋值逻辑
避免重复踩坑的实操建议
团队协作和持续集成中应强制落地：
- CI 流水线里用
php -l扫描全部 PHP 文件，确保能在目标最低版本下通过语法检查 - 项目根目录放
composer.json，明确声明"php": ">=7.1"，防止低版本环境误装 - 用 PHPCompatibility 工具做静态扫描，它能精准标出所有 7.1+ 语法在低版本中的风险点
