PHP 中合并 FAQ 数据:将成对的问答数组重组为结构化格式

本文介绍如何将第三方 api 返回的扁平化 faq 数据(每个问答分属独立数组项)按逻辑配对,合并为结构清晰的键值对或对象数组,适用于 wordpress 自定义字段等场景。

在处理来自不可控第三方 API 的 FAQ 数据时,常见模式是:同一组问答(如 faq_list_0_question 和 faq_list_0_answer)被拆分为两个独立数组元素,仅通过 meta_key 的命名规则隐含关联关系。此时,我们需要基于 meta_key 的语义结构(如下划线分隔的序号与类型)进行智能分组与合并。

核心思路是:提取每条记录中标识“组别”和“类型”的关键信息,以组别为键、类型为子键,动态构建嵌套结构。以下是两种常用且实用的实现方式:

✅ 方式一:按逻辑组键(如 faq_list_0)分组,保留原始数据结构

适用于需保留 id、post_id 等元信息的场景:

$new_data = [];
foreach ($array['data'] as $item) {
    // 拆分 meta_key,例如 "faq_list_0_question" → ['faq', 'list', '0', 'question']
    $parts = explode('_', $item['meta_key']);

    // 最后一部分是类型(question/answer),倒数第二部分通常是序号(如 '0')
    $type = array_pop($parts);
    $index = array_pop($parts); // 获取序号,如 '0'

    // 重构组键,如 "faq_list_0"
    $groupKey = implode('_', $parts) . '_' . $index;

    // 初始化组(若不存在),并存入对应类型的数据
    if (!isset($new_data[$groupKey])) {
        $new_data[$groupKey] = [];
    }
    $new_data[$groupKey][$type] = $item;
}

// 输出示例(关联数组):
// [
//   "faq_list_0" => [
//     "question" => [...],
//     "answer"   => [...]
//   ]
// ]

✅ 方式二:直接生成扁平化 FAQ 对象数组(推荐用于前端渲染)

更贴近实际业务需求——输出简洁的 FAQ 列表,每项含 id、question、answer 字段:

$new_data = [];
foreach ($array['data'] as $item) {
    $parts = explode('_', $item['meta_key']);
    $type = array_pop($parts);      // 'question' or 'answer'
    $index = array_pop($parts);     // 如 '0', '1', '2'

    // 确保该序号对应的 FAQ 条目已初始化
    if (!isset($new_data[$index])) {
        $new_data[$index] = [
            'id'       => $index,
            'question' => '',
            'answer'   => ''
        ];
    }

    // 根据 type 填充内容(只取 meta_value,更符合展示需求)
    if ($type === 'question') {
        $new_data[$index]['question'] = $item['meta_value'];
    } elseif ($type === 'answer') {
        $new_data[$index]['answer'] = $item['meta_value'];
    }
}

// 转为数值索引数组,确保顺序一致
$faqs = array_values($new_data);

// 输出示例(JSON 可用格式):
// [
//   {
//     "id": "0",
//     "question": "Lorem ipsum...",
//     "answer": "In at neque..."
//   }
// ]

⚠️ 注意事项与最佳实践

  • 健壮性增强:建议在 explode 后校验 $parts 长度,避免因 meta_key 格式异常(如缺失序号)导致逻辑错误;可添加 if (count($parts)
  • 类型安全:使用 in_array($type, ['question', 'answer']) 显式校验,防止意外字段干扰。
  • 排序保障:若 API 返回顺序不保证问答配对(如先返回所有 question 再返回 answer),上述方法仍有效,因为均依赖 index 关联;但若需严格按原始顺序渲染,可额外记录首次出现位置。
  • 扩展性考虑:如未来支持更多字段(如 faq_list_0_image),只需在 if/elseif 中追加分支,无需修改主干逻辑。

通过以上方法,你无需修改上游 API,即可将松散的元数据高效转化为语义明确、易于消费的 FAQ 结构,显著提升前后端协作效率与代码可维护性。