CAPTCHA 辅助函数

验证码辅助函数用来生成图片验证码

加载辅助函数

用下面的代码加载验证码辅助函数:

$this->load->helper('captcha');

[array]
(
  'image' => IMAGE TAG
  'time'  => TIMESTAMP (毫秒)
  'word'  => CAPTCHA WORD
)

<img src="http://example.com/captcha/12345.jpg" width="140" height="50" />

这里的"time"是一个毫秒级的时间戳，作为图片文件名（不包含扩展名）. 就像这样: 1139612155.3422

"word"是验证码, 如果不提供, 将是一个随机字符串.

使用验证码辅助函数：

加载后你可以像这样产生一个验证码:

$vals = array(
    'word'     => 'Random word',
    'img_path'   => './captcha/',
    'img_url'   => 'http://example.com/captcha/',
    'font_path'   => './path/to/fonts/texb.ttf',
    'img_width'   => '150',
    'img_height' => 30,
    'expiration' => 7200
    );
$cap = create_captcha($vals);
echo $cap['image'];

• 验证码辅助函数必须需要GD库.
• 只有 img_path 和 img_url 参数是必须的.
• 如果"word"未提供, 将自动产生一个ASCII字符串. 你也可以使用自己的词库，从里面随机挑选.
• 如果未提供TRUE TYPE字体的路径, 将会使用GD自带的字体.
• "captcha" 目录必须可写(666, or 777)
• "expiration" (秒) 指定了验证码图片的超时删除时间. 默认是2小时.

配合数据库

为了在提交表单时用到验证，你需要将create_captcha()生成的结果保存到数据库。这样，当用户提交表单时，你就可以验证数据库里是否有此验证码或是否过期。

这是一个数据表的例子:

CREATE TABLE captcha (
 captcha_id bigint(13) unsigned NOT NULL auto_increment,
 captcha_time int(10) unsigned NOT NULL,
 ip_address varchar(16) default '0' NOT NULL,
 word varchar(20) NOT NULL,
 PRIMARY KEY `captcha_id` (`captcha_id`),
 KEY `word` (`word`)
);

$this->load->helper('captcha');
$vals = array(
    'img_path'   => './captcha/',
    'img_url'   => 'http://example.com/captcha/'
    );
$cap = create_captcha($vals);
$data = array(
    'captcha_time'  => $cap['time'],
    'ip_address'  => $this->input->ip_address(),
    'word'      => $cap['word']
    );
$query = $this->db->insert_string('captcha', $data);
$this->db->query($query);
echo '提交下面的验证码:';
echo $cap['image'];
echo '<input type="text" name="captcha" value="" />';

// 首先删除旧的验证码
$expiration = time()-7200; // 2小时限制
$this->db->query("DELETE FROM captcha WHERE captcha_time < ".$expiration);  
// 然后再看是否有验证码存在:
$sql = "SELECT COUNT(*) AS count FROM captcha WHERE word = ? AND ip_address = ? AND captcha_time > ?";
$binds = array($_POST['captcha'], $this->input->ip_address(), $expiration);
$query = $this->db->query($sql, $binds);
$row = $query->row();
if ($row->count == 0)
{
    echo "你必须提交图像上显示的验证码";
}

翻译贡献者:CosyBoy, Hex, Jacklee, LSvKing, 杜建宇