Apache2 多站点配置：使用虚拟主机管理不同站点的文档根目录

理解 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字段来区分用户访问的是哪个网站。

配置步骤：

1. 启用mod_vhost_alias模块（如果尚未启用）：

   sudo a2enmod vhost_alias
   sudo systemctl restart apache2

   登录后复制

2. 创建独立的虚拟主机配置文件： 通常，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>

   登录后复制

   注意：

   

   标贝AI虚拟主播

   一站式虚拟主播视频生产和编辑平台

   15

   查看详情
   • ServerName：指定该虚拟主机响应的主要域名。
   • ServerAlias：指定该虚拟主机响应的其他域名（如www子域）。
   • DocumentRoot：为每个虚拟主机指定其独立的文档根目录。
   • <Directory>：为DocumentRoot指定的目录设置权限和选项。Require all granted是Apache 2.4+的写法，等同于旧版中的Order allow,deny Allow from all。
   • ErrorLog和CustomLog：建议为每个虚拟主机配置独立的日志文件，便于故障排查和流量分析。

3. 启用虚拟主机：

   sudo a2ensite test.example.com.conf
   sudo a2ensite test2.example.com.conf

   登录后复制

4. 禁用默认虚拟主机（如果不再需要）： 如果您的默认虚拟主机（通常是000-default.conf）不再需要，或者其DocumentRoot与您的新站点有冲突，可以考虑禁用它。

   sudo a2dissite 000-default.conf

   登录后复制

5. 测试配置并重启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中文网其它相关文章！