Apache2 DocumentRoot 指令的限制
在apache2中，documentroot指令用于指定特定虚拟主机（virtual host）或服务器的文档根目录，即web服务器提供文件服务的起始点。当客户端请求一个url时，apache会根据documentroot的设置来解析文件路径。然而，一个核心的限制是：每个虚拟主机（virtual host）只能配置一个documentroot。
这主要是由Apache指令的“上下文（Context）”决定的。例如，VirtualHost指令的上下文是“Server Config”，意味着它只能在服务器主配置文件（如httpd.conf）中使用，而不能嵌套在其他VirtualHost或Directory容器内。DocumentRoot指令的上下文是“Server Config”和“Virtual Host”，这意味着它可以在服务器主配置中设置全局文档根，也可以在每个VirtualHost块中设置独立的文档根。但是，它不允许在一个VirtualHost块内部多次定义，更不能针对VirtualHost内的子目录直接设置独立的DocumentRoot。
例如，当你有一个默认的虚拟主机配置如下：
<VirtualHost *:80>
DocumentRoot /var/www/html
<Directory /var/www/html>
Options Indexes FollowSymLinks
AllowOverride All
Order allow,deny
allow from all
</Directory>
AccessFileName .htaccess
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>如果你的网站文件位于/var/www/html/test，并且应用程序尝试使用include_once '/core.php'来引用文件，Apache会尝试在/var/www/html/core.php中查找该文件，而不是在/var/www/html/test/core.php中。这是因为DocumentRoot已经被设置为/var/www/html，应用程序的根路径被误解了。即使应用程序位于子目录中，其文件引用逻辑也需要基于其真正的文件系统路径，而不是Web服务器的文档根。为了解决这个问题，我们需要为每个独立的网站配置其专属的文档根。
解决方案：为每个网站配置独立的虚拟主机
为了在单个Apache服务器上托管多个位于不同子目录中的网站，并为每个网站提供独立的文档根，最常见且推荐的方法是为每个网站配置一个独立的虚拟主机。Apache提供了多种虚拟主机类型，其中最常用的是基于名称的虚拟主机和基于端口的虚拟主机。
1. 基于名称的虚拟主机 (Name-Based Virtual Hosts)
基于名称的虚拟主机允许你在同一个IP地址和端口上托管多个域名（例如site1.example.com和site2.example.com），每个域名对应一个独立的DocumentRoot。这是最灵活和常用的方法。
配置步骤：
确保mod_vhost_alias模块已启用：在大多数Apache安装中，此模块默认已启用。如果未启用，请在配置文件中取消注释或添加LoadModule vhost_alias_module modules/mod_vhost_alias.so。
-
配置监听端口：确保Apache监听了你希望使用的端口（通常是80或443）。
Listen 80
-
为每个网站创建独立的虚拟主机配置文件：通常，这些文件位于/etc/apache2/sites-available/（Debian/Ubuntu）或/etc/httpd/conf.d/（CentOS/RHEL）目录下。为每个网站创建一个文件，例如test.conf和test2.conf。
示例配置 (/etc/apache2/sites-available/test.conf)：
<VirtualHost *:80> ServerAdmin webmaster@example.com ServerName test.example.com # 网站的域名 DocumentRoot /var/www/html/test # 网站的独立文档根目录 <Directory /var/www/html/test> Options Indexes FollowSymLinks AllowOverride All # 允许使用.htaccess文件 Require all granted # Apache 2.4+ 权限设置 </Directory> ErrorLog ${APACHE_LOG_DIR}/error.log CustomLog ${APACHE_LOG_DIR}/access.log combined </VirtualHost>示例配置 (/etc/apache2/sites-available/test2.conf)：
<VirtualHost *:80> ServerAdmin webmaster@example.com ServerName 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}/error.log CustomLog ${APACHE_LOG_DIR}/access.log combined </VirtualHost> -
启用虚拟主机：在Debian/Ubuntu上，使用a2ensite命令启用配置文件。
sudo a2ensite test.conf sudo a2ensite test2.conf
在CentOS/RHEL上，确保配置文件在/etc/httpd/conf.d/目录下，Apache会自动加载。
-
重新加载/重启Apache服务：
sudo systemctl reload apache2 # 或 sudo systemctl restart apache2
注意事项：
- DNS配置：你需要确保test.example.com和test2.example.com在DNS中解析到你的服务器IP地址。
- 默认虚拟主机：如果你有一个默认的虚拟主机（通常是第一个加载的或使用_default_），它会处理所有不匹配任何ServerName的请求。确保其DocumentRoot指向一个合理的默认页面或错误页面。
- ServerAlias：如果你需要为同一个网站配置多个域名或子域名，可以使用ServerAlias指令。
2. 基于端口的虚拟主机 (Port-Based Virtual Hosts)
基于端口的虚拟主机允许你在同一个IP地址上，通过不同的端口号来访问不同的网站。
配置步骤：
-
配置监听端口：在Apache主配置文件中，确保Listen指令包含了所有你希望使用的端口。
Listen 80 Listen 8080
-
为每个网站创建独立的虚拟主机配置文件：
示例配置 (/etc/apache2/sites-available/test-port80.conf)：
<VirtualHost *:80> ServerAdmin webmaster@example.com ServerName 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}/error.log CustomLog ${APACHE_LOG_DIR}/access.log combined </VirtualHost>示例配置 (/etc/apache2/sites-available/test2-port8080.conf)：
<VirtualHost *:8080> ServerAdmin webmaster@example.com ServerName 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}/error.log CustomLog ${APACHE_LOG_DIR}/access.log combined </VirtualHost> 启用虚拟主机并重启Apache：与基于名称的虚拟主机相同。
注意事项：
- URL访问：用户需要通过http://example.com:8080这样的URL来访问网站，这可能不如基于名称的虚拟主机直观。
- 防火墙：确保服务器的防火墙允许传入连接到所有监听的端口。
3. 基于IP地址的虚拟主机 (IP-Based Virtual Hosts)
如果你的服务器有多个IP地址，你可以为每个IP地址配置一个独立的虚拟主机。这种方式现在较少使用，因为IP地址资源有限。配置方式与上述类似，只是VirtualHost指令中指定的是具体的IP地址而不是*。
总结
尽管在单个Apache虚拟主机内部无法为子目录设置多个DocumentRoot，但通过利用Apache强大的虚拟主机功能，我们可以为每个独立的网站（即使它们在文件系统上是子目录）配置一个专属的虚拟主机，从而拥有其独立的DocumentRoot。其中，基于名称的虚拟主机是最常用且推荐的方法，因为它提供了最大的灵活性和易用性。正确配置虚拟主机是管理多个Web应用程序的关键，它能确保每个应用程序在其预期的文件系统根目录下运行，避免文件引用错误，并为未来的扩展提供坚实的基础。在部署任何更改后，请务必重启或重新加载Apache服务，并检查错误日志以排除潜在问题。
