count()是PHP中计算数组长度的唯一标准函数,sizeof()仅为兼容别名且不鼓励使用;它支持COUNT_NORMAL和COUNT_RECURSIVE两种模式,需注意多维数组计数差异;对非数组类型返回特定值,建议先用is_array()校验;循环中应缓存count结果避免重复调用。

PHP 中计算数组长度只有 count() 这一个官方推荐函数。sizeof() 确实是 count() 的别名,但它是遗留兼容写法,语义模糊、易误导新人,且在 PHP 8+ 的文档中已明确标记为“不鼓励使用”。实际项目里混用会降低代码可读性,也容易让团队误以为两者有功能差异。
count($arr) 明确表达“计数”意图,IDE 和静态分析工具(如 PHPStan)也只识别它sizeof($arr) 不会在任何现代 PHP 教程或框架源码中出现,Laravel、Symfony 等全部统一用 count()
sizeof() 内部就是直接调用 count(),没有额外开销count() 支持两个参数:count($array, $mode)。默认 $mode = COUNT_NORMAL(只统计一级元素),但很多人不知道还有 COUNT_RECURSIVE 模式,尤其在处理多维数组时容易出错。
count($arr) 和 count($arr, COUNT_NORMAL) 结果一样['a' => [1, 2], 'b' => [3, [4, 5]]],count($arr, COUNT_RECURSIVE) 返回 6(所有叶子节点总数),而默认模式只返回 2
COUNT_RECURSIVE 可能导致逻辑错误,比如判断“是否为空数组”时用了递归模式,空子数组也会被计入count() 对非数组类型不会报错,但返回值有明确规则,不验证会导致隐性 bug:
count([]) → 0(正确)count(null) → 0(不是 warning,是定义行为!很多开发者误以为会警告)count("hello") → 1(字符串被当作单元素数组处理)count(42) → 1(整数同理)count(new stdClass()) → 1(对象默认返回 1,除非实现 Countable 接口)所以真实业务中,应先用 is_array() 判断再计数,尤其来自 API 或表单的变量:
if (is_array($data)) {
$len = count($data);
} else {
$len = 0;
}
在循环条件中直接写 count($arr) 是常见低效写法,尤其当 $arr 很大或在 for 循环里:
// ❌ 每次迭代都重新计算长度
for ($i = 0; $i < count($items); $i++) { ... }
// ✅ 提前缓存
$len = count($items);
for ($i = 0; $i < $len; $i++) { ... }
count() 本身是 O(1)(PHP 数组内部存有长度字段),但函数调用开销 + opcode 解析仍可测量,百万级循环下差距可达毫秒级null 和字符串的误判,以及在 for 循环里反复调用 count()。这两个点不改,代码就埋着静默错误和性能隐患。