本文旨在提供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模块实现：
- mod_proxy_fcgi (推荐，Apache 2.4+): 这是Apache 2.4及更高版本中推荐的FastCGI代理模块。它利用Apache的mod_proxy基础设施，通过Unix套接字或TCP端口将http请求代理到PHP-FPM。这种方法配置灵活，性能优异。
- 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+ 推荐)
步骤：
-
启用必要的Apache模块：
sudo a2enmod proxy proxy_fcgi sudo systemctl restart apache2
-
配置虚拟主机： 在每个虚拟主机的配置文件中（例如/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>
-
启用虚拟主机并重启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 (兼容性方案)
步骤：
-
安装并启用 mod_fastcgi：mod_fastcgi 通常不是Apache的默认模块，可能需要手动安装或编译。在Ubuntu上，它可能作为libapache2-mod-fastcgi包提供。
sudo apt install libapache2-mod-fastcgi # 如果可用 sudo a2enmod fastcgi sudo systemctl restart apache2
-
配置虚拟主机： 在虚拟主机配置文件中，使用 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> -
启用虚拟主机并重启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的首选，但在某些特定