查询PHP 8.0起抛出TypeError异常的内置函数完整列表

不是只有array_column()和count()两个函数受该变更影响，“所有内置函数均已完成调整”的表述也不准确，该变更是PHP官方从8.0版本开始推进的内部函数类型校验一致性改造，属于分阶段落地的调整，而非一次性全量上线。

变更核心逻辑 #

• PHP 8.0之前，内置函数的参数校验规则和用户自定义严格模式函数不一致：遇到参数类型不匹配的场景，多数内置函数只会抛出警告，同时返回null、false等容错值，不会中断程序执行。
• 从PHP 8.0开始，官方逐步把所有内置函数的参数校验逻辑对齐严格类型模式的自定义函数：参数不符合函数声明的类型要求时，会直接抛出TypeError异常。
• 该改造没有在PHP 8.0版本一次性完成，从8.0到后续的8.1、8.2、8.3等小版本中，官方一直在持续补全剩余函数的校验逻辑，因此不存在跨所有8.x版本的固定“全量受影响函数列表”。

官方日志仅提及两个函数的原因 #

count()和array_column()是PHP 8.0首批完成改造的函数中使用频率最高、存量代码踩坑概率最大的两个函数，因此官方在通用版本更新日志的醒目位置单独做了提示。其余同批次及后续版本完成改造的函数，相关说明分散在版本迁移指南的细分章节、以及每个函数对应手册页的更新日志板块，没有集中在通用更新日志中展示。

8.0版本首批完成改造的高频函数还包括大部分常用的数组、字符串操作函数，比如strlen()、strpos()、substr()、array_shift()、in_array()等，这些函数在传入非对应类型参数时，都会直接抛出TypeError，不再保留之前的警告+容错返回逻辑。

迁移排查建议 #

• 不要完全依赖静态代码检测工具识别这类问题，这类问题属于运行时类型错误，静态分析很难覆盖所有动态传参的场景。最稳妥的排查方式是将项目的全量自动化测试用例运行在目标PHP版本环境下，开启全量错误报告，即可覆盖绝大多数实际调用场景的隐患。
• 过渡阶段可以在高频调用的老逻辑前增加类型判断，比如调用count()前先校验入参是否为数组或者Countable接口实例，避免线上触发未捕获异常。
• 不要采信非官方渠道的极端表述，判断某个函数是否受影响最准确的方式，是查阅你当前部署的PHP版本对应的官方手册，对应函数页的更新日志板块会明确标注类型校验规则的变更版本。

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