Windows下PHP安全生成AES-256密钥需优先启用openssl或sodium扩展，用openssl_random_pseudo_bytes(32)或sodium_crypto_secretbox_keygen()生成32字节二进制密钥，存储时用bin2hex()转十六进制，读取时hex2bin()还原，严禁硬编码或字符串处理。
PHP 在 Windows 上生成和使用密钥，核心不是“怎么写”，而是「怎么安全生成、存储和调用」——Windows 本身不提供类似 Linux 的 /dev/urandom 抽象层，且默认 PHP 安装常缺失 openssl 或 libsodium 扩展，直接调用 random_bytes() 可能失败。
为什么 random_bytes() 在 Windows 上容易报错
PHP 7.0+ 的 random_bytes() 依赖系统 CSPRNG（加密安全伪随机数生成器）。Windows 从 Vista 起支持 BCryptGenRandom，但旧版 PHP（如 7.0.0–7.0.13）存在扩展加载顺序或 DLL 冲突问题；更常见的是：未启用 php_openssl.dll，或 openssl.cafile 路径配置错误导致整个 OpenSSL 初始化失败，连带 random_bytes() 不可用。
- 检查是否启用：
var_dump(extension_loaded('openssl'));必须返回true - 确认
php.ini中已取消注释：extension=php_openssl.dll - 若仍报
Unable to generate random bytes，临时降级兼容方案：base64_encode(openssl_random_pseudo_bytes(32))（需确保openssl可用）
生成 AES-256 密钥的可靠写法（Windows 兼容）
别硬编码 md5('mykey') 或 str_repeat('A', 32) —— 这些既不随机也不等长。AES-256 要求恰好 32 字节密钥，且必须是二进制数据，不是字符串。
- 首选（PHP 7.0+ 且
openssl启用）：$key = openssl_random_pseudo_bytes(32); - 备选（PHP 5.6+，
mcrypt已废弃，禁用）：$key = base64_decode(str_replace(['+', '/', '='], ['-', '_', ''], base64_encode(random_bytes(32))));（注意：random_bytes()失败时此行会崩） - 存密钥时不要直接写入 PHP 文件（易被 Web 访问），改用独立配置文件并设 IIS/Apache 权限为仅
SYSTEM和 PHP 进程可读
用 libsodium 替代 OpenSSL（推荐但需手动安装）
Windows 下 sodium 比 OpenSSL 更少依赖系统 DLL，PHP 7.2+ 内置，但默认不启用。它提供更直观的密钥操作接口，比如 sodium_crypto_secretbox_keygen() 直接生成 256 位密钥，无需计算字节长度。
立即学习“PHP免费学习笔记（深入）”；
- 确认启用：
var_dump(function_exists('sodium_crypto_secretbox_keygen')); - 生成密钥：
$key = sodium_crypto_secretbox_keygen();（返回 32 字节二进制） - 保存时建议用
bin2hex($key)转为十六进制字符串存文本文件，读取时用hex2bin()还原 —— 避免 Windows 记事本写入 BOM 或换行符污染二进制 - 注意：
sodium的密钥不能直接用于 OpenSSL 函数（如openssl_encrypt），二者密钥格式不互通
真正麻烦的从来不是“生成密钥”那一行代码，而是密钥生命周期管理：环境变量注入在 Windows 服务模式下不可靠，.env 文件权限难控，而注册表存储又增加部署复杂度。多数人卡住的地方，其实是把密钥当普通字符串处理，忘了它本质是固定长度的二进制 blob —— 少一个 bin2hex()，多一个 trim()，解密就必然失败。
