问题背景
在 php 开发中，我们经常会遇到需要处理结构复杂的数组数据。例如，当处理文件上传时，$_files 超全局变量通常是一个嵌套数组，其中包含文件名、文件类型、临时路径、错误码和文件大小等信息。如果我们需要根据一个预设的文件名列表来筛选这些上传的文件，并确保所有相关属性（类型、路径等）都同步更新，这就需要一种高效且准确的数组处理方法。
本教程的目标是，给定一个包含目标文件名的简单数组，以及一个包含文件所有详细信息的嵌套数组，我们如何过滤掉嵌套数组中那些文件名不在目标列表中的条目，并保持所有子数组的结构一致性。
解决方案概述
解决此问题通常可以分为以下几个步骤：
- 识别非匹配项的索引： 首先，遍历嵌套数组中作为比较基准的子数组（例如，包含文件名的 name 子数组），找出其中哪些值不在目标简单数组中。记录这些非匹配项的原始索引。
- 移除非匹配项： 遍历嵌套数组中的所有子数组（name、type、tmp_name 等），根据上一步记录的索引，将对应的元素从每个子数组中移除。
- 重新索引： 由于 unset() 操作会留下间隙，破坏数字索引的连续性，因此在移除元素后，需要对每个子数组进行重新索引，确保它们从 0 开始连续排列。
代码实现
下面是实现上述逻辑的 PHP 代码示例：
[
'detail12.docx',
'document.pdf', // 这个文件将不会被匹配
'resume.docx'
],
'type' => [
'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
'application/pdf',
'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
],
'tmp_name' => [
'/tmp/php2LK7xC',
'/tmp/phpTEWqXG', // 这个临时文件路径将不会被匹配
'/tmp/phpAKki0M'
],
'error' => [0, 0, 0],
'size' => [30887, 86118, 30887]
];
// 步骤 1: 识别非匹配项的索引
// 用于存储需要被移除的元素的索引
$indicesToRemove = [];
foreach ($fileDetails['name'] as $index => $fileName) {
// 使用 array_search 检查当前文件名是否在目标列表中
// 如果不在 ($targetFiles 中找不到，返回 false)，则记录其索引
if (array_search($fileName, $targetFiles) === false) {
$indicesToRemove[] = $index;
}
}
// 步骤 2 & 3: 移除非匹配项并重新索引
// 遍历 $fileDetails 中的所有子数组
foreach ($fileDetails as $key => $subArray) {
// 遍历所有需要移除的索引
foreach ($indicesToRemove as $index) {
// 如果当前索引存在于子数组中，则移除它
if (isset($fileDetails[$key][$index])) {
unset($fileDetails[$key][$index]);
}
}
// 移除元素后，使用 array_values() 重新索引当前子数组，确保键的连续性
$fileDetails[$key] = array_values($fileDetails[$key]);
}
// 输出过滤后的结果
echo "过滤后的文件详情:\n";
print_r($fileDetails);
?>代码解析
-
初始化数据：
立即学习“PHP免费学习笔记（深入）”；
- $targetFiles：这是一个简单的索引数组，包含了我们希望保留的文件名。
- $fileDetails：这是一个关联数组，其值是多个索引数组，模拟了 $_FILES 的结构。每个子数组（name, type 等）的相同索引对应着同一个文件的不同属性。
-
识别非匹配项的索引 ($indicesToRemove)：
- $indicesToRemove = [];：初始化一个空数组，用于存储那些在 $fileDetails['name'] 中存在但不在 $targetFiles 中的元素的索引。
- foreach ($fileDetails['name'] as $index => $fileName)：遍历 $fileDetails 数组中的 name 子数组。$index 是当前元素的数字索引，$fileName 是其值。
- if (array_search($fileName, $targetFiles) === false)：这是核心判断逻辑。
- array_search($fileName, $targetFiles) 尝试在 $targetFiles 数组中查找 $fileName。
- 如果找到，array_search 会返回该值在 $targetFiles 中的第一个匹配键（索引）。
- 如果未找到，array_search 返回 false。
- 我们使用 === false 进行严格比较，以确保区分 false 和 0（因为 0 也是一个有效的索引）。
- $indicesToRemove[] = $index;：如果文件名未在 $targetFiles 中找到，则将其原始索引 $index 添加到 $indicesToRemove 数组中。
-
移除非匹配项并重新索引：
- foreach ($fileDetails as $key => $subArray)：遍历 $fileDetails 数组本身。$key 会是 name, type, tmp_name 等，$subArray 是对应的子数组。
- foreach ($indicesToRemove as $index)：对于每个子数组，再次遍历之前收集到的所有需要移除的索引。
- if (isset($fileDetails[$key][$index])) { unset($fileDetails[$key][$index]); }：在当前的子数组 $fileDetails[$key] 中，如果存在对应 $index 的元素，则使用 unset() 函数将其移除。isset() 检查是必要的，以防止尝试删除不存在的键导致警告。
- $fileDetails[$key] = array_values($fileDetails[$key]);：在内层循环结束后（即当前子数组的所有非匹配项都已被移除后），使用 array_values() 函数重新索引该子数组。unset() 操作会移除元素及其键，导致数组索引不连续。array_values() 会创建一个新数组，其中包含原数组的所有值，并重新分配从 0 开始的数字索引，从而恢复数组的连续性。
预期输出
运行上述代码，将得到以下结果：
过滤后的文件详情:
Array
(
[name] => Array
(
[0] => detail12.docx
[1] => resume.docx
)
[type] => Array
(
[0] => application/vnd.openxmlformats-officedocument.wordprocessingml.document
[1] => application/vnd.openxmlformats-officedocument.wordprocessingml.document
)
[tmp_name] => Array
(
[0] => /tmp/php2LK7xC
[1] => /tmp/phpAKki0M
)
[error] => Array
(
[0] => 0
[1] => 0
)
[size] => Array
(
[0] => 30887
[1] => 30887
)
)可以看到，原始 document.pdf 及其所有相关属性（类型、临时路径、错误、大小）都已被正确移除，并且所有子数组的索引都已重新排列。
注意事项与总结
- array_search 的严格比较： 务必使用 === false 进行严格比较，因为 array_search 在找到值时可能返回 0，而 0 == false 在非严格比较下为真，可能导致逻辑错误。
- unset() 的局限性： unset() 只会移除数组元素，但不会重新索引数字键。因此，在需要连续数字索引的场景下，后续使用 array_values() 是非常重要的。
- 性能考量： 对于非常大的数组，多次遍历和 unset() 操作可能会有性能开销。如果性能是关键因素，可以考虑构建一个新的过滤后的数组，而不是在原数组上进行修改，这可能会在某些情况下更高效，但代码复杂度可能略有增加。
- 通用性： 本方法不仅适用于 $_FILES 结构，也适用于任何需要基于一个子数组的匹配条件来同步过滤所有相关子数组的场景。只需将 fileDetails['name'] 替换为你的基准子数组即可。
通过以上步骤，我们能够高效且准确地在 PHP 中实现复杂嵌套数组的条件过滤和数据同步，确保数据的完整性和一致性。
