PHP array_walk 回调函数中变量引用传递的最佳实践

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

array_walk($inventory, 'fruitTypes', &$fruits); // 错误示范

function fruitTypes($value, $key, $fruits) { // $fruits 未声明为引用
    $fruits[] = $key; // 这里的修改只作用于函数内部的 $fruits 副本
}
array_walk($inventory, 'fruitTypes', $fruits);
// 外部的 $fruits 不会发生改变

<?php

$inventory = [
    'Apples' => ['Golden Delicious', 'Granny Smith','Fuji'],
    'Oranges' => ['Valencia', 'Navel', 'Jaffa']
];

// 声明一个空数组，用于收集键。这个数组将在回调函数中被填充。
$fruits = []; 

/**
 * 回调函数，用于收集数组的键。
 *
 * @param mixed $value 当前迭代的数组元素的值。
 * @param string $key 当前迭代的数组元素的键。
 * @param array &$targetArray 接收键的目标数组，必须通过引用传递。
 */
function collectKeys($value, $key, &$targetArray) {
    // 将当前元素的键添加到目标数组中
    $targetArray[] = $key;
}

// 调用 array_walk
// 第一个参数 $inventory 是要遍历的数组。
// 第二个参数 'collectKeys' 是回调函数名。
// 第三个参数 $fruits 是要传递给回调函数的额外数据（即目标数组）。
// 注意：这里 $fruits 是按值传递给 array_walk 的，但回调函数内部会通过引用操作它。
array_walk($inventory, 'collectKeys', $fruits);

echo "收集到的水果类型键：\n";
print_r($fruits);

/*
输出结果:
收集到的水果类型键：
Array
(
    [0] => Apples
    [1] => Oranges
)
*/

// 另一个修改数组元素的示例
$numbers = [1, 2, 3];

/**
 * 回调函数，用于修改数组元素并记录操作。
 *
 * @param int &$item 当前数组元素的值，通过引用传递，允许修改。
 * @param mixed $key 当前数组元素的键。
 * @param array &$logArray 记录操作的数组，通过引用传递。
 */
function processAndLog(&$item, $key, &$logArray) {
    $item *= 2; // 修改原始数组元素
    $logArray[] = "处理了键为 '$key' 的元素，新值为 $item"; // 记录操作
}

$operationLog = [];
array_walk($numbers, 'processAndLog', $operationLog);

echo "\n处理后的数字数组：\n";
print_r($numbers);

echo "\n操作日志：\n";
print_r($operationLog);

/*
输出结果:
处理后的数字数组：
Array
(
    [0] => 2
    [1] => 4
    [2] => 6
)

操作日志：
Array
(
    [0] => 处理了键为 '0' 的元素，新值为 2
    [1] => 处理了键为 '1' 的元素，新值为 4
    [2] => 处理了键为 '2' 的元素，新值为 6
)
*/

?>

// 使用匿名函数和 use 关键字实现相同功能
$fruits_anon = [];
array_walk($inventory, function($value, $key) use (&$fruits_anon) {
    $fruits_anon[] = $key;
});
echo "\n使用匿名函数收集到的水果类型键：\n";
print_r($fruits_anon);