安装后第一件事是检查Apache和MySQL服务状态及端口占用，确认80和3306端口未被Skype、IIS等占用，再通过“配置→端口检测”扫描冲突并修改端口，保存后重启服务。
安装后第一件事：检查服务状态和端口占用
安装完成打开 PHPEnv 控制面板，Apache 和 MySQL 默认是红色（停止）状态。别急着点启动——先确认 80 端口（Apache）和 3306 端口（MySQL）没被 Skype、IIS、其他集成环境或后台服务占着，否则点击“启动”会卡住或秒退。
常见现象：Apache 启动失败、MySQL 服务无法响应、控制面板里状态反复变红。
- 点击菜单栏
配置 → 端口检测，它会自动扫描并标出冲突进程 - 若检测到占用，可直接在 PHPEnv 里修改端口（比如 Apache 改成
8080，MySQL 改成3307），改完记得点“保存配置”再重启 - Windows 下常见冲突源：
Skype（默认用 80/443）、Web Deployment Agent Service、World Wide Web Publishing Service
必须做的三步基础配置
很多新手装完就去建站，结果访问 localhost 报 404 或空白页，问题往往出在这三处没调好。
-
开启“新增站点后自动写入 hosts”：路径是
开始 → 软件设置 → 高级设置，勾选此项，否则你添加的域名（如test.local）不会自动解析到127.0.0.1 -
确认默认 Web 服务为 Apache：路径是
开始 → 软件设置 → 环境设置，选Apache（不是 Nginx，除非你明确需要）；PHPEnv 默认带多个 Web 服务，但新用户用 Apache 最稳 -
检查 PHP 版本是否已安装并启用：点
软件管理 → PHP 版本，至少装一个（如8.2.15），再回到主界面点右上角PHP 版本切换，选中刚装的那个版本
创建第一个站点前，先验证 PHP 环境是否真跑起来了
别跳过这步。很多人以为服务绿了就万事大吉，其实 PHP 解析模块可能没加载，index.php 会被当成纯文本下载，或者直接 500 错误。
立即学习“PHP免费学习笔记（深入）”；
- 在 PHPEnv 安装目录下找
www文件夹（通常是D:\phpenv\www），把里面自带的phpinfo.php复制一份到你的站点根目录 - 浏览器访问
http://localhost/phpinfo.php（或你设的域名，如http://test.local/phpinfo.php） - 看到完整的 PHP 配置页才算通过；如果提示
File not found或下载文件，说明 Apache 的DocumentRoot没指向对位置，或.htaccess/mod_rewrite未启用
hosts 文件写入失败？别硬改系统文件
手动编辑 C:\Windows\System32\drivers\etc\hosts 常因权限不足失败，尤其装在 C 盘时。PHPEnv 提供了更可靠的替代方案。
如果你发现添加站点后域名无法解析，或 ping test.local 返回超时，优先按这个顺序排查：
- 确认已开启
高级设置 → 新增站点后自动写入 hosts，且 PHPEnv 是以管理员身份运行的（右键快捷方式 → “以管理员身份运行”） - 检查 PHPEnv 日志：点
日志 → Apache error.log，搜索Permission denied或hosts关键字 - 实在不行，临时用浏览器访问
http://127.0.0.1:8080（假设你改了端口），绕过域名解析环节，先确保 PHP 能执行
真正的麻烦往往不在安装，而在默认配置和 Windows 权限的隐性咬合——比如没管理员权限时，PHPEnv 写不了 hosts，也改不了 Apache 的 httpd.conf，但错误提示常藏在日志深处，不主动看就一直卡住。
