萬盛學電腦網

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

PHP 遞歸遍歷數組並應用回調函數的通用實現

場景

需要對多維數組(甚至包含對象)的所有標量值統一應用某個處理函數(如 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
        )
)
*/

核心設計點

  1. 統一入口:單一函數處理陣列、對象、字符串三種結構,業務代碼無需關心結構深度。
  2. 回調靈活:接受函數名、閉包、類靜態方法等任何 callable,復用性極高。
  3. 保持結構:返回值類型與結構與輸入完全一致,避免副作用。
  4. 異常快速失敗:不可調用時拋出 InvalidArgumentException,便於調試。

常見應用場景

場景回調函數
防 SQL 注入(舊項目)addslashes / mysqli_real_escape_string
XSS 防護輸出htmlspecialchars
去除首尾空白trim
統一編碼轉換mb_convert_encoding
敏感詞過濾自定義過濾函數

性能提示

  • 大數組(>10 萬元素)遞歸可能導致棧溢出,可改用迭代器 + 手動棧實現非遞歸版本。
  • 頻繁調用時,將回調緩存為變量避免重複 is_callable 檢查。

總結

function_deep 是處理巢狀數據結構的利器,將「遍歷邏輯」與「業務處理」解耦,代碼更乾淨、可測試。實際項目中建議封裝到工具類或 Helper 函數庫中,配合 PHPStan/Psalm 靜態分析確保類型安全。

copyright © 萬盛學電腦網 all rights reserved