如何在单个PHP脚本中因PHP版本过低提前终止以避免语法错误？

要在单个PHP脚本中实现版本检查，且避免低版本环境因不支持的语法直接报错，核心思路是让低版本PHP无需解析高版本特性代码，可以通过__HALT_COMPILER()函数实现，具体方案如下：

实现原理 #

PHP执行脚本时会先编译整个文件，但遇到__HALT_COMPILER()会立即停止编译后续内容，仅执行该函数之前的代码。利用这一特性：

1. 在__HALT_COMPILER()前完成版本检查，版本不满足则直接退出；
2. 版本满足时，读取脚本中__HALT_COMPILER()之后的高版本代码，通过eval执行。

示例代码 #

#!/usr/bin/env php
<?php
define("MIN_PHP_VER", 8.2);

// 版本检查逻辑
if (version_compare(PHP_VERSION, MIN_PHP_VER, '<')) {
    echo "This script requires at least PHP " . MIN_PHP_VER . "\n";
    exit(1);
}

// 读取并执行后续高版本代码
$scriptContent = file_get_contents(__FILE__);
// 截取__HALT_COMPILER()之后的内容（+18是该函数字符串的长度）
$highVersionCode = substr($scriptContent, strpos($scriptContent, '__HALT_COMPILER();') + 18);
eval($highVersionCode);
exit;

// 标记编译终止点，后续内容不会被PHP预编译
__HALT_COMPILER();

// --------------------------
// 以下是PHP 8.2+支持的代码
readonly class SomeClass
{
    public string $name;

    public function __construct(string $name)
    {
        $this->name = $name;
    }
}

// 测试代码
$obj = new SomeClass("Test");
echo "Successfully created readonly class instance: " . $obj->name . "\n";
echo "Running on PHP version: " . PHP_VERSION . "\n";

注意事项 #

• __HALT_COMPILER();必须单独占一行，行尾不能有多余字符，否则会影响代码截取的准确性；
• eval函数存在安全风险，仅当脚本完全由你控制、不会被恶意篡改时使用；
• 若脚本包含二进制内容，file_get_contents读取可能出现问题，但纯PHP代码场景下无影响。

内容的提问来源于stack exchange，提问作者Andrew