php多版本共存本质是进程级隔离，通过指定不同php二进制路径实现：cli端用update-alternatives或path控制，默认调用；web服务器需在vhost/server中显式配置fastcgi_pass或proxypassmatch指向对应php-fpm实例；composer等工具须显式指定php版本，且cli与fpm的php.ini、扩展、opcache须各自匹配。
PHP多版本共存的核心是进程级隔离，不是“切换”而是“指定”
PHP本身不提供运行时切换版本的功能。所谓“兼容多PHP版本”，实际是指在开发或部署中，让不同项目（甚至同一台机器的不同命令）能各自使用指定的PHP二进制文件，互不干扰。关键不是改全局配置，而是控制 php 命令指向哪个可执行文件，或在Web服务器中显式调用特定版本的 php-cgi / php-fpm。
终端命令行下如何让 php 指向不同版本
本质是修改 $PATH 顺序或用别名/软链接控制默认调用路径。常见做法：
- 用
update-alternatives（Debian/Ubuntu）统一管理：sudo update-alternatives --install /usr/bin/php php /usr/bin/php7.4 74 sudo update-alternatives --install /usr/bin/php php /usr/bin/php8.1 81 sudo update-alternatives --config php
执行后会弹出交互菜单选择默认版本 - 手动软链接（简单但易冲突）：
sudo ln -sf /usr/bin/php8.1 /usr/bin/php
注意：该操作影响所有未显式指定路径的php调用 - 项目级临时覆盖（推荐）：在项目根目录写
.bashrc或直接运行时指定：PATH="/opt/php/8.2/bin:$PATH" composer install
或直接调用：/opt/php/8.2/bin/php artisan migrate
Web服务器中如何为不同站点绑定不同PHP版本
Apache 和 Nginx 不会自动识别系统PHP版本，必须显式配置处理器。重点不是“PHP怎么切”，而是“Web服务器怎么把请求交给哪个 php-fpm 实例”。
- Apache + mod_proxy_fcgi：每个
<virtualhost></virtualhost>内指定不同ProxyPassMatch到对应php-fpmsock：<FilesMatch \.php$> SetHandler "proxy:unix:/var/run/php/php8.1-fpm.sock|fcgi://localhost/" </FilesMatch>注意路径中的php8.1-fpm.sock必须与实际监听的 socket 文件一致 - Nginx：每个
server块内用fastcgi_pass指向不同php-fpm的 socket 或端口：fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
确保对应版本的php-fpm服务已启用并监听该路径 - 切勿混用
php.ini：每个php-fpm实例有独立的php.ini（如/etc/php/7.4/fpm/php.ini），扩展、内存限制等必须单独配置
Composer 和脚本执行时的PHP版本陷阱
Composer 本身是PHP脚本，它的行为完全取决于它启动时使用的 php 解释器。一个常见错误是：全局 Composer 用 PHP 7.4 安装了依赖，但项目运行时用 PHP 8.2 启动，导致 opcache 或扩展兼容问题。
立即学习“PHP免费学习笔记（深入）”；
- 检查当前 Composer 使用的 PHP：
composer --version
看输出第一行是否含预期版本号；也可运行composer show --platform
查看平台信息 - 强制 Composer 使用某版本：
php8.2 /usr/local/bin/composer install
（假设composer是 PHAR 文件） - CI/CD 中务必显式声明：
php8.1 -d memory_limit=-1 composer install
避免因环境默认版本变更导致构建失败 -
php -v和php --ini必须在每次切换后验证，尤其注意 CLI 和 FPM 的php.ini是两套
真正难的不是装多个PHP，而是确保每个上下文（CLI、FPM、Cron、CI）都明确知道自己该用哪一个，并且配置、扩展、php.ini、OPcache 状态全部匹配。漏掉任何一个环节，就可能表现为“明明切了版本，但 var_dump($_SERVER['PHP_VERSION']) 还是旧的”。
