phpEnv添加虚拟主机只需两步:项目放www目录下并右键创建;它自动配置服务、写hosts并重启,需管理员权限,域名不能重复,路径须规范,且Apache/Nginx配置逻辑不同。

phpEnv 添加虚拟主机不需要手动改 httpd-vhosts.conf 或写 server 块——它用的是图形化+命令行双路径,核心操作就两步:放对项目目录 + 点一下右键。
项目必须放在 phpEnv 的 www 目录下
这是硬性前提。phpEnv 启动时只扫描 www 子目录生成站点列表,其他路径(比如桌面、D:\myproject)它压根看不到。
- 默认路径是
C:\phpenv\www(Windows)或~/phpenv/www(macOS/Linux),别自己另建父级目录 - 项目名不能含空格或中文,推荐用小写字母+短横线,比如
blog-test、api-v2 - 如果项目有
public或web入口目录(如 Laravel),确保浏览器访问的是这个子目录,而不是整个项目根目录
右键托盘图标 → Quick App → Create Virtual Host
这是最常用、最可靠的添加方式。phpEnv 会自动完成三件事:生成 Apache/Nginx 配置、写入 hosts、重启服务。
- 必须以管理员权限运行 phpEnv,否则写
hosts文件会失败(Windows 下尤其明显) - 弹出的对话框里填的域名,会直接写进系统
hosts,例如填demo.test,就会加一行127.0.0.1 demo.test - 如果提示 “Virtual host already exists”,说明该域名已在
hosts中存在,或另一个项目已占用了同名配置,删掉旧条目再试
命令行方式:phpenv vhost add
适合批量操作或 CI/CD 场景,但要注意路径和参数顺序。
- 语法是:
phpenv vhost add <domain><path-to-project></path-to-project></domain>,例如:phpenv vhost add myapp.test C:\phpenv\www\myapp -
<path-to-project></path-to-project>必须是www下的相对路径或绝对路径,且不能带尾部斜杠 - 执行后不会自动打开浏览器,需手动刷新 DNS 缓存(
ipconfig /flushdnson Windows) - 如果报错
Failed to reload nginx/apache,大概率是端口被占用(比如 Skype 占了 80 端口),查netstat -ano | findstr :80
最容易被忽略的一点:phpEnv 默认启用的是 Apache,如果你在设置里切过 Nginx,那么右键创建的虚拟主机实际走的是 Nginx 配置,但它的日志路径、root 指向规则和 Apache 不一样——别拿 Apache 的调试经验去套 Nginx 的 403 错误。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











