怎么在linux进行php版本控制_linux平台操作方法】

3次阅读

php cli与web版本不一致的根本原因是二者使用独立配置和二进制,需分别通过php –ini和phpinfo()确认加载的php.ini路径,修改后重启对应服务(如apache2或php8.1-fpm)。

怎么在linux进行php版本控制_linux平台操作方法】

php -v 显示的版本和 web 里不一致?查 php.ini 加载路径才是关键

linux 下 PHP 版本混乱,根本原因不是没装对,而是 CLI 和 Web(如 Apache/FPM)用了两套配置、甚至两个二进制。运行 php -v 看到的是命令行版本,而浏览器访问显示的是 Web 服务器加载的 PHP 模块版本。

必须先确认实际生效的配置位置:
php --ini —— 查 CLI 的配置路径
phpinfo()(写个临时 PHP 文件用浏览器打开)—— 查 Web 环境的 Loaded Configuration File

  • 两个环境的 php.ini 可能完全不同,改错地方等于白改
  • Web 环境下,Apache 用 libphp 模块,nginx + PHP-FPM 则由 php-fpm 进程控制,改完要重启对应服务(systemctl restart apache2systemctl restart php8.1-fpm
  • FPM 配置文件通常在 /etc/php/8.1/fpm/php.ini,别只改 /etc/php/8.1/cli/php.ini

用 apt 安装多个 PHP 版本后,怎么切系统默认的 php 命令?

ubuntu/debian 默认只允许一个 php 命令指向一个版本,靠 update-alternatives 管理,不是简单 ln -sf。

操作前先确认已安装的版本: ls /usr/bin/php* —— 看有没有 php8.1php8.2 这类带版本号的二进制

  • 如果还没注册进 alternatives,先执行:
    sudo update-alternatives --install /usr/bin/php php /usr/bin/php8.1 81
    sudo update-alternatives --install /usr/bin/php php /usr/bin/php8.2 82
  • 切换时用:
    sudo update-alternatives --config php —— 交互式选择
  • 注意:这个只影响 CLI 的 php 命令,不影响 Web 环境,也不影响 composer(它会读 PHP_BINARY 或自己找)

PHP-FPM 多版本共存:一个站点用 8.1,另一个用 8.2,怎么配?

Nginx 不直接调用 PHP 二进制,而是把请求转发给 PHP-FPM 的 socket 或端口。所以“多版本”本质是跑多个 php-fpm 实例,每个监听不同 socket,再在 server 块里指定 fastcgi_pass

例如让某个站点走 8.2:
fastcgi_pass unix:/run/php/php8.2-fpm.sock;

  • 确保对应版本的 FPM 已启用并运行:
    sudo systemctl enable php8.2-fpm
    sudo systemctl start php8.2-fpm
  • 检查 socket 文件是否存在:
    ls /run/php/php8.2-fpm.sock —— 如果没有,可能是 FPM 启动失败,看日志:
    sudo journalctl -u php8.2-fpm -n 20
  • 每个 FPM 实例有独立的 www.conf(如 /etc/php/8.2/fpm/pool.d/www.conf),里面 listen = 必须唯一,不能多个版本监听同一个 socket

升级 PHP 后网站报 class not foundundefined function?优先查扩展是否启用

PHP 主版本升级(如 7.4 → 8.1)后,很多扩展默认不自动启用,尤其是非核心扩展(如 gdmbstringcurl)。错误不是代码问题,而是扩展没加载。

立即学习PHP免费学习笔记(深入)”;

查当前启用的扩展:
php -m | grep -E 'gd|mbstring|curl'(CLI)
phpinfo() 页面里搜索 “Loaded Extensions”(Web)

  • Debian/Ubuntu 下,扩展包名带版本号,比如 php8.1-gd,升级 PHP 后旧扩展包不会自动迁移,得手动装:
    sudo apt install php8.2-gd php8.2-mbstring php8.2-curl
  • 扩展配置文件在 /etc/php/8.2/mods-available/,启用需软链到 /etc/php/8.2/fpm/conf.d//etc/php/8.2/cli/conf.d/,或用:
    sudo phpenmod -v 8.2 gd mbstring curl
  • 有些扩展(如 apcu)在新版 PHP 中行为变更,即使启用了也可能抛异常,得看具体报错再判断是不是兼容性问题

版本切换最麻烦的从来不是装几个包,而是搞清 CLI、FPM、Apache 模块三者各自加载哪份配置、哪个二进制、哪个扩展目录。漏掉任意一环,就会出现“明明改了却没生效”的情况。

text=ZqhQzanResources