Apache Virtual Host 多版本 PHP 配置实践

本文旨在提供apache virtual host配置多版本php的实用指南，解决本地开发环境中不同项目php版本需求冲突的问题。我们将详细介绍如何利用php-fpm和apache的`mod_proxy_fcgi`或`mod_fastcgi`模块，为每个虚拟主机指定独立的php版本，从而优化开发流程，提高效率，避免繁琐的手动切换。

多版本PHP共存的需求与挑战

在日常的Web开发中，开发者经常需要同时维护多个项目。这些项目可能基于不同的框架、库或CMS，对PHP版本有不同的依赖。例如，一个老旧项目可能需要PHP 7.4，而新项目则可能要求PHP 8.0或更高版本。在本地开发环境中，如果只有一个PHP版本可用，开发者将面临频繁切换PHP版本的困境。

传统的PHP版本切换方式，如通过命令行启用或禁用Apache的PHP模块（sudo a2enmod php{X} & sudo a2dismod php{Y}），并重启Apache服务，不仅操作繁琐，而且效率低下。这种方式强制所有虚拟主机使用相同的PHP版本，无法满足不同项目对独立PHP版本的需求。因此，寻求一种为每个Apache Virtual Host配置独立PHP版本的方法变得尤为重要。

核心原理：PHP-FPM与Apache的集成

要实现Apache多版本PHP的共存，关键在于理解PHP-FPM（FastCGI Process Manager）以及Apache如何通过FastCGI协议与之通信。

PHP-FPM概述： PHP-FPM是PHP FastCGI的实现，它是一个独立的进程管理器，可以运行多个PHP解释器实例。每个PHP-FPM实例都可以配置为使用特定的PHP版本，并监听不同的端口或Unix套接字。这使得我们可以在同一台服务器上同时运行PHP 7.4、PHP 8.0等多个版本的PHP。

Apache与PHP-FPM的通信： Apache本身不直接执行PHP代码，而是将PHP请求转发给PHP-FPM处理。这通常通过以下两种Apache模块实现：

1. mod_proxy_fcgi (推荐，Apache 2.4+): 这是Apache 2.4及更高版本中推荐的FastCGI代理模块。它利用Apache的mod_proxy基础设施，通过Unix套接字或TCP端口将HTTP请求代理到PHP-FPM。这种方法配置灵活，性能优异。
2. mod_fastcgi (兼容性方案): 这是一个第三方模块，也允许Apache与FastCGI进程通信。它通过FastCgiExternalServer指令定义外部FastCGI服务器，然后通过AddHandler和Action指令将PHP请求路由到该服务器。

准备工作：安装与配置多版本PHP-FPM

在配置Apache虚拟主机之前，您需要确保系统上安装了所需的所有PHP版本及其对应的FPM组件。以Ubuntu为例，您可以通过以下命令安装：

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

# 安装 PHP 7.4 及其 FPM
sudo apt update
sudo apt install php7.4 php7.4-fpm libapache2-mod-php7.4 # libapache2-mod-php7.4 是可选的，如果仅使用FPM则不需要

# 安装 PHP 8.0 及其 FPM
sudo apt install php8.0 php8.0-fpm

# 安装 PHP 8.1 及其 FPM
sudo apt install php8.1 php8.1-fpm

安装完成后，请确认各个PHP-FPM服务正在运行，并且它们监听的是不同的Unix套接字或TCP端口。默认情况下，PHP-FPM服务会创建Unix套接字，例如：

• PHP 7.4-FPM: /run/php/php7.4-fpm.sock
• PHP 8.0-FPM: /run/php/php8.0-fpm.sock
• PHP 8.1-FPM: /run/php/php8.1-fpm.sock

您可以使用systemctl status phpX.Y-fpm命令检查服务状态。

方法一：通过 Virtual Host 配置指定PHP版本 (推荐)

这是最推荐和最灵活的方法，能够为每个虚拟主机精确地指定PHP版本。

1. 使用 mod_proxy_fcgi (Apache 2.4+ 推荐)

步骤：

1. 启用必要的Apache模块：

   

   ViiTor实时翻译

   AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

   116

   查看详情

   sudo a2enmod proxy proxy_fcgi
   sudo systemctl restart apache2

   登录后复制

2. 配置虚拟主机： 在每个虚拟主机的配置文件中（例如/etc/apache2/sites-available/example1.local.conf），添加相应的配置来指定PHP-FPM套接字。

   示例代码： 假设 example1.local 使用 PHP 7.4，example2.local 使用 PHP 8.0。

   # example1.local.conf - 使用 PHP 7.4
   <VirtualHost *:80>
       ServerName example1.local
       DocumentRoot /var/www/example1
       ErrorLog ${APACHE_LOG_DIR}/example1_error.log
       CustomLog ${APACHE_LOG_DIR}/example1_access.log combined
   
       <Directory /var/www/example1>
           Options Indexes FollowSymLinks
           AllowOverride All
           Require all granted
       </Directory>
   
       # 将所有 .php 文件的请求代理到 PHP 7.4 FPM 的 Unix 套接字
       <FilesMatch \.php$>
           SetHandler "proxy:unix:/run/php/php7.4-fpm.sock|fcgi://localhost"
       </FilesMatch>
   
       # 另一种 ProxyPassMatch 的写法，效果类似
       # ProxyPassMatch ^/(.*\.php(/.*)?)$ unix:/run/php/php7.4-fpm.sock|fcgi://localhost/$1
   </VirtualHost>
   
   # example2.local.conf - 使用 PHP 8.0
   <VirtualHost *:80>
       ServerName example2.local
       DocumentRoot /var/www/example2
       ErrorLog ${APACHE_LOG_DIR}/example2_error.log
       CustomLog ${APACHE_LOG_DIR}/example2_access.log combined
   
       <Directory /var/www/example2>
           Options Indexes FollowSymLinks
           AllowOverride All
           Require all granted
       </Directory>
   
       # 将所有 .php 文件的请求代理到 PHP 8.0 FPM 的 Unix 套接字
       <FilesMatch \.php$>
           SetHandler "proxy:unix:/run/php/php8.0-fpm.sock|fcgi://localhost"
       </FilesMatch>
   </VirtualHost>

   登录后复制

3. 启用虚拟主机并重启Apache：

   sudo a2ensite example1.local.conf
   sudo a2ensite example2.local.conf
   sudo systemctl restart apache2

   登录后复制

注意事项：

• 确保 DocumentRoot 和 Directory 指向正确的项目路径。
• AllowOverride All 允许 .htaccess 文件生效，但对于PHP版本切换，VHost配置已足够。
• fcgi://localhost 是必需的，即使是Unix套接字连接，mod_proxy_fcgi 也要求一个主机名。

2. 使用 mod_fastcgi (兼容性方案)

步骤：

1. 安装并启用 mod_fastcgi：mod_fastcgi 通常不是Apache的默认模块，可能需要手动安装或编译。在Ubuntu上，它可能作为libapache2-mod-fastcgi包提供。

   sudo apt install libapache2-mod-fastcgi # 如果可用
   sudo a2enmod fastcgi
   sudo systemctl restart apache2

   登录后复制

2. 配置虚拟主机： 在虚拟主机配置文件中，使用 FastCgiExternalServer 定义外部PHP-FPM服务，并通过 AddHandler 和 Action 将请求路由到它。

   示例代码： 假设 example3.local 使用 PHP 8.1。

   # example3.local.conf - 使用 PHP 8.1
   <VirtualHost *:80>
       ServerAdmin webmaster@example.com
       ServerName example3.local
       DocumentRoot /var/www/example3
       ErrorLog ${APACHE_LOG_DIR}/example3_error.log
       CustomLog ${APACHE_LOG_DIR}/example3_access.log combined
   
       # 定义 PHP 8.1 FastCGI 服务器
       # 第一个参数是虚拟路径，第二个参数是实际的FPM套接字或端口
       FastCgiExternalServer /var/www/php-fpm/php8.1-fpm -socket /run/php/php8.1-fpm.sock -idle-timeout 300
   
       <Directory /var/www/example3>
           Options Indexes FollowSymLinks
           AllowOverride All
           Require all granted
       </Directory>
   
       <IfModule mod_fastcgi.c>
           # 定义一个处理器名称，例如 php81-fcgi
           AddHandler php81-fcgi .php
           # 将该处理器映射到 FastCgiExternalServer 定义的虚拟路径
           Action php81-fcgi /var/www/php-fpm/php8.1-fpm virtual
       </IfModule>
   </VirtualHost>

   登录后复制

3. 启用虚拟主机并重启Apache：

   sudo a2ensite example3.local.conf
   sudo systemctl restart apache2

   登录后复制

注意事项：

• FastCgiExternalServer 的第一个参数 /var/www/php-fpm/php8.1-fpm 是一个任意的虚拟路径，但必须是可写的目录或其父目录存在且可写，因为 mod_fastcgi 可能会在那里创建临时文件。
• Action 指令将 .php 文件请求（通过 AddHandler 识别）转发给 FastCgiExternalServer 定义的虚拟路径。

方法二：通过 .htaccess 文件局部配置 (有限场景)

虽然虚拟主机配置是管理多版本PHP的首选，但在某些特定

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