安装后第一件事是检查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 错误。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 在 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，但错误提示常藏在日志深处，不主动看就一直卡住。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！