在Apache2中，每个虚拟主机（VirtualHost）只能配置一个文档根目录（DocumentRoot）。若需在同一服务器上托管多个网站，并为每个网站指定独立的根目录，正确的方法是为每个网站创建单独的虚拟主机。本文将详细阐述为何无法在单个虚拟主机内设置多个文档根目录，并提供通过名称虚拟主机（Name-based Virtual Hosts）实现多站点管理的专业配置方案，包括示例代码与注意事项。
理解 DocumentRoot 与 VirtualHost 的上下文
apache配置指令具有特定的上下文（context），决定了它们可以在哪些配置区域内使用。对于documentroot指令，其上下文为“服务器配置（server config）”和“虚拟主机（virtual host）”。这意味着documentroot可以在主服务器配置文件（如httpd.conf）中定义，也可以在zuojiankuohaophpcnvirtualhost>容器内定义，但不能在<directory>容器内或.htaccess文件中定义。
而<VirtualHost>指令的上下文仅为“服务器配置”，表明它只能在主服务器配置文件中直接定义，而不能嵌套在其他<VirtualHost>或<Directory>容器内。
这明确指出，DocumentRoot是与一个特定的虚拟主机或整个服务器实例（当没有虚拟主机时）关联的。因此，尝试在一个<VirtualHost>容器内为不同的子目录设置多个DocumentRoot是不可行的，Apache设计上不允许这种行为。当您的代码（例如include_once ‘/core.php’）在子目录中运行时，它会尝试从当前虚拟主机定义的DocumentRoot（即/var/www/html）的根目录查找/core.php，而非子目录的根目录，从而导致文件查找失败。
多站点管理的解决方案：使用独立的虚拟主机
为了解决此问题，您需要为每个独立的网站（即使它们物理上位于主DocumentRoot的子目录中）创建独立的虚拟主机。Apache提供了多种实现方式，其中最常用且推荐的是基于名称的虚拟主机（Name-based Virtual Hosts）。
1. 名称虚拟主机 (Name-based Virtual Hosts)
名称虚拟主机允许您在单个IP地址和端口上托管多个域名不同的网站。Apache通过HTTP请求头中的Host字段来区分用户访问的是哪个网站。
配置步骤：
-
启用mod_vhost_alias模块（如果尚未启用）：
sudo a2enmod vhost_alias sudo systemctl restart apache2
登录后复制 -
创建独立的虚拟主机配置文件：
通常，Apache配置存储在/etc/apache2/sites-available/目录中。您可以为每个网站创建一个单独的.conf文件，例如test.example.com.conf和test2.example.com.conf。示例配置：
假设您有两个网站：
- test.example.com，其文件位于/var/www/html/test
- test2.example.com，其文件位于/var/www/html/test2
/etc/apache2/sites-available/test.example.com.conf:
<VirtualHost *:80> ServerName test.example.com ServerAlias www.test.example.com DocumentRoot /var/www/html/test <Directory /var/www/html/test> Options Indexes FollowSymLinks AllowOverride All Require all granted </Directory> ErrorLog ${APACHE_LOG_DIR}/test_error.log CustomLog ${APACHE_LOG_DIR}/test_access.log combined </VirtualHost>登录后复制/etc/apache2/sites-available/test2.example.com.conf:
<VirtualHost *:80> ServerName test2.example.com ServerAlias www.test2.example.com DocumentRoot /var/www/html/test2 <Directory /var/www/html/test2> Options Indexes FollowSymLinks AllowOverride All Require all granted </Directory> ErrorLog ${APACHE_LOG_DIR}/test2_error.log CustomLog ${APACHE_LOG_DIR}/test2_access.log combined </VirtualHost>登录后复制注意：
- ServerName：指定该虚拟主机响应的主要域名。
- ServerAlias：指定该虚拟主机响应的其他域名（如www子域）。
- DocumentRoot：为每个虚拟主机指定其独立的文档根目录。
- <Directory>：为DocumentRoot指定的目录设置权限和选项。Require all granted是Apache 2.4+的写法，等同于旧版中的Order allow,deny Allow from all。
- ErrorLog和CustomLog：建议为每个虚拟主机配置独立的日志文件，便于故障排查和流量分析。
-
启用虚拟主机：
sudo a2ensite test.example.com.conf sudo a2ensite test2.example.com.conf
登录后复制 -
禁用默认虚拟主机（如果不再需要）：
如果您的默认虚拟主机（通常是000-default.conf）不再需要，或者其DocumentRoot与您的新站点有冲突，可以考虑禁用它。sudo a2dissite 000-default.conf
登录后复制 -
测试配置并重启Apache：
sudo apache2ctl configtest sudo systemctl restart apache2
登录后复制
重要注意事项：
- DNS解析： 确保您的域名（test.example.com和test2.example.com）已正确解析到您的服务器IP地址。
- 文件权限： 确保Apache用户（通常是www-data）对DocumentRoot及其子目录拥有读取权限。
- AllowOverride All： 如果您的网站使用了.htaccess文件进行URL重写或其他配置，请确保在<Directory>块中设置了AllowOverride All。
- 主虚拟主机： 如果有多个虚拟主机，并且其中一个没有ServerName或ServerAlias匹配传入请求，Apache将使用配置文件中定义的第一个虚拟主机作为默认主机。
2. 基于端口的虚拟主机 (Port-based Virtual Hosts)
如果您不使用域名，或者希望通过不同的端口访问不同的网站，可以使用基于端口的虚拟主机。
示例配置：
# 监听额外端口，例如 8080
Listen 8080
<VirtualHost *:80>
ServerName example.com
DocumentRoot /var/www/html/site1
# ... 其他配置
</VirtualHost>
<VirtualHost *:8080>
ServerName example.com
DocumentRoot /var/www/html/site2
# ... 其他配置
</VirtualHost>
用户将通过http://example.com访问site1，通过http://example.com:8080访问site2。
3. 基于IP的虚拟主机 (IP-based Virtual Hosts)
当服务器拥有多个IP地址时，可以将每个IP地址绑定到一个不同的网站。
示例配置：
<VirtualHost 192.168.1.100:80>
ServerName site1.example.com
DocumentRoot /var/www/html/site1
# ... 其他配置
</VirtualHost>
<VirtualHost 192.168.1.101:80>
ServerName site2.example.com
DocumentRoot /var/www/html/site2
# ... 其他配置
</VirtualHost>
这种方法要求服务器配置多个网络接口或IP别名。
总结
尽管在单个Apache虚拟主机内设置多个DocumentRoot是不可能的，但通过为每个网站创建独立的虚拟主机，您可以有效地管理服务器上的多个站点。名称虚拟主机是最灵活和推荐的方法，它允许您在单个IP地址和端口上通过不同的域名区分和托管多个网站。通过这种方式，每个网站都能拥有其独立的DocumentRoot，从而确保文件包含和路径解析的正确性，即使面对由他人创建的“现成网站”也能轻松适配。务必在更改配置后进行测试并重启Apache服务，以确保所有更改生效。
以上就是Apache2 多站点配置：使用虚拟主机管理不同站点的文档根目录的详细内容，更多请关注php中文网其它相关文章！