本地PHP环境绑定多个域名配置教程

想在本地PHP开发环境中为多个项目（如projecta.test、projectb.test）分别绑定独立域名，实现专业级多站点并行调试？本文手把手教你通过修改系统hosts文件、配置Apache虚拟主机或Nginx server块、甚至结合PHP内置服务器与反向代理，轻松完成多域名映射——无论你使用XAMPP、WAMP、MAMP还是自建环境，只需几步关键操作，即可告别端口切换烦恼，让每个本地项目拥有专属域名，提升开发效率与真实感。

如果您在本地运行 PHP 环境（如 XAMPP、WAMP、MAMP 或手动配置的 Apache/Nginx），希望为多个项目分别绑定独立域名（例如 projecta.test、projectb.test），则需修改系统 hosts 文件与 Web 服务器虚拟主机配置。以下是实现此目标的具体步骤：

一、修改系统 hosts 文件映射本地域名

该步骤使操作系统将自定义域名解析为 127.0.0.1，从而将请求导向本地 Web 服务器。

1、以管理员身份打开文本编辑器（如记事本）。

2、打开系统 hosts 文件：Windows 路径为 C:\Windows\System32\drivers\etc\hosts；macOS/Linux 路径为 /etc/hosts。

3、在文件末尾新增两行（可根据实际项目增减）：

127.0.0.1 projecta.test

127.0.0.1 projectb.test

4、保存文件（若提示权限不足，请确认已使用管理员/Root 权限运行编辑器）。

二、Apache 环境下配置多个 VirtualHost

Apache 通过 VirtualHost 指令区分不同域名的请求，并将其指向对应项目目录，需确保 httpd-vhosts.conf 已启用且监听 80 端口。

1、打开 Apache 配置目录中的 httpd-vhosts.conf（通常位于 xampp\apache\conf\extra\ 或 /etc/apache2/sites-available/ 下）。

2、确认 Apache 主配置中已取消注释：Include conf/extra/httpd-vhosts.conf。

3、在 httpd-vhosts.conf 文件末尾添加两个独立 VirtualHost 块：

  ServerName projecta.test

  DocumentRoot "D:/xampp/htdocs/projecta"

    Require all granted

  ServerName projectb.test

  DocumentRoot "D:/xampp/htdocs/projectb"

    Require all granted

4、重启 Apache 服务使配置生效。

三、Nginx 环境下配置多个 server 块

Nginx 使用 server 块按 server_name 匹配请求，并将流量路由至指定 root 目录，需确保 nginx.conf 正确引入站点配置。

1、打开 Nginx 主配置文件 nginx.conf（通常位于 nginx/conf/nginx.conf）。

2、确认 http 块内包含：include sites-enabled/*.conf; 或类似路径引用（若无，可手动添加并创建 sites-enabled 目录）。

3、在 sites-enabled 目录下新建两个文件：projecta.conf 和 projectb.conf。

4、projecta.conf 内容如下：

server {

  listen 80;

  server_name projecta.test;

  root D:/nginx/html/projecta;

  index index.php index.html;

  location ~ \.php$ {

    fastcgi_pass 127.0.0.1:9000;

    fastcgi_index index.php;

    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

    include fastcgi_params;

  }

}

5、projectb.conf 内容结构相同，仅修改 server_name 和 root 路径。

6、执行 nginx -t 验证语法，无误后运行 nginx -s reload 重载配置。

四、使用 php -S 启动内置服务器并配合反向代理

当不依赖 Apache/Nginx 时，可利用 PHP 内置服务器启动单个项目，再通过 Nginx/Apache 作反向代理将不同域名请求转发至对应本地端口。

1、为 projecta 启动 PHP 内置服务器：php -S 127.0.0.1:8001 -t D:/projects/projecta。

2、为 projectb 启动另一实例：php -S 127.0.0.1:8002 -t D:/projects/projectb。

3、在 Nginx 的主 server 块中添加两个 location 或独立 server 块：

server {

  server_name projecta.test;

  location / {

    proxy_pass http://127.0.0.1:8001;

    proxy_set_header Host $host;

  }

}

server {

  server_name projectb.test;

  location / {

    proxy_pass http://127.0.0.1:8002;

    proxy_set_header Host $host;

  }

}

4、重载 Nginx 配置。

五、验证域名是否成功绑定

完成上述任一配置后，需在浏览器中访问对应域名，确认是否加载正确项目首页，并排除常见错误干扰。

1、在浏览器地址栏输入 http://projecta.test（注意不加 www，且不带端口号）。

2、检查页面是否显示 projecta 项目的 index 文件内容。

3、打开浏览器开发者工具（F12），切换到 Network 标签页，刷新页面，确认响应状态码为 200 且域名解析目标为 127.0.0.1。

4、若返回 404 或连接被拒绝，检查 Apache/Nginx 是否运行、对应 VirtualHost/server 块是否拼写正确、DocumentRoot 路径是否存在且有读取权限。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《本地PHP环境绑定多个域名配置教程》文章吧，也可关注golang学习网公众号了解相关技术文章。