如何便捷向ACF嵌套分组字段批量插入数据？

问题背景 #

用wp_insert_post创建institution类型文章时，直接传入ACF分组字段的数组（比如primary_info）无法填充嵌套子字段，只有普通字段（如author）能正常生效。虽然手动指定primary_info_full_name这种拼接后的键可以解决，但分组内字段多的话操作太麻烦，需要更高效的实现方式。

原无效代码 #

$post_field = get_fields($id);

$result = wp_insert_post([
    "post_type"   => "institution",
    "post_title"  => get_post($id)->post_title,
    "post_status" => "publish",
    "meta_input"  => [
        "author"       => $post_field["author"],
        "primary_info" => $post_field["primary_info"],
    ],
]);

其中$post_field["primary_info"]的结构：

$post_field["primary_info"] = [
    "full_name" => "name",
    "short_name" => "short_name",
];

手动指定键的繁琐有效写法 #

'meta_input' => array(
    'author'                  => $post_field['author'],
    'primary_info_full_name'  => 'name'
),

高效解决方案 #

ACF分组字段在数据库中是以{分组键}_{子字段键}的格式存储元数据的，以下几种方法可以批量处理：

方法1：手动遍历分组转换键名 #

适合单个分组的快速处理：

$post_field = get_fields($id);

// 初始化基础元数据
$meta_input = [
    "author" => $post_field["author"],
];

// 遍历primary_info分组，拼接键名后加入meta_input
$group_key = 'primary_info';
foreach ($post_field[$group_key] as $sub_key => $value) {
    $meta_input["{$group_key}_{$sub_key}"] = $value;
}

// 创建文章
$result = wp_insert_post([
    "post_type"   => "institution",
    "post_title"  => get_post($id)->post_title,
    "post_status" => "publish",
    "meta_input"  => $meta_input,
]);

方法2：通用分组转换函数（支持多分组） #

如果有多个分组需要处理，封装通用函数更省心：

// 转换ACF分组为meta键值对的工具函数
function convert_acf_group_to_meta($group_key, $group_data) {
    $meta_pairs = [];
    foreach ($group_data as $sub_key => $value) {
        $meta_pairs["{$group_key}_{$sub_key}"] = $value;
    }
    return $meta_pairs;
}

// 使用示例
$post_field = get_fields($id);

$meta_input = [
    "author" => $post_field["author"],
    // 合并primary_info分组的转换结果
    ...convert_acf_group_to_meta('primary_info', $post_field['primary_info']),
    // 有其他分组的话直接追加
    // ...convert_acf_group_to_meta('contact_info', $post_field['contact_info']),
];

$result = wp_insert_post([
    "post_type"   => "institution",
    "post_title"  => get_post($id)->post_title,
    "post_status" => "publish",
    "meta_input"  => $meta_input,
]);

方法3：用ACF内置update_field函数（最简洁） #

创建文章后，直接用ACF的update_field函数填充分组字段，不需要手动处理键名：

// 先创建基础文章
$result = wp_insert_post([
    "post_type"   => "institution",
    "post_title"  => get_post($id)->post_title,
    "post_status" => "publish",
    "meta_input"  => [
        "author" => $post_field["author"],
    ],
]);

// 文章创建成功后，用ACF函数填充分组字段
if ($result) {
    update_field('primary_info', $post_field['primary_info'], $result);
}

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