根本原因是PATH未包含当前PHP版本的bin目录，或VC++运行库缺失、php.ini语法错误、Web服务配置未同步；需手动添加路径、安装VC++2022、用php -l校验配置、更新服务器模块路径并彻底重启服务。
PHP 可执行文件根本找不到
执行 phpenv which php 或直接运行 php -v 报 “不是内部或外部命令”，说明系统 PATH 里压根没加载当前 PHP 版本的路径。
Windows 用户尤其要注意：
– phpenv 在 CMD 中不会自动把 bin 目录加入 PATH，必须手动补全（如 E:\phpenv\versions\8.4.1\bin）；
– PowerShell 默认不兼容，建议用 Git Bash 或 WSL；
– 检查系统环境变量中是否漏了 source $(phpenv root)/bin/phpenv.sh（Linux/macOS）或对应初始化脚本（Windows 需配置启动 shell）。
PHP 自身启动失败（非 phpenv 问题）
phpenv 只是切换版本，不负责 PHP 解释器能否跑起来。若 php -v 命令闪退、弹窗报 DLL 缺失，或提示 “VCRUNTIME140_1.dll 丢失”，就是 VC++ 运行库未安装。
PHP 8.4.1 官方二进制依赖 Visual C++ 2022 Redistributable (x64)：
– 去微软官网下载安装包，选 x64 版本（即使系统是 64 位，也别装 x86）；
– 安装后必须重启终端，再试 php -v 和 php -m；
– 进入 phpenv versions --current 显示的目录，双击运行 php.exe，可快速验证是否弹窗报错。
php.ini 配置语法错误导致静默退出
PHP 加载时若遇到 php.ini 语法问题（如 extension 写错、路径含中文/空格、引号未闭合、分号遗漏），会直接失败且不输出任何提示，表现为 php -S 无响应、Apache/Nginx 启动后立即停止。
正确排查方式：
– 先用 phpenv which php 找到当前 PHP 路径；
– cd 到该目录，执行 php -l php.ini（注意是 -l，不是 -c）；
– 若提示 “Errors parsing php.ini on line X”，重点检查该行及前 3–5 行：常见错误包括 extension=php_curl.dll 写成 extension=curl，或路径没加引号（如 extension_dir = "C:\php\ext" 缺少引号易崩）；
– 临时重命名 php.ini 为 php.ini.bak，复制一份 php.ini-development 替代，再测试。
Web 服务（Apache/Nginx）无法与 PHP 8.4.1 协同
phpenv 不管理 Web 服务器与 PHP 的粘合逻辑。切换到 8.4.1 后，Apache 可能仍加载旧版 php_module，Nginx 可能仍指向旧版 php-fpm.sock 或错误端口。
立即学习“PHP免费学习笔记（深入）”；
关键检查点：
– Apache：确认 httpd.conf 中 LoadModule php_module 路径指向 8.4.1 对应的 php8apache2_4.dll，且 AddHandler application/x-httpd-php .php 已启用；
– Nginx：确认 fastcgi_pass 指向正确的 127.0.0.1:9000 或 sock 文件路径（如 /tmp/php-cgi-84.sock），并用 ps aux | grep php-fpm 确认进程在运行；
– 修改配置后务必彻底重启服务（不是“重载”，而是先 stop 再 start），否则旧进程残留会导致绑定失败或 502/503 错误。
端口冲突与隐身占用
Apache/Nginx 默认监听 80/443，但 Windows 下常有“看不见”的进程抢端口：
- Skype：默认启用“使用 80/443 端口”选项，即使未打开主界面也会占；
- Web Deployment Agent Service：IIS 相关服务，任务管理器里看不到，但 netstat 查不到；
- 旧版 SQL Server Reporting Services、Python 开发服务器、NPM Proxy Manager；
- phpenv 自身残留 httpd.exe 或 nginx.exe 进程，需在任务管理器中手动结束。
验证方法：
– Windows 执行 netstat -ano | findstr :80，拿到 PID 后用 tasklist | findstr PID 查进程名；
– 临时解决：改 Apache 的 Listen 8080 或 Nginx 的 listen 8080，长期建议禁用无关服务。
