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

count() 是唯一标准函数,不要用 sizeof()
PHP 中计算数组长度只有 count() 这一个官方推荐函数。sizeof() 确实是 count() 的别名,但它是遗留兼容写法,语义模糊、易误导新人,且在 PHP 8+ 的文档中已明确标记为“不鼓励使用”。实际项目里混用会降低代码可读性,也容易让团队误以为两者有功能差异。
-
count($arr)明确表达“计数”意图,IDE 和静态分析工具(如 PHPStan)也只识别它 -
sizeof($arr)不会在任何现代 PHP 教程或框架源码中出现,Laravel、Symfony 等全部统一用count() - 两者性能完全一致——因为
sizeof()内部就是直接调用count(),没有额外开销
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可能导致逻辑错误,比如判断“是否为空数组”时用了递归模式,空子数组也会被计入
空数组、非数组类型、NULL 的行为必须验证
count() 对非数组类型不会报错,但返回值有明确规则,不验证会导致隐性 bug:
-
count([])→0(正确) -
count(null)→0(不是 warning,是定义行为!很多开发者误以为会警告) -
count("hello")→1(字符串被当作单元素数组处理) -
count(42)→1(整数同理) -
count(new stdClass())→1(对象默认返回 1,除非实现Countable接口)
所以真实业务中,应先用 is_array() 判断再计数,尤其来自 API 或表单的变量:
立即学习“PHP免费学习笔记(深入)”;
if (is_array($data)) {
$len = count($data);
} else {
$len = 0;
}
性能敏感场景:避免重复调用 count()
在循环条件中直接写 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 解析仍可测量,百万级循环下差距可达毫秒级 - PHP 7.4+ 的 opcache 能做部分优化,但不能依赖——显式缓存更可靠、更易读
- foreach 没这个问题,它天然按内部指针遍历,无需长度判断
null 和字符串的误判,以及在 for 循环里反复调用 count()。这两个点不改,代码就埋着静默错误和性能隐患。











