CodeIgniter 加密類

加密類

加密類提供了雙向數(shù)據(jù)加密的方式，它依賴于 PHP 的 Mcrypt 擴展，所以要有 Mcrypt 擴展才能運行。

重要

這個類庫已經(jīng)廢棄，保留只是為了向前兼容。請使用新的 加密類 。

使用加密類

設(shè)置你的密鑰

密鑰 是對字符串進行加密或解密的一段信息片段。實際上，你設(shè)置的密鑰 是 唯一 能解密通過該密鑰加密的數(shù)據(jù)，所以一定要慎重選擇你的密鑰， 而且如果你打算對持久數(shù)據(jù)進行加密的話，你最好不要修改密鑰。

不用說，你應(yīng)該小心保管好你的密鑰，如果有人得到了你的密鑰，那么數(shù)據(jù)就能 很容易的被解密。如果你的服務(wù)器不在你的控制之下，想保證你的密鑰絕對安全 是不可能的，所以在在你使用密鑰對敏感數(shù)據(jù)（譬如信用卡號碼）進行加密之前， 請再三斟酌。

為了最大程度的利用加密算法，你的密鑰最好使用32位長度（256字節(jié)），為了 保證安全性，密鑰字符串應(yīng)該越隨機越好，包含數(shù)字、大寫和小寫字符，不應(yīng)該 直接使用一個簡單的字符串。

你的密鑰可以保存在 application/config/config.php 文件中，或者使用你 自己設(shè)計的保存機制也行，然后在加解密時動態(tài)的取出密鑰。

如果要通過文件 application/config/config.php 來保存你的密鑰，那么打開 該文件然后設(shè)置:

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

消息長度

有一點很重要，你應(yīng)該知道，通過加密方法生成的消息長度大概會比原始的消息長 2.6 倍。舉個例子來說，如果你要加密的字符串是 "my super secret data" ，它 的長度為 21 字符，那么加密之后的字符串的長度大約為 55 字符（這里之所以說 “大約” 是因為加密字符串以 64 位為單位非線性增長）。當(dāng)你選擇數(shù)據(jù)保存機制時 請記住這一點，譬如 Cookie 只能存儲 4k 的信息。

初始化類

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

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

初始化之后，加密類的對象就可以這樣訪問:

$this->encrypt

類參考

classCI_Encrypt

encode($string[, $key = ''])

參數(shù):

• $string (string) -- Data to encrypt
• $key (string) -- Encryption key

返回: Encrypted string

返回類型: string

執(zhí)行數(shù)據(jù)加密，并返回加密后的字符串。例如:

$msg = 'My secret message';

$encrypted_string = $this->encrypt->encode($msg);

如果你不想使用配置文件中的密鑰，你也可以將你的密鑰通過第二個可選參數(shù)傳入:

$msg = 'My secret message';
$key = 'super-secret-key';

$encrypted_string = $this->encrypt->encode($msg, $key);

decode($string[, $key = ''])

參數(shù):

• $string (string) -- String to decrypt
• $key (string) -- Encryption key

返回: Plain-text string

返回類型: string

解密一個已加密的字符串。例如:

$encrypted_string = 'APANtByIGI1BpVXZTJgcsAG8GZl8pdwwa84';

$plaintext_string = $this->encrypt->decode($encrypted_string);

如果你不想使用配置文件中的密鑰，你也可以將你的密鑰通過第二個可選參數(shù)傳入:

$msg = 'My secret message';
$key = 'super-secret-key';

$encrypted_string = $this->encrypt->decode($msg, $key);

set_cipher($cipher)

參數(shù):

• $cipher (int) -- Valid PHP MCrypt cypher constant

返回: CI_Encrypt instance (method chaining)

返回類型: CI_Encrypt

設(shè)置一個 Mcrypt 加密算法，默認(rèn)情況下，使用的是 MCRYPT_RIJNDAEL_256 ，例如:

$this->encrypt->set_cipher(MCRYPT_BLOWFISH);

訪問 php.net 獲取一份 可用的加密算法清單 。

如果你想測試下你的服務(wù)器是否支持 MCrypt ，你可以:

echo extension_loaded('mcrypt') ? 'Yup' : 'Nope';

set_mode($mode)

參數(shù):

• $mode (int) -- Valid PHP MCrypt mode constant

返回: CI_Encrypt instance (method chaining)

返回類型: CI_Encrypt

設(shè)置一個 Mcrypt 加密模式，默認(rèn)情況下，使用的是 MCRYPT_MODE_CBC ，例如:

$this->encrypt->set_mode(MCRYPT_MODE_CFB);

訪問 php.net 獲取一份 可用的加密模式清單 。

encode_from_legacy($string[, $legacy_mode = MCRYPT_MODE_ECB[, $key = '']])

參數(shù):

• $string (string) -- String to encrypt
• $legacy_mode (int) -- Valid PHP MCrypt cipher constant
• $key (string) -- Encryption key

返回: Newly encrypted string

返回類型: string

允許你重新加密在 CodeIgniter 1.x 下加密的數(shù)據(jù)，這樣可以和 CodeIgniter 2.x 的 加密類庫保持兼容。只有當(dāng)你的加密數(shù)據(jù)是永久的保存在諸如文件或數(shù)據(jù)庫中時，并且 你的服務(wù)器支持 Mcrypt ，你才可能需要使用這個方法。如果你只是在諸如會話數(shù)據(jù) 或其他臨時性的數(shù)據(jù)中使用加密的話，那么你根本用不到它。盡管如此，使用 2.x 版本 之前的加密庫加密的會話數(shù)據(jù)由于不能被解密，會話會被銷毀。

重要
為什么只是提供了一個重新加密的方法，而不是繼續(xù)支持原有的加密方法呢？ 這是因為 CodeIgniter 2.x 中的加密庫不僅在性能和安全性上有所提高，而且我們 并不提倡繼續(xù)使用老版本的加密方法。當(dāng)然如果你愿意的話，你完全可以擴展加密庫， 使用老的加密方法來替代新的加密方法，無縫的兼容 CodeIgniter 1.x 加密數(shù)據(jù)。 但是作為一個開發(fā)者，作出這樣的決定還是應(yīng)該小心謹(jǐn)慎。

$new_data = $this->encrypt->encode_from_legacy($old_encrypted_string);