Laravel全局重写count函数：PHP7升PHP8兼容方案咨询

问题背景 #

我们正在对Laravel项目进行PHP7到PHP8的版本升级，遇到count函数的兼容性问题：

原代码：

$a = new stdClass();
count($a);

不同PHP版本执行结果差异：

PHP7返回：1
PHP8抛出错误：TypeError: count(): Argument #1 ($value) must be of type Countable|array

项目规模较大，存在大量不规范使用count的场景，虽已修复大部分问题，但仍需一套兼容回退方案，希望全局重写count函数，实现以下逻辑：

function safeCount($foo) { 
    try {
        return count($foo); 
    } catch (\TypeError $e) {
        \Log::warning('调用count时传入非Countable/array类型参数');
        return 1;
    }
}

让应用内所有count($a)调用自动替换为上述逻辑。

可行方案 #

方案1：命名空间覆盖（仅自定义命名空间生效） #

PHP允许在自定义命名空间下定义与内置函数同名的函数，优先调用当前命名空间的函数。

1. 在项目根目录创建app/helpers.php，写入：

namespace App;

function count($value) {
    try {
        // 调用全局内置count函数
        return \count($value);
    } catch (\TypeError $e) {
        \Illuminate\Support\Facades\Log::warning(
            '不规范count调用：传入非Countable/array类型',
            ['参数类型' => gettype($value)]
        );
        return 1;
    }
}

2. 修改composer.json，添加自动加载：

"autoload": {
    "files": [
        "app/helpers.php"
    ]
}

3. 执行命令生效：

composer dump-autoload

注意：此方案仅对App\命名空间下的代码生效，第三方依赖包或全局命名空间的代码不受影响。

方案2：使用runkit扩展全局重写（风险较高） #

通过PECL的runkit扩展可以直接重写PHP内置函数，实现全局生效，但该扩展在生产环境使用需谨慎，且需额外安装。

1. 安装runkit扩展（以PHP8为例）：

pecl install runkit7

2. 在Laravel的bootstrap/app.php中添加重写逻辑：

if (extension_loaded('runkit7')) {
    runkit_function_redefine(
        'count',
        '$value',
        '
        try {
            return \count($value);
        } catch (\TypeError $e) {
            \Illuminate\Support\Facades\Log::warning(
                "不规范count调用：传入非Countable/array类型",
                ["参数类型" => gettype($value)]
            );
            return 1;
        }
        '
    );
}

注意：runkit在PHP8中的兼容性需提前验证，生产环境使用可能引发不可预期的核心行为问题。

方案3：全局替换为自定义安全函数（推荐长期方案） #

最安全且可控的方式是将项目中所有count调用替换为自定义函数，便于后续逐步清理不规范代码：

1. 在app/helpers.php中定义全局安全函数：

function safe_count($value) {
    if (is_countable($value)) {
        return count($value);
    }
    \Illuminate\Support\Facades\Log::warning(
        '不规范count调用：传入非Countable/array类型',
        ['参数类型' => gettype($value)]
    );
    return 1;
}

2. 同样在composer.json中添加该文件的自动加载，执行composer dump-autoload生效。

3. 使用IDE的全局替换功能，将项目中所有count(替换为safe_count(。

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