如何为Apache Virtual Host配置不同的PHP版本

本教程详细介绍了如何在apache服务器上为不同的虚拟主机（virtual host）配置使用独立的php版本，从而避免手动切换php模块的繁琐操作。核心方法是利用apache的`mod_proxy_fcgi`模块与php-fpm服务结合，通过在每个虚拟主机配置中指定对应的php-fpm套接字，实现高效且灵活的多版本php环境管理。

引言

在本地开发环境中，开发者经常需要同时维护使用不同PHP版本的项目。然而，传统的Apache mod_php 模块一次只能加载一个PHP版本，这意味着每次切换项目时，都需要手动启用/禁用Apache的PHP模块并重启服务，例如运行 sudo a2enmod phpX.Y && sudo a2dismod phpZ.W && sudo service apache2 restart。这种操作不仅效率低下，而且容易出错。

为了解决这一痛点，本教程将指导您如何利用Apache的虚拟主机（Virtual Host）配置，结合PHP-FPM（FastCGI Process Manager）服务，实现为每个虚拟主机指定独立的PHP版本，从而实现无缝的项目切换。

前提条件

在开始配置之前，请确保您的系统满足以下条件：

1. Apache Web 服务器已安装并运行。
2. 多个PHP-FPM版本已安装。 例如，您需要 php7.4-fpm 和 php8.0-fpm 等。在Ubuntu/Debian系统上，您可以通过以下命令安装：

   sudo apt update
   sudo apt install php7.4-fpm php8.0-fpm libapache2-mod-fcgid # libapache2-mod-fcgid is often useful

   登录后复制
3. 每个PHP-FPM服务都已启动并监听其独立的Unix套接字或端口。 默认情况下，PHP-FPM安装后会自动创建并监听Unix套接字，例如 /run/php/php7.4-fpm.sock 和 /run/php/php8.0-fpm.sock。您可以通过 systemctl status phpX.Y-fpm 命令检查其运行状态。

启用必要的Apache模块

要使Apache能够与PHP-FPM通信，您需要启用 mod_proxy 和 mod_proxy_fcgi 模块。这些模块允许Apache将PHP请求转发给PHP-FPM处理。

立即学习“PHP免费学习笔记（深入）”；

sudo a2enmod proxy
sudo a2enmod proxy_fcgi
sudo systemctl restart apache2

配置PHP-FPM池（可选，通常默认已配置）

通常，安装PHP-FPM时会自动为每个版本创建并配置一个默认的FPM池（pool）以及对应的Unix套接字。例如，php7.4-fpm 会在 /etc/php/7.4/fpm/pool.d/www.conf 中定义其池，并监听 /run/php/php7.4-fpm.sock。

如果您需要自定义池名称或套接字路径，可以编辑这些配置文件。但在大多数情况下，使用默认设置即可。

虚拟主机配置示例

现在，我们将为每个虚拟主机配置其特定的PHP版本。我们将使用 ProxyPassMatch 或 SetHandler 指令结合 mod_proxy_fcgi 来实现。

方法一：使用 SetHandler (推荐，更清晰)

这是最直接且推荐的方法，它在虚拟主机配置中明确指定如何处理 .php 文件，并将其转发到特定的PHP-FPM套接字。

1. 为 example1.local 配置 PHP 7.4

创建一个新的虚拟主机配置文件，例如 /etc/apache2/sites-available/example1.local.conf：

<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    ServerName example1.local
    DocumentRoot /var/www/example1

    <Directory /var/www/example1>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    # 配置使用 PHP 7.4-FPM
    <FilesMatch \.php$>
        SetHandler "proxy:unix:/run/php/php7.4-fpm.sock|fcgi://localhost/"
    </FilesMatch>

    ErrorLog ${APACHE_LOG_DIR}/example1_error.log
    CustomLog ${APACHE_LOG_DIR}/example1_access.log combined
</VirtualHost>

2. 为 example2.local 配置 PHP 8.0

创建另一个虚拟主机配置文件，例如 /etc/apache2/sites-available/example2.local.conf：

琅琅配音

全能AI配音神器

89

查看详情

<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    ServerName example2.local
    DocumentRoot /var/www/example2

    <Directory /var/www/example2>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    # 配置使用 PHP 8.0-FPM
    <FilesMatch \.php$>
        SetHandler "proxy:unix:/run/php/php8.0-fpm.sock|fcgi://localhost/"
    </FilesMatch>

    ErrorLog ${APACHE_LOG_DIR}/example2_error.log
    CustomLog ${APACHE_LOG_DIR}/example2_access.log combined
</VirtualHost>

请确保将 DocumentRoot 和 ServerName 替换为您的实际项目路径和域名。

方法二：使用 AddHandler (基于原始答案，需预定义Handler)

原始答案中提到了 AddHandler application/x-httpd-php74 .php 或 <IfModule mod_fastcgi.c> AddHandler php74-fcgi .php </IfModule>。这种方法依赖于 Apache 中预先定义好的 FastCGI Handler。

要使 AddHandler php74-fcgi .php 生效，您需要全局定义 php74-fcgi 这个 Handler，通常通过 mod_action 和 mod_fcgid 或 mod_cgi 模块来实现。例如，在 Apache 的全局配置或某个 conf-available 文件中：

# 启用 mod_action 和 mod_fcgid (如果尚未启用)
# sudo a2enmod action fcgid
# sudo systemctl restart apache2

# 在 /etc/apache2/conf-available/php-fpm-handlers.conf 或类似文件中定义
<IfModule mod_fcgid.c>
    # 定义 php74-fcgi 处理器
    FcgidWrapper /usr/lib/cgi-bin/php7.4-fpm-wrapper .php
    AddHandler php74-fcgi .php

    # 定义 php80-fcgi 处理器
    FcgidWrapper /usr/lib/cgi-bin/php8.0-fpm-wrapper .php
    AddHandler php80-fcgi .php
</IfModule>

其中 /usr/lib/cgi-bin/php7.4-fpm-wrapper 是一个指向 PHP-FPM 二进制文件的简单 shell 脚本，用于将请求传递给 FPM。

然后，在您的虚拟主机配置中：

<VirtualHost *:80>
    ServerName example1.local
    DocumentRoot /var/www/example1
    <IfModule mod_fcgid.c> # 对应您使用的FastCGI模块
        AddHandler php74-fcgi .php
    </IfModule>
    # ... 其他配置
</VirtualHost>

注意事项：

• mod_fastcgi.c 在现代Apache中通常指的是 mod_fcgid 或 mod_proxy_fcgi。mod_proxy_fcgi 是与PHP-FPM配合的推荐方式。
• 使用 AddHandler 方法需要额外的全局配置来定义这些Handler，不如 SetHandler "proxy:unix:..." 方法在虚拟主机内部自包含和明确。因此，对于PHP-FPM，更推荐使用方法一。

激活虚拟主机并重启Apache

配置完成后，您需要激活新的虚拟主机并重新加载Apache配置。

1. 激活虚拟主机：

   sudo a2ensite example1.local.conf
   sudo a2ensite example2.local.conf

   登录后复制
2. 禁用默认虚拟主机（如果不需要）：

   sudo a2dissite 000-default.conf

   登录后复制
3. 检查Apache配置语法：

   sudo apache2ctl configtest

   登录后复制

   如果显示 Syntax OK，则表示配置无误。

4. 重新加载Apache服务：

   sudo systemctl reload apache2

   登录后复制

验证配置

为了验证每个虚拟主机是否使用了正确的PHP版本，您可以在每个项目的 DocumentRoot 下创建一个 info.php 文件：

<?php
phpinfo();
?>

然后，在浏览器中访问 http://example1.local/info.php 和 http://example2.local/info.php。您应该能看到 phpinfo() 页面顶部显示了对应的PHP版本（例如 "PHP Version 7.4.x" 或 "PHP Version 8.0.x"）。

故障排除

• PHP-FPM服务未运行： 确保所有需要的PHP-FPM服务都已启动。例如，sudo systemctl status php7.4-fpm。
• Unix套接字路径不正确： 检查虚拟主机配置中的 proxy:unix:/path/to/socket 是否与PHP-FPM的实际监听路径一致。默认通常在 /run/php/ 目录下。
• Apache模块未启用： 确保 mod_proxy 和 mod_proxy_fcgi 模块已启用。
• 域名解析问题： 确保您的本地 /etc/hosts 文件已将 example1.local 和 example2.local 解析到 127.0.0.1。

  127.0.0.1 example1.local
  127.0.0.1 example2.local

  登录后复制

总结

通过上述配置，您已经成功地为Apache虚拟主机设置了独立的PHP版本。这种方法不仅解决了手动切换PHP版本的

以上就是如何为Apache Virtual Host配置不同的PHP版本的详细内容，更多请关注php中文网其它相关文章！