ThinkPHP Windows安装：Win10/Win11兼容性全说明【说明】-ThinkPHP-PHP中文网

thinkphp在windows部署成功的关键是：public目录必须设为web根目录、php版本需匹配框架要求（如tp6.0.x用php7.4或8.0）、伪静态规则必须生效，三者缺一不可，否则导致404或白屏。

thinkphp windows安装：win10/win11兼容性全说明【说明】

在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加载失败，项目根本无法启动。

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请求能力

windows-shell-syntax

在 Windows 上执行终端命令，或对比 Windows 与 Linux 的 Shell 语法时使用。建议先检测当前 Shell 是 PowerShell 还是 cmd.exe，再给出相应命令……

下载

执行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欢迎页即表示安装成功。