PHP 核心源碼深度解析：count() 函數實現機制全解析

引言

count() 是 PHP 中使用頻率極高的函數，用於統計陣列元素個數或實作 Countable 介面的物件屬性數量。本文基於 PHP 5.4+ 源碼，從函數簽名、參數行為、核心實現流程、遞迴計數機制、物件處理邏輯等維度深度剖析其內部運作原理。

函數簽名與基本行為

int count ( mixed $array_or_countable [, int $mode = COUNT_NORMAL ] )

• 第一參數：陣列或實作 Countable 介面的物件；其他型別（整數、字串、一般物件）均回傳 1；null 回傳 0。
• 第二參數 $mode：
  • COUNT_NORMAL（預設，值 0）：僅計算第一層元素數量。
  • COUNT_RECURSIVE（值 1）：遞迴計算多維陣列所有層級元素總和。
• 回傳值：整數計數；發生無限遞迴時拋出 E_WARNING 並回傳大於預期的值。

核心執行流程（偽代碼邏輯）

function count($var, $mode = COUNT_NORMAL) {
    switch (Z_TYPE_P(var)) {
        case IS_NULL:
            return 0;
        case IS_ARRAY:
            return php_count_recursive(var, mode);
        case IS_OBJECT:
            // 1. 檢查是否為 array-like object (繼承 ArrayObject)
            if (Z_OBJ_HT_P(var)->count_elements) {
                return Z_OBJ_HT_P(var)->count_elements(var);
            }
            // 2. 檢查是否實作 Countable 介面
            if (instanceof_function(Z_OBJCE_P(var), spl_ce_Countable)) {
                return zend_call_method(var, 'count', ...);
            }
            // 3. 一般物件回傳 1
            return 1;
        default: // string, int, float, bool, resource
            return 1;
    }
}

關鍵實現細節

1. 遞迴計數器 php_count_recursive

位於 ext/standard/array.c，核心邏輯：

• 使用 HashTable 的 nNumOfElements 直接取得當前層級元素數（O(1)）。
• 若 mode == COUNT_RECURSIVE，遍歷每個元素，若值為陣列則遞迴呼叫自身累加。
• 遞迴保護：每個 Bucket 設有 u.v.nApplyCount 計數器，遞迴進入時 ++，離開時 --；若偵測到 nApplyCount > 1 則觸發 E_WARNING「Recursion detected」，防止無限迴圈。

2. ArrayObject 與 count_elements 處理器

當物件繼承 ArrayObject 且實作 count() 方法時，PHP 內核會在物件的 zend_object_handlers 中設定 count_elements 指向內部處理函數，最終呼叫使用者定義的 count() 方法。若未實作 count()，預設回傳 0。

3. Countable 介面機制

實作 Countable 介面的類別必須定義 public function count(): int。PHP 執行 count($obj) 時，透過 instanceof_function 判斷，再呼叫 zend_call_method 執行使用者方法，直接返回其整數結果。

實戰範例與結果對照

效能建議與最佳實踐

1. 避免在迴圈條件中重複呼叫 count()：
   

   // 差：每次迴圈都計算
   for ($i=0; $i < count($arr); $i++) { ... }
   // 優：預先儲存
   $len = count($arr);
   for ($i=0; $i < $len; $i++) { ... }

2. 大型多維陣列慎用 COUNT_RECURSIVE：遞迴遍歷會消耗大量 CPU 與記憶體，必要時改用迭代器或自定義計數邏輯。
3. 物件屬性計數：若需統計一般物件屬性數，請先轉型 count((array)$obj)。

原始碼參考位置

• 主入口：ext/standard/array.c → php_if_count()
• 遞迴核心：ext/standard/array.c → php_count_recursive()
• 物件處理器：Zend/zend_object_handlers.c → zend_std_count_elements()
• Countable 介面：ext/spl/spl_iterators.c → spl_ce_Countable

結語

理解 count() 的底層實現，不僅能寫出更高效的程式碼，也能在除錯遞迴陣列、設計自定義集合類別時做出正確決策。建議開發者閱讀 PHP 官方源碼倉庫中的相關檔案，並關注 PHP 8.x 版本對 count() 的優化（如 JIT 加速、型別系統增強）。