本文旨在解决xampp环境下虚拟主机配置中常见的documentroot指向错误问题。通过详细阐述基于不同域名、子文件夹或端口的三种虚拟主机配置方案，并提供相应的代码示例和注意事项，帮助开发者正确设置本地开发环境，实现多个项目的快速切换和独立运行。
XAMPP虚拟主机简介
在Web开发中，我们经常需要在本地同时开发多个项目。XAMPP作为一款流行的集成开发环境，提供了Apache服务器，而虚拟主机（Virtual Host）功能则允许Apache在同一台服务器上托管多个网站，每个网站拥有独立的域名或端口，并指向不同的文档根目录（documentRoot）。这对于本地开发来说，意味着我们可以通过http://project1.local和http://project2.local等自定义域名来访问不同的本地项目，而无需将所有项目都放在Apache默认的htdocs目录下，极大地提高了开发效率和项目管理能力。
常见配置误区解析
配置XAMPP虚拟主机时，开发者常遇到的一个问题是，即使设置了多个VirtualHost，访问自定义域名时，Apache却始终提供默认的htdocs内容，或者总是显示第一个定义的虚拟主机内容。这通常是由于Apache无法正确匹配传入的请求与VirtualHost配置中的ServerName指令所致。
Apache服务器在接收到HTTP请求时，会根据请求中的主机名（Host Header）来尝试匹配httpd-vhosts.conf文件中定义的VirtualHost。如果请求的主机名与任何VirtualHost的ServerName或ServerAlias都不匹配，Apache通常会回退到其默认的documentRoot（通常是XAMPP安装目录下的htdocs），或者根据NameVirtualHost指令的配置，将请求发送给第一个匹配的虚拟主机。
例如，原始配置中：
<VirtualHost *:80> documentRoot "/home/(user)/webdev/app1" ServerName webdev.app1 # ...</VirtualHost><VirtualHost *:80> documentRoot "/home/(user)/webdev/app2" ServerName webdev.app2 # ...</VirtualHost>登录后复制
当访问webdev.app1或webdev.app2时，如果Apache没有正确识别这些ServerName，它可能就会提供htdocs的内容。而当访问localhost时，由于localhost没有明确的VirtualHost定义，Apache可能会将请求匹配到第一个定义的VirtualHost，即app1。正确的配置关键在于确保每个虚拟主机都有一个唯一的标识符（域名或端口），并且Apache能够通过这个标识符准确地将其与传入请求关联起来。
方案一：基于不同域名区分虚拟主机（推荐）
这是最常用也是最符合实际生产环境的虚拟主机配置方式。每个项目都拥有一个独立的本地域名。
1. Apache配置 (httpd-vhosts.conf)
确保httpd.conf中已取消注释Include etc/extra/httpd-vhosts.conf。在httpd-vhosts.conf文件中，为每个项目定义一个VirtualHost块。
# 确保Apache监听80端口Listen 80# 默认的VirtualHost，可选，用于处理不匹配任何ServerName的请求# 建议保留一个默认的VirtualHost，指向htdocs或一个统一的本地开发入口# <VirtualHost *:80># documentRoot "/opt/lampp/htdocs" # XAMPP默认htdocs路径# ServerName localhost# </VirtualHost><VirtualHost *:80> # 网站管理员邮箱，可选 ServerAdmin webmaster@app1.local # 项目的根目录 documentRoot "/home/youruser/webdev/app1" # 项目的域名 ServerName webdev.app1 # 可选，项目的别名，例如 www.app1.local ServerAlias *.webdev.app1 # 错误日志路径 ErrorLog "logs/app1.error.log" # 访问日志路径 CustomLog "logs/app1.access.log" common # 目录权限配置 <Directory "/home/youruser/webdev/app1"> Options Indexes FollowSymlinks ExecCGI Includes AllowOverride All # 允许使用.htaccess文件 Require all granted # 允许所有请求访问 </Directory></VirtualHost><VirtualHost *:80> ServerAdmin webmaster@app2.local documentRoot "/home/youruser/webdev/app2" ServerName webdev.app2 ServerAlias *.webdev.app2 ErrorLog "logs/app2.error.log" CustomLog "logs/app2.access.log" common <Directory "/home/youruser/webdev/app2"> Options Indexes FollowSymlinks ExecCGI Includes AllowOverride All Require all granted </Directory></VirtualHost>登录后复制
注意事项：
将/home/youruser/webdev/app1替换为你的实际项目路径。ServerName必须是唯一的，并与你将在hosts文件中配置的域名一致。ServerAlias允许你为同一个虚拟主机指定多个别名。<Directory>块用于配置特定目录的访问权限和行为。AllowOverride All允许Apache读取并应用项目目录下的.htaccess文件规则。2. 系统hosts文件配置
为了让你的操作系统能够将自定义域名解析到本地服务器（127.0.0.1），你需要修改hosts文件。
Linux/macOS: /etc/hostsWindows: C:\Windows\System32\drivers\etc\hosts使用管理员权限打开该文件，并添加以下内容：
百度虚拟主播 百度智能云平台的一站式、灵活化的虚拟主播直播解决方案
36 查看详情 
127.0.0.1 localhost::1 localhost127.0.0.1 webdev.app1127.0.0.1 webdev.app2登录后复制
注意事项：
确保每个ServerName都有对应的127.0.0.1映射。修改hosts文件后，可能需要刷新DNS缓存或重启浏览器才能生效。方案二：基于子文件夹区分虚拟主机
这种方法适用于你不想为每个项目都设置独立域名，而是希望通过localhost/app1、localhost/app2这样的URL来访问。这种情况下，你只需要一个虚拟主机指向一个公共的父目录。
1. Apache配置 (httpd-vhosts.conf)
Listen 80<VirtualHost *:80> # 将documentRoot指向所有项目的父目录 documentRoot "/home/youruser/webdev" ServerName localhost # 或者你希望的公共域名 ErrorLog "logs/local_apps.error.log" CustomLog "logs/local_apps.access.log" common <Directory "/home/youruser/webdev"> Options Indexes FollowSymlinks ExecCGI Includes AllowOverride All Require all granted </Directory></VirtualHost>登录后复制
2. 项目结构
在documentRoot指定的父目录（例如/home/youruser/webdev）下创建子文件夹，每个子文件夹代表一个项目：
/home/youruser/webdev/├── app1/│ └── index.html└── app2/ └── index.html登录后复制
访问方式：在浏览器中访问http://localhost/app1和http://localhost/app2。
方案三：基于不同端口区分虚拟主机
这种方法为每个项目分配一个独立的端口号，通过localhost:81、localhost:82等方式访问。
1. Apache配置 (httpd-vhosts.conf)
首先，你需要在httpd.conf或httpd-vhosts.conf中指定Apache监听这些额外的端口。
# 监听标准80端口Listen 80# 监听其他端口Listen 81Listen 82<VirtualHost *:81> ServerAdmin webmaster@app1.local documentRoot "/home/youruser/webdev/app1" ServerName localhost # 在此场景下，ServerName可以是localhost ErrorLog "logs/app1_port81.error.log" CustomLog "logs/app1_port81.access.log" common <Directory "/home/youruser/webdev/app1"> Options Indexes FollowSymlinks ExecCGI Includes AllowOverride All Require all granted </Directory></VirtualHost><VirtualHost *:82> ServerAdmin webmaster@app2.local documentRoot "/home/youruser/webdev/app2" ServerName localhost # 在此场景下，ServerName可以是localhost ErrorLog "logs/app2_port82.error.log" CustomLog "logs/app2_port82.access.log" common <Directory "/home/youruser/webdev/app2"> Options Indexes FollowSymlinks ExecCGI Includes AllowOverride All Require all granted </Directory></VirtualHost>登录后复制
2. hosts文件配置
在这种方案下，hosts文件通常只需要包含127.0.0.1 localhost即可，因为你将通过IP地址和端口号访问。
访问方式：在浏览器中访问http://localhost:81和http://localhost:82。
虚拟主机配置通用步骤与注意事项
编辑httpd.conf: 确保httpd.conf中取消注释了Include etc/extra/httpd-vhosts.conf这一行，以便Apache能够加载虚拟主机配置文件。编辑httpd-vhosts.conf: 根据上述方案选择并配置你的虚拟主机。编辑hosts文件: 根据你选择的方案（尤其是基于域名的方案），修改操作系统的hosts文件。重启Apache服务器: 任何对Apache配置文件的修改都需要重启Apache服务才能生效。在XAMPP控制面板中点击“Stop”然后“Start”Apache即可。文件和目录权限: 确保documentRoot指定的目录及其内容对Apache用户（通常是daemon或www-data）是可读的。如果权限设置不当，Apache可能无法访问文件，导致“Forbidden”错误。检查Apache错误日志: 如果遇到问题，请检查XAMPP安装目录下apache/logs/error_log文件，它会提供详细的错误信息，帮助你诊断问题。ServerName与请求匹配: 这是解决documentRoot指向错误的关键。Apache会根据请求头中的Host字段来匹配VirtualHost中的ServerName。如果ServerName不匹配，Apache可能不会按预期工作。默认虚拟主机: 考虑设置一个默认的VirtualHost（通常指向htdocs或一个统一的开发入口），以处理所有不匹配任何特定ServerName的请求。总结
正确配置XAMPP虚拟主机是提高本地开发效率的关键一步。通过理解Apache如何匹配请求与VirtualHost配置，并根据项目需求选择合适的区分方案（域名、子文件夹或端口），开发者可以轻松地在本地管理和切换多个项目。务必仔细检查配置文件语法，并利用Apache的错误日志进行故障排除，以确保虚拟主机能够按预期工作。
以上就是XAMPP虚拟主机配置指南：解决documentRoot指向错误的详细内容，更多请关注php中文网其它相关文章！
