mcrypt 编码函数库

字体大小: 中小 标准 ->行高大小: 标准
要使用本函数库要先准备 mcrypt 程序,可以到 ftp://argeas.cs-net.gr/pub/unix/mcrypt 下载这个程序 libmcrypt-x.x.tar.gz。同时在编译 php 程序时需要加入 --with-mcrypt 的选项,俾使本函数库能顺利运作。

本函数提供的编码方式有 des、tripledes、blowfish (默认值)、3-way、safer-sk64、safer-sk128、twofish、tea、rc2 及使用 cbc, ofb, cfb, ecb 作为密码检索的 gost。此外还有 rc6 及 idea 等非免费的编码方式。见下面列示为已定义的密码:

 

  • mcrypt_blowfish
  • mcrypt_des
  • mcrypt_tripledes
  • mcrypt_threeway
  • mcrypt_gost
  • mcrypt_crypt
  • mcrypt_des_compat
  • mcrypt_safer64
  • mcrypt_safer128
  • mcrypt_cast128
  • mcrypt_tean
  • mcrypt_rc2
  • mcrypt_twofish (mcrypt 2.x 前的版本用)
  • mcrypt_twofish128 (mcrypt 2.x 后的版本用)
  • mcrypt_twofish192
  • mcrypt_twofish256
  • mcrypt_rc6
  • mcrypt_idea

在密码检索本 (cipher) 方面,本函库支持 cbc、ofb、cfb 与 ecb 四种密码检索本。这四种密码检索本的简单叙述如下,更详细的信息请参考 schneier 所着作的 applied cryptography (isbn: 0-471-11709-9):

 

  1. ecb (electronic codebook): 适合随机的资料,例如使用另外的密钥。若资料量少且随机时,使用 ecb 较不适合。
  2. cbc (cipher block chaining): 适合文件的加密,安全性较 ecb 好。
  3. cfb (cipher feedback): 适合对位组资料流中的某段独立位组资料 (single bytes) 加密。
  4. ofb (output feedback): 与 cfb 相容,尤其适合在无法忍受错误波及的应用上。

目前 php 仍无法对单位 (bit) 的熵值做加密解密的步骤,目前只适合对字符串作密码处理。

在使用 cfb 及 ofb 二种模式时,必须要向量初始化 (initialization vector, iv),cbc 模式也可以使用向量初始化。向量初始化的值在加解密时必须是独一无二的,同时也要保持相同。当加密后的资料输出时,也可同时输出密码钥匙 (例如存在文件中);或者也可以将向量初始化的值与加密后的资料一起输出。

mcrypt_get_cipher_name: 取得编码方式的名称。
mcrypt_get_block_size: 取得编码方式的区块大小。
mcrypt_get_key_size: 取得编码钥匙大小。
mcrypt_create_iv: 从随机源将向量初始化。
mcrypt_cbc: 使用 cbc 将资料加/解密。
mcrypt_cfb: 使用 cfb 将资料加/解密。
mcrypt_ecb: 使用 ecb 将资料加/解密。
mcrypt_ofb: 使用 ofb 将资料加/解密。

mcrypt_get_cipher_name
取得编码方式的名称。
语法: string mcrypt_get_cipher_name(int cipher);
返回值: 字符串
函数种类: 编码处理
内容说明: 本函数用来取得编码方式的名称。返回值为名称字符串,若没有指定的编码方式则返回 false 或输入的名称。
使用范例
下例会输出 tripledes 字符串。
<?php
$cipher = mcrypt_tripledes;
print mcrypt_get_cipher_name($cipher);
?>

mcrypt_get_block_size
取得编码方式的区块大小。
语法: int mcrypt_get_block_size(int cipher);
返回值: 整数
函数种类: 编码处理
内容说明: 本函数用来取得编码方式的区块大小。参数为编码名称,返回整数治募?单位为位组 (byte)。

mcrypt_get_key_size
取得编码钥匙大小。
语法: int mcrypt_get_key_size(int cipher);
返回值: 整数
函数种类: 编码处理
内容说明: 本函数用来取得编码钥匙的大小。参数为编码名称,返回整数治募?单位为位组 (byte)。

mcrypt_create_iv
从随机源将向量初始化。
语法: string mcrypt_create_iv(int size, int source);
返回值: 字符串
函数种类: 编码处理
内容说明: 本函数用来建立向量初始化 (initialization vector, iv) 的值。参数 size 为指定的向量初始化治募?长度。参数 source 为随机资料的来源,来源可以是 mcrypt_rand (系统产生的随机值)、mcrypt_dev_random (unix 系统中 /dev/random 的资料)、mcrypt_dev_urandom (unix 系统中 /dev/urandom 的资料),若使用 mcrypt_rand 当做随机源,记得先使用 srand() 产生乱数种子。
使用范例
<?php
$cipher = mcrypt_tripledes;
$block_size = mcrypt_get_block_size($cipher);
$iv = mcrypt_create_iv($block_size, mcrypt_dev_random);
?>

mcrypt_cbc
使用 cbc 将资料加/解密。
语法: string mcrypt_cbc(int cipher, string key, string data, int mode, string [iv]);
返回值: 字符串
函数种类: 编码处理
内容说明: 本函数使用 cbc 密码检索本 (cipher block chaining),将资料加密及解密。参数 cipher 为加/解密方式,例如 mcrypt_tripledes。参数 key 是密码钥匙,当然要注意保持它的机密性。欲加密或解密的字符串就放在参数 data 之中。参数 mode 表示加密 mcrypt_encrypt 或是解密 mcrypt_decrypt。参数 iv 是可省略的参数,代表向量初始化 (initialization vector, iv)。

mcrypt_cfb
使用 cfb 将资料加/解密。
语法: string mcrypt_cfb(int cipher, string key, string data, int mode, string iv);
返回值: 字符串
函数种类: 编码处理
内容说明: 本函数使用 cfb 密码检索本 (cipher feedback),将资料加密及解密。参数 cipher 为加/解密方式,例如 mcrypt_tripledes。参数 key 是密码钥匙,当然要注意保持它的机密性。欲加密或解密的字符串就放在参数 data 之中。参数 mode 表示加密 mcrypt_encrypt 或是解密 mcrypt_decrypt。参数 iv 是代表向量初始化 (initialization vector, iv)。

mcrypt_ecb
使用 ecb 将资料加/解密。
语法: string mcrypt_ecb(int cipher, string key, string data, int mode);
返回值: 字符串
函数种类: 编码处理
内容说明: 本函数使用 ecb 密码检索本 (electronic codebook),将资料加密及解密。参数 cipher 为加/解密方式,例如 mcrypt_tripledes。参数 key 是密码钥匙,当然要注意保持它的机密性。欲加密或解密的字符串就放在参数 data 之中。参数 mode 表示加密 mcrypt_encrypt 或是解密 mcrypt_decrypt。

mcrypt_ofb
使用 ofb 将资料加/解密。
语法: string mcrypt_ofb(int cipher, string key, string data, int mode, string iv);
返回值: 字符串
函数种类: 编码处理
内容说明: 本函数使用 ofb 密码检索本 (output feedback),将资料加密及解密。参数 cipher 为加/解密方式,例如 mcrypt_tripledes。参数 key 是密码钥匙,当然要注意保持它的机密性。欲加密或解密的字符串就放在参数 data 之中。参数 mode 表示加密 mcrypt_encrypt 或是解密 mcrypt_decrypt。参数 iv 为向量初始化 (initialization vector, iv)

此文章由 www.phpgz.com 收集整理 ,地址为: http://www.phpgz.com/htmls/637.html

大屏阅读,大屏评论.