PHP程序绑定域名的核心在于Web服务器（Apache/Nginx）虚拟主机配置与本地hosts文件映射协同生效，需依次完成DNS解析、服务器配置（ServerName与DocumentRoot对齐）、hosts添加127.0.0.1映射、重启服务及端口检查，缺一不可。
phpEnv 本身不处理域名绑定，它只是个集成环境启动器；真正起作用的是它内置的 Apache 或 Nginx，以及你本地的 hosts 文件。 直接改 phpEnv 界面或配置面板里的“域名”字段没用，那只是 UI 提示。绑不成功，90% 是因为 hosts 和 Apache 的 VirtualHost 没对齐。
修改 Windows/macOS 的 hosts 文件添加本地映射
这是所有本地域名访问的第一步，跳过就全白搭。系统必须知道 myapp.test 指向本机。
- Windows 路径：
C:\Windows\System32\drivers\etc\hosts，需用记事本/VS Code 以管理员身份打开 - macOS/Linux 路径：
/etc/hosts，需sudo权限编辑 - 追加一行（不要带
http://，不要写端口）：127.0.0.1 myapp.test - 保存后立即刷新 DNS 缓存：Windows 运行
ipconfig /flushdns，macOS 运行sudo dscacheutil -flushcache - 验证是否生效：终端执行
ping myapp.test，应返回127.0.0.1
配置 Apache 的 VirtualHost（phpEnv 默认用 Apache）
phpEnv 启动的是 Apache，但它的虚拟主机配置默认是关闭的，且不自动加载自定义配置。你得手动启用并写规则。
- 找到 phpEnv 安装目录下的 Apache 配置文件，常见路径如：
D:\phpenv\apache\conf\httpd.conf - 确认这行未被注释：
Include conf/extra/httpd-vhosts.conf - 打开
conf/extra/httpd-vhosts.conf，在末尾添加完整块（注意DocumentRoot必须是你项目的实际路径）：
<VirtualHost *:80>
ServerName myapp.test
DocumentRoot "D:/projects/myapp/public"
<Directory "D:/projects/myapp/public">
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
- 如果项目用 Laravel/Lumen 等框架，
DocumentRoot必须指向public目录，不是项目根目录 - Apache 配置里不能出现中文路径、空格路径，否则会报
Invalid command 'Directory'类错误 - 改完重启 phpEnv 中的 Apache 服务（点“重启”按钮，不是只点“启动”）
phpEnv 界面里“添加站点”按钮为什么没反应？
phpEnv 控制面板上的“添加站点”功能，本质是帮你生成一个 VirtualHost 块并写入 httpd-vhosts.conf，但它有硬性限制：
立即学习“PHP免费学习笔记（深入）”；
- 只支持路径中无空格、无中文、无特殊符号（比如
D:\my project就会失败） - 不会自动修改
hosts，你仍需手动加 - 如果它生成的配置里
ServerName和你hosts里写的不完全一致（比如大小写、多了一个点），就会 404 - 部分旧版 phpEnv（v2.x）根本不读取
httpd-vhosts.conf，而是把配置硬编码进主httpd.conf，此时要直接改那个文件
为什么访问 myapp.test 显示 502 或空白页？
这不是 PHP 报错，是 Web 服务器和 PHP 解析链断了。重点查三处：
- Apache 日志：
D:\phpenv\apache\logs\error.log，搜[core:notice]或PHP Fatal行 - 确认 PHP 模块已加载：在
httpd.conf里检查是否有LoadModule php_module和AddHandler application/x-httpd-php .php - 如果用了 PHP-FPM（某些新版 phpEnv 可选），Apache 的
VirtualHost必须配ProxyPassMatch，不能只靠AddHandler - 浏览器开发者工具 Network 标签里看响应状态码——如果是 502，基本是 Apache 没连上 PHP-FPM；如果是 200 但内容为空，可能是 PHP 脚本出错且
display_errors关了
最常被忽略的一点：phpEnv 启动的 Apache 默认监听 *:80，但如果你系统已有 Skype、IIS 或其它程序占了 80 端口，ServerName 再对也起不来。先用 netstat -ano | findstr :80（Windows）或 lsof -i :80（macOS）确认端口干净。
