本文介绍如何使用 PHP 对深度嵌套的二维（及以上）数组进行结构化降维，精准提取所有子项中的 text 字段值，并保留原始层级关系，支持纯值数组或键值对格式输出。
本文介绍如何使用 php 对深度嵌套的二维（及以上）数组进行结构化降维，精准提取所有子项中的 `text` 字段值，并保留原始层级关系，支持纯值数组或键值对格式输出。
在处理 OCR 解析、PDF 表格提取或 JSON 转换后的结构化数据时，常遇到类似多层嵌套的 PHP 数组——如 ['data'][0][0]['text'] 这类路径。目标往往不是保留全部元信息（如 top、left、width 等布局属性），而是仅提取并扁平化文本内容，同时维持其逻辑分组（例如每行一组、每列一组）。此时，手动遍历 foreach 不仅冗长易错，也难以复用；而 array_column() 等内置函数又无法直接穿透多维结构。
为此，我们推荐一个简洁、健壮且可复用的工具函数 getColumns()：
function getColumns(array $data, string $key, bool $keyStatus = false): array
{
return array_map(function ($items) use ($key, $keyStatus) {
if (is_array($items)) {
return !$keyStatus
? array_column($items, $key) // 返回纯值数组：[0 => '', 1 => 'Monday', ...]
: array_map(function ($item) use ($key) {
return [$key => $item[$key] ?? '']; // 返回键值对数组：[['text' => ''], ['text' => 'Monday'], ...]
}, $items);
}
return [];
}, $data);
}✅ 使用方式
假设原始数据存储在变量 $array 中，且目标数据位于 $array['data']（即第一级索引为 'data' 的子数组）：
-
提取为带
text键的关联子数组（匹配你期望的最终结构）：立即学习“PHP免费学习笔记（深入）”；
$result = getColumns($array['data'], 'text', true); print_r($result);
-
提取为纯文本值数组（更轻量、适合后续
implode()或 CSV 导出）：$texts = getColumns($array['data'], 'text'); // $keyStatus 默认 false print_r($texts);
⚠️ 注意事项
-
空值安全：函数内部使用
$item[$key] ?? ''，确保即使某子项缺失text键，也不会触发Notice，统一返回空字符串。 -
类型防护：
is_array($items)检查避免对非数组元素（如null、string）调用array_column()导致警告。 -
层级限制：该函数适用于「两层嵌套」场景（即
$data是一维数组，其每个元素是含text键的子数组），恰好覆盖你提供的数据结构（$array['data'][i][j]）。若需处理更深嵌套（如三层以上），应改用递归方案（如array_walk_recursive+ 自定义收集器），但会牺牲结构保真度。 -
性能友好：全程使用
array_map和内置函数，无显式for循环，符合函数式编程习惯，执行效率高。
✅ 总结
getColumns() 并非通用“无限降维”工具，而是针对结构明确、目标字段固定的嵌套数组设计的精准提取器。它以最小代码量达成两个关键目标：
① 剥离无关字段（自动忽略 top/left/width 等）；
② 保持业务分组语义（每一行仍为独立子数组，便于按行渲染表格或生成 Markdown 表格）。
对于你的实际需求——从 PDF 文本坐标数据中提取干净的 text 内容并还原为逻辑行结构——此方案开箱即用、稳定可靠，是比硬编码循环更专业、更可持续的选择。
