PHP crypt() 函數
PHP String 參考手冊
定義和用法
crypt() 函數返回使用 DES、Blowfish 或 MD5 算法加密的字符串。
在不同的操作系統上，該函數的行為不同，某些操作系統支持一種以上的算法類型。在安裝時，PHP 會檢查什么算法可用以及使用什么算法。
確切的算法依賴于 salt 參數的格式和長度。salt 可以通過增加由一個特定字符串與一個特定的加密方法生成的字符串的數量來使得加密更安全。
這里有一些和 crypt() 函數一起使用的常量。這些常量值是在安裝時由 PHP 設置的。
常量：
- [CRYPT_SALT_LENGTH] - 默認的加密長度。使用標準的 DES 加密，長度為 2
- [CRYPT_STD_DES] - 標準的基于 DES 加密有 2 個字符的 salt，來自字母表 "./0-9A-Za-z"。在 salt 中使用無效的字符將引發函數失敗。
- [CRYPT_EXT_DES] - 擴展的基于 DES 加密有 9 個字符的 salt，由 1 個下劃線，后邊跟 4 個字節的迭代次數和 4 個字節的 salt 組成。這些被編碼為可打印字符，每個字符 6 位，最低有效字符優先。值 0 到 63 被編碼為 "./0-9A-Za-z"。在 salt 中使用無效的字符將引發函數失敗。
- [CRYPT_MD5] - MD5 加密有 12 個字符的 salt，以 $1$ 開始。
- [CRYPT_BLOWFISH] - Blowfish 加密有一個以 $2a$、$2x$ 或 $2y$ 開始的 salt，一個兩位數的 cost 參數 "$"，以及來自字母表 "./0-9A-Za-z" 中的 22 個字符。使用字母表以外的字符將引發函數返回一個長度為 0 的字符串。"$" 參數是以 2 為底的基于 Blowfish 散列算法的迭代次數的對數，必須在 04-31 范圍內。在該范圍以外的值將引發函數失敗。
- [CRYPT_SHA_256] - SHA-256 加密有 16 個字符的 salt，以 $5$ 開始。如果 salt 字符串以 "rounds=<N>$" 開始，N 的數字值用于表示散列循環被執行的次數，這與 Blowfish 中的 cost 參數類似。默認的循環次數是 5000，最小值是 1000，最大值是 999,999,999。任何超出這個范圍的 N 的值將會轉換成最接近的邊界值。
- [CRYPT_SHA_512] - SHA-512 加密有 16 個字符的 salt，以 $6$ 開始。 如果 salt 字符串以 "rounds=<N>$" 開始，N 的數字值用于表示散列循環被執行的次數，這與 Blowfish 中的 cost 參數類似。默認的循環次數是 5000，最小值是 1000，最大值是 999,999,999。任何超出這個范圍的 N 的值將會轉換成最接近的邊界值。
在該函數支持多種算法的系統上，上面的常量如果支持則設置為 "1"，否則設置為 "0"。
注釋：沒有相應的解密函數。crypt() 函數使用一種單向算法。
語法
| 參數 | 描述 |
| str | 必需。規定要編碼的字符串。 |
| salt | 可選。用于增加被編碼字符數目的字符串，以使編碼更加安全。如果未提供 salt 參數，則每次調用該函數時會隨機生成一個。 |
技術細節
| 返回值： | 返回加密字符串，如果失敗則返回一個小于 13 個字符并保證不同于 salt 的字符串。 |
| PHP 版本： | 4+ |
| 更新日志： | 在 PHP 5.3.7 中，新增了 $2x$ 和 $2y$ Blowfish 模式，用來處理潛在的高位攻擊。
在 PHP 5.3.2 中，新增了常量 SHA-256 和 SHA-512。
自 PHP 5.3.2 起，Blowfish 在無效的循環將返回 "failure" 字符串（"*0" 或 "*1"），而不是后退到 DES。
自 PHP 5.3.0 起，PHP 自帶 MD5 加密實現、標準 DES 實現、擴展 DES 實現以及 Blowfish 算法。如果系統不支持上述的算法，將使用 PHP 自帶的算法實現。 |
實例
實例 1
在本實例中，我們將測試不同的算法：
<?php
// 2 character salt
if (CRYPT_STD_DES == 1)
{
echo "Standard DES: ".crypt('something','st')."n<br>";
}
else
{
echo "Standard DES not supported.n<br>";
}
// 4 character salt
if (CRYPT_EXT_DES == 1)
{
echo "Extended DES: ".crypt('something','_S4..some')."n<br>";
}
else
{
echo "Extended DES not supported.n<br>";
}
// 12 character salt starting with $1$
if (CRYPT_MD5 == 1)
{
echo "MD5: ".crypt('something','$1$somethin$')."n<br>";
}
else
{
echo "MD5 not supported.n<br>";
}
// Salt starting with $2a$. The two digit cost parameter: 09. 22 characters
if (CRYPT_BLOWFISH == 1)
{
echo "Blowfish: ".crypt('something','$2a$09$anexamplestringforsalt$')."n<br>";
}
else
{
echo "Blowfish DES not supported.n<br>";
}
// 16 character salt starting with $5$. The default number of rounds is 5000.
if (CRYPT_SHA256 == 1)
{
echo "SHA-256: ".crypt('something','$5$rounds=5000$anexamplestringforsalt$')."n<br>"; }
else
{
echo "SHA-256 not supported.n<br>";
}
// 16 character salt starting with $5$. The default number of rounds is 5000.
if (CRYPT_SHA512 == 1)
{
echo "SHA-512: ".crypt('something','$6$rounds=5000$anexamplestringforsalt$');
}
else
{
echo "SHA-512 not supported.";
}
?>
上面的代碼輸出如下（取決于操作系統）：
Standard DES: stqAdD7zlbByI
Extended DES: _S4..someQXidlBpTUu6
MD5: $1$somethin$4NZKrUlY6r7K7.rdEOZ0w.
Blowfish: $2a$09$anexamplestringforsaleLouKejcjRlExmf1671qw3Khl49R3dfu
SHA-256: $5$rounds=5000$anexamplestringf$KIrctqsxo2wrPg5Ag/hs4jTi4PmoNKQUGWFXlVy9vu9
SHA-512: $6$rounds=5000$anexamplestringf$Oo0skOAdUFXkQxJpwzO05wgRHG0dhuaPBaOU/
oNbGpCEKlf/7oVM5wn6AN0w2vwUgA0O24oLzGQpp1XKI6LLQ0.
PHP String 參考手冊
