PHP array_walk() 深度解析：遍歷修改數組、傳遞額外參數、遞歸處理

array_walk() 是 PHP 遍歷並**原地修改**數組的核心函數，支援傳遞用戶數據、遞歸處理多維數組。本文詳細講解語法、參數陷阱、常見模式與性能對比。

函數簽名

array_walk(array &$array, callable $callback, mixed $arg = null): bool

• &$array：引用傳遞，**回調函數修改 $value 會直接改變原數組**。
• $callback：fn(&$value, $key, $arg) { ... }，第一參數必須按引用 &$value 才能修改原數組。
• $arg：額外參數，將原樣傳給回調第三參數。
• 返回 true，失敗拋警告。

基礎示例：修改數組元素、使用額外參數

$fruits = ['apple', 'banana', 'orange'];

array_walk($fruits, function(&$item, $key, $prefix) {
    $item = $prefix . $item;
}, 'Fruit: ');

print_r($fruits);
/*
Array
(
    [0] => Fruit: apple
    [1] => Fruit: banana
    [2] => Fruit: orange
)
*/

遞歸處理多維數組

function walkRecursive(array &$array, callable $callback, $arg = null) {
    array_walk($array, function(&$value, $key) use (&$walkRecursive, $callback, $arg) {
        if (is_array($value)) {
            $walkRecursive($value, $callback, $arg);
        } else {
            $callback($value, $key, $arg);
        }
    });
}

$data = [
    'user' => ['name' => 'Alice', 'tags' => ['php', 'laravel']],
    'settings' => ['theme' => 'dark', 'lang' => 'en']
];

walkRecursive($data, function(&$v, $k) {
    if (is_string($v)) $v = strtoupper($v);
});

print_r($data);
// 所有字符串值變大寫，鍵名不變

常見陷阱與避坑

array_walk vs array_map vs foreach

實戰模式：數組清洗/標準化

function sanitizeArray(array &$data, array $rules) {
    array_walk($data, function(&$value, $key) use ($rules) {
        if (isset($rules[$key])) {
            $rule = $rules[$key];
            // 修剪
            if ($rule['trim'] ?? false) $value = trim($value);
            // 類型轉換
            if (isset($rule['type'])) {
                settype($value, $rule['type']);
            }
            // 回調處理
            if (isset($rule['callback']) && is_callable($rule['callback'])) {
                $value = $rule['callback']($value);
            }
        }
    });
}

$input = ['  name  ' => '  Alice  ', 'age' => '25', 'email' => 'ALICE@EXAMPLE.COM'];
sanitizeArray($input, [
    'name'  => ['trim' => true],
    'age'   => ['type' => 'integer'],
    'email' => ['trim' => true, 'callback' => 'strtolower'],
]);
print_r($input);
// ['name'=>'Alice', 'age'=>25, 'email'=>'alice@example.com']

總結

• 需原地修改、傳遞額外參數、可中斷 → array_walk。
• 需返回新數組、多數組並行、鍵值轉換 → array_map。
• 複雜邏輯、需 break/continue、修改鍵名、性能極致 → foreach。

掌握 array_walk 的引用機制與遞歸模式，能優雅處理多維數組清洗、標準化、批量轉換等高頻任務。