写 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
$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
$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
$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
$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
$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_encode 会输出 {"0":..,"2":..} 而不是 [..],前端拿到就报 map is not a function。对外返回列表前务必套一层 array_values()。array_reduce:归约成单值
array_reduce 用一个累加器(carry)把整个数组压成一个结果:求和、拼接字符串、按字段分组、构建索引表都靠它。第三个参数是初始值,强烈建议显式传入——空数组时它就是返回值,不传则得到 null。
<?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
$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 / reduce | foreach |
|---|---|---|
| 语义表达 | 意图清晰,一行一动作 | 需读完循环体才知道在做什么 |
| 键名控制 | filter 保留键、map 丢键,易踩坑 | 完全可控 |
| 内存占用 | 每步都生成新数组,链式更明显 | 可原地修改,省内存 |
| 执行性能 | 有回调开销,略慢于 foreach | 最快,适合百万级数据 |
| 中途退出 | 不能 break | 可 break / continue |
结论很实际:几百条以内的配置、列表、接口返回值,优先用函数式写法换可读性;上万条的热点循环,老老实实 foreach;超大数据用生成器 yield 逐个处理,避免一次性把所有元素装进内存。
高频坑位速查
- filter 后忘了 array_values:接口返回
{}而非[]。 - filter 不传回调:
0、"0"被误删。 - reduce 不传初始值:空数组返回
null,再参与运算直接报类型错误。 - 多数组 map 长度不等:短板补
null,回调参数要允许 null。 - 回调里做数据库查询:N 次 IO 放大成 N 倍延迟,应改成批量查询后在内存里 map。
- 链式套太深:调试困难,拆成中间变量或封装管道函数。
array_values,压之前记得给初始值。延伸:这些函数也值得顺手掌握
三个核心之外,array_column(取列并重建索引)、array_walk(原地修改,引用传参)、array_combine(键值配对)、usort + 飞船运算符(自定义排序)能覆盖剩下八成数组需求。它们的共同点是:把循环交给 C 层实现,你只负责描述规则。
数组处理熟练之后,往下就该关心数据从哪来、错误怎么兜。索引越界、null 参与运算、回调抛异常,这些在数组密集的代码里出现频率极高。
数据处理的上限不取决于你会多少个函数,而取决于你能否一眼看出「这段代码到底在表达什么意图」。
相关阅读
- PHP 学习路线图 2026:从入门到进阶的完整指南 —— 先看全局,再补细节。
- PHP 错误处理与异常机制全解析:try/catch、Error、自定义异常 —— 数组回调里抛异常该怎么兜。
- 用 PHP 实现图片批量压缩 —— 典型的 map + 循环落地场景。
- PHP 8.3 vs 8.4 对比与升级教程 —— 新版本对数组与类型系统的调整。