如何通过创建自定义函数封装 array_count_values() 来提高代码复用性并简化开发过程？

M66 2025-06-07

在开发过程中，数组操作是常见的任务之一。PHP 提供了很多内建函数来操作数组，其中 array_count_values() 是一个非常实用的函数。它的作用是统计数组中所有值的出现次数，并将结果以关联数组的形式返回。然而，有时候我们希望将这一操作封装成一个自定义函数，以便在项目中复用，并且简化开发过程。

本文将展示如何通过创建一个自定义函数来封装 array_count_values()，以提高代码的复用性，并且提升代码的简洁度和可维护性。

1. array_count_values() 基础介绍

array_count_values() 是 PHP 的一个内建函数，能够统计一个数组中所有值的出现次数。它返回一个关联数组，其中键是数组中出现的值，值是该值的出现次数。

示例代码：

$array = ["apple", "banana", "apple", "orange", "banana", "apple"];
$count = array_count_values($array);
print_r($count);

输出结果：

Array
(
    [apple] => 3
    [banana] => 2
    [orange] => 1
)

从上述示例可以看到，array_count_values() 可以非常方便地统计数组元素的出现频率。

2. 创建自定义函数封装 array_count_values()

虽然 array_count_values() 是一个非常方便的内建函数，但我们可以进一步封装它，创建一个更具通用性和可扩展性的自定义函数。这样，我们可以在需要时重复使用它，并且将函数逻辑集中管理。

自定义函数设计：

我们将创建一个自定义函数 countValues，它接收一个数组作为参数，调用 array_count_values() 来统计该数组中每个值的出现次数，并返回结果。

/**
 * 统计数组中各个值的出现次数
 *
 * @param array $inputArray 输入的数组
 * @return array 返回统计结果的关联数组
 */
function countValues(array $inputArray): array {
    // 使用 array_count_values 进行计数
    return array_count_values($inputArray);
}

示例代码：

$array = ["apple", "banana", "apple", "orange", "banana", "apple"];
$result = countValues($array);
print_r($result);

输出结果：

Array
(
    [apple] => 3
    [banana] => 2
    [orange] => 1
)

通过封装，我们可以更清晰地管理和复用这段代码。并且，如果未来需要对该逻辑进行扩展（比如加入对大小写敏感性的控制，或者过滤掉某些特定值等），我们只需修改 countValues() 函数即可。

3. 提高代码复用性与简化开发过程

3.1 代码复用

封装函数的最大好处就是提高了代码的复用性。无论你在项目的哪个地方需要进行类似的统计，只需调用 countValues() 函数即可，不需要每次都写一段 array_count_values() 的调用代码。这样，代码变得更加模块化，且容易管理。

3.2 简化开发

在开发过程中，我们常常会遇到类似的任务：统计数组中某些值的出现次数。通过封装 array_count_values()，可以让我们在开发时直接调用 countValues()，无需每次都关心底层实现细节。这样不仅可以提升开发效率，还能使代码更具可读性。

3.3 易于扩展和维护

封装后的函数如果有新的需求或者修改，我们只需要修改一个地方（即 countValues() 函数本身）。这使得代码更易于维护，并且可以根据需求灵活调整。例如，如果我们希望统计的过程中忽略某些特定的值，或者进行值的过滤，封装后的函数能够方便地进行扩展。

4. 代码示例扩展：增加过滤功能

为了更好地演示封装的扩展性，假设我们想在统计值时，过滤掉某些特定的值。我们可以修改 countValues() 函数，增加一个可选的过滤参数。

修改后的 countValues() 函数：

/**
 * 统计数组中各个值的出现次数，并且过滤掉指定的值
 *
 * @param array $inputArray 输入的数组
 * @param array $excludeValues 需要排除的值
 * @return array 返回统计结果的关联数组
 */
function countValues(array $inputArray, array $excludeValues = []): array {
    // 过滤掉不需要的值
    $filteredArray = array_diff($inputArray, $excludeValues);
    
    // 使用 array_count_values 进行计数
    return array_count_values($filteredArray);
}

示例代码：

$array = ["apple", "banana", "apple", "orange", "banana", "apple"];
$exclude = ["banana"]; // 过滤掉 'banana'
$result = countValues($array, $exclude);
print_r($result);

输出结果：

Array
(
    [apple] => 3
    [orange] => 1
)

通过扩展，我们可以在调用时选择性地排除某些值，使得函数更加灵活和实用。

5. 结论

通过创建自定义函数封装 array_count_values()，我们可以实现更高效、简洁且可维护的代码。封装不仅提高了代码的复用性，还简化了开发过程，并且使得代码逻辑更加清晰。无论是在基础的统计功能，还是在需要扩展更多功能时，封装后的函数都能够灵活应对，提升开发效率。

希望本篇文章能够帮助你理解如何通过封装内建函数来简化开发过程，并有效提高代码的可维护性和复用性。

array_count_values