必装fileinfo和opcache：前者支撑Laravel MIME判断，后者提升性能并保障autoload；安装时应跳过snmp等易致失败的冷门扩展，且新PHP需手动绑定站点、重启对应php-fpm以清OPcache。
宝塔软件商店安装PHP版本时，扩展勾选不全会直接导致项目报错
fileinfo 和 opcache 是两个最容易被忽略但又最关键的基础扩展。Laravel 的 Storage::put() 依赖 fileinfo 提供 MIME 类型判断，缺它会抛出 Call to undefined function mime_content_type()；而没开 opcache，ThinkPHP 或 Laravel 启动慢一倍以上，且部分 Composer autoload 逻辑会异常。
安装时别全选扩展——snmp、pspell、recode 这类冷门扩展在 CentOS/Ubuntu 上常因系统缺依赖（如 net-snmp-devel）导致整个 PHP 安装中断，面板只报“安装失败”，不提示具体缺什么。
建议操作：
- 必勾：
fileinfo、opcache、pdo、mysqli、redis（如需 Redis） - 按需勾：
imagick（需提前在系统装好ImageMagick库，否则静默跳过） - 跳过：
snmp、pspell、recode、tidy等非业务必需项
安装完PHP版本，网站仍用旧版？不是没装好，是没手动绑定
宝塔不会自动把新装的 PHP 版本分配给任何站点。哪怕你装了 PHP-8.2，所有网站默认仍走面板当前“默认PHP版本”（通常是最早装的那个），除非你进每个站点设置里明确选择。
立即学习“PHP免费学习笔记（深入）”；
常见错误现象：
- 宝塔 PHP 管理页显示
PHP-8.2状态为“正在运行”，但访问网站phpinfo()显示的还是7.4 - 点击站点设置 → PHP版本下拉菜单里没有
PHP-8.2选项（说明安装未完成或服务未启动） - 选了新版本点保存，但页面报
502 Bad Gateway（大概率是php-fpm-82进程根本没起来）
验证步骤：
- 执行
ps aux | grep php-fpm，确认出现类似php-fpm: master process (/www/server/php/82/etc/php-fpm.conf)的进程行 - 检查
/www/server/php/82/var/run/php-fpm.sock文件是否存在且属主为www:www - 去「软件管理」页面，找到
PHP-8.2，点「设置」→「服务」，确保「PHP-FPM 服务」状态为已启动
CLI 命令行调用 PHP 与网站用的版本完全无关
你在 SSH 里敲 php -v 或运行 composer install，调用的是系统级软链接（通常指向 /usr/bin/php → /www/server/php/80/bin/php），和你在面板里给某个网站绑定的 PHP-8.2 毫无关系。
这会导致严重问题：
-
composer install用PHP-8.0解析composer.json，但网站实际跑在PHP-8.2上，结果依赖装错版本，运行时报class not found - 计划任务里写
php /www/wwwroot/test/cron.php，却因 CLI 默认是7.4而触发语法错误（比如用了match表达式）
正确做法：
- 临时调用：直接用绝对路径，例如
/www/server/php/82/bin/php composer.phar install - 加别名（推荐）：
alias php82='/www/server/php/82/bin/php'，然后php82 -v - 切勿直接改
/usr/bin/php软链——宝塔后台任务、插件脚本都可能崩
切换PHP版本后页面行为没变？先清 OPcache 再重启 php-fpm
很多用户切换到 PHP-8.1 后，phpinfo() 显示版本对了，但老代码照样报错、新特性不生效。这不是配置没生效，而是 OPcache 缓存了旧版本编译的 opcode，还在继续执行。
关键点：
- 每个 PHP 版本的 OPcache 是独立的，
/www/server/php/74/etc/php.ini里的opcache.enable不影响81版本 - 仅重启 Nginx 不管用，必须重启对应版本的
php-fpm（比如php-fpm-81）才能清空其 OPcache - 如果想手动清空，可访问
http://你的域名/ocp.php（需自己放一个含opcache_reset()的脚本），但前提是该脚本由目标版本解析
最稳妥流程：改完站点绑定 → 进「PHP管理」→ 找到目标版本 → 「设置」→ 「服务」→ 「重启」。别跳过这步。
