首页
/ 正文

PHP array_count_values() 函数（超详细）

更新时间: 2025-04-11 04:26:14

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;

《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前，星球内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习，欢迎点击围观

前言：为什么需要统计数组元素的出现次数？

在 PHP 开发中，数组是存储和处理数据的核心结构之一。无论是处理用户提交的表单数据、分析日志文件，还是统计商品库存信息，开发者常常需要快速统计特定元素在数组中的出现次数。例如，统计投票系统中每个选项的得票数，或统计用户访问页面的频次。

此时，PHP 内置的 array_count_values() 函数便成为了一个不可或缺的工具。它通过简洁的语法和高效的性能，帮助开发者轻松实现数组元素的频率统计。本文将从基础概念到实战案例，系统讲解这个函数的使用方法与技巧，帮助你快速掌握其核心价值。

一、函数基础：理解 array_count_values() 的核心功能

1.1 函数定义与语法结构

array_count_values() 是 PHP 标准库中的一个数组处理函数，其作用是 统计数组中每个值出现的次数，并返回一个关联数组，其中键名是原数组的值，键值则是该值出现的次数。

语法格式：

array_count_values(array $input) : array

参数说明：

$input：需要统计的数组，必须为一维数组。

返回值：

返回一个关联数组，键名是原数组的值，键值是对应值的出现次数。如果输入为空数组，则返回空数组。

1.2 函数特性与限制

仅适用于一维数组：若传入多维数组，函数会将子数组视为普通值进行统计，但无法展开统计内部元素。
键名无关性：统计结果仅关注元素的值，原数组的键名会被忽略。
自动合并相同值：不同键名但值相同的元素会被视为同一项进行计数。

示例说明：

$array = [1, 2, 'apple', 'apple', 2, 'banana'];
$result = array_count_values($array);
// 输出：['1' => 1, '2' => 1, 'apple' => 2, 'banana' => 1]

二、使用示例：从简单到复杂的应用场景

2.1 基础用法：统计简单数组

案例背景：统计班级学生选择的水果种类及数量。

$fruits = ['apple', 'banana', 'apple', 'orange', 'banana', 'apple'];
$count = array_count_values($fruits);
print_r($count);
/* 输出结果：
Array
(
    [apple] => 3
    [banana] => 2
    [orange] => 1
)
*/

关键点解析：

函数自动忽略原数组的索引，仅统计值的出现次数。
结果中的键名会转为字符串类型，即使原元素是整数。

2.2 处理混合类型数据

案例背景：统计包含数字和字符串的混合数组。

$mixedArray = [1, '1', 2, 2, 'apple', 'apple', 2];
$count = array_count_values($mixedArray);
print_r($count);
/* 输出结果：
Array
(
    [1] => 1
    [1] => 1  // 这里会报错吗？
    [2] => 2
    [apple] => 2
)

常见误区：

类型敏感性：PHP 会将整数 1 和字符串 '1' 视为不同值，因此它们会被分别统计。这可能导致意外结果，需注意数据类型的一致性。

2.3 处理空值与布尔值

案例背景：统计包含 null 和布尔值的数组。

$specialValues = [null, true, false, null, true, true];
$count = array_count_values($specialValues);
print_r($count);
/* 输出结果：
Array
(
    [1] => 3  // true 转为 1
    [] => 1   // false 转为空字符串
    [ ] => 2  // null 转为空字符串（需注意 PHP 版本差异）
)

注意事项：

null 会被转为空字符串（""）。
true 转为字符串 "1"，false 转为 ""。
建议在处理布尔值或 null 时，先进行类型转换或预处理。

三、进阶技巧：结合其他函数实现复杂需求

3.1 统计后排序结果

需求场景：按出现次数从高到低排序统计结果。

$votes = ['A', 'B', 'A', 'C', 'A', 'B', 'B'];
$counts = array_count_values($votes);
arsort($counts); // 保留键名并降序排序
print_r($counts);
/* 输出结果：
Array
(
    [B] => 3
    [A] => 3
    [C] => 1
)
*/

3.2 过滤特定条件的元素

需求场景：仅统计出现次数大于 1 的元素。

$numbers = [1, 2, 2, 3, 3, 3];
$counts = array_count_values($numbers);
$filtered = array_filter($counts, function($count) {
    return $count > 1;
});
print_r($filtered);
/* 输出结果：
Array
(
    [2] => 2
    [3] => 3
)
*/

3.3 处理多维数组的变通方案

需求场景：统计二维数组中某一列的值出现次数。

$users = [
    ['id' => 1, 'status' => 'active'],
    ['id' => 2, 'status' => 'inactive'],
    ['id' => 3, 'status' => 'active'],
    ['id' => 4, 'status' => 'active']
];

// 提取 status 列后统计
$statuses = array_column($users, 'status');
$statusCounts = array_count_values($statuses);
print_r($statusCounts);
/* 输出结果：
Array
(
    [active] => 3
    [inactive] => 1
)
*/

四、常见问题与解决方案

4.1 问题：函数返回空数组

可能原因：

输入数组为空。
数组元素全为 null 或无法转换为字符串的值。

解决方案：

$data = [];
$result = array_count_values($data); // 返回空数组
if (empty($result)) {
    echo "无有效数据可统计";
}

4.2 问题：统计结果与预期不符

可能原因：

数组元素类型不一致（如 1 和 '1' 被视为不同值）。
存在特殊字符或空值未处理。

解决方案：

// 强制类型转换为字符串
$cleanArray = array_map('strval', $originalArray);
$result = array_count_values($cleanArray);

4.3 问题：如何统计关联数组的键名？

解决方案：若需统计关联数组的键名出现次数，可先提取键名：

$assocArray = ['a' => 1, 'b' => 2, 'a' => 3];
$keys = array_keys($assocArray);
$keyCounts = array_count_values($keys);
print_r($keyCounts); // 输出：['a' => 2, 'b' => 1]

五、应用场景与最佳实践

5.1 实际案例：电商商品销量统计

需求：统计某商品在不同地区的销售次数。

$sales = ['east', 'north', 'east', 'south', 'east', 'west'];
$regionsCount = array_count_values($sales);
echo "东部地区销量：" . $regionsCount['east'] ?? 0;
// 输出：东部地区销量：3

5.2 日志分析：统计 HTTP 状态码分布

$logs = [
    '200', '404', '200', '500', '200', '404', '200'
];
$statusCounts = array_count_values($logs);
print_r($statusCounts);
/* 输出：
Array
(
    [200] => 4
    [404] => 2
    [500] => 1
)
*/

5.3 表单数据处理：统计多选框选项

// 假设表单提交的数据为：['skills' => ['php', 'javascript', 'php', 'python']]
$selectedSkills = $_POST['skills'];
$skillCounts = array_count_values($selectedSkills);
// 可用于生成投票结果或推荐系统

六、与类似函数的对比

6.1 array_count_values() vs. count()

array_count_values()：统计每个元素的出现次数。
count()：统计数组的总元素个数或指定维度的长度。

$array = [1, 2, 2];
echo count($array); // 输出 3（总元素数）
print_r(array_count_values($array)); // 输出 [1 => 1, 2 => 2]

6.2 array_count_values() vs. foreach 循环

手动统计示例：

$array = ['a', 'b', 'a', 'c'];
$count = [];
foreach ($array as $value) {
    $count[$value] = ($count[$value] ?? 0) + 1;
}
print_r($count); // 结果与 array_count_values 相同

对比总结：

array_count_values()：代码简洁，性能更高（内部优化）。
foreach：适用于需要自定义统计逻辑（如条件过滤）的场景。

七、总结：掌握这个函数的实用价值

通过本文的讲解，我们深入理解了 PHP array_count_values() 函数的核心功能、使用场景及进阶技巧。这个函数在以下场景中尤其有价值：

快速统计元素频率：如投票系统、日志分析、商品销量统计。
数据预处理：在进行进一步分析前，先了解数据分布情况。
减少代码冗余：替代手动的 foreach 循环，提升代码可读性。

建议读者通过实际项目中的具体案例练习，例如：

统计用户注册来源渠道的分布。
分析网站访问路径的热门程度。
处理问卷调查的多选题结果。

掌握这一函数后，你将能够更高效地处理 PHP 开发中的数组统计需求，为后续的复杂数据操作打下坚实基础。

八、扩展阅读与进阶学习

PHP 官方文档：array_count_values()
相关函数学习：array_keys(), array_values(), array_unique()
进阶技巧：结合 array_map()、array_filter() 实现复杂统计逻辑

通过持续实践与探索，你将逐渐掌握 PHP 数组处理的精髓，成为一名更高效的开发者。