PHP array_filter() 過濾空值陣列的進階用法與陷阱

核心發現：無回調時的「隱式布爾轉換」

array_filter() 官方文檔明確指出：若不提供回調函數，將移除所有轉換為 `false` 的元素。這特性可一鍵清理「空值」陣列，但需精確理解 PHP 的假值定義。

實戰測試與結果分析

 '藍色夏威夷的博客', // 非空字符串 → true
    1 => false,              // 布爾假 → false ✓
    2 => 1,                  // 非零整數 → true
    3 => null,               // null → false ✓
    4 => '',                 // 空字符串 → false ✓
    5 => 'https://www.jb51.net', // 非空字符串 → true
    6 => '0',                // 字符串 "0" → false ✓ （關鍵陷阱！）
    7 => [],                 // 空數組 → false ✓
    8 => 0,                  // 整數 0 → false ✓
];

$valid = array_filter($entry);
print_r($valid);

輸出結果

Array
(
    [0] => 藍色夏威夷的博客
    [2] => 1
    [5] => https://www.jb51.net
)

被移除的「假值」清單

進階用法：自定義回調精準控制

場景 1：保留字符串 "0"、數字 0

// 僅移除 null、false、空字符串、空數組
$filtered = array_filter($entry, function ($v) {
    return $v !== null && $v !== false && $v !== '' && $v !== [];
});
// 保留：'0', 0, 0.0, 'text', 1, [...]

場景 2：遞歸過濾多維數組空值

function deepFilter(array $arr): array {
    $arr = array_filter($arr, function ($v) {
        if (is_array($v)) {
            $v = deepFilter($v);
            return !empty($v); // 遞歸後非空才保留
        }
        return $v !== null && $v !== false && $v !== '';
    });
    return $arr;
}

場景 3：保留鍵名關聯（默認行為）

array_filter 保留原鍵名，若需重建索引：

$filtered = array_values(array_filter($entry)); // 索引重排 0,1,2...

性能與替代方案

• foreach 手動過濾：大數組（>10萬）時比 `array_filter` 快 20%~30%，可避免函數調用開銷
• array_diff：需移除特定值集合時 `array_diff($arr, [null, false, ''])` 更語義化
• 集合庫：Laravel Collections / Symfony Polyfill 提供鏈式操作 `collect($arr)->filter()->values()->all()`

避坑總結

1. 字符串 "0" 會被誤刪：業務涉及狀態碼、權限位掩碼時必須自定義回調
2. 對象默認視為 true：即使對象屬性全空，`array_filter` 也不會移除（需回調檢查）
3. 嚴格模式：PHP 8.1+ 可用 `array_filter($arr, fn($v) => $v !== null)` 類型安全寫法

善用 array_filter 無回調特性可快速清理髒數據，但務必確認業務對「假值」的定義與 PHP 一致，否則請顯式編寫回調函數。