創建自定義函數封裝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