本文旨在指导开发者如何在 apache 服务器上为不同的虚拟主机配置独立的 php 版本，以解决在开发多项目时频繁切换 php 版本带来的不便。我们将重点介绍利用 php-fpm 和 apache 的 `mod_proxy_fcgi` 模块实现版本隔离的核心原理与实践步骤，并提供详细的配置示例和注意事项，帮助您构建高效灵活的开发环境。
在本地开发环境中，管理多个使用不同 PHP 版本的项目是一个常见需求。传统上，通过启用/禁用 Apache 的 mod_php 模块来切换 PHP 版本既繁琐又低效。更优的解决方案是让每个 Apache 虚拟主机独立地运行其所需的 PHP 版本。这通常通过将 Apache 与 PHP-FPM (FastCGI Process Manager) 结合使用来实现。
理解 PHP 运行模式：为何选择 PHP-FPM
在深入配置之前，了解 PHP 不同的运行模式至关重要：
- mod_php (或 php_module): 这是 PHP 作为 Apache 模块直接加载的方式。它的优点是配置简单，但缺点是每个 Apache 进程都会加载 PHP 解释器，资源消耗较大。更重要的是，在同一 Apache 实例下，只能同时启用一个 PHP 版本，这使得多版本共存变得困难。
-
CGI / FastCGI / PHP-FPM:
- CGI (Common Gateway Interface): 每次请求都会启动一个新的 PHP 进程，效率低下。
- FastCGI: CGI 的改进版本，PHP 进程以守护进程形式运行，避免了每次请求都启动新进程的开销。
- PHP-FPM (FastCGI Process Manager): 专为 PHP 设计的 FastCGI 实现，提供了进程管理、错误日志、慢日志等高级功能。它是实现 Apache 多版本 PHP 的首选方案，因为它允许不同版本的 PHP-FPM 独立运行，监听不同的端口或 Unix socket。
选择 PHP-FPM 的主要原因在于其隔离性和灵活性。每个 PHP-FPM 实例可以独立配置，互不干扰，从而轻松实现 Apache 虚拟主机与特定 PHP 版本的绑定。
准备工作：安装与配置多版本 PHP-FPM
首先，确保您的系统上安装了所需的不同 PHP 版本及其对应的 PHP-FPM 服务。以 Ubuntu 为例，您可以使用 apt 命令安装：
立即学习“PHP免费学习笔记（深入）”；
sudo apt update sudo apt install php7.4-fpm php8.0-fpm php5.6-fpm
安装完成后，每个 PHP-FPM 版本通常会创建一个独立的 Unix socket 文件或监听一个 TCP 端口。您可以通过查看其配置文件来确认：
- PHP 7.4-FPM: 通常在 /etc/php/7.4/fpm/pool.d/www.conf 中配置，默认监听 unix:/run/php/php7.4-fpm.sock。
- PHP 8.0-FPM: 通常在 /etc/php/8.0/fpm/pool.d/www.conf 中配置，默认监听 unix:/run/php/php8.0-fpm.sock。
- PHP 5.6-FPM: 同样会在 /etc/php/5.6/fpm/pool.d/www.conf 中配置，可能监听 unix:/run/php/php5.6-fpm.sock 或一个 TCP 端口（如 127.0.0.1:9000）。
如果需要，您可以修改这些配置文件，为每个 PHP-FPM 实例指定不同的 Unix socket 路径或 TCP 端口，以避免冲突和提高可读性。例如，将 PHP 5.6-FPM 配置为监听 127.0.0.1:9000。修改后请重启相应的 PHP-FPM 服务：
sudo systemctl restart php7.4-fpm sudo systemctl restart php8.0-fpm sudo systemctl restart php5.6-fpm
核心配置：Apache 虚拟主机与 PHP-FPM 整合
要将 Apache 虚拟主机与特定的 PHP-FPM 实例连接起来，我们需要启用 Apache 的 mod_proxy 和 mod_proxy_fcgi 模块。
-
启用必要的 Apache 模块:
sudo a2enmod proxy sudo a2enmod proxy_fcgi sudo a2enmod setenvif # 某些配置可能需要 sudo service apache2 restart
-
配置虚拟主机: 在每个虚拟主机的配置文件中（通常位于 /etc/apache2/sites-available/），使用 ProxyPassMatch 指令将 .php 请求转发到对应的 PHP-FPM socket 或端口。
以下是为不同虚拟主机配置不同 PHP 版本的示例：
示例一：example1.local 使用 PHP 7.4
<VirtualHost *:80> ServerAdmin webmaster@example1.local ServerName example1.local DocumentRoot /var/www/example1 <Directory /var/www/example1> Options Indexes FollowSymLinks AllowOverride All Require all granted </Directory> # 将 .php 请求转发到 PHP 7.4-FPM 的 Unix socket <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>示例二：example2.local 使用 PHP 8.0
<VirtualHost *:80> ServerAdmin webmaster@example2.local ServerName example2.local DocumentRoot /var/www/example2 <Directory /var/www/example2> Options Indexes FollowSymLinks AllowOverride All Require all granted </Directory> # 将 .php 请求转发到 PHP 8.0-FPM 的 Unix socket <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>示例三：example4.local 使用 PHP 5.6 (假设监听 TCP 端口 9000)
<VirtualHost *:80> ServerAdmin webmaster@example4.local ServerName example4.local DocumentRoot /var/www/example4 <Directory /var/www/example4> Options Indexes FollowSymLinks AllowOverride All Require all granted </Directory> # 将 .php 请求转发到 PHP 5.6-FPM 的 TCP 端口 <FilesMatch \.php$> SetHandler "proxy:fcgi://127.0.0.1:9000" </FilesMatch> ErrorLog ${APACHE_LOG_DIR}/example4_error.log CustomLog ${APACHE_LOG_DIR}/example4_access.log combined </VirtualHost>配置解释:
- ServerName: 虚拟主机的域名。
- DocumentRoot: 网站文件根目录。
- <FilesMatch \.php$>: 匹配所有 .php 文件。
- SetHandler "proxy:unix:/path/to/php-fpm.sock|fcgi://localhost/": 这是将请求通过 mod_proxy_fcgi 转发到指定 PHP-FPM Unix socket 的关键指令。fcgi://localhost/ 部分是 FastCGI 协议要求，通常可以保持不变。
- SetHandler "proxy:fcgi://127.0.0.1:9000": 如果 PHP-FPM 监听 TCP 端口，则使用此格式。
-
启用虚拟主机并重启 Apache:
sudo a2ensite example1.local.conf sudo a2ensite example2.local.conf sudo a2ensite example4.local.conf sudo service apache2 restart
替代方案：使用 AddHandler (特定场景)
原始问题中提到了使用 AddHandler 的方法，这通常用于将特定文件类型映射到已定义的处理器。
-
在虚拟主机配置中使用 AddHandler:
<VirtualHost *:80> ServerAdmin webmaster@example.com ServerName example.com ServerAlias www.example.com DocumentRoot /var/www/html/example # 确保 mod_fastcgi 或 mod_fcgid 已启用并配置了对应的处理器 <IfModule mod_fastcgi.c> AddHandler php74-fcgi .php </IfModule> # 或者 <IfModule mod_fcgid.c> # AddHandler php74-fcgi .php # FcgidWrapper /path/to/php-cgi-7.4 .php # </IfModule> ErrorLog ${APACHE_LOG_DIR}/error.log CustomLog ${APACHE_LOG_DIR}/access.log combined </VirtualHost>解释: 这里的 AddHandler php74-fcgi .php 意味着 Apache 会将 .php 文件交给名为 php74-fcgi 的处理器处理。这个处理器本身需要由其他模块（如 mod_fastcgi 或 mod_fcgid）定义，并指向具体的 PHP-FPM socket 或一个包装脚本（wrapper script）。例如，mod_fcgid 可以通过 FcgidWrapper 指令来定义这样的处理器。
这种方法相对于 ProxyPassMatch 来说，其底层处理器（php74-fcgi）的定义和管理可能更为复杂，需要确保系统层面已经注册了这些处理器。在现代 Apache + PHP-FPM 的组合中，mod_proxy_fcgi 配合 SetHandler "proxy:..." 的方式更为直接和推荐。
-
在 .htaccess 文件中使用 AddHandler: 理论上，您也可以在项目的 .htaccess 文件中添加 AddHandler 指令：
# .htaccess 文件内容 AddHandler application/x-httpd-php74 .php
这要求 Apache 配置允许 .htaccess 中的 AddHandler 指令（AllowOverride All），并且服务器环境已全局或局部配置了 application/x-httpd-php74 这样的 MIME 类型处理器，使其能够正确地调用对应的 PHP 版本。然而，这种方式的灵活性和隔离性不如直接在虚拟主机配置中通过 mod_proxy_fcgi 指向 PHP-FPM socket。在多版本 PHP-FPM 场景下，不推荐将此作为主要配置方式，因为它可能依赖于系统更深层次的配置，且容易造成混淆。
注意事项与最佳实践
- 权限管理: 确保 Apache 用户（通常是 www-data）对 PHP-FPM 的 Unix socket 文件有读写权限，以及对网站根目录和文件的执行和读取权限。
- 错误排查: 如果遇到问题，请检查 Apache 的错误日志 (/var/log/apache2/error.log) 和各个 PHP-FPM 服务的日志（例如 /var/log/php7.4-fpm.log）。
- PHP-FPM 配置: 每个 PHP-FPM 实例的 www.conf 文件中，可以调整 pm.max_children, pm.start_servers 等参数以优化性能。
- 域名解析: 确保您的本地开发环境的 /etc/hosts 文件已正确配置，将 example1.local, example2.local 等域名解析到 127.0.0.1。
- HTTPS/SSL 配置: 如果您的虚拟主机需要支持 HTTPS，请确保在 VirtualHost 配置中为端口 443 添加相应的 SSLCertificateFile 和 SSLCertificateKeyFile 指令，并同样配置 PHP-FPM 转发。
- 生产环境: 生产环境的配置可能需要更复杂的负载均衡和高可用性考虑，但核心原理是相同的。
总结
通过将 Apache 与 PHP-FPM 结合，并利用 Apache mod_proxy_fcgi 模块的 SetHandler 指令，您可以轻松地为不同的虚拟主机配置独立的 PHP 版本。这种方法不仅解决了多项目开发中 PHP 版本切换的痛点，还提供了更好的性能隔离和稳定性。遵循本文提供的步骤和示例，您将能够构建一个高效且灵活的 Apache 多版本 PHP 开发环境。
