宝塔多php版本需手动绑定站点并确保php-fpm运行及配置匹配，cli默认路径不自动切换，扩展需按版本单独安装，composer需同步更新php版本约束。
PHP 版本在宝塔里装了却用不上？检查 php -v 和网站配置是否对得上
宝塔装了多个 PHP 版本，但命令行执行 php -v 还是旧版本，或者网站直接报 500、提示“PHP not found”，大概率是系统默认 PHP 路径没切，或站点没手动指定版本。宝塔的多版本是「并存不自动切换」，它不会帮你改系统级软链接，也不会替你把每个网站绑到新 PHP。
- 先确认当前 CLI 的 PHP 是哪个：
which php，再看php -v输出的路径和版本 - 宝塔安装的 PHP 实际在
/www/server/php/下，比如/www/server/php/81对应 PHP 8.1，里面bin/php才是可执行文件 - 如果想让终端默认用新版，得手动改软链接（如
ln -sf /www/server/php/81/bin/php /usr/bin/php），但注意：这会影响所有依赖系统 PHP 的脚本（比如某些宝塔插件、shell 脚本），不推荐盲目替换 - 更安全的做法是：只在网站设置里绑定 PHP 版本——进宝塔 → 网站 → 设置 → PHP 版本 → 选对应版本（如
php-81）
切换 PHP 版本后网站白屏或 502？重点查 php-fpm 是否启动 + 配置是否匹配
宝塔里点了“切换 PHP 版本”，但网站打不开，常见原因是新版本的 php-fpm 没起来，或者 www.conf 里监听方式和 Nginx 不一致。
- 进宝塔 → 软件商店 → 找到对应 PHP 版本（如 PHP-8.1）→ 点击“设置” → “服务” → 确保
php-fpm状态是“已启动”；没启就点启动，失败则看日志（/www/wwwlogs/php81.log） - 检查该 PHP 版本的
www.conf（路径类似/www/server/php/81/etc/php-fpm.d/www.conf），确认listen是 socket 还是 TCP：
– 如果是listen = /tmp/php-cgi-81.sock，Nginx 配置里必须用fastcgi_pass unix:/tmp/php-cgi-81.sock
– 如果是listen = 127.0.0.1:9001，就得对应fastcgi_pass 127.0.0.1:9001 - 宝塔通常自动同步，但如果你手动改过 Nginx 配置或用了自定义模板，可能残留旧端口/sock 路径，要核对
扩展没加载、mysqli 或 redis 报错？每个 PHP 版本的扩展是独立编译的
PHP 多版本并行时，每个版本的 extension_dir 和已启用扩展完全隔离。你在 PHP 7.4 装了 redis.so，不代表 PHP 8.1 就有；不重新安装、不手动开启，就会报 Class 'Redis' not found 或 Call to undefined function mysqli_connect()。
- 进宝塔 → 软件商店 → 找到目标 PHP 版本 → 点“设置” → “安装扩展”，勾选需要的（如
redis、opcache、fileinfo）→ 安装完记得重启php-fpm - 如果扩展列表里没有你要的（比如
swoole），需手动编译：进对应 PHP 目录（如/www/server/php/81），运行bin/phpize→./configure --with-php-config=bin/php-config→make && make install，再在etc/php.ini里加extension=swoole.so - 验证是否生效：新建一个
phpinfo.php放网站根目录，访问看输出里有没有对应扩展模块，别只信php -m | grep redis，CLI 和 FPM 的php.ini可能不同
升级 PHP 后 Composer 报错 Your requirements could not be resolved？composer.json 的 php 约束没更新
项目里 composer.json 写着 "php": "^7.4"，但你现在用的是 PHP 8.1，Composer 默认会按当前 PHP 版本校验兼容性。它不是报语法错，而是拒绝安装/更新，因为觉得“这个包不支持我这个 PHP 版本”。
- 临时绕过：加
--ignore-platform-reqs（如composer install --ignore-platform-reqs），但仅限调试，上线前必须处理真实兼容问题 - 正确做法：改
composer.json里的php约束，比如改成"php": "^8.1"或宽松点"php": ">=8.1 - 注意：有些包（如老版本 Laravel、ThinkPHP）确实不兼容 PHP 8+，不能硬升；得先查文档或升级框架本身，否则即使 Composer 过了，运行时也会崩
最常被忽略的一点：宝塔里看似切换成功了，但 phpinfo() 显示的 Loaded Configuration File 路径，可能和你编辑的 php.ini 不是一份——每个 PHP 版本的配置文件路径不同，改错地方等于白改。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
