必须在PHP应用层用openssl_encrypt()配合随机IV加密，密文存VARBINARY字段，密钥从环境变量读；否则MySQL自带AES_ENCRYPT()等于没加密。
直接说结论：别用 MySQL 自带的 AES_ENCRYPT()，必须在 PHP 应用层用 openssl_encrypt() + 随机 $iv 加密，密文存 VARBINARY 字段，密钥从环境变量读 —— 否则等于没加密。
openssl_encrypt() 解密失败只返回 false，怎么快速定位问题
PHP 的 OpenSSL 扩展不抛异常，openssl_decrypt() 失败就静默返回 false，你改十次逻辑不如看一眼底层错误。开发期务必加校验：
- 解密后立刻检查：
if ($decrypted === false) { error_log('OpenSSL error: ' . openssl_error_string()); } - 常见报错：
error:06065（IV 长度不对）、error:0606F（密钥长度或格式错）、error:06072（填充损坏） - 别依赖
base64_decode()的 silent fail：先base64_decode($encoded, true)，第三个参数设true可让非法 Base64 直接返回false，避免传垃圾给openssl_decrypt()
IV 必须每次随机生成，且不能只存密文不存 IV
复用或硬编码 $iv 是最常见翻车点 —— 同一明文会产出相同密文，丧失语义安全，还可能被重放或统计分析。
- 生成方式必须是：
$iv = openssl_random_pseudo_bytes(openssl_cipher_iv_length('AES-256-CBC'));（不是random_bytes(16)就完事，得匹配算法） - 存储方式推荐两种：
– 拼接后 Base64：$storage = base64_encode($iv . $ciphertext_raw);，解密时$decoded = base64_decode($storage); $iv = substr($decoded, 0, 16); $ciphertext_raw = substr($decoded, 16);
– 分开存字段：user_phone_enc存密文（VARBINARY），user_phone_iv存 IV（CHAR(22)，因为base64_encode(16字节)固定 22 字符） - 绝对不要把
$iv写成字符串常量，比如'1234567890123456'—— 这会让整个加密形同虚设
MySQL 字段类型选 VARBINARY，别用 VARCHAR 存 Base64
加密后的密文是二进制数据，不是文本。用 VARCHAR 存，MySQL 会在字符集转换中悄悄破坏它。
立即学习“PHP免费学习笔记（深入）”；
- 正确做法：
ALTER TABLE users MODIFY user_id_card VARBINARY(255);（AES-256-CBC 下，100 字符明文加密后约 136 字节，留余量） - 如果坚持存 Base64 字符串：
– 字段用VARCHAR(344)（136 × 2.5 ≈ 340，四舍五入）
– PDO 连接必须显式禁用模拟预处理：PDO::ATTR_EMULATE_PREPARES => false
– 并在 DSN 中加;charset=binary，否则 UTF-8 连接仍可能触发隐式转换 - 反例：
TEXT或VARCHAR配utf8mb4_unicode_ci—— 插入时看似成功，读出来openssl_decrypt()必然失败
密钥不能硬编码，环境变量也要防泄漏
密钥写在代码里、配置文件里、甚至 .env 里但没屏蔽 Web 访问，和明文存库没区别。
- 密钥来源优先级：
– Docker secrets / Kubernetes Secret（生产）
–getenv('APP_ENCRYPTION_KEY')（需确认 PHP 运行用户能读取该环境变量）
– 绝对不用file_get_contents('/path/to/key.bin')，除非该文件权限为600且不在 Web 根目录下 - 密钥长度必须严格：AES-256 要 32 字节二进制数据，不是 32 位字符串。
– 正确：$key = hex2bin(getenv('APP_ENCRYPTION_KEY'));（前提是环境变量是 64 位 hex 字符串）
– 错误：$key = substr(getenv('APP_ENCRYPTION_KEY'), 0, 32);（截的是字符，不是字节，UTF-8 下可能只有 16 字节） - 别用
md5()或sha1()截取密钥 —— 它们输出固定 16/20 字节，不满足 AES-256 的 32 字节要求；要用hash('sha256', $input, true)确保二进制输出
真正难的不是调通 openssl_encrypt()，而是确保密钥不泄露、IV 不复用、字段不乱码、错误不静默 —— 这四点漏掉任意一个，加密就归零。
