PHP函数：array_map：对数组应用回调处理

简介

array_map 是PHP中一个强大的数组处理函数，它的核心功能是将一个回调函数，均匀地应用到给定数组的每一个元素上，并返回处理后的新数组。这就像一条流水线，为数组中的每个“零件”执行相同的“加工”操作。它常用于数据清洗、格式转换、批量计算等需要对数据集进行统一处理的场景。

语法

array_map(?callable $callback, array $array, array ...$arrays): array

函数内部机制：array_map 会遍历一个或多个输入数组（长度以最长的输入数组为准），在每次迭代中，它将当前各数组对应位置上的元素作为参数，调用你提供的 $callback 函数，并将回调函数的返回值收集起来，最终组成一个新数组返回。

用法

基础用法

最基本的场景是对一个数组的每个元素执行相同的操作。

<?php
// 场景：将用户输入的一组数字字符串转换为整数并进行平方计算
$userInput = ['2', '5', '10'];

// 定义一个回调函数
function squareNumber($n) {
    // 先将字符串转为整数，再计算平方
    $intVal = (int)$n;
    return $intVal * $intVal;
}

// 使用 array_map 应用回调
$squaredNumbers = array_map('squareNumber', $userInput);

print_r($squaredNumbers);
// 输出：Array ( [0] => 4 [1] => 25 [2] => 100 )
?>

这里明确地将字符串转换为整数（(int)$n），是为了确保数学运算的安全性，即使输入中混入了非纯数字字符串，也能得到一个确定的结果（如 '10abc' 会转为 10）。直接对字符串进行乘法运算，PHP虽然会尝试类型转换，但显式转换使意图更清晰，避免隐式转换的歧义。

进阶用法

处理多个数组

array_map 可以同时处理多个数组，回调函数按顺序接收每个数组的对应元素。

<?php
// 场景：计算两个数组中对应位置元素的和
$prices = [100, 200, 300];
$quantities = [2, 3, 1];

// 回调函数现在接收两个参数
function calculateTotal($price, $quantity) {
    // 注意：涉及金额计算，实际项目中应使用专门的高精度数学函数（如bcmath）
    return $price * $quantity;
}

$totals = array_map('calculateTotal', $prices, $quantities);
print_r($totals);
// 输出：Array ( [0] => 200 [1] => 600 [2] => 300 )
?>

使用匿名函数（闭包）

让代码更紧凑，尤其适用于一次性使用的简单逻辑。

<?php
// 场景：清理用户提交的一组标签，去除首尾空格并转为小写
$rawTags = [' PHP ', 'MySQL', ' JavaScript '];

$cleanedTags = array_map(
    function($tag) {
        // trim() 去空格，strtolower() 转小写
        return strtolower(trim($tag));
    },
    $rawTags
);

print_r($cleanedTags);
// 输出：Array ( [0] => php [1] => mysql [2] => javascript )
?>

传递类静态方法或对象方法

<?php
class Formatter {
    public static function formatCurrency($amount) {
        return '$' . number_format($amount, 2);
    }
}

$amounts = [1234.5, 99, 4567.89];
$formatted = array_map(['Formatter', 'formatCurrency'], $amounts);
print_r($formatted);
// 输出：Array ( [0] => $1,234.50 [1] => $99.00 [2] => $4,567.89 )
?>

当 $callback 为 null 时

会创建一个“转置”效果的多维数组，将多个输入数组的对应元素组合在一起。

<?php
$a = ['a', 'b', 'c'];
$b = [1, 2, 3];

$result = array_map(null, $a, $b);
print_r($result);
/* 输出：
Array
(
    [0] => Array ( [0] => a [1] => 1 )
    [1] => Array ( [0] => b [1] => 2 )
    [2] => Array ( [0] => c [1] => 3 )
)
*/
// 这在需要将多个数组“压缩”在一起时很有用。
?>

易错点

回调函数参数顺序与数组参数顺序不匹配

回调函数接收参数的顺序，严格对应array_map中传入数组的顺序。第一个数组的元素作为回调的第一个参数，第二个数组的元素作为第二个参数，以此类推。顺序写反会导致逻辑错误。

// 错误示例
$arr1 = [1, 2];
$arr2 = [10, 20];
$result = array_map(function($a, $b) { return $a - $b; }, $arr2, $arr1); // 意图是 arr1 - arr2，但实际是 arr2 - arr1

认为 array_map 会修改原数组

array_map 返回一个新数组，原始输入数组不会被改变。这是一个纯函数式操作，是很多新手容易忽略的特性。

$numbers = [1, 2, 3];
$newNumbers = array_map(function($n) { return $n * 2; }, $numbers);
// $numbers 仍然是 [1, 2, 3]
// $newNumbers 是 [2, 4, 6]

在回调函数中直接使用 echo 等输出语句

array_map 的目的是转换数据并返回新数组，而不是产生副作用（如直接输出）。在回调中输出会打乱程序流程，且返回值不可控。

// 不良实践
$data = [1, 2, 3];
$result = array_map(function($n) {
    echo $n; // 不要在这里输出！
    return $n * 2;
}, $data);
// 输出会立刻发生：123，并且$result是[2,4,6]

回调函数未定义或不可调用

如果传递给 array_map 的第一个参数不是一个有效的回调函数（如函数名拼写错误），会导致致命错误。

// 错误：函数名拼写错误
$result = array_map('myFuncton', $array); // 应该是 'myFunction'

最佳实践

优先使用匿名函数处理简单逻辑

对于只在此处使用的简单转换，使用匿名函数可以让代码更紧凑，逻辑更集中，无需在外部定义一个小函数，提高了代码的可读性和内聚性。

// 好：逻辑集中，意图明确
$uppercased = array_map(fn($str) => strtoupper($str), $names);

在PHP 7.4+中，使用箭头函数简化

箭头函数（fn(...)）可以更简洁地书写单表达式匿名函数，并自动继承父作用域变量，无需use关键字。

$factor = 10;
$multiplied = array_map(fn($n) => $n * $factor, $numbers);
// 比 function($n) use ($factor) { return $n * $factor; } 简洁得多

确保回调函数是“纯净”且可测试的

理想情况下，回调函数应该只依赖于它的输入参数，不修改外部状态（无副作用）。这样的函数更容易单独进行单元测试，也保证了array_map行为的可预测性。

对于非常简单的元素获取，考虑使用 array_column

如果你的目标只是从多维数组中提取某个键名的值，array_column 是比 array_map 更专用、更高效的函数。

$users = [
    ['id' => 1, 'name' => 'Alice'],
    ['id' => 2, 'name' => 'Bob'],
];
// 使用 array_map
$names = array_map(fn($user) => $user['name'], $users);
// 使用更优的 array_column
$names = array_column($users, 'name');

始终接收 array_map 的返回值

牢记 array_map 不修改原数组，你必须将其结果赋值给一个变量，才能在后续逻辑中使用处理后的数据。这是最基本也最重要的实践。

// 正确做法
$processedData = array_map($callback, $rawData);
// 现在可以使用 $processedData 了
do_something($processedData);

性能考量

虽然 array_map 的抽象很好，但它有轻微的函数调用开销。对于超大型数组（例如数十万以上元素）进行极其简单的操作（如+1），在性能临界路径上，使用foreach循环有时可能略快。但在绝大多数情况下，array_map 带来的代码清晰度收益远超其微小的性能开销，优先保证代码清晰和可维护性。