如何用单个update_post_meta函数批量保存WordPress自定义字段？

我在WordPress订单与订阅管理页面，通过foreach循环生成了多个带唯一ID的输入框（格式如san_agreement_number_1、san_agreement_number_2……），输入框数量不固定，需要点击“更新”按钮时将所有输入框内容全部保存。

当前硬编码方案（不合理） #

目前使用硬编码的方式调用update_post_meta保存自定义字段，代码如下：

add_action( 'post_updated', 'sab_save_service_agreement_numbers' );
function sab_save_service_agreement_numbers( $order_id ){
    update_post_meta( $order_id, 'san_agreement_number_1', wc_clean( $_POST[ 'san_agreement_number_1' ] ) );
    update_post_meta( $order_id, 'san_agreement_number_2', wc_clean( $_POST[ 'san_agreement_number_2' ] ) );
    update_post_meta( $order_id, 'san_agreement_number_3', wc_clean( $_POST[ 'san_agreement_number_3' ] ) );
    update_post_meta( $order_id, 'san_agreement_number_4', wc_clean( $_POST[ 'san_agreement_number_4' ] ) );
    update_post_meta( $order_id, 'san_agreement_number_5', wc_clean( $_POST[ 'san_agreement_number_5' ] ) );
}

这种方式明显不合理，因为输入框的数量可能是任意的，无法提前预判。

尝试的无效方案 #

我尝试过以下代码，但只能保存最后一个自定义字段，无法动态保存所有字段：

$san_count = 1;

add_action( 'post_updated', 'sab_save_service_agreement_numbers' );
function sab_save_service_agreement_numbers( $order_id ){
    update_post_meta( $order_id, 'san_agreement_number_$san_count', wc_clean( $_POST[ 'san_agreement_number_$san_count' ] ) );
    
    ++$san_count;
}

最优批量更新方案 #

方案一：遍历POST数据匹配字段前缀 #

直接遍历$_POST数组，筛选出以san_agreement_number_开头的字段，同时清理旧的元数据避免残留：

add_action( 'post_updated', 'sab_save_service_agreement_numbers' );
function sab_save_service_agreement_numbers( $order_id ) {
    // 清理所有旧的协议号元数据，防止残留过期字段
    $existing_meta = get_post_meta( $order_id );
    foreach ( $existing_meta as $meta_key => $meta_value ) {
        if ( str_starts_with( $meta_key, 'san_agreement_number_' ) ) {
            delete_post_meta( $order_id, $meta_key );
        }
    }

    // 遍历POST数据，保存新的协议号
    if ( ! empty( $_POST ) ) {
        foreach ( $_POST as $key => $value ) {
            if ( str_starts_with( $key, 'san_agreement_number_' ) ) {
                $clean_value = wc_clean( $value );
                if ( ! empty( $clean_value ) ) {
                    update_post_meta( $order_id, $key, $clean_value );
                }
            }
        }
    }
}

方案二：使用数组形式命名输入框（更推荐） #

生成输入框时改用数组格式的name属性，这样处理逻辑更清晰，也更符合表单规范：

生成输入框的代码示例

// 假设$items是循环的数据源
foreach ( $items as $index => $item ) {
    // 获取已保存的协议号
    $agreement_number = get_post_meta( $order_id, 'san_agreement_number_' . ( $index + 1 ), true );
    // 使用数组形式的name属性
    echo '<input type="text" name="san_agreement_numbers[]" value="' . esc_attr( $agreement_number ) . '" />';
}

保存字段的代码示例

add_action( 'post_updated', 'sab_save_service_agreement_numbers' );
function sab_save_service_agreement_numbers( $order_id ) {
    // 清理旧的协议号元数据
    $existing_meta = get_post_meta( $order_id );
    foreach ( $existing_meta as $meta_key => $meta_value ) {
        if ( str_starts_with( $meta_key, 'san_agreement_number_' ) ) {
            delete_post_meta( $order_id, $meta_key );
        }
    }

    // 处理POST中的数组数据
    if ( isset( $_POST['san_agreement_numbers'] ) && is_array( $_POST['san_agreement_numbers'] ) ) {
        foreach ( $_POST['san_agreement_numbers'] as $index => $value ) {
            $clean_value = wc_clean( $value );
            if ( ! empty( $clean_value ) ) {
                update_post_meta( $order_id, 'san_agreement_number_' . ( $index + 1 ), $clean_value );
            }
        }
    }
}

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