为本地PHP项目配置独立域名需通过虚拟主机实现,方法包括:一、Apache修改httpd-vhosts.conf并配hosts;二、Nginx新建server块并重载;三、Laragon图形化快速创建;四、Docker Compose结合nginx-proxy容器化部署;五、Valet命令行一键绑定。

如果您在本地 PHP 环境中运行多个项目,希望为每个项目分配独立的域名(如 project1.test、project2.test),则需通过配置 Web 服务器的虚拟主机实现多站点访问。以下是针对常见本地环境的多种配置方法:
一、Apache 环境下配置虚拟主机
Apache 支持基于名称的虚拟主机,通过修改 httpd-vhosts.conf 文件并配合系统 hosts 文件,可将自定义域名解析到本地 127.0.0.1。
1、打开 Apache 配置目录中的 httpd-vhosts.conf 文件(通常位于 conf/extra/ 目录下)。
2、在文件末尾添加如下虚拟主机块:
立即学习“PHP免费学习笔记(深入)”;
ServerName project1.test
DocumentRoot "C:/xampp/htdocs/project1"
Require all granted
3、在系统 hosts 文件(Windows 路径为 C:\Windows\System32\drivers\etc\hosts,macOS/Linux 为 /etc/hosts)中添加一行:127.0.0.1 project1.test。
4、重启 Apache 服务使配置生效。
二、Nginx 环境下配置 server 块
Nginx 使用 server 指令块模拟虚拟主机行为,每个 server 块对应一个域名,需确保主配置文件已包含对 sites-enabled 目录的引用或直接在 nginx.conf 中嵌入配置。
1、进入 Nginx 配置目录,新建文件 project2.test.conf,内容如下:
server {
listen 80;
server_name project2.test;
root C:/nginx/html/project2;
index index.php;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
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;
}
}
2、在系统 hosts 文件中添加:127.0.0.1 project2.test。
3、检查配置语法:nginx -t,无误后执行 nginx -s reload 重载配置。
三、使用 Laragon 快速创建虚拟主机
Laragon 是集成化本地开发环境,内置自动化虚拟主机管理功能,无需手动编辑配置文件即可完成域名绑定与 SSL 启用。
1、将项目文件夹放入 Laragon 的 www 目录下(如 www/project3)。
2、右键点击 Laragon 系统托盘图标,选择 Quick App → Create Virtual Host。
3、在弹出窗口中输入域名 project3.test,确认后自动完成 hosts 写入与 Nginx/Apache 配置生成。
4、Laragon 会自动启用 HTTPS 并生成对应证书,访问 https://project3.test 即可加载站点。
四、使用 Docker Compose 启动多站点容器
通过定义多个 service 并结合反向代理容器(如 nginx-proxy),可在单机上以容器方式隔离多个 PHP 站点,每个站点拥有独立域名和 PHP 版本。
1、创建 docker-compose.yml,定义 php-fpm 和 nginx-proxy 服务,并为每个站点设置 labels:
services:
project4:
image: php:8.2-apache
volumes:
- ./project4:/var/www/html
environment:
- VIRTUAL_HOST=project4.test
2、启动前确保已运行 jwilder/nginx-proxy 容器,并映射端口 80 和 443。
3、在系统 hosts 文件中添加:127.0.0.1 project4.test。
4、执行 docker-compose up -d 启动服务,访问域名即可路由至对应容器。
五、使用 Valet(macOS/Linux)配置 Laravel Valet 风格虚拟主机
Valet 是轻量级命令行虚拟主机工具,专为 PHP 开发设计,通过 dnsmasq 实现泛域名解析,支持一键链接目录与域名绑定。
1、全局安装 Valet:composer global require laravel/valet。
2、执行 valet install 初始化,自动配置 dnsmasq 与 Nginx。
3、进入项目目录,运行 valet link project5,即注册域名 project5.test。
4、Valet 自动将该域名指向当前目录,无需修改 hosts 或服务器配置文件。











