必须配置$config['encryption_key']才能使用codeigniter加密功能,密钥需32位随机字符串、不可预测、不得硬编码在控制器中,ci 3.0+已改用encryption类及encrypt()/decrypt()方法,加密结果为base64编码且可逆。

加密前必须设好 $config['encryption_key']
CodeIgniter 的 encrypt 类不是开箱即用的,没配密钥就调 $this->encrypt->encode() 会直接报错:In order to use the encryption class requires that you set an encryption key in your config file.。这个密钥不是可选配置,是硬性依赖。
密钥要够随机、够长:推荐 32 字符(对应 256 位),别用 '12345' 或 md5('password') 这类可预测值。可以用 random_string('alnum', 32) 生成——先加载字符串辅助函数:$this->load->helper('string');,再执行。
- 密钥一旦写进
application/config/config.php,后续所有加解密都默认用它,改了会导致旧数据无法解密 - 密钥不能是纯数字或常见单词;含大小写字母 + 数字最稳妥
- 不要把密钥硬编码在控制器里传给
encode(),除非你明确需要多密钥隔离场景(比如不同租户用不同密钥)
encode() 和 decode() 是成对操作,别混用函数名
老版本 CI(如 2.x)用的是 $this->encrypt->encode() / $this->encrypt->decode();但注意:CI 3.0+ 已废弃 Encrypt 类,改用 Encryption 类,方法名变成 encrypt() / decrypt()。如果你看到“Call to undefined method”错误,大概率是版本不匹配。
实操时确认你用的是哪个类:
- CI 2.x:加载
encrypt库,调encode()/decode() - CI 3.1+:加载
encryption库,调encrypt()/decrypt(),且需先配置$config['encryption_key']和可选的$config['encryption_driver'](默认openssl) - 加密后结果是 base64 编码字符串,长度约是原文本的 2.6 倍——存进数据库字段时,
TEXT通常够用,但别往VARCHAR(50)里硬塞
加密结果不可逆?不,它是对称加密,能且只能用同一密钥解密
有人误以为 CI 加密是像 password_hash() 那样的单向哈希,其实不是。encode() 是对称加密(底层用 mcrypt 或 OpenSSL),只要密钥没丢、没改,就能原样还原。这也意味着:密钥泄露 = 数据裸奔。
- 千万别把密钥写在前端 JS、URL 参数或日志里
- 敏感字段(如身份证号、银行卡号)加密入库没问题,但得确保密钥不和数据存在同一台服务器上(比如密钥从环境变量读取,而非 config.php)
- 如果用户自己设密钥(比如“个人加密笔记”功能),请用
random_string('crypto')(CI 3.1.11+ 支持)生成密码学安全随机串,而不是md5(time())
base64 编码后的字符串含 +、/、=,传参或存 Cookie 要注意 URL 安全
加密后输出是标准 base64,但 + 和 / 在 URL 中有特殊含义,= 又常被截断。直接放进 GET 参数或 Cookie 可能出错,典型现象是解密失败,报 “Invalid payload” 或乱码。
解决办法很简单:传输前做 URL 安全 base64 编码(也叫 base64url):
$encoded = str_replace(['+', '/', '='], ['-', '_', ''], base64_encode($encrypted)); // 解密前反向替换回来 $decoded = base64_decode(str_replace(['-', '_'], ['+', '/'], $encoded));
- CI 自身不提供 URL 安全变体,得自己 wrap 一层
- Cookie 存加密数据时,建议额外用
urlencode()包裹整个字符串,双重保险 - 别依赖浏览器自动 decode——PHP 接收时要用
urldecode()先还原,再走解密流程










