将两个列表合并为字典形式：array_combine 实战

M66 2025-06-07

在 PHP 中，array_combine() 函数非常适合将两个数组合并成一个关联数组（即字典）。这个函数接收两个参数：第一个是键数组，第二个是值数组，然后返回一个以第一个数组中的元素作为键，第二个数组中的元素作为值的数组。

函数原型

array_combine(array $keys, array $values): array|false

$keys：键数组，包含了所有用作字典键的元素。
$values：值数组，包含了所有用作字典值的元素。

返回值：

返回一个关联数组，其中 $keys 中的元素作为键，$values 中的元素作为值。
如果两个数组的元素数量不相等，或者其中一个数组为空，则函数返回 false。

实战示例

假设我们有两个列表，一个包含学生的名字，另一个包含学生的成绩，我们希望将它们合并成一个字典，方便查询每个学生的成绩。

<?php

// 学生名字数组
$students = ['Alice', 'Bob', 'Charlie', 'David'];

// 学生成绩数组
$scores = [85, 92, 78, 88];

// 使用 array_combine 将两个数组合并成一个字典
$student_scores = array_combine($students, $scores);

// 输出结果
if ($student_scores !== false) {
    echo "学生成绩字典:\n";
    print_r($student_scores);
} else {
    echo "数组长度不一致，无法合并！\n";
}

?>

代码解析

我们首先定义了两个数组：$students 存储学生的名字，$scores 存储对应的成绩。
然后使用 array_combine() 将这两个数组合并成一个字典，键是学生的名字，值是学生的成绩。

如果合并成功，返回的是一个关联数组，格式如下：

Array
(
    [Alice] => 85
    [Bob] => 92
    [Charlie] => 78
    [David] => 88
)

如果两个数组的长度不相同，array_combine() 会返回 false，因此我们要检查结果以避免错误。

错误处理与注意事项

数组长度不一致：如果两个数组的长度不同，array_combine() 会返回 false。在实际应用中，我们通常需要先检查数组的长度，或者在调用之前确保它们的长度是相同的。
空数组：如果任意一个数组为空，函数也会返回 false。在处理数据时，请务必确保传入的数组不为空。
键的唯一性：合并后的字典键必须是唯一的。如果有重复的键，后面的值会覆盖前面的值。

示例 2：检查数组长度

为了避免因数组长度不一致导致错误，我们可以在使用 array_combine() 之前，手动检查两个数组的长度：

<?php

$students = ['Alice', 'Bob', 'Charlie', 'David'];
$scores = [85, 92, 78];

// 检查数组长度是否一致
if (count($students) === count($scores)) {
    $student_scores = array_combine($students, $scores);
    print_r($student_scores);
} else {
    echo "学生名单与成绩列表长度不一致，无法合并！\n";
}

?>

常见应用场景

配对数据：当你需要将两个相关的数组（如名字和电话号码）配对时，array_combine() 是一个非常高效的工具。
表单处理：在接收表单数据时，可能会有一个字段名称数组和一个字段值数组，你可以使用 array_combine() 来合并它们，形成一个便于操作的关联数组。

小结

array_combine() 函数非常适合将两个一一对应的数组合并成一个关联数组（字典），常用于配对数据、表单处理等场景。在使用时，要确保两个数组的长度一致，否则函数会返回 false，并且确保键是唯一的。

array_combine