PHP：高效合并多个数组以创建结构化新数组的教程

本教程详细介绍了如何在 php 中将多个扁平数组高效地合并为一个包含关联子数组的新数组。我们将重点探讨 array_map() 函数，并结合 compact() 和 array_combine() 等辅助函数，提供多种实现方案，包括现代 PHP 7.4+ 的箭头函数语法，以帮助开发者创建结构清晰、易于维护的数据结构。

在 php 开发中，我们经常会遇到需要将分散在多个数组中的相关数据进行整合，形成一个更具结构化、易于处理的单一数组的场景。例如，你可能拥有分别存储页面id、位置和优先级的三个独立数组，并希望将它们组合成一个由关联数组构成的新数组，其中每个关联数组代表一个完整的记录。

假设我们有以下三个原始数组：

$first = array(13, 66, 15); $second = array('append', 'prepend', 'append'); $third = array(2, 4, 1);

我们的目标是生成一个如下所示的单一数组：

$new_array = array(     array('page' => 13, 'position' => 'append', 'priority' => 2),     array('page' => 66, 'position' => 'prepend', 'priority' => 4),     array('page' => 15, 'position' => 'append', 'priority' => 1) );

下面我们将介绍几种实现此目标的有效方法。

方法一：使用 array_map() 结合 compact()

array_map() 函数是处理此问题的理想选择。它能够并行遍历一个或多个数组，并对每个元素应用回调函数，然后返回一个包含回调函数结果的新数组。当需要从多个数组中按索引取值并构建新结构时，array_map() 的多参数特性非常有用。

立即学习“PHP免费学习笔记（深入）”；

结合 compact() 函数，我们可以简洁地创建关联数组。compact() 函数接受变量名（字符串形式）作为参数，并返回一个包含这些变量名及其值的关联数组。

<?php $first = array(13, 66, 15); $second = array('append', 'prepend', 'append'); $third = array(2, 4, 1);  $new_array_method1 = array_map(     function($page, $position, $priority) {         // compact() 函数将传入的变量名（字符串）作为键，变量的值作为值，         // 创建一个新的关联数组。         return compact('page', 'position', 'priority');     },     $first,    // $page 对应 $first 的元素     $second,   // $position 对应 $second 的元素     $third     // $priority 对应 $third 的元素 );  print_r($new_array_method1); ?>

代码解析：

• array_map() 的第一个参数是一个匿名函数，它接收与输入数组数量相同的参数。
• $first, $second, $third 作为 array_map() 的后续参数传入，它们的元素将依次作为匿名函数的 $page, $position, $priority 参数。
• 在匿名函数内部，compact(‘page’, ‘position’, ‘priority’) 会创建一个形如 [‘page’ => $page, ‘position’ => $position, ‘priority’ => $priority] 的关联数组。

方法二：使用 array_map() 结合 array_combine() 和可变参数

为了提高代码的灵活性和可维护性，特别是当需要组合的数组数量或键名可能发生变化时，我们可以采用 array_combine() 和 PHP 5.6+ 引入的可变参数 (…$args) 语法。这种方法允许我们集中定义键名，避免在回调函数中重复输入。

<?php $first = array(13, 66, 15); $second = array('append', 'prepend', 'append'); $third = array(2, 4, 1);  // 定义键名数组，顺序必须与 array_map() 传入的数组顺序一致 $keys = ['page', 'position', 'priority'];  $new_array_method2 = array_map(     function(...$args) use ($keys) {         // array_combine() 将 $keys 数组作为键，...$args（即当前迭代的元素数组）作为值         // 创建一个新的关联数组。         return array_combine($keys, $args);     },     $first,     $second,     $third );  print_r($new_array_method2); ?>

代码解析：

• $keys 数组明确定义了最终关联数组的键名。
• 匿名函数使用 …$args 接收所有传入的数组元素作为一个数组。例如，第一次迭代时 $args 将是 [13, ‘append’, 2]。
• use ($keys) 语句将 $keys 数组从外部作用域引入到匿名函数内部。
• array_combine($keys, $args) 以 $keys 为键，$args 为值，生成期望的关联数组。这种方式的优点是，如果需要修改键名或增加/减少组合的数组，只需修改 $keys 数组和 array_map() 的参数列表即可，回调函数本身无需改动，提高了代码的复用性和可维护性。

方法三：PHP 7.4+ 箭头函数简化语法

对于 PHP 7.4 及更高版本，我们可以使用更简洁的箭头函数 (fn) 语法来进一步简化回调函数。箭头函数自动捕获外部作用域的变量，因此无需 use 关键字。

<?php // 假设 $first, $second, $third 和 $keys 已经定义 // ... (同上文定义) ... $first = array(13, 66, 15); $second = array('append', 'prepend', 'append'); $third = array(2, 4, 1); $keys = ['page', 'position', 'priority'];  $new_array_method3 = array_map(     fn(...$args) => array_combine($keys, $args),     $first,     $second,     $third );  print_r($new_array_method3); ?>

代码解析：

• fn(…$args) => array_combine($keys, $args) 是一个箭头函数。它等同于 function(…$args) use ($keys) { return array_combine($keys, $args); }。
• 箭头函数自动继承父作用域的变量（如 $keys），使其代码更加紧凑和易读。

注意事项

1. 数组长度一致性： array_map() 在处理多个数组时，会以最短的数组为准进行迭代。如果输入数组的长度不一致，结果数组的长度将与最短的那个数组相同，并且较长数组中超出部分的数据会被忽略。在实际应用中，应确保所有待合并的数组长度一致，或者在合并前进行长度检查。
2. 键名与参数顺序： 在使用 compact() 或 array_combine() 时，确保回调函数中参数的顺序与 $keys 数组（如果使用）的顺序，以及 array_map() 传入的原始数组的顺序保持一致。这种顺序匹配是正确构建关联数组的关键。
3. PHP 版本兼容性： 箭头函数是 PHP 7.4+ 的特性。如果你的项目运行在较低的 PHP 版本上，应使用匿名函数（方法一或方法二）。

总结

本文介绍了在 PHP 中将多个扁平数组合并为一个结构化新数组的多种方法。无论是使用 array_map() 结合 compact() 快速实现，还是利用 array_combine() 和可变参数提高灵活性和可维护性，亦或是借助 PHP 7.4+ 的箭头函数简化代码，选择哪种方法取决于你的具体需求、项目规范以及所使用的 PHP 版本。理解这些技术将帮助你更高效地处理和组织 PHP 中的数据结构。