PHP如何将带层级前缀的字段数组转换为Facebook API所需Graph查询格式

核心转换思路 #

当前选中的列数组全部遵循[实体前缀]_[实体属性]的命名规则，而Facebook要求的查询格式只是把相同实体的属性聚合到一起，不需要逐属性重复标注实体名，整个转换过程可以拆成三步：

• 提前配置好支持的实体前缀、常见列名拼写错误的兜底规则
• 逐列拆分实体和属性，按实体维度归类属性列表
• 把每个实体的属性拼进大括号，最后拼接所有实体片段得到最终查询串

可直接复用的实现代码 #

// 实体配置：包含前缀映射、常见拼写容错规则
$entityConfig = [
    'prefix_map' => [
        'campaign' => 'campaign',
        'adset' => 'adset',
        'ad' => 'ad'
    ],
    // 针对实际开发中常见的列名拼写错误做兜底，比如示例里漏写a的campiagn
    'typo_correction' => [
        'campiagn' => 'campaign'
    ]
];

// 你拿到的前端选中列数组
$columns = ["campaign_start_time", "campiagn_end_time", "campaign_id", "campaign_budget", "adset_name", "ad_name"];

$groupedProps = [];
foreach ($columns as $column) {
    // 拆分列名时限制最多拆2段，避免属性名本身带下划线时拆分错误
    $parts = explode('_', $column, 2);
    $rawPrefix = $parts[0] ?? '';
    $prop = $parts[1] ?? '';

    // 跳过拆分失败的非法列名
    if (empty($prop)) {
        continue;
    }

    // 先纠正拼写错误，拿到规范前缀
    $prefix = $entityConfig['typo_correction'][$rawPrefix] ?? $rawPrefix;
    // 校验当前前缀属于支持的实体
    $entityName = $entityConfig['prefix_map'][$prefix] ?? null;
    if (!$entityName) {
        continue;
    }

    // 用属性值做数组键，天然去重，避免重复属性出现在查询串里
    $groupedProps[$entityName][$prop] = $prop;
}

// 拼接最终查询串
$segments = [];
foreach ($groupedProps as $entity => $props) {
    $segments[] = sprintf('%s{%s}', $entity, implode(',', $props));
}
$query = implode(',', $segments);

运行上述代码，最终生成的$query值和你给出的目标示例完全匹配：
campaign{start_time,end_time,id,budget},adset{name},ad{name}

实际开发注意事项 #

• 拆分列名时必须用explode('_', $column, 2)限制拆分深度，后续如果扩展带下划线的属性名（比如campaign_effective_status），不会出现拆分错误
• 分组存储属性时用属性值作为数组键，可以自动过滤前端重复勾选的同列，避免生成无效的重复参数
• 可以根据Facebook API的文档，在prefix_map里灵活扩展支持的实体类型（比如insight、account），不需要修改核心转换逻辑
• 生产环境建议给每个实体增加允许的属性白名单，遇到不在白名单的属性直接过滤，避免调用API时因为非法参数报错

内容的提问来源于stack exchange，提问作者user14815470