openssl_cipher_iv_length 函数早在 PHP 7.1.0 引入，非 PHP 8.2 新增；它根据指定算法名（如 'AES-128-CBC'）返回对应 IV 字节长度，非法算法返回 false，PHP 8.2 仅强化类型声明与错误提示。
openssl_cipher_iv_length 函数在 PHP 8.2 中并不是新增函数，它早在 PHP 7.1.0 就已引入。你可能看到的是文档更新、IDE 提示强化，或误将其他扩展/框架的特性归到该函数上。
如何正确获取加密算法的 IV 长度
该函数的作用是：根据指定的 OpenSSL 加密算法名称（如 'AES-128-CBC'），返回该算法推荐/必需的初始化向量（IV）字节长度。
使用方式很简单：
- 传入合法的 cipher name 字符串（区分大小写，需与
openssl_get_cipher_methods()返回的列表一致） - 返回整数，单位是字节（不是位）
- 如果算法名无效或不支持，返回
false
示例：
立即学习“PHP免费学习笔记（深入）”；
var_dump(openssl_cipher_iv_length('AES-128-CBC')); // int(16)
var_dump(openssl_cipher_iv_length('AES-256-GCM')); // int(12) ← GCM 常用 12 字节 IV
var_dump(openssl_cipher_iv_length('chacha20')); // int(12)
var_dump(openssl_cipher_iv_length('invalid')); // bool(false)
注意 IV 长度 ≠ 密钥长度
别混淆这两个概念：
-
IV 长度由算法模式决定（如 CBC、GCM、CTR 的固定要求），用
openssl_cipher_iv_length()获取 -
密钥长度由算法本身和密钥强度决定（如 AES-128 要 16 字节密钥），可用
openssl_cipher_key_length()查
例如：AES-128-CBC 的 IV 总是 16 字节，但密钥也必须是 16 字节；而 AES-256-CBC IV 仍是 16 字节，密钥则要 32 字节。
实际使用建议
- 生成 IV 时，务必用
random_bytes()按该函数返回值生成，不可截断或填充 - GCM 模式下，IV（又称 nonce）通常推荐 12 字节（而非 16），虽然 16 也合法，但 12 是标准且更高效
- 调用前建议先检查算法是否支持：
in_array($cipher, openssl_get_cipher_methods(), true)
PHP 8.2 相关变化（澄清误区）
PHP 8.2 本身未改动此函数行为，但加强了类型声明和错误提示：
- 参数类型现在明确为
string，传非字符串会触发TypeError - 返回值类型声明为
int|false，利于静态分析工具识别 - 内部对某些废弃 cipher name（如带
-openssl后缀的旧名）可能更严格拒绝
