PHP常用数组函数解析-艾林博客 - 技术交流与经验分享的个人博客

一、核心数据处理函数

1. array_map - 批量处理器

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

array_map 函数的作用是将一个回调函数应用到多个数组的对应元素上，并返回一个新的数组，新数组的元素是回调函数的返回值。

参数解释：

$callback：一个可调用的函数，该函数将应用到每个数组的对应元素上。这个函数接受的参数数量取决于传入的数组数量，例如，如果传入两个数组，那么回调函数将接受两个参数，分别是两个数组的对应元素。
$arrays：一个或多个数组，这些数组的对应元素将作为 $callback 函数的参数。

简单场景使用实例：价格加密

$prices = [99, 199, 299];
$encrypted = array_map(fn($n) => base64_encode((string)$n), $prices);
// 输出：['OTk=', 'MTk5', 'Mjk5']

在这个简单场景中，我们有一个包含价格的数组 $prices，我们想要对每个价格进行加密。通过 array_map 函数，我们将 base64_encode 函数作为回调函数应用到 $prices 数组的每个元素上，实现了对价格的加密。

复杂场景使用实例：矩阵转置

$matrix = [
    [1, 2, 3],
    [4, 5, 6],
    [7, 8, 9]
];

$transposed = array_map(
    fn(...$col) => $col, 
    ...$matrix
);
/* 输出：
[
    [1,4,7],
    [2,5,8],
    [3,6,9]
]
*/

在这个复杂场景中，我们有一个二维数组 $matrix 表示一个矩阵。通过 array_map 函数，我们将一个匿名函数作为回调函数，该匿名函数接受多个参数并将它们组成一个数组。通过将 $matrix 数组展开作为 array_map 的参数，我们实现了矩阵的转置。

2. array_filter - 智能筛选器

array_filter(array $array, ?callable $callback = null, int $mode = 0): array

array_filter 函数用于过滤数组中的元素。它可以根据指定的回调函数来决定保留哪些元素，或者根据默认行为（如果没有提供回调函数）来过滤掉虚假值（如 false、0、null、'' 等）。

参数解释：

$array：要进行过滤的数组。
$callback：可选的回调函数。如果提供了这个函数，array_filter 将对 $array 中的每个元素调用该函数。如果回调函数返回 true，则该元素将被保留在结果数组中；如果返回 false，则该元素将被过滤掉。
$mode：可选的模式参数。它可以取以下值：
- 0（默认值）：回调函数只接受一个参数，即数组的元素。
- ARRAY_FILTER_USE_KEY：回调函数接受两个参数，第一个是数组的键，第二个是数组的元素。
- ARRAY_FILTER_USE_BOTH：回调函数接受两个参数，第一个是数组的键，第二个是数组的元素，并且键和元素都将作为回调函数的参数。

简单场景使用实例：过滤空值

$data = [1, 0, false, '', null];
$filtered = array_filter($data);
// 输出：[1]

在这个简单场景中，我们没有提供回调函数，array_filter 使用默认行为过滤掉了 $data 数组中的虚假值，只保留了 1。

复杂场景使用实例：权限验证

$permissions = [
    'user.read' => true,
    'user.delete' => false,
    'admin.create' => true
];

$valid = array_filter(
    $permissions,
    fn($val, $key) => $val && str_contains($key, 'admin'),
    ARRAY_FILTER_USE_BOTH
);
// 输出：['admin.create' => true]

在这个复杂场景中，我们有一个包含权限信息的数组 $permissions。我们使用 array_filter 函数，并提供了一个回调函数和 ARRAY_FILTER_USE_BOTH 模式。回调函数检查权限值是否为 true 并且权限键是否包含 'admin'，只有满足这些条件的权限才会被保留在结果数组中。

3. array_reduce - 数据聚合器

array_reduce(array $array, callable $callback, mixed $initial = null): mixed

array_reduce 函数将数组简化为一个单一的值。它通过迭代数组的每个元素，并使用回调函数将当前元素与一个累加器结合起来，最终返回累加器的值。

参数解释：

$array：要进行简化的数组。
$callback：回调函数，该函数接受两个参数：累加器（$carry）和当前数组元素（$value）。回调函数应该返回一个新的累加器值，该值将在下一次迭代中使用。
$initial：可选的初始值。如果提供了这个值，它将作为累加器的初始值。如果没有提供，将使用数组的第一个元素作为初始值（如果数组不为空）。

简单场景使用实例：计算数组总和

$numbers = [1, 2, 3, 4];
$sum = array_reduce($numbers, fn($carry, $n) => $carry + $n, 0);
// 输出：10

在这个简单场景中，我们有一个包含数字的数组 $numbers。我们使用 array_reduce 函数，并提供了一个匿名回调函数和初始值 0。回调函数将累加器和当前元素相加，最终返回数组元素的总和。

复杂场景使用实例：电商统计

$orders = [
    ['amount' => 150, 'fee' => 5],
    ['amount' => 299, 'fee' => 8],
    ['amount' => 89, 'fee' => 2]
];

$total = array_reduce($orders, function($carry, $order) {
    $carry['total_amount'] += $order['amount'];
    $carry['total_fee'] += $order['fee'];
    return $carry;
}, ['total_amount' => 0, 'total_fee' => 0]);

// 输出：['total_amount' => 538, 'total_fee' => 15]

在这个复杂场景中，我们有一个包含订单信息的数组 $orders。我们使用 array_reduce 函数，并提供了一个匿名回调函数和初始值 ['total_amount' => 0, 'total_fee' => 0]。回调函数将每个订单的金额和费用累加到累加器中，最终返回包含总金额和总费用的数组。

二、数组结构操作函数

4. array_chunk - 分块处理器

array_chunk(array $array, int $length, bool $preserve_keys = false): array

array_chunk 函数将一个数组分割成多个指定长度的子数组。

参数解释：

$array：要进行分割的数组。
$length：每个子数组的长度。
$preserve_keys：可选的布尔值参数。如果为 false（默认值），子数组的键将被重新索引为从 0 开始的连续整数；如果为 true，子数组将保留原始数组的键。

简单场景使用实例：数组分块

$data = [1, 2, 3, 4, 5];
$chunks = array_chunk($data, 2);
// 输出：[[1, 2], [3, 4], [5]]

在这个简单场景中，我们有一个包含数字的数组 $data。我们使用 array_chunk 函数将其分割成每个长度为 2 的子数组，结果是一个包含三个子数组的数组。

复杂场景使用实例：大文件分片上传

$fileBlocks = array_chunk(
    str_split(file_get_contents('bigfile.zip')), 
    1024 * 1024, // 1MB分块
    true
);

在这个复杂场景中，我们读取一个大文件的内容，并使用 str_split 函数将其分割成单个字符的数组。然后，我们使用 array_chunk 函数将这个字符数组分割成每个长度为 1MB 的子数组，并保留原始键。这样，我们可以将这些子数组逐个上传到服务器，实现大文件的分片上传。

5. array_splice - 元素替换器

array_splice(array &$input, int $offset, ?int $length = null, mixed $replacement = []): array

array_splice 函数从数组中移除指定数量的元素，并可以在移除的位置插入新的元素。

参数解释：

$input：要进行操作的数组，这个参数是通过引用传递的，即函数会直接修改原始数组。
$offset：指定从数组的哪个位置开始移除元素。如果 $offset 为正数，从数组的起始位置开始计数；如果 $offset 为负数，从数组的末尾开始计数。
$length：可选参数，指定要移除的元素数量。如果省略或为 null，将从 $offset 位置开始移除到数组的末尾。如果 $length 为正数，移除指定数量的元素；如果 $length 为负数，移除从 $offset 位置到数组末尾倒数 $length 个元素之前的所有元素。
$replacement：可选参数，指定要插入到移除元素位置的新元素。可以是一个值或一个数组。

简单场景使用实例：删除元素

$array = [1, 2, 3, 4];
array_splice($array, 1, 2);
// 输出：[1, 4]

在这个简单场景中，我们有一个包含数字的数组 $array。我们使用 array_splice 函数从数组的第二个位置（索引为 1）开始移除 2 个元素，结果是数组变为 [1, 4]。

复杂场景使用实例：动态修改配置

$config = ['db_host', 'db_user', 'cache_time'];
array_splice(
    $config, 
    2, 
    0, 
    ['db_pass', 'cache_type'] // 在位置2插入新元素
);
// 结果：['db_host','db_user','db_pass','cache_type','cache_time']

在这个复杂场景中，我们有一个包含配置项的数组 $config。我们使用 array_splice 函数从数组的第三个位置（索引为 2）开始移除 0 个元素，并在该位置插入两个新的配置项 ['db_pass', 'cache_type']，结果是数组变为 ['db_host', 'db_user', 'db_pass', 'cache_type', 'cache_time']。

6. array_flip - 键值翻转器

array_flip(array $array): array

array_flip 函数用于翻转数组的键和值，即原来的键变为值，原来的值变为键。

参数解释：

$array：要进行键值翻转的数组。

简单场景使用实例：翻转键值

$colors = ['red' => '#FF0000', 'green' => '#00FF00'];
$flipped = array_flip($colors);
// 输出：['#FF0000' => 'red', '#00FF00' => 'green']

在这个简单场景中，我们有一个包含颜色名称和对应颜色代码的数组 $colors。我们使用 array_flip 函数将其键值翻转，得到一个新的数组，其中颜色代码作为键，颜色名称作为值。

复杂场景使用实例：快速查找重复值

$data = ['a', 'b', 'a', 'c'];
$unique = array_flip(array_flip($data));
// 输出：['a', 'b', 'c']（保留最后一个出现位置）

在这个复杂场景中，我们有一个包含重复元素的数组 $data。我们首先使用 array_flip 函数将数组的键值翻转，这样重复的元素会覆盖之前的键值。然后，我们再次使用 array_flip 函数将键值翻转回来，这样就得到了一个去除重复元素的数组，并且保留了最后一个出现的元素的位置。

7. array_intersect - 数据交集体

array_intersect(array $array, array ...$arrays): array

array_intersect 函数用于计算多个数组的交集，即返回一个包含所有数组中都存在的元素的数组。

参数解释：

$array：第一个数组，作为比较的基准。
$arrays：一个或多个其他数组，这些数组将与第一个数组进行比较。

简单场景使用实例：查找交集

$array1 = [1, 2, 3];
$array2 = [2, 3, 4];
$intersect = array_intersect($array1, $array2);
// 输出：[2, 3]

在这个简单场景中，我们有两个包含数字的数组 $array1 和 $array2。我们使用 array_intersect 函数计算它们的交集，结果是一个包含 2 和 3 的数组，因为这两个元素在 $array1 和 $array2 中都存在。

复杂场景使用实例：权限交集

$userPerms = ['read', 'write', 'delete'];
$allowedPerms = ['read', 'edit'];

$validPerms = array_intersect($userPerms, $allowedPerms);
// 输出：['read']

在这个复杂场景中，我们有一个包含用户权限的数组 $userPerms 和一个包含允许权限的数组 $allowedPerms。我们使用 array_intersect 函数计算它们的交集，结果是一个只包含 'read' 的数组，因为只有 'read' 权限在两个数组中都存在。

三、高级数据处理函数

8. array_walk_recursive - 递归遍历器

array_walk_recursive(array &$array, callable $callback, mixed $userdata = null): bool

array_walk_recursive 函数递归地遍历数组中的所有元素，并对每个元素应用指定的回调函数。

参数解释：

$array：要进行遍历的数组，这个参数是通过引用传递的，即函数会直接修改原始数组。
$callback：回调函数，该函数接受两个参数：当前元素的值（$value）和当前元素的键（$key）。回调函数还可以接受第三个参数 $userdata，如果提供了的话。
$userdata：可选参数，将作为第三个参数传递给回调函数。

简单场景使用实例：递归修改值

$data = ['a' => 1, 'b' => ['c' => 2]];
array_walk_recursive($data, function(&$v) {
    $v *= 2;
});
// 输出：['a' => 2, 'b' => ['c' => 4]]

在这个简单场景中，我们有一个包含嵌套数组的数组 $data。我们使用 array_walk_recursive 函数，并提供了一个匿名回调函数。回调函数将每个元素的值乘以 2，实现了对数组中所有元素的递归修改。

复杂场景使用实例：多维数组清洗

$data = [
    'user' => ['name' => ' John ', 'tags' => [' php ', '  dev ']],
    'log' => ['  error ', 'warning  ']
];

array_walk_recursive($data, function(&$v) {
    $v = trim($v);
});
/* 输出：
[
    'user' => ['name' => 'John', 'tags' => ['php','dev']],
    'log' => ['error','warning']
]
*/

在这个复杂场景中，我们有一个包含嵌套数组的多维数组 $data，其中包含一些字符串，这些字符串可能包含多余的空格。我们使用 array_walk_recursive 函数，并提供了一个匿名回调函数。回调函数使用 trim 函数去除每个字符串的首尾空格，实现了对多维数组中所有字符串的清洗。