codeigniter 3 的 captcha() 函数不支持纯字母验证码,因其字符集硬编码且无配置项;需手动生成纯字母字符串并同步写入 session 才能确保验证一致。

CodeIgniter 3 的 captcha() 函数不支持纯字母验证码
CodeIgniter 3 自带的 captcha() 辅助函数默认生成数字+大小写字母混合验证码,但它的底层逻辑硬编码了字符集:'0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ',且没有提供配置项来替换或过滤。如果你需要「纯字母(a-z, A-Z)」验证码,直接调用 create_captcha() 并传入 'word' 参数是无效的——它只影响是否使用自定义词,不改变字符源。
常见错误现象:create_captcha(['word' => 'abcde']) 看似指定了纯字母,但实际仍可能被后续随机填充逻辑覆盖;更典型的是用户手动删掉数字后,验证码图片文字与 session 中存储的 hash 不匹配,导致始终验证失败。
- 真正可控的方式是绕过
create_captcha(),自己生成纯字母字符串,再用 CI 的imagejpeg()或 GD 手动绘图 - 或者重写
create_captcha()的字符生成部分(推荐在自定义 helper 中封装) - 务必确保生成的
word和写入$_SESSION(或 CI 的$this->session->set_userdata())的内容完全一致
手动构造纯字母验证码并写入 Session
这是最稳妥、兼容性最好、也最容易调试的做法。关键不是“怎么画图”,而是“怎么让前后端对得上”。CI 3 的验证码验证逻辑本质就两步:① 用户提交的值和 session 中存的 word 比较;② 图片只是展示载体。所以只要保证 session 写对,图片内容可自定义。
示例代码片段(放在控制器中):
function generate_letter_captcha() {
$chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
$word = '';
for ($i = 0; $i // 必须用 CI 的 session 写入方式,不能直接 $_SESSION
$this->session->set_userdata('captcha_word', $word);
// 返回 word 供后续生成图片(或交给 view 渲染)
echo json_encode(['word' => $word]);
}
注意:$this->session->set_userdata() 是必须的,否则 $this->session->userdata('captcha_word') 在验证时取不到;rand() 足够用于验证码场景,无需 random_int()(除非你有合规审计要求)。
验证时为什么总是失败?检查这三个点
90% 的“验证码不通过”问题不是逻辑错,而是状态没对齐。重点排查以下三项:
- session 是否已启动?CI 3 要求在
config/autoload.php中启用'session',且控制器构造函数里不能漏掉parent::__construct(); - 验证动作是否发生在同一 session 生命周期内?例如页面刷新后重新生成了新验证码,但用户提交的是旧图片对应的值
- 大小写是否严格一致?CI 默认不转大小写,
'AbC'≠'abc'。可在验证前统一转小写:strtolower($this->input->post('captcha')) === strtolower($this->session->userdata('captcha_word'))
如果用了 AJAX 动态刷新验证码,记得每次成功生成后清空旧 captcha_word 并写入新值,避免 race condition。
不想手写绘图?用第三方库替代 CI 原生 captcha
CI 3 的原生 captcha 类老旧、扩展性差、字体/干扰线控制弱。如果你需要稳定、可配、纯字母的方案,建议换轻量库,比如 gregwar/captcha(PHP 7.1+ 兼容):
use Gregwar\Captcha\CaptchaBuilder;
<p>$builder = new CaptchaBuilder;
$builder->setCharacters('abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ');
$builder->build();
$this->session->set_userdata('captcha_phrase', $builder->getPhrase());
header('Content-type: image/jpeg');
$builder->output();</p>
优势明显:
-
setCharacters()明确指定字符集,无歧义 - 支持中文、字体路径、背景色、干扰线强度等精细控制
- 不依赖 CI 的
image_lib,避免 GD 模块缺失报错(如Call to undefined function imagecreate())
唯一要注意的是:composer 自动加载需在 CI 的 application/config/autoload.php 中补上 'vendor/autoload.php',否则类找不到。
复杂点往往不在生成,而在 session 生命周期管理和大小写策略。哪怕只改一行 strtolower(),也可能让整个流程从“怎么都不对”变成“立刻可用”。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











