使用CMB2库的WordPress站点如何实现指定自定义字段提交数据加密

完全可以通过CMB2自带的钩子结合WordPress核心的加密能力实现指定字段的加密存储，不需要额外引入第三方依赖，具体实现步骤如下：

前置说明 #

WordPress 5.2及以上版本自带wp_encrypt()、wp_decrypt()加解密函数，会自动调用wp-config.php中预设的安全密钥完成加解密，无需自己管理密钥，安全性符合通用业务要求。

步骤1：梳理需要加密的字段 #

提前整理好所有需要加密的CMB2字段ID，比如收集身份证号的id_card、收集紧急联系人的emergency_contact等，后续逻辑中统一对这些字段做处理。

步骤2：配置字段保存前加密逻辑 #

使用CMB2字段的sanitization_cb参数，自定义保存回调函数，在数据入库前完成加密，示例代码如下：

// 自定义字段加密回调
function custom_cmb2_encrypt_value( $value, $field_args, $field ) {
    // 此处替换为你自己需要加密的字段ID列表
    $need_encrypt_fields = [ 'id_card', 'emergency_contact', 'private_address' ];
    
    // 仅对指定字段非空值加密
    if ( in_array( $field->id(), $need_encrypt_fields ) && ! empty( $value ) ) {
        $value = wp_encrypt( $value );
    }
    return $value;
}

// 注册CMB2字段时添加sanitization_cb参数指定加密回调
$cmb->add_field( [
    'name' => '身份证号',
    'id'   => 'id_card',
    'type' => 'text',
    // 新增这一行即可绑定加密逻辑
    'sanitization_cb' => 'custom_cmb2_encrypt_value',
] );

步骤3：配置字段读取时自动解密 #

加密后的数据直接读取为密文，通过CMB2的cmb2_get_field过滤器实现读取时自动解密，示例代码如下：

add_filter( 'cmb2_get_field', 'custom_cmb2_decrypt_value', 10, 3 );
function custom_cmb2_decrypt_value( $value, $field_id, $object_id ) {
    // 和加密字段列表保持一致
    $need_encrypt_fields = [ 'id_card', 'emergency_contact', 'private_address' ];
    
    if ( in_array( $field_id, $need_encrypt_fields ) && ! empty( $value ) ) {
        $decrypted_value = wp_decrypt( $value );
        // 解密失败返回空，避免泄露密文
        $value = is_wp_error( $decrypted_value ) ? '' : $decrypted_value;
    }
    return $value;
}

注意事项 #

• 务必备份wp-config.php中的所有安全密钥，密钥丢失后所有加密数据无法恢复
• 加密后的数据长度会比原文长3倍左右，如果自定义存储表存储字段，建议将字段类型设为text避免内容被截断
• 如果使用的WordPress版本低于5.2，可自行通过openssl扩展实现加解密逻辑，只需替换上述代码中的加解密调用部分即可，钩子逻辑无需调整
• 该方案同时适配后台字段录入、前台CMB2表单提交的场景，无需额外修改提交逻辑

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