codeigniter加密前必须配置$config['encryption_key'],否则调用encrypt()/decrypt()直接报错;密钥需32位随机字符串,不可预测、不得硬编码,ci 3.0+仅支持encryption类及对应方法,加密结果为base64编码且长度约增2.6倍。

CodeIgniter 加密不是“配了就能用”,不设 $config['encryption_key'] 就调 encrypt() 或 decode(),直接报错:「In order to use the encryption class requires that you set an encryption key in your config file.」——这不是警告,是硬性拦截。
加密前必须配置 $config['encryption_key'],且不能是临时值
这个密钥不是可选项,也不是运行时传参就能绕过的。CI 3.0+ 的 Encryption 类在初始化时就检查它,缺了就抛异常,不给你任何机会。
- 长度推荐 32 字符(对应 AES-256),别用
'12345'、md5('pass')或时间戳这类可预测字符串 - 生成方式建议:先
$this->load->helper('string');,再用random_string('alnum', 32)得到真正随机值 - 必须写进
application/config/config.php,例如:$config['encryption_key'] = 'Xv9qF2mR8tLzKpWnYsBcVdEaGhJiN7oU'; - 改了密钥 → 所有旧加密数据无法解密,数据库里存的密文全变废料
encrypt() 和 decrypt() 是 CI 3.0+ 唯一可用方法
老教程里写的 $this->encrypt->encode() 在 CI 3.x 已彻底废弃。如果你看到「Call to undefined method」或「Class 'CI_Encrypt' not found」,基本就是混用了旧类名和新版本。
- CI 3.0+ 只认
Encryption类,加载方式是$this->load->library('encryption'); - 加解密操作直接走
$this->encryption->encrypt($data)和$this->encryption->decrypt($cipher) - 不要试图手动 new Encryption(),它依赖 CI 的 loader 和 config 注入
- 加密结果是 base64 编码字符串,长度约为原文本的 2.6 倍 —— 存进 MySQL 时字段至少设为
TEXT,VARCHAR(255)都可能截断
解密失败常见原因:类型错、密钥错、版本错
最常遇到的错误是 strlen() expects parameter 1 to be string, object given,这说明你传给 decrypt() 的根本不是字符串,而是空对象、null 或数据库查出来没取值的 stdClass 实例。
- 确认数据库字段读出来的是字符串:用
var_dump($row->encrypted_field)看真实值,不是NULL或空对象 - 确认没在控制器里重复加载加密库(比如构造函数 load 一次,方法里又 load 一次),可能导致实例冲突
- 确认加密和解密用的是同一个
$config['encryption_key'],且没被运行时覆盖 - 如果用在登录验证场景,别直接比对
decrypt($db_pass) === $input_pass,优先用 password_verify() + hash 机制;加密类只适合加密非密码类敏感字段(如邮箱、手机号)
密钥不能硬编码在业务逻辑里,但多租户隔离时可以动态传
绝大多数场景下,密钥只该出现在 config.php。但如果你做 SaaS,需要每个租户数据互不可读,就得绕过全局密钥,走动态密钥路径。
- 此时不要改
$config['encryption_key'],而是用$this->encryption->initialize(['key' => $tenant_key])重置当前实例密钥 - 注意:每次 initialize 都会丢弃旧状态,所以要在加解密前调用,且确保同一线程内不混用
- 密钥本身不能存明文进数据库,建议用主密钥加密后存储,或由 KMS 服务托管
- 这种模式大幅提升复杂度,除非真有合规要求(如 GDPR 分租户数据隔离),否则别轻易上
最易被忽略的一点:CI 的加密类默认用 OpenSSL 驱动,但某些老旧服务器只装了 Mcrypt(已废弃),或者 OpenSSL 版本太低不支持 AES-256。出问题时先看 phpinfo() 里有没有 openssl 模块,再检查 $config['encryption_driver'] 是否被误设为 'mcrypt' —— CI 3.1.11+ 已完全移除对它的支持。











