phpEnv 默认不启用 OpenSSL 扩展，需手动在 php.ini 中取消 extension=openssl 注释并重启服务；验证可用 openssl_pkey_new() 测试密钥生成，对称加密须严格匹配 IV 和填充方式，RSA 加密超长数据需分段或采用混合加密。
phpEnv 默认不启用 OpenSSL 扩展，必须手动开启，否则所有 openssl_* 函数（如 openssl_encrypt、openssl_pkey_new）都会报错 “Call to undefined function”。
确认 OpenSSL 扩展是否已加载
在 phpEnv 的 PHP 目录下运行：php -m | findstr openssl（Windows）或 php -m | grep openssl（Linux/macOS）。没输出就代表没启用。
常见错误现象：Call to undefined function openssl_pkey_new() 或 file_get_contents(): Unable to find the wrapper "https" —— 这两个都指向 OpenSSL 未启用。
- phpEnv 的配置文件路径通常是
php\php.ini（不是 Apache 的httpd.conf） - 搜索
;extension=openssl，去掉前面的分号，改为extension=openssl - 确保
extension_dir指向正确的扩展目录，例如extension_dir = "ext"（相对路径）或绝对路径如extension_dir = "D:\phpEnv\php\ext" - 修改后必须重启 phpEnv 的 Web 服务（不是只刷新页面）
验证 OpenSSL 是否能正常生成密钥对
写个最小测试脚本，避免被其他配置干扰：
立即学习“PHP免费学习笔记（深入）”；
```php
<?php
$config = [
'private_key_bits' => 2048,
'private_key_type' => OPENSSL_KEYTYPE_RSA,
];
$res = openssl_pkey_new($config);
if (!$res) {
echo '密钥生成失败：' . openssl_error_string();
exit;
}
openssl_pkey_export($res, $privKey);
$pubKey = openssl_pkey_get_details($res);
echo "公钥长度：" . strlen($pubKey['key']) . " 字符\n";
echo "私钥开头：" . substr($privKey, 0, 30) . "...\n";
openssl_free_key($res);
?>
```如果输出类似 -----BEGIN PRIVATE KEY-----...，说明 OpenSSL 已就绪；如果报错或输出空，优先检查 php.ini 中 extension=openssl 是否生效、openssl.cnf 路径是否被正确引用（某些旧版 phpEnv 需要显式配置 openssl.cafile）。
对称加密（AES/DES）必须配对使用 IV 和填充方式
openssl_encrypt() 和 openssl_decrypt() 不是“填完参数就能跑通”的函数，IV 和 $options 必须严格一致，否则解密必然失败。
-
$iv必须是二进制字节（不是 hex 或 base64 字符串），且长度由算法决定：openssl_cipher_iv_length('aes-256-cbc')返回 16 - 推荐用
openssl_random_pseudo_bytes()生成 IV，不要手写或复用 - 填充方式默认是 PKCS#7（对应
OPENSSL_RAW_DATA），但若用OPENSSL_ZERO_PADDING，明文必须自己补足块长度，且解密后需手动 rtrim("\0") - ECB 模式不需要 IV，但极度不安全，生产环境禁用
典型安全写法：
```php $method = 'aes-256-cbc'; $data = 'hello world'; $ivlen = openssl_cipher_iv_length($method); $iv = openssl_random_pseudo_bytes($ivlen); $key = '32-byte-secret-key-for-aes256'; // 实际应更随机且保密 $encrypted = openssl_encrypt($data, $method, $key, OPENSSL_RAW_DATA, $iv); $decrypted = openssl_decrypt($encrypted, $method, $key, OPENSSL_RAW_DATA, $iv); ```
RSA 加密超长数据必须分段
PHP 的 openssl_public_encrypt() 对明文长度有硬限制：RSA-2048 最多加密 245 字节（PKCS#1 v1.5 填充），超过就直接返回 false，无任何警告。
- 不能靠增大 key bits 来绕过 —— 4096 位最多也只支持约 500 字节
- 分段逻辑必须和解密端完全一致：加密端按 117 字节切分（2048 位），解密端按 128 字节还原（2048/8）
- 拼接密文时建议用不可见分隔符（如
\x00\x01），避免 base64 解码后出现歧义 - 真正需要加密大文本时，应该用混合加密：用 RSA 加密一个随机 AES 密钥，再用该 AES 密钥加密原始数据
最容易被忽略的一点：RSA 加密后的密文是二进制，必须用 base64_encode() 后才能安全传输或存储；解密前必须先 base64_decode()，否则 openssl_private_decrypt() 会静默失败。
