萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 遞迴清理陣列:移除空值、空字串、空陣列的最佳實踐

需求分析

表單提交、API 回傳、配置解析常產生包含「空值」的陣列:''、null、[]、false、0、'0'。業務上需精確定義什麼算「空」並移除,避免污染下游邏輯。

核心函數實現

<?php
/**
 * 遞迴移除陣列中的空值
 * @param array $array 輸入陣列
 * @param array $emptyValues 視為空的值列表,預設:null, '', [], false
 * @param bool $strict 嚴格模式:true=僅移除完全匹配 $emptyValues,false=同時移除 '0', 0 等
 * @return array 清理後陣列
 */
function array_clean_recursive(array $array, array $emptyValues = [null, '', [], false], $strict = true) {
    $cleaned = [];
    foreach ($array as $key => $value) {
        if (is_array($value)) {
            $nested = array_clean_recursive($value, $emptyValues, $strict);
            // 遞迴清理後若為空陣列,視為空值
            if (empty($nested) && (in_array([], $emptyValues, true) || !$strict)) {
                continue; // 跳過空陣列
            }
            $cleaned[$key] = $nested;
        } else {
            $isEmpty = in_array($value, $emptyValues, true);
            // 非嚴格模式額外檢查 '0', 0, '0.0' 等
            if (!$strict && in_array($value, ['0', 0, '0.0', 0.0], true)) {
                $isEmpty = true;
            }
            if (!$isEmpty) {
                $cleaned[$key] = $value;
            }
        }
    }
    return $cleaned;
}

// 測試
$dirty = [
    'name' => '張三',
    'age' => '',
    'email' => null,
    'tags' => [],
    'active' => false,
    'score' => 0,
    'profile' => [
        'phone' => '',
        'address' => '台北市',
        'social' => [
            'fb' => null,
            'ig' => 'user_ig'
        ]
    ],
    'metadata' => [0 => 'keep', 1 => '']
];

echo "原始:\n";
print_r($dirty);

echo "\n嚴格模式(預設):\n";
print_r(array_clean_recursive($dirty));

echo "\n非嚴格模式(移除 0/'0'):\n";
print_r(array_clean_recursive($dirty, [null, '', [], false], false));

輸出結果對比

嚴格模式(預設):
Array
(
    [name] => 張三
    [score] => 0
    [profile] => Array
        (
            [address] => 台北市
            [social] => Array
                (
                    [ig] => user_ig
                )
        )
    [metadata] => Array
        (
            [0] => keep
        )
)

非嚴格模式:
Array
(
    [name] => 張三
    [profile] => Array
        (
            [address] => 台北市
            [social] => Array
                (
                    [ig] => user_ig
                )
        )
    [metadata] => Array
        (
            [0] => keep
        )
)

進階版:支援物件、可呼叫過濾器

function deep_clean($data, callable $filter = null) {
    $defaultFilter = function($v) {
        return !($v === null || $v === '' || (is_array($v) && empty($v)));
    };
    $filter = $filter ?? $defaultFilter;
    
    if (is_array($data)) {
        $result = [];
        foreach ($data as $k => $v) {
            $cleaned = deep_clean($v, $filter);
            if (is_array($cleaned) && empty($cleaned)) continue;
            if ($filter($cleaned)) $result[$k] = $cleaned;
        }
        return $result;
    }
    if (is_object($data) && method_exists($data, 'toArray')) {
        return deep_clean($data->toArray(), $filter);
    }
    return $filter($data) ? $data : null;
}

// 自定義過濾:保留 0 和 false
$custom = deep_clean($dirty, function($v) {
    return !($v === null || $v === '' || (is_array($v) && empty($v)));
});

內建函數替代方案對比

方法程式碼限制
array_filter()array_filter($arr, fn($v)=>$v!=='' && $v!==null)僅單層、無法處理巢狀陣列
array_walk_recursive需配合引用修改,邏輯較繁瑣難以移除整個空子陣列
遞迴函數本文方案完全控制、支援任意深度、可自定義空值定義

實戰應用場景

1. API 參數清洗

$cleanParams = array_clean_recursive($_POST ?? [], [null, '', []]);
// 移除空字串參數,避免 WHERE name = '' 查詢全表

2. 配置檔合併

$default = ['debug'=>false, 'cache'=>['redis'=>[], 'memcached'=>[]]];
$userConfig = ['cache'=>['redis'=>['host'=>'127.0.0.1']]];
$merged = array_merge_recursive($default, $userConfig);
$final = array_clean_recursive($merged); // 移除空的 memcached 陣列

3. 資料庫寫入前清理

$entity = array_clean_recursive($formData, [null, '', []], true);
// 確保不寫入空字串覆蓋資料庫預設值

總結

遞迴清理陣列空值是資料預處理關鍵步驟。關鍵在於:

  1. 明確定義業務上的「空值」標準
  2. 遞迴處理巢狀結構並正確移除空子陣列
  3. 提供嚴格/非嚴格模式適應不同場景
  4. 考慮效能:超大陣列可用引用傳遞 &$value 就地修改避免複製
copyright © 萬盛學電腦網 all rights reserved