加密类（新版）¶

初始化类¶

正如 CodeIgniter 中的其他类一样，在你的控制器中使用 $this->load->library() 方法来初始化加密类:

$this->load->library('encryption');

初始化之后，加密类的对象就可以这样访问:

$this->encryption

默认行为¶

默认情况下，加密类会通过你配置的 encryption_key 参数和 SHA512 HMAC 认证， 使用 AES-128 算法的 CBC 模式。

但是要注意的是，encryption_key 参数的用法可能并不是你想的那样。

如果你对密码学有点熟悉的话，你应该知道，使用 HMAC 算法认证也需要使用一个密钥， 而在加密的过程和认证的过程中使用相同的密钥可不是个好的做法。

正因为此，程序会从你的配置的 encryption_key 参数中派生出两个密钥来： 一个用于加密，另一个用于认证。这其实是通过一种叫做 HKDF （HMAC-based Key Derivation Function）的技术实现的。

设置 encryption_key 参数¶

加密密钥 encryption key 是用于控制加密过程的一小段信息，使用它可以对普通文本进行加密和解密。 这个过程可以保证只有你能对数据进行解密，其他人是看不到你的数据的，这其中的关键就是加密密钥。 如果你使用了一个密钥来加密数据，那么就只能通过这个密钥来解密，所以你不仅应该仔细选择你的密钥， 还应该好好的保管好它，不要忘记了。

还有一点要注意的是，为了确保最高的安全性，这个密钥不仅 应该 越强壮越好，而且 应该 经常修改。 不过这在现实中很难做到，也不好实现，所以 CodeIgniter 提供了一个配置参数用于设置你的密钥， 这个密钥（几乎）每次都会用到。

不用说，你应该小心保管好你的密钥，如果有人得到了你的密钥，那么数据就能很容易的被解密。 如果你的服务器不在你的控制之下，想保证你的密钥绝对安全是不可能的， 所以在在你使用密钥对敏感数据（例如信用卡号码）进行加密之前，请再三斟酌。

你的加密密钥的长度 必须 满足正在使用的加密算法允许的长度。例如，AES-128 算法最长支持 128 位（16 字节）。下面有一个表列出了不同算法支持的密钥长度。

你所使用的密钥应该越随机越好，它不能是一个普通的文本字符串，经过哈希函数处理过也不行。 为了生成一个合适的密钥，你应该使用加密类提供的 create_key() 方法:

// $key will be assigned a 16-byte (128-bit) random key
$key = $this->encryption->create_key(16);

密钥可以保存在 application/config/config.php 配置文件中，或者你也可以设计你自己的存储机制， 然后加密解密的时候动态的去获取它。

如果要保存在配置文件 application/config/config.php 中，可以打开该文件，然后设置:

$config['encryption_key'] = 'YOUR KEY';

你会发现 create_key() 方法返回的是二进制数据，没办法复制粘贴，所以你可能还需要使用 bin2hex() 、 hex2bin() 或 Base64 编码来更好的处理密钥数据。例如:

// Get a hex-encoded representation of the key:
$key = bin2hex($this->encryption->create_key(16));

// Put the same value in your config with hex2bin(),
// so that it is still passed as binary to the library:
$config['encryption_key'] = hex2bin(<your hex-encoded key>);

支持的加密算法和模式¶

消息长度¶

有一点对你来说可能很重要，加密的字符串通常要比原始的文本字符串要长（取决于算法）。

这个会取决于加密所使用的算法，添加到密文上的 IV ，以及添加的 HMAC 认证信息。 另外，为了保证传输的安全性，加密消息还会被 Base64 编码。

当你选择数据保存机制时请记住这一点，例如 Cookie 只能存储 4k 的信息。

配置类库¶

考虑到可用性，性能，以及一些历史原因，加密类使用了和老的 加密类 一样的驱动、 加密算法、模式 和 密钥。

上面的 "默认行为" 一节已经提到，系统将自动检测驱动（OpenSSL 优先级要高点），使用 CBC 模式的 AES-128 算法，以及 $config['encryption_key'] 参数。

如果你想改变这点，你需要使用 initialize() 方法，它的参数为一个关联数组，每一项都是可选：

例如，如果你想将加密算法和模式改为 AES-126 CTR ，可以这样:

$this->encryption->initialize(
    array(
        'cipher' => 'aes-256',
        'mode' => 'ctr',
        'key' => '<a 32-character random string>'
    )
);

另外，我们也可以设置一个密钥，如前文所说，针对所使用的算法选择一个合适的密钥非常重要。

我们还可以修改驱动，如果你两种驱动都支持，但是出于某种原因你想使用 MCrypt 来替代 OpenSSL

// Switch to the MCrypt driver
$this->encryption->initialize(array('driver' => 'mcrypt'));

// Switch back to the OpenSSL driver
$this->encryption->initialize(array('driver' => 'openssl'));

对数据进行加密与解密¶

使用已配置好的参数来对数据进行加密和解密是非常简单的，你只要将字符串传给 encrypt() 和/或 decrypt() 方法即可:

$plain_text = 'This is a plain-text message!';
$ciphertext = $this->encryption->encrypt($plain_text);

// Outputs: This is a plain-text message!
echo $this->encryption->decrypt($ciphertext);

这样就行了！加密类会为你完成所有必须的操作并确保安全，你根本不用关系细节。

// Assume that we have $ciphertext, $key and $hmac_key
// from on outside source

$message = $this->encryption->decrypt(
    $ciphertext,
    array(
        'cipher' => 'blowfish',
        'mode' => 'cbc',
        'key' => $key,
        'hmac_digest' => 'sha256',
        'hmac_key' => $hmac_key
    )
);