ThinkPHP 8 能否运行不取决于 php -v 是否成功，而取决于 PHP 8.2 必须匹配 vs17+NTS+x64 官方包、正确安装 VC2022 运行库、php.ini 绝对路径配置 extension_dir 及 openssl/curl/mbstring/pdo_mysql/gd 扩展、启用 opcache 内存与文件数、Web 服务器严格指向 public 目录且重写规则生效。
php -v 能跑，不代表 ThinkPHP 8 能跑——绝大多数失败发生在 PHP 扩展没对齐、CLI 和 Web 用的不是同一个 php.ini、或 public 目录没设对。直接用 ZIP 包手动配 PHP 8.2 + Composer 是最稳路径，别依赖集成环境自动切换。
选对 PHP 8.2 Windows 官方包，只认准 vs17 + NTS + x64
去 https://www.php.cn/link/a9a2c061a1c2743d489c6863eae6725a 下载 php-8.2.x-Win32-vs17-x64.zip（不是 vs16，不是 ts，不是 x86）。Windows 下 PHP 8.2 只提供 Non-Thread-Safe（NTS）版本，且必须匹配 VS17 编译器（对应 VC2022 运行库）。解压到不含中文、空格、长路径的位置，比如 C:\php82。
安装前先装 Microsoft Visual C++ 2022 Redistributable (x64)，否则 php -v 直接报 “VCRUNTIME140.dll 丢失”。
- 不装 VC2022 运行库 → 启动就崩
- 选错 vs16 包 → 扩展加载失败，
php -m看不见openssl或curl - 解压到
C:\Program Files\php82→ 路径含空格，部分 CLI 工具调用失败
php.ini 必改三处：extension_dir、关键扩展、时区
复制 php.ini-development 改名为 php.ini，然后重点改这三项：
-
extension_dir = "C:/php82/ext"—— 必须写绝对路径，用正斜杠或双反斜杠，加双引号，结尾不加/ - 取消注释这些行：
extension=openssl、extension=curl、extension=mbstring、extension=pdo_mysql、extension=gd（Windows 下扩展名是 .dll，不用改后缀） -
date.timezone = Asia/Shanghai—— 不设这个，strtotime()返回时间戳偏 8 小时，Laravel/ThinkPHP 启动可能直接报错
改完保存，运行 php --ini 确认加载的是你刚改的这份 php.ini；再跑 php -m | findstr "openssl gd" 验证扩展真加载了。
立即学习“PHP免费学习笔记（深入）”；
Composer 安装 ThinkPHP 8 项目时强制指定 php.ini
常见现象：php -m 能看见 gd，但 composer install 却报 “The requested PHP extension gd is missing”。根本原因是 Composer CLI 默认读注册表或旧路径下的 php.ini，和你手动配的不是同一份。
- 执行
php --ini查看实际加载路径，记下完整路径（如C:\php82\php.ini） - 创建项目时用：
php -c C:\php82\php.ini composer create-project topthink/think mytp 8.1.* - 后续所有命令都带上
-c参数，例如：php -c C:\php82\php.ini composer install - 如果仍报扩展缺失，检查
C:\php82\ext\php_gd.dll是否真实存在，以及是否被杀毒软件（如火绒、360）静默拦截
Web 服务根目录必须指向 public，且 Apache/Nginx 要重写支持
ThinkPHP 8 的入口统一在 public 目录，Web 服务器不能指向项目根目录，否则会暴露敏感文件（如 app/、config/）。
- Apache：编辑虚拟主机配置，
DocumentRoot和<Directory>都设为C:/mytp/public；确认mod_rewrite已启用，并确保public\.htaccess存在且内容是 ThinkPHP 官方标准重写规则 - Nginx：在
server块里设root C:/mytp/public;，并添加location / { try_files $uri $uri/ /index.php?s=$request_uri; } - 开发阶段可跳过 Apache/Nginx：进项目根目录运行
php think run（需确保php.ini已启用sockets扩展），访问http://127.0.0.1:8000即可
最关键的细节常被忽略：OPcache 在 PHP 8.2 下默认值太小，TP8 多命名空间+Composer 自动加载极易触发缓存驱逐，导致类找不到。务必在 php.ini 中设 opcache.memory_consumption=256 和 opcache.max_accelerated_files=19997（必须是质数）。
