PHPEnv安装必须选官网https://www.phpenv.cn/下载Windows版8.9.5稳定版，安装路径用D:\phpEnv等英文无空格非系统盘，务必以管理员身份运行并避开Program Files目录，否则90%报错源于权限或路径问题。
直接装就行，但路径和权限选错，后面 90% 的报错都白折腾。
安装包从哪下、怎么选版本
去官网 https://www.phpenv.cn/ 下载 Windows 版安装包，别点第三方镜像或论坛链接。当前最新稳定版是 8.9.5（截至 2026 年 4 月），集成了 PHP 7.4、MySQL 5.7、Apache 和 Nginx，够大多数项目用。
不建议装开发版或 alpha 版，容易遇到 PHP version mismatch 或服务启动后立即退出的问题。如果项目明确要求 PHP 8.1+，等它在 PHPEnv 的「软件商店」里上架后再装，别自己硬塞外部 PHP。
- 安装包大小约 200MB，下载慢可换网络或稍后重试
- 下载后关闭杀毒软件再双击运行，否则可能被拦截写入注册表或服务项
- 别用迅雷等下载工具，曾有用户反馈校验失败导致安装完 Apache 启动即报
error code 0xc000007b
安装路径和权限必须避开的坑
安装路径不能含中文、空格、特殊符号，也绝对不要选 C:\Program Files 或 C:\Program Files (x86)。这些目录有 UAC 权限限制，会导致 PHPEnv 无法自动写入 hosts、无法保存站点配置、日志文件创建失败——你看到的 Apache 启动后变红 或 MySQL 服务未响应，八成是这原因。
立即学习“PHP免费学习笔记（深入）”；
推荐路径：D:\phpEnv 或 E:\dev\phpenv，全程英文、无空格、非系统盘。
- 安装时务必勾选「创建桌面快捷方式」，否则后续找控制面板很麻烦
- 安装完成后，右键桌面快捷方式 → 「以管理员身份运行」首次启动一次，让它完成组件自动安装（比如 VC++ 运行库、服务注册）
- 如果启动后弹窗提示「端口检测失败」，先别急着改端口，先检查是否真有程序占用了
80（Apache）或3306（MySQL）
启动服务失败时优先查什么
点击控制面板上的「启动」按钮，Apache/MySQL 状态没变绿，第一反应不是重装，而是看日志和端口。
打开 PHPEnv 主界面 → 「配置」→ 「日志查看器」，重点扫两行：[crit] (OS 10013)Permission denied（权限问题）、Address already in use（端口冲突）。前者说明路径或权限不对；后者得进「端口检测」手动改。
- 改端口：Apache 改成
8080，MySQL 改成3307，改完点「保存并重启服务」 - 别只改 Apache 的端口却不改 MySQL 的——有些老项目硬编码了
3306，改完得同步更新项目里的database.php或.env - 如果改完还是启动失败，打开任务管理器 → 「详细信息」页，搜
httpd.exe或mysqld.exe，有残留进程就结束掉再试
新增站点后打不开 localhost 或域名
新增站点后，PHPEnv 默认会自动写入 hosts 并重启服务，但这个功能依赖「管理员权限」。如果你是普通用户启动的 PHPEnv，hosts 文件不会被修改，浏览器访问 tp8.com 就会 DNS 失败。
验证方法：用记事本（以管理员身份运行）打开 C:\Windows\System32\drivers\etc\hosts，看末尾有没有类似 127.0.0.1 tp8.com 的行。没有就手动加，保存前确认记事本是「以管理员身份运行」。
- 站点根目录路径要填绝对路径，比如
D:\phpEnv\www\tp8.com\public，不能写./tp8.com/public或相对路径 - ThinkPHP、Laravel 等框架必须把根目录指向
public子目录，否则会暴露app/、config/等敏感目录 - 改完站点配置一定要点「保存」，PHPEnv 不会自动保存，点了才真正写入配置并触发 Apache 重载
最常被忽略的一点：每次改完 httpd.conf 或 php.ini（哪怕只是取消一个扩展的注释），都得手动点 PHPEnv 控制面板上的「重启 Apache」，光改文件不重启，等于没改。
