需修改hosts文件映射域名并配置phpenv的httpd-vhosts.conf虚拟主机，再重启apache服务；路径须为项目public目录，启用allowoverride all，确保权限与语法正确。
如果您在使用phpEnv搭建本地PHP开发环境后，希望为项目配置独立的本地域名（如 project.test），则需通过修改系统 hosts 文件与 phpEnv 内置 Apache 的虚拟主机配置协同实现。以下是完成该任务的具体操作步骤：
一、修改系统 hosts 文件添加域名映射
该步骤使操作系统将自定义域名解析为本地回环地址 127.0.0.1，从而将浏览器请求导向 phpEnv 托管的 Apache 服务。
1、以管理员身份运行记事本（Windows）或终端编辑器（macOS/Linux）。
2、打开系统 hosts 文件：Windows 路径为 C:\Windows\System32\drivers\etc\hosts；macOS/Linux 路径为 /etc/hosts。
3、在文件末尾新增一行，格式为：127.0.0.1 project.test（可按需添加多行，如 127.0.0.1 api.project.test）。
4、保存文件；若提示权限拒绝，请确认已使用管理员/root 权限运行编辑器。
5、刷新系统 DNS 缓存：Windows 执行 ipconfig /flushdns；macOS 执行 sudo dscacheutil -flushcache；Linux 执行 sudo systemd-resolve --flush-caches。
二、启用并配置 phpEnv 的 httpd-vhosts.conf 虚拟主机
phpEnv 默认集成 Apache，其虚拟主机功能需通过额外配置文件启用，确保 Apache 能识别并路由不同域名至对应项目目录。
1、进入 phpEnv 安装目录下的 Apache 配置路径，通常为 phpenv\apache\conf\httpd.conf。
2、用文本编辑器打开 httpd.conf，搜索 Include conf/extra/httpd-vhosts.conf。
3、确认该行未被注释（即开头无 #）；若被注释，请删除 # 并保存。
4、打开 phpenv\apache\conf\extra\httpd-vhosts.conf 文件，在末尾添加如下 VirtualHost 块：
ServerName project.test
DocumentRoot "D:/phpenv/www/project/public"
AllowOverride All
Require all granted
5、将 DocumentRoot 和
三、重启 phpEnv 的 Apache 服务
所有配置变更仅在 Apache 重新加载后生效，需强制终止当前进程并启动新实例。
1、打开 phpEnv 主程序界面或命令行工具。
2、执行 phpenv restart apache（若命令不支持，则手动停止再启动：先点击“Stop Apache”，再点击“Start Apache”）。
3、观察状态栏或日志窗口，确认 Apache 启动成功且无报错（特别留意 “Syntax OK” 或 “Apache started” 提示）。
4、在浏览器中访问 http://project.test，验证是否正确加载项目首页而非 Apache 默认页或 404 错误。
四、检查并修正常见路径与权限问题
当域名可解析但页面无法显示时，多数源于 DocumentRoot 指向错误或目录访问权限不足，需逐项排查。
1、确认项目目录中存在 index.php 或有效入口文件，且位于 DocumentRoot 指定路径下。
2、检查 phpenv\apache\conf\extra\httpd-vhosts.conf 中的路径是否含中文、空格或特殊字符；如有，请改用短英文路径或使用双引号包裹路径。
3、确保 AllowOverride All 已启用，否则 Laravel/.htaccess 类重写规则将失效，导致路由 404。
4、若使用 Windows 系统且项目位于非系统盘（如 D:\），请确认 Apache 进程具有该磁盘的读取权限；必要时右键目录 → 属性 → 安全 → 编辑 → 添加 Users 组并赋予读取权限。
五、使用 phpEnv 自带的域名管理工具（如可用）
部分新版 phpEnv 提供图形化域名绑定面板，可绕过手动编辑配置文件，降低出错概率。
1、启动 phpEnv 主程序，进入“环境设置”或“虚拟主机”选项卡。
2、点击“添加新站点”，填写站点名称（如 project）、域名（project.test）、项目路径（D:\phpenv\www\project）。
3、勾选“自动写入 hosts”和“启用 Apache 虚拟主机”选项。
4、点击“保存并应用”，工具将自动完成 hosts 修改、vhost 配置注入及 Apache 重启。
5、查看生成的 httpd-vhosts.conf 文件末尾，确认新增块结构完整、无语法错误（如缺失 或引号不匹配）。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
