如何实战配置ThinkPHP验证码参数？

本文共计928个文字，预计阅读时间需要4分钟。

如果您在ThinkPHP项目中安装了验证码扩展但出现异常、格式不正确或功能失效，很可能是因为验证码参数未正确配置或配置结构不匹配。以下是对不同版本和环境的验证码参数配置方法：

一、手动创建并配置config/captcha.php文件

ThinkPHP 6 默认不自带captcha.php配置文件，必须手动创建该文件，否则会抛出“Class 'think\captcha\Captcha' not found”或初始化失败错误；该文件需返回一个关联数组，且至少包含length和useZh等基础键，结构与TP5不兼容。

1、在项目根目录下的config/子目录中新建captcha.php文件（若无config目录则先创建）。

2、写入以下基础配置内容（确保使用UTF-8无BOM编码）：

立即学习“PHP免费学习笔记（深入）”；

3、保存后确认文件路径为config/captcha.php，且PHP可读取该文件。

4、验证是否生效：在控制器中调用Captcha::create()或访问验证码路由，观察输出是否符合配置预期。

二、配置字体路径与背景色参数

font_path必须为绝对路径，相对路径在CLI模式下将无法定位字体文件；bg参数必须为RGB数值数组，十六进制字符串（如'#ff0000'）会导致静默失败、页面空白或回退默认灰底。

1、下载支持中文的TrueType字体（如simhei.ttf），放入public/fonts/目录。

2、在captcha.php中设置'font_path' => __DIR__ . '/../public/fonts/simhei.ttf'。