核心是两步联动：修改hosts文件实现127.0.0.1域名解析，再配置Apache VirtualHost指向项目public目录并启用PHP模块；需确保权限、路径、语法、VC运行库及PHP-Apache版本兼容性均正确。
在 Windows 11 上为 Apache 2.4.69 + PHP 8.4.1 环境绑定自定义域名（如 myapp.test），核心是两步联动：系统级域名解析（hosts） + Web 服务器路由分发（VirtualHost）。只要路径规范、权限到位、配置无语法错误，整个过程稳定可靠。
修改 Windows hosts 文件做本地解析
这是让浏览器“认得”你写的域名的第一步。所有自定义域名都必须映射到 127.0.0.1：
- 以管理员身份运行记事本（右键 → “以管理员身份运行”）
- 打开文件：
C:\Windows\System32\drivers\etc\hosts - 在文件末尾新增一行（注意用空格分隔，不要用 Tab）：
127.0.0.1 myapp.test
如需多项目，可追加：127.0.0.1 api.myapp.test127.0.0.1 admin.local - 保存文件。若提示“拒绝访问”，请确认记事本是管理员模式打开的
- 刷新 DNS 缓存：
Win+R → 输入cmd→ 运行：ipconfig /flushdns - 验证是否生效：命令行执行
ping myapp.test，应返回Reply from 127.0.0.1
配置 Apache 虚拟主机（httpd-vhosts.conf）
Apache 需明确知道收到 myapp.test 请求时，该去哪个目录找文件。假设你用的是 Apache Lounge 手动安装（路径为 C:\Apache24），操作如下：
- 确保主配置已启用虚拟主机模块：
编辑C:\Apache24\conf\httpd.conf，找到并取消注释这一行：Include conf/extra/httpd-vhosts.conf - 编辑
C:\Apache24\conf\extra\httpd-vhosts.conf，在文件末尾添加：
<VirtualHost *:80>
ServerName myapp.test
DocumentRoot "D:/projects/myapp/public"
<Directory "D:/projects/myapp/public">
Require all granted
AllowOverride All
</Directory>
</VirtualHost>
-
关键点说明：
•DocumentRoot必须指向项目实际可访问的入口目录（如 Laravel 的public、ThinkPHP 的public，不是项目根目录）
•<Directory>块中Require all granted是 Apache 2.4+ 的必需权限指令
• 若项目含 .htaccess 重写规则（如 Laravel 路由），必须保留AllowOverride All - 保存后，用管理员 CMD 进入
C:\Apache24\bin，执行：httpd -t—— 检查配置语法是否 OK
若返回Syntax OK，再执行：httpd -k restart—— 重启服务（或用services.msc重启 Apache24 服务）
确认 PHP 已正确加载并支持该站点
域名能解析、Apache 能路由，但 PHP 不工作，页面仍会空白或下载 .php 文件。请检查以下三项：
立即学习“PHP免费学习笔记（深入）”；
-
PHP 模块是否已加载：
在httpd.conf中确认存在且未被注释的三行（路径按你实际安装调整）：LoadModule php_module "C:/php/php8apache2_4.dll"AddHandler application/x-httpd-php .phpPHPIniDir "C:/php" -
PHP 版本与 Apache 兼容：
PHP 8.4.1 必须是 Thread Safe (TS) + VC17 编译版本（对应 Visual Studio 2022 运行库），Apache 2.4.69 也需同为 VC17；两者位数（x64）必须一致 -
测试 PHP 是否就绪：
在D:/projects/myapp/public下新建info.php，内容为：<?php phpinfo(); ?>
浏览器访问 https://www.php.cn/link/9fd6b74ffaf18102f326484be5e00d4a，能看到 PHP 详细信息页即成功
常见卡点与快速排查
如果访问 http://myapp.test 报错或无响应，按顺序检查：
-
403 Forbidden：DocumentRoot 目录权限不足 → 检查
<Directory>块中Require all granted是否写对，路径是否拼写准确 -
404 Not Found：域名没解析或 VirtualHost 未生效 → 再次执行
ping myapp.test和httpd -t -
页面空白 / 下载 .php 文件：PHP 模块未加载或配置错误 → 检查
httpd.conf中LoadModule路径是否真实存在，PHPIniDir是否指向含php.ini的目录 -
Apache 启动失败：端口被占（如 Skype、IIS）、VC 运行库缺失、路径含中文或空格 → 用
netstat -ano | findstr :80查端口，安装 Microsoft Visual C++ 2022 Redistributable (x64)
