如何在 PHP 中动态构建并过滤多维子数组，移除空值项

本文介绍如何在 php 中安全地构建包含多个子数组的嵌套结构，并通过条件判断精准剔除未初始化或为空的子数组项，避免生成无效键（如空字符串键 `””`）和 `NULL` 值，确保最终 json 输出结构干净、符合预期。

在处理数据库查询结果并按类型分组构建多维数组时，一个常见问题是：当某类数据（如 id_tipo_profissional == 2）在当前查询结果中完全不存在时，其对应变量（如 $id_tipo_profissional_2、$profissionais_2）未被赋值或为 null，但后续仍被强行写入最终数组——导致出现 “”: { … } 这样的非法空键及 null 字段，破坏 jsON 结构的语义完整性与前端解析稳定性。

根本原因在于原代码使用了无条件构造 + array_filter() 后置过滤的方式：

$resultado = array_filter([     "tipo" => [         $id_tipo_profissional_1 => [ /* ... */ ],         $id_tipo_profissional_2 => [ /* ... */ ],     ], ]);

⚠️ 注意：array_filter() 默认仅过滤值为 falsy 的元素（如 null, false, 0, “”, []），但此处的问题是键名本身为 “”（空字符串），而该键对应的值（如 [‘id_tipo_profissional’ => null, …]）可能因 php 类型转换未被彻底判定为 falsy（尤其当数组含 null 但非空时），导致空键残留。

✅ 正确解法是：前置条件校验 + 动态构建，即只在数据真正有效时才向目标数组添加对应条目。

立即学习“PHP免费学习笔记（深入）”；

以下是优化后的完整逻辑（兼容 PHP 7.4+，兼顾可读性与健壮性）：

// 初始化主容器 $resultado = ['tipo' => []];  // 处理类型 1（需确保 $profissionais_1 已声明且非空，或至少 $id_tipo_profissional_1 有效） if (isset($id_tipo_profissional_1) && $id_tipo_profissional_1 !== '') {     $resultado['tipo'][$id_tipo_profissional_1] = [         'id_tipo_profissional'      => $id_tipo_profissional_1,         'nome_tipo_profissional'    => $tipo_profissional_1,         'profissionais'             => $profissionais_1 ?? []     ]; }  // 处理类型 2（同理） if (isset($id_tipo_profissional_2) && $id_tipo_profissional_2 !== '') {     $resultado['tipo'][$id_tipo_profissional_2] = [         'id_tipo_profissional'      => $id_tipo_profissional_2,         'nome_tipo_profissional'    => $tipo_profissional_2,         'profissionais'             => $profissionais_2 ?? []     ]; }  // 可选：进一步清理空 profissionais 数组（若业务要求“无人员则不保留该类型”） foreach ($resultado['tipo'] as $key => &$item) {     if (empty($item['profissionais'])) {         unset($resultado['tipo'][$key]);     } } unset($item); // 解除引用  return json_encode($resultado, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);

? 关键改进点说明：

• ✅ 使用 isset() + 显式非空判断，避免未定义变量触发 Notice；
• ✅ ?? [] 提供安全默认值，防止 profissionais_* 未定义导致 null；
• ✅ empty($item[‘profissionais’]) 可选二次过滤：若某类型下无任何专业人员，则彻底移除该类型节点（更贴近真实业务场景）；
• ✅ JSON_UNESCAPED_UNICODE 确保中文不被转义，JSON_PRETTY_PRINT 便于调试（上线前可移除）。

? 进阶建议：
对于更多类型（如 3, 4…），推荐将逻辑抽象为循环或映射配置，避免重复 if 块。例如：

$types = [     '1' => [&$id_tipo_profissional_1, &$tipo_profissional_1, &$profissionais_1],     '2' => [&$id_tipo_profissional_2, &$tipo_profissional_2, &$profissionais_2], ]; foreach ($types as $id => [$idRef, $nameRef, $profsRef]) {     if (isset($idRef) && $idRef == $id) {         $resultado['tipo'][$id] = [             'id_tipo_profissional'   => $idRef,             'nome_tipo_profissional' => $nameRef,             'profissionais'          => $profsRef ?? []         ];     } }

这样既保持扩展性，又消除冗余代码。最终输出将严格匹配期望结构——无空键、无 null 字段、语义清晰，为前后端协作奠定坚实基础。