添加WooCommerce后台产品自定义字段出现PHP警告求解决

问题分析 #

原有代码在PHP 8.1环境下触发两个警告：

PHP Warning: Undefined variable $post in /home/xxx/public_html/wp-content/themes/flatsome-cobra/functions.php(65) : eval()'d code on line 4
PHP Warning: Attempt to read property "ID" on null in /home/xxx/public_html/wp-content/themes/flatsome-cobra/functions.php(65) : eval()'d code on line 4

核心原因：

1. 依赖全局$post变量的方式，在PHP 8.1更严格的变量检查规则下，钩子触发时$post未初始化就会报错；
2. woocommerce_process_product_meta钩子已被WooCommerce弃用，且直接读取$_POST未做安全校验，不符合现代PHP和WordPress安全规范。

修改步骤及完整代码 #

1. 替换全局变量依赖，确保字段渲染安全 #

在字段渲染函数中，改用get_post()获取当前产品对象，避免依赖全局变量，同时预填已保存的字段值：

2. 替换弃用钩子，增强数据保存安全性 #

使用WooCommerce官方推荐的woocommerce_admin_process_product_object钩子替代旧钩子，直接接收产品对象操作元数据，同时添加输入过滤。

完整修改后代码 #

<?php
// Add custom Theme Functions here

// Display Fields
add_action('woocommerce_product_options_inventory_product_data', 'woocommerce_product_custom_fields');
 
// Save Fields - 使用WooCommerce最新钩子
add_action('woocommerce_admin_process_product_object', 'woocommerce_product_custom_fields_save');
 
 
function woocommerce_product_custom_fields()
{
    // 获取当前产品对象，避免依赖全局变量
    $post = get_post();
    if (!$post || $post->post_type !== 'product') return;

    echo '<div class="product_custom_field">';
    // Custom Part Number Text Field
    woocommerce_wp_text_input(
        array(
            'id' => '_part_number',
            'placeholder' => 'Part Number (Short SKU)',
            'label' => __('Part Number', 'woocommerce'),
            'desc_tip' => true,
            'value' => get_post_meta($post->ID, '_part_number', true)
        )
    );
    // Custom Part Ref Text Field
    woocommerce_wp_text_input(
        array(
            'id' => '_part_ref',
            'placeholder' => 'Part Ref (Schematic Ref)',
            'label' => __('Part Ref', 'woocommerce'),
            'desc_tip' => true,
            'value' => get_post_meta($post->ID, '_part_ref', true)
        )
    );
    echo '</div>';
 
}

function woocommerce_product_custom_fields_save($product)
{
    // Custom Part Number Text Field
    if (isset($_POST['_part_number'])) {
        $part_number = sanitize_text_field($_POST['_part_number']);
        $product->update_meta_data('_part_number', $part_number);
    } else {
        $product->delete_meta_data('_part_number');
    }

    // Custom Part Ref Text Field
    if (isset($_POST['_part_ref'])) {
        $part_ref = sanitize_text_field($_POST['_part_ref']);
        $product->update_meta_data('_part_ref', $part_ref);
    } else {
        $product->delete_meta_data('_part_ref');
    }
}

关键优化点 #

• 移除全局$post依赖，改用get_post()确保变量有效性，彻底解决PHP 8.1的未定义变量警告；
• 替换弃用钩子为官方最新钩子，保证代码兼容未来WooCommerce版本；
• 添加sanitize_text_field()过滤用户输入，避免XSS安全风险；
• 处理空值场景，字段为空时自动删除对应元数据，保持数据库清洁。

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