PHP获取数组长度 · 完全实战指南
在PHP开发中,获取数组长度是最高频操作之一。无论是统计用户列表、处理API响应还是循环遍历,掌握count()与sizeof()的细节至关重要。本指南由xservx整理,深度剖析与php获取数组长度相关的所有周边知识。
① count() 核心
count() 是PHP内置函数,用于计算数组中的元素个数。语法:count($array, $mode)。默认$mode=0不递归计数多维数组。
⚙️ 示例:count([1,2,3]) 返回 3。
② sizeof() 别名
sizeof() 是count()的别名,功能完全一致。许多开发者从C语言背景习惯使用sizeof,但在PHP中两者无性能差异。
📌 推荐统一使用count()以增强可读性。
③ 多维数组计数
使用count($array, COUNT_RECURSIVE) 或模式1,可递归统计所有元素。注意:它会计数所有层级的值。
⚠️ 例如嵌套数组[1,[2,3]] 递归计数返回4。
版本演进与数组长度
PHP 4 · 早期基础
count() 函数初步稳定,仅支持有限模式。数组长度获取依赖简单的内部哈希表计数。
PHP 5 · 面向对象增强
引入Countable接口,对象可通过实现count()方法自定义长度返回。例如实现Countable的类可使用count($obj)。
PHP 7 · 性能飞跃
数组内部结构优化,获取数组长度变为O(1)操作,直接读取内部zend_array的nNumOfElements字段,速度极快。
PHP 8 · 现代特性
命名参数、联合类型等让数组处理更安全。count()在空数组或未定义变量时仍会抛出警告,建议结合isset()使用。
网友们还关心
⚡ count() vs 手动循环
很多初学者担心count()在大数组中性能问题。实际上PHP内部维护数组长度,count($arr)直接读取结构体成员,时间复杂度O(1)。而手动遍历计数则复杂度O(n)。
※ 建议:永远使用count()获取数组长度,勿重复造轮子。
⚠️ 常见陷阱与警告
count() 对非数组或非Countable对象传入会产生警告并返回1(PHP8之前)或TypeError。务必先验证is_array($var)。
另一个易错点:count(null) 在PHP8中已废弃,返回0但抛出E_DEPRECATED。建议使用?? []确保安全。
◣ 多维递归计数时,COUNT_RECURSIVE会计数所有叶子节点,可能得到非预期结果。
◤ 对象与Countable接口
如果希望自定义类支持count(),实现Countable接口并定义count(): int方法。
class Users implements Countable {
private array $list = [];
public function count(): int { return count($this->list); }
}
这样count($usersObj)将返回内部列表长度,符合面向对象设计。
※ 实战技巧集合
① 安全获取长度:$len = is_array($data) ? count($data) : 0;
② 判断非空数组:if (count($arr)) { ... } 或更优雅的 if ($arr) { ... }
③ 关联数组长度:count()同样适用于关联数组,计算键值对数量。
④ 与array_filter结合:count(array_filter($arr)) 统计真值元素个数。
count() 深度解析
count() 函数原型:count(Countable|array $value, int $mode = COUNT_NORMAL): int。第一个参数为数组或Countable对象,第二个参数控制递归。当$mode设为COUNT_RECURSIVE(或1)时,将递归计算所有元素。
| 示例代码 | 返回值 | 说明 |
|---|---|---|
| count([1,2,3]) | 3 | 普通索引数组 |
| count(['a'=>'x','b'=>'y']) | 2 | 关联数组长度 |
| count([[1,2],[3,4]],1) | 6 | 递归计数所有元素 |
| count([]) | 0 | 空数组 |
在PHP8.1+中,count() 对非数组类型更加严格,建议开启严格类型。
sizeof() 是别名吗?
是的,sizeof() 在PHP手册中明确标注为count()的别名。两者在Zend引擎中指向同一内部函数。历史上保留sizeof是为了兼容C程序员习惯。目前社区主流风格规范(PSR-12)推荐使用count()。
多维数组长度与递归统计
多维数组的长度获取常被误解。默认count($multiArr)只统计第一维元素数量。若需统计所有维度的叶节点总数,必须使用COUNT_RECURSIVE。但注意,它会计数所有键和值吗?实际上只计数值。
例如:$arr = ['colors' => ['red','green'], 'numbers' => [1,2,3]];
count($arr) → 2 (两个元素:colors和numbers)
count($arr, COUNT_RECURSIVE) → 7 (2个第一维 + 2个red/green + 3个数字)
⚙️ 若想只统计所有叶子节点数量,可自定义递归函数。
深度关联知识库
◢ array_key_last()
获取数组最后一个键名,配合count()可定位末尾元素。PHP 7.3+支持。
◤ empty() 与长度
empty($arr) 等价于 count($arr) === 0,但empty不产生警告。
※ 数组解构
使用[$first, $second] = $arr; 前常需确认数组长度至少为2。
掌握php获取数组长度的核心方法后,建议结合array_map、array_reduce等函数构建高效数据处理流程。xservx持续更新PHP最佳实践。
↗ 参考官方文档:count 与 sizeof 均位于PHP手册数组函数章节。