需要對多維數組(甚至包含對象)的所有標量值統一應用某個處理函數(如 addslashes, trim, htmlspecialchars)。WordPress 的 stripslashes_deep 是典型例子,本文將其泛化為 function_deep($callback, $value)。
<?php
/**
* 遞歸對數組/對象/字符串應用回調函數
* @param callable|string $callback 回調函數名或閉包
* @param mixed $value 待處理值(數組、對象、字符串)
* @return mixed 處理後的值,結構保持不變
*/
function function_deep($callback, $value) {
// 1. 校驗回調可用性
if (!is_callable($callback)) {
throw new InvalidArgumentException("Callback '$callback' is not callable");
}
// 2. 數組:遞歸處理每個元素
if (is_array($value)) {
return array_map(function ($v) use ($callback) {
return function_deep($callback, $v);
}, $value);
}
// 3. 對象:遞歸處理所有屬性
if (is_object($value)) {
$vars = get_object_vars($value);
foreach ($vars as $key => $data) {
$value->$key = function_deep($callback, $data);
}
return $value;
}
// 4. 字符串:直接應用回調
if (is_string($value)) {
return $callback($value);
}
// 5. 其他類型(int, float, bool, null)原樣返回
return $value;
}
<?php
$data = [
"I'm bean",
"I'm bean",
[
"I'm bean",
"I'm bean"
],
(object)["name" => "Tom's", "age" => 20],
];
// 為所有字符串加反斜杠
$escaped = function_deep('addslashes', $data);
print_r($escaped);
/* 輸出:
Array
(
[0] => I\'m bean
[1] => I\'m bean
[2] => Array
(
[0] => I\'m bean
[1] => I\'m bean
)
[3] => stdClass Object
(
[name] => Tom\'s
[age] => 20
)
)
*/
callable,復用性極高。InvalidArgumentException,便於調試。| 場景 | 回調函數 |
|---|---|
| 防 SQL 注入(舊項目) | addslashes / mysqli_real_escape_string |
| XSS 防護輸出 | htmlspecialchars |
| 去除首尾空白 | trim |
| 統一編碼轉換 | mb_convert_encoding |
| 敏感詞過濾 | 自定義過濾函數 |
is_callable 檢查。function_deep 是處理巢狀數據結構的利器,將「遍歷邏輯」與「業務處理」解耦,代碼更乾淨、可測試。實際項目中建議封裝到工具類或 Helper 函數庫中,配合 PHPStan/Psalm 靜態分析確保類型安全。