多PHP版本共存怎么切换运行版本

“纵有疾风来，人生不言弃”，这句话送给正在学习文章的朋友们，也希望在阅读本文《多PHP版本共存如何指定运行版本》后，能够真的帮助到大家。我也会在后续的文章中，陆续更新文章相关的技术文章，有好的建议欢迎大家在评论留言，非常感谢！

必须用 update-alternatives 管理 PHP 多版本共存，因其可原子化同步 php、phpize、php-config 等 CLI 工具链；而 ln -sf 仅改 php 命令，导致 Apache 模块、PHP-FPM、Composer 等因版本不一致报错。

PHP 多版本共存时，不能靠改 php 命令软链接硬切，必须用 update-alternatives 注册并管理，否则 CLI、Apache、CLI 工具链（如 Composer）会不一致甚至报错。

为什么不能直接 ln -sf 切换 /usr/bin/php

手动改软链接只影响 CLI 的 php 命令，但 Apache 的 libphp.so、php-fpm 服务、phpize、php-config 都各自独立；Composer 依赖 php 和 php-config 版本匹配，硬切后常报 PHP version mismatch。

• update-alternatives 能统一注册 php、phpize、php-config 等关联命令，保证原子切换
• Apache 模块和 FPM 实例仍需单独配置（它们不走 alternatives），但 CLI 环境可保持干净
• 不同版本的 php 二进制路径必须已存在，比如 /usr/bin/php7.4、/usr/bin/php8.1

注册 PHP 版本到 update-alternatives

每个 PHP 二进制及其配套工具都要分别注册。以 PHP 7.4 和 8.1 为例：

sudo update-alternatives --install /usr/bin/php php /usr/bin/php7.4 74 \
  --slave /usr/bin/phpize phpize /usr/bin/phpize7.4 \
  --slave /usr/bin/php-config php-config /usr/bin/php-config7.4
<p>sudo update-alternatives --install /usr/bin/php php /usr/bin/php8.1 81 \
--slave /usr/bin/phpize phpize /usr/bin/phpize8.1 \
--slave /usr/bin/php-config php-config /usr/bin/php-config8.1</p>

• 末尾数字（74、81）是优先级，越大越可能被自动选中
• --slave 必须跟主项同名（如 php 主项，phpize 就是它的 slave），否则切换时不会联动
• 注册前确认对应命令真实存在，例如 ls /usr/bin/php* /usr/bin/phpize*

切换默认 PHP 版本（含关联工具）

运行交互式选择，所有注册的 slave 会同步变更：

sudo update-alternatives --config php

终端会列出选项，输入编号回车即可。验证是否生效：

php -v
phpize -v
php-config --version

• 如果 php -v 和 php-config --version 不一致，说明某个 slave 没注册对，重查路径和 --slave 参数
• 切换后 Composer 可能缓存旧版本信息，执行 composer clear-cache 再试
• 某些发行版（如 Ubuntu 22.04+）默认用 php8.1，若需降级，必须显式 --config，不能依赖优先级自动选

Apache 和 PHP-FPM 不受 update-alternatives 影响

update-alternatives 只管 CLI 工具链，Web 服务需单独处理：

• Apache：通过 a2dismod php7.4 && a2enmod php8.1 切换模块，再 systemctl restart apache2
• PHP-FPM：启用对应服务，如 systemctl enable php8.1-fpm && systemctl restart php8.1-fpm，并在 vhost 或 Nginx 配置里指定 fastcgi_pass 127.0.0.1:9081
• 务必检查 phpinfo() 页面中的 Loaded Configuration File，确认 Web 环境实际加载的是目标版本的 php.ini

真正麻烦的从来不是切换命令，而是让 CLI、Web、构建工具三者指向同一套头文件、扩展和配置——update-alternatives 解决了 CLI 层，剩下两层得自己盯住路径和 reload 行为。

本篇关于《多PHP版本共存怎么切换运行版本》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！