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 实例”。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• Apache + mod_proxy_fcgi：每个 <VirtualHost> 内指定不同 ProxyPassMatch 到对应 php-fpm sock：

  <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']) 还是旧的”。