如何在WordPress的add_meta_boxes中复用全局自定义字段数组？

你遇到的全局数组无法调用的问题，大概率是变量加载顺序冲突或者全局变量的使用不规范导致的——直接在全局作用域定义的变量，可能会因为WordPress的钩子执行机制、代码加载顺序，或者被其他主题/插件的代码意外覆盖，导致函数执行时变量未初始化。

下面给你两种可靠的复用方案，优先推荐第二种（函数封装），更符合WordPress的开发规范：

方案一：修正全局变量的使用方式 #

确保数组定义在所有函数和钩子注册之前，并且在需要的函数里正确声明全局变量：

// Step1. 自定义字段数组 - 必须放在所有函数/钩子注册之前
$cf_media = array( 'cf_apple' => 'apple', 'cf_banana' => 'banana' );
$cf_service = array( 'cf_apple' => 'apple', 'cf_melon' => 'melon' );

// Step2. 设置自定义字段
function adding_custom_meta_boxes($post_type, $post) {
    switch ($post_type) {
        case 'media':
            global $cf_media; // 明确声明使用全局变量
            add_meta_box( 'meta_info', 'media area', 'create_cf', 'media', 'normal', 'high', $cf_media );
            break;
        case 'service':
            global $cf_service; // 明确声明使用全局变量
            add_meta_box( 'meta_info', 'service area', 'create_cf', 'service', 'normal', 'high', $cf_service );
            break;
        default:
            break;
    }
}
add_action('add_meta_boxes', 'adding_custom_meta_boxes', 10, 2);

// Step3. 输入区域显示（无需修改）
function create_cf($post, $box) {
    foreach( $box['args'] as $keyname=>$k ) {
        $get_value = esc_html( get_post_meta( $post->ID, $keyname, true ) );
        wp_nonce_field( 'action-' . $keyname, 'nonce-' . $keyname );
        echo '<label for="' . $keyname . '">' . $k . '</label><br>';
        echo '<input name="' . $keyname . '" value="' . $get_value . '" style="width: 100%;">';
    }
}

// Step4. 自定义字段保存处理
function save_meta_field( $post_id ) {
    // 复用全局数组，提取需要处理的字段键名
    global $cf_media, $cf_service;
    $cf_all = array_unique(array_merge(array_keys($cf_media), array_keys($cf_service)));
    
    foreach( $cf_all as $d ) {
        // 优化安全验证逻辑，符合WordPress规范
        if ( isset( $_POST['nonce-' . $d] ) && wp_verify_nonce( $_POST['nonce-' . $d], 'action-' . $d ) ) {
            $value = isset( $_POST[$d] ) ? sanitize_text_field($_POST[$d]) : '';
            update_post_meta( $post_id, $d, $value );
        }
    }
}
add_action( 'save_post', 'save_meta_field' );

方案二：用函数封装数组（推荐） #

全局变量容易引发命名冲突或加载顺序问题，更优雅的方式是把数组封装成函数，需要时直接调用获取：

// Step1. 封装数组为可复用的函数
function get_cf_media_fields() {
    return array( 
        'cf_apple' => 'apple', 
        'cf_banana' => 'banana' 
    );
}

function get_cf_service_fields() {
    return array( 
        'cf_apple' => 'apple', 
        'cf_melon' => 'melon' 
    );
}

// Step2. 设置自定义字段
function adding_custom_meta_boxes($post_type, $post) {
    switch ($post_type) {
        case 'media':
            $cf_media = get_cf_media_fields();
            add_meta_box( 'meta_info', 'media area', 'create_cf', 'media', 'normal', 'high', $cf_media );
            break;
        case 'service':
            $cf_service = get_cf_service_fields();
            add_meta_box( 'meta_info', 'service area', 'create_cf', 'service', 'normal', 'high', $cf_service );
            break;
        default:
            break;
    }
}
add_action('add_meta_boxes', 'adding_custom_meta_boxes', 10, 2);

// Step3. 输入区域显示（无需修改）
function create_cf($post, $box) {
    foreach( $box['args'] as $keyname=>$k ) {
        $get_value = esc_html( get_post_meta( $post->ID, $keyname, true ) );
        wp_nonce_field( 'action-' . $keyname, 'nonce-' . $keyname );
        echo '<label for="' . $keyname . '">' . $k . '</label><br>';
        echo '<input name="' . $keyname . '" value="' . $get_value . '" style="width: 100%;">';
    }
}

// Step4. 自定义字段保存处理
function save_meta_field( $post_id ) {
    // 复用函数返回的数组，提取字段键名
    $cf_media = get_cf_media_fields();
    $cf_service = get_cf_service_fields();
    $cf_all = array_unique(array_merge(array_keys($cf_media), array_keys($cf_service)));
    
    foreach( $cf_all as $d ) {
        if ( isset( $_POST['nonce-' . $d] ) && wp_verify_nonce( $_POST['nonce-' . $d], 'action-' . $d ) ) {
            $value = isset( $_POST[$d] ) ? sanitize_text_field($_POST[$d]) : '';
            update_post_meta( $post_id, $d, $value );
        }
    }
}
add_action( 'save_post', 'save_meta_field' );

这种方式的优势：

• 避免全局变量污染，不会和其他代码的变量命名冲突
• 无需担心加载顺序，函数在调用时才执行，确保数组始终可用
• 后期修改字段时，只需要修改对应的函数即可，维护更便捷

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