写 PHP 业务代码,十行里有六行在跟数组打交道。而 PHP 数组函数 里真正撑起日常开发的,其实就三个:array_map、array_filter、array_reduce。它们分别对应"逐个转换""挑出想要的""汇总成一个值"三种最基本的意图。把这三个用熟,大量 foreach 加临时变量的样板代码会立刻消失,逻辑也会从"怎么做"变成"要什么"。

本文不罗列手册,而是按真实业务场景拆解高频用法,顺带把容易踩的坑一次讲清:键名为什么保住了、0 为什么被吃掉、多个数组怎么对齐、初始值到底要不要传。

为什么优先用这三个函数

命令式写法把遍历、判断、累加三件事混在一个循环里,读代码的人得在脑子里模拟执行一遍。函数式写法把意图直接写在函数名上:map 是映射,filter 是筛选,reduce 是归约。配合 PHP 7.4 起的箭头函数,一行就能表达完整语义。

ℹ️
版本前提
箭头函数 fn() 需要 PHP 7.4+;str_starts_with 需要 PHP 8.0+。本文示例基于 PHP 8.1+,在 8.3 / 8.4 上行为一致。

array_map:一对一转换

array_map 对每个元素执行回调,返回一个元素个数相同的新数组。原数组不受影响,这也意味着它会额外占用一份内存。

基础:单数组映射

php map.php
<?php
$prices = [99, 199, 299];

// 含税价,保留两位小数
$withTax = array_map(fn(float $p) => round($p * 1.06, 2), $prices);

print_r($withTax);
// Array ( [0] => 104.94 [1] => 210.94 [2] => 316.94 )

多数组:按位置并排

传入多个数组时,回调按索引位置同时取值,返回数组长度以最长的为准,缺位补 null。这是把两列数据拼成关联行的最短写法。

php map-multi.php
<?php
$names  = ['张三', '李四', '王五'];
$scores = [88, 92];

$rows = array_map(
    fn(?string $n, ?int $s) => ['name' => $n, 'score' => $s],
    $names,
    $scores
);

// [['name'=>'张三','score'=>88], ['name'=>'李四','score'=>92], ['name'=>'王五','score'=>null]]

如果回调传 null,array_map 会退化成"拉链"操作,把多个数组按位打包成二维数组,常用来做键值配对:

php zip.php
<?php
$pairs = array_map(null, ['id', 'name'], [1, 'foo']);
// [[ 'id', 1 ], [ 'name', 'foo' ]]

// 再配合 array_column 就能转成关联数组
$assoc = array_column($pairs, 1, 0);
// ['id' => 1, 'name' => 'foo']
⚠️
键名会被丢弃
array_map 只保留单数组时的字符串键,多数组模式下结果一律重新索引为 0..n。想保留键名做映射,用 array_map + array_combine 或直接 foreach 更稳。

array_filter:按条件筛选

array_filter 返回回调为真的元素,关键在于它保留原键名。这是新手最容易忽略、也是线上 bug 最常见的来源。

默认回调会吃掉 0 和空串

php filter.php
<?php
$nums = [1, 0, 2, null, 3, '', 4];

$kept = array_filter($nums);   // [0=>1, 2=>2, 4=>3, 6=>4]  键名不连续

$list = array_values($kept);   // [1, 2, 3, 4]  重新索引

// 只想排除 null,不想误杀 0 和 ''
$safe = array_filter($nums, fn($v) => $v !== null);

不传回调时,array_filter 走的是 bool 转换,0、"0"、""、null、false、空数组统统被过滤。价格、库存、评分这类可能合法为 0 的字段,必须显式写回调。

按值、按键、按值加键

php filter-modes.php
<?php
$data = ['php' => 10, 'js' => 0, 'go' => 5, 'python' => 0];

// 默认:回调收到值
$positive = array_filter($data, fn(int $v) => $v > 0);

// ARRAY_FILTER_USE_KEY:回调收到键
$pOnly = array_filter($data, fn(string $k) => str_starts_with($k, 'p'), ARRAY_FILTER_USE_KEY);

// ARRAY_FILTER_USE_BOTH:回调收到值、键
$matched = array_filter(
    $data,
    fn(int $v, string $k) => $v > 0 && strlen($k) > 2,
    ARRAY_FILTER_USE_BOTH
);
⚠️
连续下标断裂 → JSON 变对象
筛选后的数组键名是断的,直接 json_encode 会输出 {"0":..,"2":..} 而不是 [..],前端拿到就报 map is not a function。对外返回列表前务必套一层 array_values()。

array_reduce:归约成单值

array_reduce 用一个累加器(carry)把整个数组压成一个结果:求和、拼接字符串、按字段分组、构建索引表都靠它。第三个参数是初始值,强烈建议显式传入——空数组时它就是返回值,不传则得到 null。

php reduce.php
<?php
$orders = [
    ['no' => 'A1', 'dept' => '研发', 'amount' => 120.5],
    ['no' => 'A2', 'dept' => '市场', 'amount' => 80.0],
    ['no' => 'A3', 'dept' => '研发', 'amount' => 200.0],
];

// 1. 求和(必须给初始值 0,否则空数组返回 null)
$total = array_reduce($orders, fn(float $sum, array $o) => $sum + $o['amount'], 0.0);

// 2. 按部门分组
$byDept = array_reduce($orders, function (array $carry, array $o): array {
    $carry[$o['dept']][] = $o['no'];
    return $carry;
}, []);

// ['研发' => ['A1', 'A3'], '市场' => ['A2']]

// 3. 构建 id 索引表,便于 O(1) 查找
$indexed = array_reduce($orders, function (array $carry, array $o): array {
    $carry[$o['no']] = $o;
    return $carry;
}, []);

注意分组和建索引的写法:回调里直接修改 $carry 并 return,不需要 array_merge。后者在大数组上会疯狂复制,是性能杀手。

组合实战:一条数据处理流水线

真实场景往往三步连做——先补算字段(map),再剔除不合格数据(filter),最后汇总(reduce)。链式写法的可读性远胜一个大循环:

php pipeline.php
<?php
$orders = [
    ['price' => 39.9, 'qty' => 3],
    ['price' => 9.9,  'qty' => 2],
    ['price' => 199,  'qty' => 1],
];

$paidTotal = array_reduce(
    array_filter(
        array_map(
            fn(array $o): array => $o + ['total' => round($o['price'] * $o['qty'], 2)],
            $orders
        ),
        fn(array $o): bool => $o['total'] >= 50   // 只统计满 50 的订单
    ),
    fn(float $sum, array $o): float => $sum + $o['total'],
    0.0
);

// 39.9*3=119.7 通过;9.9*2=19.8 被剔除;199 通过 → 318.7
💡 小技巧:链式嵌套一深就难读,可以先赋值给中间变量,或者封装成 collect() 风格的辅助函数,把 map/filter/sum 串成方法链。团队项目里后者更易维护。

和 foreach 怎么选

对比项array_map / filter / reduceforeach
语义表达意图清晰,一行一动作需读完循环体才知道在做什么
键名控制filter 保留键、map 丢键,易踩坑完全可控
内存占用每步都生成新数组,链式更明显可原地修改,省内存
执行性能有回调开销,略慢于 foreach最快,适合百万级数据
中途退出不能 break可 break / continue

结论很实际:几百条以内的配置、列表、接口返回值,优先用函数式写法换可读性;上万条的热点循环,老老实实 foreach;超大数据用生成器 yield 逐个处理,避免一次性把所有元素装进内存。

高频坑位速查

  • filter 后忘了 array_values:接口返回 {} 而非 []。
  • filter 不传回调:0、"0" 被误删。
  • reduce 不传初始值:空数组返回 null,再参与运算直接报类型错误。
  • 多数组 map 长度不等:短板补 null,回调参数要允许 null。
  • 回调里做数据库查询:N 次 IO 放大成 N 倍延迟,应改成批量查询后在内存里 map。
  • 链式套太深:调试困难,拆成中间变量或封装管道函数。
✅
一句话记住
map 改形状,filter 挑元素,reduce 压成一个值;改完记得 array_values,压之前记得给初始值。

延伸:这些函数也值得顺手掌握

三个核心之外,array_column(取列并重建索引)、array_walk(原地修改,引用传参)、array_combine(键值配对)、usort + 飞船运算符(自定义排序)能覆盖剩下八成数组需求。它们的共同点是:把循环交给 C 层实现,你只负责描述规则。

数组处理熟练之后,往下就该关心数据从哪来、错误怎么兜。索引越界、null 参与运算、回调抛异常,这些在数组密集的代码里出现频率极高。

数据处理的上限不取决于你会多少个函数,而取决于你能否一眼看出「这段代码到底在表达什么意图」。

相关阅读