PHP 8中如何避免向count函数传入非可数值时触发致命错误？

错误信息 #

Fatal error: Uncaught TypeError: count(): Argument #1 ($value) must be of type Countable|array, null given in C:\xampp\htdocs\app\includes\functions\create_session.php:78
Stack trace:
#0 C:\xampp\htdocs\public\front_desk.php(508): Session->check_subfeature_access(22, 0)
#1 {main} thrown in C:\xampp\htdocs\app\includes\functions\create_session.php on line 78

一、无法通过PHP配置忽略该限制 #

PHP 8.0+ 已彻底移除对非Countable/array类型传入count()的兼容机制，没有任何配置项可以关闭这个致命错误，必须通过修改代码解决。

二、正则表达式批量替换方案 #

1. 全局通用替换 #

针对所有count()调用场景，用正则将参数强制转为数组，快速修复大部分报错：

• 正则表达式：count\(([^)]+)\)
• 替换内容：count((array)$1)

适用场景：项目中绝大多数count()调用的参数都可能为null或非数组类型，可直接在IDE（如VS Code、PHPStorm）中开启全局文件替换。

2. 精准替换（针对超全局变量） #

如果只想修复$_POST/$_GET等超全局变量的调用，避免误改其他合法场景，用以下规则：

• 正则表达式：count\(\$_(POST|GET|REQUEST|SESSION)\[([^\]]+)\]\)
• 替换内容：count((array)$_$1[$2])

3. 命令行批量处理 #

如果需要一次性处理整个项目的PHP文件：

• Linux/macOS（使用sed）：

sed -i 's/count\(([^)]+)\)/count((array)\1)/g' /path/to/your/project/*.php

• Windows（使用PowerShell）：

Get-ChildItem -Path "D:\your-project-path" -Filter "*.php" -Recurse | ForEach-Object {
    (Get-Content $_.FullName) -replace 'count\(([^)]+)\)', 'count((array)$1)' | Set-Content $_.FullName
}

三、长期重构方案 #

批量替换只是临时过渡，建议后续逐步优化代码：

• 对可能为null的变量，使用空合并运算符初始化：count($var ?? [])
• 对超全局变量参数，提前做类型校验：$items = $_POST['items'] ?? []; count($items);
• 利用PHP 8的类型声明，在函数参数或返回值中明确数组/Countable类型，从根源避免此类问题

内容的提问来源于stack exchange，提问作者Sannan - Move to Codidact