如何优化展示WooCommerce商品自定义字段的PHP代码

你提供的代码重复逻辑过多，后续新增字段维护成本很高，优化方案核心是将字段配置和输出逻辑拆分，具体优化后的代码如下：

function show_product_custom_fields() {
    global $product;
    // 自定义字段配置：数组键为后台自定义字段的元数据key，值为前端展示的标签，新增字段仅需在此处追加配置
    $custom_fields = [
        'storage'             => '存储容量',
        'delivery_date'       => '配送日期',
        'mpn'                 => '厂商产品编号',
        'color'               => '颜色',
        'sizes_available'     => '可选尺寸',
        'country_of_origin'   => '产地',
        // 后续新增字段直接按照上方格式添加一行即可，无需修改其他代码
    ];

    $product_id = $product->get_id();
    foreach ($custom_fields as $meta_key => $label) {
        $value = get_post_meta($product_id, $meta_key, true);
        if (!empty($value)) {
            echo '<div>' . esc_html($label) . ': ' . esc_html($value) . '</div>';
        }
    }
}
add_action( 'woocommerce_after_shop_loop_item', 'show_product_custom_fields', 10 );

如果你需要保留英文展示标签，直接修改$custom_fields数组里的标签值即可。

优化说明 #

• 字段配置统一管理：所有字段的元数据标识和展示标签都集中在$custom_fields数组中，后续新增字段只需要加一行配置，不用重复写获取、判断、输出的逻辑，扩展性极强
• 兼容高版本WooCommerce：替换了原代码中直接访问$product->id属性的写法，改用官方推荐的$product->get_id()方法，避免高版本WooCommerce下的报错
• 修复语法错误：原代码中Manufacturer's product number的单引号没有转义，会直接触发PHP语法错误，优化后已经处理
• 安全性提升：新增esc_html()转义输出逻辑，避免自定义字段内容包含恶意代码导致的XSS安全问题
• 代码精简：整体代码量大幅减少，逻辑清晰，排查问题更方便

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