1. 理解复杂嵌套数组结构
在PHP开发中，我们经常会遇到包含多层嵌套的数组结构。例如，以下是一个典型的数组示例，其中包含多组数据，每组数据又是一个包含多个键值对的子数组：
$dataArray = [
0 => [
"data" => [
0 => ["id_data" => "P-1234", "name_data" => "data 0 warga 1"],
1 => ["id_data" => "P-1235", "name_data" => "data 0 warga 2"]
]
],
1 => [
"data" => [
0 => ["id_data" => "O-1134", "name_data" => "data 1 warga 1"],
1 => ["id_data" => "O-1135", "name_data" => "data 1 warga 2"],
2 => ["id_data" => "O-1136", "name_data" => "data 1 warga 3"],
]
]
];我们的目标是从这个 $dataArray 中查找 id_data 为 "O-1135" 的完整记录。直接遍历所有层级会使代码变得复杂且效率低下。
2. 核心查找策略：array_column与array_search的结合
为了高效地在上述复杂结构中查找数据，我们可以利用PHP的内置函数array_column和array_search。
- array_column(array $array, mixed $column_key, mixed $index_key = null): array: 此函数返回输入数组中指定列的值。它可以将多维数组中的某一列提取出来，形成一个一维数组。
- array_search(mixed $needle, array $haystack, bool $strict = false): mixed: 此函数在数组中搜索给定的值，如果成功则返回相应的键名，否则返回 false。
通过结合这两个函数，我们可以先将目标子数组中的特定列（例如 id_data）提取出来，然后在这个一维列中快速查找目标值。
立即学习“PHP免费学习笔记（深入）”；
3. 实现数据查找函数
下面是实现数据查找功能的PHP函数及其使用示例：
[
"data" => [
0 => ["id_data" => "P-1234", "name_data" => "data 0 warga 1"],
1 => ["id_data" => "P-1235", "name_data" => "data 0 warga 2"]
]
],
1 => [
"data" => [
0 => ["id_data" => "O-1134", "name_data" => "data 1 warga 1"],
1 => ["id_data" => "O-1135", "name_data" => "data 1 warga 2"],
2 => ["id_data" => "O-1136", "name_data" => "data 1 warga 3"],
]
]
];
/**
* 在嵌套数组中查找指定键值的记录
*
* @param array $arr 待查找的数组
* @param string $findVal 目标值
* @param string $keyToSearch 目标值对应的键名，默认为'id_data'
* @return array|false 如果找到则返回对应的子数组，否则返回false
*/
function find_value_from_nested_array(array $arr, string $findVal, string $keyToSearch = 'id_data')
{
foreach ($arr as $childArr) {
// 检查 'data' 键是否存在且为数组
if (isset($childArr['data']) && is_array($childArr['data'])) {
// 提取 'data' 数组中所有元素的 'id_data' 列
$idDataColumn = array_column($childArr['data'], $keyToSearch);
// 在提取的列中查找目标值
// array_search 返回找到的键名（索引），如果未找到则返回 FALSE
$foundIndex = array_search($findVal, $idDataColumn);
// 严格检查 $foundIndex 是否不为 FALSE
if ($foundIndex !== false) {
// 如果找到，返回对应的完整子数组
return $childArr['data'][$foundIndex];
}
}
}
// 如果遍历完所有子数组都没有找到，则返回 false
return false;
}
// 示例调用
echo "查找 'O-1135':\n";
print_r(find_value_from_nested_array($dataArray, 'O-1135'));
echo "\n查找 'P-1234':\n";
print_r(find_value_from_nested_array($dataArray, 'P-1234'));
echo "\n查找 'NON-EXISTENT':\n";
print_r(find_value_from_nested_array($dataArray, 'NON-EXISTENT'));
?>4. 代码解析
-
函数定义: find_value_from_nested_array($arr, $findVal, $keyToSearch = 'id_data') 接受三个参数：
- $arr: 要搜索的原始嵌套数组。
- $findVal: 要查找的具体值（例如 "O-1135"）。
- $keyToSearch: 可选参数，指定在哪个键名下查找 $findVal，默认为 'id_data'。
- 外层遍历: foreach ($arr as $childArr) 循环遍历 $dataArray 的顶级元素（即 0 => [...] 和 1 => [...]）。
-
内层数据提取:
- if (isset($childArr['data']) && is_array($childArr['data'])): 这一步是必要的安全检查，确保当前 $childArr 包含一个名为 data 的数组，以避免在访问不存在的键时产生错误。
- $idDataColumn = array_column($childArr['data'], $keyToSearch);: 这是核心步骤。对于每个 $childArr 中的 data 子数组，array_column 提取所有 id_data（或 $keyToSearch 指定的键）的值，生成一个类似 ['P-1234', 'P-1235'] 或 ['O-1134', 'O-1135', 'O-1136'] 的一维数组。
-
目标值查找:
- $foundIndex = array_search($findVal, $idDataColumn);: 在上一步生成的一维 $idDataColumn 数组中查找 $findVal。如果找到，$foundIndex 将是该值在 $idDataColumn 中的索引；如果未找到，则为 false。
- if ($foundIndex !== false): 使用严格比较 !== false 是非常重要的，因为 array_search 可能会返回 0（一个有效的索引），而 0 == false 在非严格比较下为真。
- 返回结果: 如果找到，return $childArr['data'][$foundIndex]; 将返回 data 子数组中与 $foundIndex 对应的完整记录。
- 未找到情况: 如果循环结束仍未找到，函数将返回 false。
5. 注意事项与优化
- 严格比较: 在使用 array_search 时，务必使用 !== false 进行严格比较，以避免 0 索引被误判为未找到。
- 键名存在性检查: 在访问 $childArr['data'] 之前，添加 isset($childArr['data']) && is_array($childArr['data']) 这样的检查，可以有效防止因键名不存在或类型不匹配导致的PHP警告或错误。
- 性能考量: 对于非常庞大的数据集，每次循环都调用 array_column 会有性能开销。如果数组结构更深或者查找条件更复杂，可能需要考虑递归函数或使用 array_filter 结合匿名函数进行更灵活的查找。然而，对于本例所示的两层嵌套结构，此方法已足够高效。
- 灵活性: 将 keyToSearch 作为函数参数，使得该函数可以灵活地根据不同的键名进行查找，增强了其复用性。
- 返回结果: 此函数返回找到的第一个匹配项。如果需要查找所有匹配项，则需要修改函数逻辑，例如将所有匹配项收集到一个数组中并返回。
6. 总结
通过巧妙地结合使用 array_column 和 array_search，我们可以高效且优雅地在PHP的复杂嵌套数组中查找特定数据。这种方法避免了深层嵌套循环的复杂性，提高了代码的可读性和维护性。理解并掌握这种查找策略，对于处理日常PHP开发中的数据结构操作至关重要。
