在php开发过程中,统计数组中各个元素出现的次数属于高频需求,比如统计用户提交的标签分布、统计订单状态占比等场景都会用到。php内置的array_count_values函数就是专门用来处理这类统计任务的工具,它能够遍历数组并统计每个值出现的次数,返回对应的频次映射数组。

array_count_values函数基本用法
array_count_values的函数定义非常简单,它只接收一个数组参数,返回一个新的关联数组,新数组的键是原数组中出现过的值,值是该值在原数组中出现的次数。
基础使用示例如下:
<?php // 定义一个包含重复元素的数组 $source_array = array(1, 2, 2, 3, 3, 3, 'a', 'a', 'b'); // 调用array_count_values统计频次 $count_result = array_count_values($source_array); // 打印统计结果 print_r($count_result); ?>
上述代码的输出结果如下:
Array
(
[1] => 1
[2] => 2
[3] => 3
[a] => 2
[b] => 1
)
函数使用限制与注意事项
array_count_values并不是所有类型的数组都能正常处理,使用时需要注意以下几点限制:
- 参数必须是数组类型,如果传入非数组参数会触发警告并返回false
- 原数组的元素值只能是整型、字符串类型,如果出现其他类型比如数组、对象、资源类型,会抛出警告并且这些元素会被忽略
- 统计结果中键的类型会保持原数组元素的类型,比如原数组中的整型1和字符串1会被当作两个不同的键分别统计
特殊场景的处理方案
原数组包含非字符串非整型元素
如果原数组中存在浮点型、布尔型等元素,需要先对数组做预处理,把这些元素转换成字符串或者整型再统计,示例如下:
<?php
$source_array = array(1, 2.5, true, false, 'test');
// 预处理数组,把非字符串非整型元素转成字符串
$processed_array = array_map(function($item) {
if (is_int($item) || is_string($item)) {
return $item;
}
return strval($item);
}, $source_array);
$count_result = array_count_values($processed_array);
print_r($count_result);
?>
统计多维数组的元素频次
array_count_values只能处理一维数组,如果是多维数组需要先提取目标维度的元素组成新的一维数组再统计,示例如下:
<?php
// 多维数组示例,统计每个用户的状态出现次数
$user_list = array(
array('id' => 1, 'status' => 'active'),
array('id' => 2, 'status' => 'inactive'),
array('id' => 3, 'status' => 'active'),
array('id' => 4, 'status' => 'active'),
);
// 提取status列组成新数组
$status_array = array_column($user_list, 'status');
$count_result = array_count_values($status_array);
print_r($count_result);
?>
与其他统计方式的对比
除了array_count_values,开发者也可以自己遍历数组实现频次统计,两者的对比如下:
| 统计方式 | 优势 | 劣势 |
|---|---|---|
| array_count_values | 内置函数执行效率高,代码简洁,无需手动写遍历逻辑 | 仅支持整型、字符串元素,场景受限 |
| 手动遍历统计 | 支持所有类型的元素,可自定义统计规则 | 需要写更多代码,执行效率略低于内置函数 |
手动遍历统计的示例代码如下:
<?php
$source_array = array(1, 2, 2, 3, 3, 3, 'a', 'a', 'b');
$count_result = array();
foreach ($source_array as $item) {
if (!isset($count_result[$item])) {
$count_result[$item] = 0;
}
$count_result[$item]++;
}
print_r($count_result);
?>
常见问题解答
统计结果中键的顺序是怎样的
array_count_values返回的数组键的顺序和原数组中元素第一次出现的顺序一致,不是按照频次大小或者键名排序的,如果需要排序可以配合arsort函数按照频次降序排列。
原数组为空时返回什么
如果传入的数组为空数组,array_count_values会返回一个空数组,不会触发任何错误。
phparray_count_values频次统计数组操作修改时间:2026-06-21 20:27:29