如何在WooCommerce结账页实现仅访客用户的姓氏字段唯一性校验

现有代码问题说明 #

• 钩子使用错误：当前挂载的woocommerce_before_checkout_billing_form是表单渲染前置钩子，不支持校验逻辑执行，需使用WooCommerce专用的结账校验钩子
• 回调函数名不匹配：钩子注册时填写的回调函数名为lastname_field，实际定义的函数名为validate_lastname_field，二者完全不对应，逻辑无法触发
• 缺少访客判断逻辑：未做登录状态校验，会对已登录用户也触发重复校验，不符合需求
• 存在SQL注入风险：直接将未处理的POST参数拼接进SQL语句，有安全隐患
• 表前缀写死：代码中固定写死abc_usermeta表名，换用不同表前缀的站点会直接查询失败
• 缺少空值判断：用户未填写姓氏时也会执行无效查询

修复后可用代码 #

add_action( 'woocommerce_after_checkout_validation', 'validate_unique_billing_lastname_for_guests', 10, 2 );
function validate_unique_billing_lastname_for_guests( $data, $errors ) {
    global $wpdb;

    // 仅对未登录访客生效，已登录用户跳过校验
    if ( is_user_logged_in() ) {
        return;
    }

    // 读取提交的姓氏并做非空校验
    $lastname = trim( $data['billing_last_name'] ?? '' );
    if ( empty( $lastname ) ) {
        return;
    }

    // 安全查询是否存在重复姓氏
    $is_exist = $wpdb->get_var( $wpdb->prepare(
        "SELECT COUNT(user_id) FROM {$wpdb->usermeta} WHERE meta_key = %s AND meta_value = %s",
        'billing_last_name',
        $lastname
    ) );

    // 重复则抛出错误提示
    if ( $is_exist > 0 ) {
        $errors->add( 'billing_last_name_error', __( '该姓氏已存在，请更换后提交', 'woocommerce' ) );
    }
}

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