表單提交、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 | 需配合引用修改,邏輯較繁瑣 | 難以移除整個空子陣列 |
| 遞迴函數 | 本文方案 | 完全控制、支援任意深度、可自定義空值定義 |
$cleanParams = array_clean_recursive($_POST ?? [], [null, '', []]);
// 移除空字串參數,避免 WHERE name = '' 查詢全表
$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 陣列
$entity = array_clean_recursive($formData, [null, '', []], true);
// 確保不寫入空字串覆蓋資料庫預設值
遞迴清理陣列空值是資料預處理關鍵步驟。關鍵在於:
&$value 就地修改避免複製