自定义WooCommerce支付网关表单验证：无法获取POST数据

问题根源 #

你遇到的POST数据获取不到的问题，核心原因有两个：

• WooCommerce支付网关的表单字段需要带上网关ID作为前缀，否则字段不会被正确纳入提交的表单数据集合
• 直接调用原生$_POST数组存在安全风险，且WooCommerce有自己的表单数据处理机制，直接读取可能无法拿到正确值

修复步骤 #

1. 修改表单字段的name属性 #

在payment_fields()方法里，给所有表单输入框的name属性加上网关ID前缀（$this->id），确保字段能被WooCommerce正确捕获：

public function payment_fields(){
    echo '<fieldset id="wc-' . esc_attr( $this->id ) . '-cc-form">';

    echo 
        "<div class='pb-card-form'>
            <div class='pb-card-form-top'>
                <label for='card-number'>Credit Card Number</label>
                <input id='pb-card-number' type='number' name='" . esc_attr( $this->id ) . "_card-number'>
            </div>

            <div class='pb-card-form-bottom'>
                <div class='pb-card-form-expiry'>
                    <label for='card-expiry'>Expiry Date</label>
                    <input id='pb-card-expiry' type='text' name='" . esc_attr( $this->id ) . "_card-expiry' placeholder='MM/YY'>
                </div>
                <span class='pb-card-bottom-spacer'></span>
                <div class='pb-card-form-ccv'>
                    <label for='card-ccv'>CCV</label>
                    <input id='pb-card-ccv' type='number' name='" . esc_attr( $this->id ) . "_card-ccv'>
                </div>
            </div>
        </div>";

    echo '</fieldset>';
}

2. 正确获取并验证表单数据 #

在validate_fields()方法里，使用WooCommerce提供的WC()->checkout->get_posted_data()来安全获取提交的数据，同时添加必要的验证逻辑：

public function validate_fields(){
    // 获取提交的表单数据
    $posted_data = WC()->checkout->get_posted_data();
    $card_expiry = isset( $posted_data[ $this->id . '_card-expiry' ] ) ? sanitize_text_field( $posted_data[ $this->id . '_card-expiry' ] ) : '';

    // 验证有效期是否为空
    if( empty( $card_expiry ) ){
        wc_add_notice( '请填写银行卡有效期', 'error' );
        return false;
    }

    // 验证有效期格式是否为MM/YY
    if( ! preg_match( '/^(0[1-9]|1[0-2])\/\d{2}$/', $card_expiry ) ){
        wc_add_notice( '银行卡有效期格式错误，请输入MM/YY格式', 'error' );
        return false;
    }

    // 卡号验证
    $card_number = isset( $posted_data[ $this->id . '_card-number' ] ) ? sanitize_text_field( $posted_data[ $this->id . '_card-number' ] ) : '';
    if( empty( $card_number ) || strlen( $card_number ) < 16 ){
        wc_add_notice( '请输入有效的银行卡号', 'error' );
        return false;
    }

    // CCV验证
    $card_ccv = isset( $posted_data[ $this->id . '_card-ccv' ] ) ? sanitize_text_field( $posted_data[ $this->id . '_card-ccv' ] ) : '';
    if( empty( $card_ccv ) || strlen( $card_ccv ) < 3 ){
        wc_add_notice( '请输入有效的CCV码', 'error' );
        return false;
    }

    return true;
}

额外说明 #

• 始终使用esc_attr()、sanitize_text_field()等方法处理输出和输入数据，避免XSS安全漏洞
• 表单字段的ID可以保持不变，但name必须带网关ID前缀，这是WooCommerce支付网关的规范要求
• 验证逻辑可以根据支付接口的要求进一步细化，比如银行卡号的Luhn算法校验、有效期是否过期等

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