本文介绍一种可靠方法：利用 WooCommerce 会话（WC Session）持久化记录用户来源页面，并据此在结账页动态禁用指定支付网关（如 PayPal），避免因页面跳转导致 wp_get_referer() 失效。
本文介绍一种可靠方法：利用 woocommerce 会话（wc session）持久化记录用户来源页面，并据此在结账页动态禁用指定支付网关（如 paypal），避免因页面跳转导致 `wp_get_referer()` 失效。
在 WooCommerce 开发中，有时需实现“条件化支付网关控制”——例如仅当用户从特定页面（如 /send-money/）跳转至结账页时，才隐藏 PayPal 网关；而直接访问结账页或从其他页面进入时仍正常显示。初学者常尝试直接使用 wp_get_referer() 配合 woocommerce_available_payment_gateways 过滤器，但该方式在实际场景中往往失效：因为用户从来源页 → 购物车 → 结账页的多步跳转过程中，wp_get_referer() 在结账页返回的通常是购物车页 URL，而非原始来源页。
✅ 正确解法是借助 WooCommerce 会话系统，在用户首次进入流程时捕获并持久化来源信息。会话数据在用户本次浏览周期内全程可用，不受中间页面干扰。
以下为完整、健壮的实现代码（推荐添加至主题的 functions.php 或自定义插件中）：
add_filter( 'woocommerce_available_payment_gateways', 'dealion_payment_gateway_disable_onpage' );
function dealion_payment_gateway_disable_onpage( $available_gateways ) {
// 后台管理页面不执行逻辑，提升性能与安全性
if ( is_admin() ) {
return $available_gateways;
}
// 检查会话中是否已存储来源标识
if ( null === WC()->session->get( 'dealion_referer' ) ) {
// 首次访问流程：获取并存入当前 referer（即用户上一页）
$referer = wp_get_referer();
WC()->session->set( 'dealion_referer', $referer );
} else {
// 后续步骤（如结账页）直接读取已保存的 referer
$referer = WC()->session->get( 'dealion_referer' );
}
// 精确匹配来源 URL（注意末尾斜杠一致性），并移除 PayPal 网关
if ( isset( $available_gateways['paypal'] ) &&
'https://www.myshop.store/send-money/' === $referer ) {
unset( $available_gateways['paypal'] );
}
return $available_gateways;
}? 关键注意事项：
- ✅ URL 匹配需严格一致：建议使用全路径（含协议、域名、结尾斜杠），避免因重定向或 URL 规范化导致匹配失败。可考虑用
strpos()或parse_url()做模糊匹配（如只校验路径部分/send-money/），增强鲁棒性； - ✅ 会话生命周期：WC Session 默认随浏览器关闭而销毁，符合业务预期；若需跨会话保留，应改用用户元数据或 Cookie（需额外权限与隐私合规处理）；
- ⚠️ 缓存兼容性：若站点启用页面级缓存（如 WP Super Cache、Cloudflare），可能绕过 PHP 执行，导致会话逻辑失效。务必确保结账页（
/checkout/）和来源页被排除在静态缓存之外； - ? 调试技巧：开发阶段可临时添加
error_log( print_r( $referer, true ) );查看实际捕获值，或使用浏览器开发者工具检查 Network 请求中的 Referer Header。
该方案兼顾可靠性与可维护性，是 WooCommerce 条件化网关控制的推荐实践。如需扩展支持多个来源页或多网关规则，只需将判断逻辑升级为数组配置即可。
