如何在 WooCommerce 单产品页中合并多个函数变量并统一输出

本文介绍在 woocommerce `woocommerce_single_product_summary` 钩子中，如何安全、高效地合并多个函数生成的变量（如 `$var1` 和 `$var2`），并在同一 html 元素中输出，避免重复钩子调用与作用域问题。

在 WooCommerce 主题开发中，常需在商品摘要区（如标题下方）动态展示组合信息（例如价格标签 + 库存状态 + 自定义字段）。若将逻辑拆分为多个独立函数并分别挂载到同一钩子（如 woocommerce_single_product_summary），会因 PHP 函数作用域隔离导致变量无法互通——function1 中定义的 $var1 在 function2 中不可访问，直接拼接

text.$var1.$var2. 会失败。

推荐方案：使用单一回调函数 + 后端变量聚合
与其依赖钩子顺序或全局变量（易引发冲突、难维护），不如将所有逻辑整合进一个函数，并在其中完成变量计算与统一渲染：

add_action( 'woocommerce_single_product_summary', 'display_merged_product_info', 7 );

function display_merged_product_info() {
    global $product;

    // 获取基础变量（示例：自定义字段 + 动态计算值）
    $var1 = get_post_meta( $product->get_id(), '_custom_field_1', true ) ?: 'N/A';
    $var2 = wc_get_stock_html( $product ); // 或其他函数返回值

    // 安全输出：转义内容，防止 XSS
    $output = sprintf(
        '文本：%s — %s',
        esc_html( $var1 ),
        esc_html( $var2 )
    );

    echo $output;
}

✅ 优势说明：

• 作用域可控：所有变量在函数内声明，天然可组合；
• 性能更优：仅一次钩子执行，减少重复查询（如多次 get_post_meta）；
• 安全可靠：使用 esc_html() 等函数过滤输出，符合 WordPress 安全规范；
• 可扩展性强：新增变量只需在函数内追加逻辑，无需新增钩子。

⚠️ 注意事项：

• 若变量来源涉及数据库查询（如 get_post_meta），请确保键名正确且已存在，建议配合 ?: 提供默认值；
• 避免在钩子中执行耗时操作（如远程 API 调用），否则影响页面加载性能；
• 如需复用逻辑，可将变量获取封装为独立函数（如 get_merged_vars()），再由主回调调用，保持职责分离。

综上，合并输出的核心不是“共享变量”，而是统一入口、集中处理。通过单个 add_action 回调完成数据采集、加工与渲染，既简洁又健壮，是 WooCommerce 开发中的最佳实践。