ThinkPHP5验证码跨平台部署指南：Linux与Windows环境实操【说明】-ThinkPHP-PHP中文网

thinkphp5验证码跨平台部署需四步：一装对扩展版本并运行php think captcha:install；二启用可写session；三配置web服务器url重写支持/captcha.html路由；四前端调用带防缓存刷新。

thinkphp5验证码跨平台部署指南：linux与windows环境实操【说明】

ThinkPHP5验证码在Windows和Linux上都能跑，但细节差异不小。核心问题不在框架本身，而在于环境依赖、路径权限、Session机制和URL重写支持是否到位。跨平台部署不是“一套配置打天下”，而是分系统查漏补缺。

TP5.0只能用 think-captcha=1.*，TP5.1起用 =2.*，TP6/8用最新版即可。装错版本会直接报类不存在或方法签名不匹配。

Windows：CMD进项目根目录，执行 composer require topthink/think-captcha=1.*（TP5.0）
Linux：终端同样位置，执行相同命令；若因网络慢，先运行 composer config -g repo.packagist composer https://packagist.laravel-china.org 切国内镜像
装完必须运行 php think captcha:install，生成 config/captcha.php 和 public/static/captcha/ 资源目录

验证码值靠Session存储，Session没启动或无法写入，前端显示空白图、后端校验永远失败。

使用 auto、native 或 external 引擎审计待安装的 skill 包或归档，并可选启用 LLM 语义分析。

下载

确认 config/app.php 中 'middleware' => [..., \think\middleware\SessionInit::class] 已启用
Windows下检查 php.ini 的 session.save_path 指向有效目录（如 C:\php\tmp），并确保IIS/Apache有该目录写权限
Linux下检查 session.save_path（常见为 /var/lib/php/sessions），执行 sudo chown -R www-data:www-data /var/lib/php/sessions（Ubuntu）或 apache:apache（CentOS）
临时验证：在控制器里加 session('test', 'ok'); dump(session('test'));，能输出即Session正常

验证码图片地址如 /captcha.html 或 /index.php/captcha，本质是路由转发，依赖URL重写和PHP脚本执行能力。

Windows Apache：确认 httpd.conf 已开启 LoadModule rewrite_module modules/mod_rewrite.so，且对应 <directory></directory> 块中 AllowOverride All
Windows Nginx：在 server 块内添加 location /captcha.html { try_files $uri $uri/ /index.php?$query_string; }
Linux Apache（Ubuntu）：运行 sudo a2enmod rewrite，再检查虚拟主机配置中 AllowOverride All
Linux Nginx（CentOS）：确保 location ~ \.php$ 正确指向 php-fpm socket，并添加 location ^~ /captcha.html { try_files $uri $uri/ /index.php?$query_string; }

模板里用 {:captcha_img()} 或 <img src="%7B:url('captcha')%7D">，点击刷新时必须带时间戳防缓存。

推荐写法：<img id="verify-img" src="%7B:captcha_src()%7D" onclick="this.src='{:captcha_src()}?'+Math.random()">
Linux下注意：如果使用伪静态隐藏入口文件，.htaccess 或 Nginx rewrite 规则需放行 captcha.html 请求，避免被误判为静态资源404
Windows IIS用户：需额外配置 web.config，添加 <rule name="Captcha" stopprocessing="true"><match url="^captcha\.html$"></match><action type="Rewrite" url="index.php/captcha"></action></rule>

不复杂但容易忽略。把扩展装对、Session写通、重写配准、前端刷活，四个环节串起来，验证码就能稳稳跑在两个系统上。