ThinkPHP在Windows部署成功的关键是：public目录必须设为Web根目录、PHP版本需匹配框架要求（如TP6.0.x用PHP7.4或8.0）、伪静态规则必须生效，三者缺一不可，否则导致404或白屏。
在Windows 10或Windows 11系统上安装ThinkPHP时，常因PHP版本错配、public目录未设为Web根目录、伪静态规则缺失导致404或白屏，而系统本身对框架无直接兼容性障碍，真正卡住的是环境配置细节。
确认PHP版本与ThinkPHP版本严格匹配
ThinkPHP不是“装上就能跑”的工具，它对PHP有硬性语法和扩展依赖。TP6.0.x必须用PHP 7.4或8.0（NTS版），TP5.0.x建议用PHP 7.2–7.4；PHP 8.1+会触发TP6.0.6的类型推导报错，PHP 8.3则完全不被支持。
打开命令行，执行：php -v 和 php --ini，核对CLI实际调用的PHP版本与php.ini路径——别被XAMPP控制面板里显示的“当前PHP版本”误导，那只是Apache模块用的版本。
若输出中含“ZTS”字样，说明是线程安全版，【ThinkPHP官方明确要求使用NTS（非线程安全）版本】，否则vendor/autoload.php加载失败，项目根本无法启动。
立即学习“PHP免费学习笔记（深入）”；
Composer安装前必须完成的三步验证
方法一：用php -m检查必需扩展是否启用
PDO、MBstring、OpenSSL、CURL这四个扩展缺一不可。运行php -m | findstr /i "pdo mbstring openssl curl"，若无返回，编辑php.ini（路径来自php --ini），去掉对应extension=行前的分号，保存后重启Web服务或命令行终端。
方法二：强制开启OpenSSL（极易遗漏）
即使php -m显示openssl，仍需确认php.ini中extension=php_openssl.dll这一行未被注释且路径正确；某些集成环境（如老版PHPStudy）的openssl.dll文件名可能是php_openssl.dll或php_openssl.so，务必按实际文件名填写。
方法三：测试HTTPS请求能力
执行php -r "print_r(file_get_contents('https://www.baidu.com'));exit;"，若报错“Unable to find the socket transport 'ssl'”，说明OpenSSL未真正生效，此时composer install必然失败。
用Composer创建ThinkPHP项目（以TP6.0稳定版为例）
第一步：切换到你的Web根目录（例如D:\xampp\htdocs）
第二步：执行命令 → composer create-project topthink/think tp --prefer-dist
第三步：等待下载完成，生成tp文件夹，注意观察最后几行是否出现“Installing dependencies from lock file”和“Package operations: 32 installs, 0 updates, 0 removals”——若中途报错“failed to open stream: php_network_getaddresses”，说明镜像源失效，立即执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/再重试。
第四步：进入tp目录 → cd tp，执行php think run启动内置服务器，浏览器访问http://127.0.0.1:8000，看到ThinkPHP欢迎页即表示安装成功。
Web服务器必须指向public目录
XAMPP/WampServer用户最容易犯的错误：把整个tp文件夹丢进htdocs，然后访问http://localhost/tp，结果暴露.env文件且所有路由404。正确做法是——
将浏览器地址改为http://localhost/tp/public/，能打开首页就证明public路径可访问；若不能，请检查Apache或Nginx是否已启用rewrite模块，并确认.htaccess（Apache）或nginx.conf（Nginx）中已配置PATHINFO重写规则。
IIS用户必须安装URL Rewrite模块，在tp\public目录下放置web.config文件，内容包含重写规则；【切勿修改public/index.php入口文件来绕过public目录】，这会导致调试模式失效、日志路径错乱、静态资源404等连锁问题。
