宝塔面板与命令行升级ThinkPHP存在本质差异：宝塔通过图形界面自动处理Nginx重载、PHP-FPM绑定及伪静态注入，而命令行需手动配置文件、进程管理与权限校验；两者因扩展状态或运行目录设置不同可能导致白屏或路由失效。
跨平台升级ThinkPHP时，宝塔面板和纯命令行两种方式在操作路径、依赖控制、环境隔离性、错误反馈粒度上存在本质差异：宝塔用图形界面封装了Nginx重载、PHP-FPM服务绑定、伪静态注入等动作，而命令行需手动干预配置文件、进程管理及权限校验；同一TP版本在两者环境下可能因扩展启用状态或运行目录设置不同导致白屏或路由失效。
宝塔面板升级ThinkPHP的核心路径
进入宝塔 → 【网站】→ 找到目标站点 → 点击【设置】→ 【网站目录】→ 将【运行目录】改为 /public（必须带开头斜杠，否则请求无法命中index.php）。
在【PHP版本】选项卡中选择已安装且状态为「运行中」的目标PHP版本（如PHP-8.2），注意下拉菜单里选的是带前缀的完整标识，不是「8.2」或「PHP 8.2」。
切换后立即点击【伪静态】选项卡，从下拉列表中选择「thinkphp」规则并保存——该规则会自动注入PATH_INFO支持逻辑，避免手动写错location块。
上传新版本TP压缩包至根目录 → 在线解压 → 删除旧版runtime文件夹 → 进入【安全】选项卡关闭「防跨站攻击(open_basedir)」，否则vendor/autoload.php加载失败。
纯命令行升级ThinkPHP的关键动作
先确认当前PHP CLI版本与Web服务版本一致：执行 which php 和 /www/server/php/82/bin/php -v 对比路径与输出，若不一致，需手动启用宝塔的PHP-CLI开关或重建软链接。
cd 到网站根目录 → 执行 composer update topthink/think --with-dependencies，这一步必须指定 --with-dependencies，否则tp6.1+的依赖树（如league/event）不会同步更新，导致事件监听器丢失。
手动修改Nginx配置文件：/www/server/nginx/conf/vhost/your-site.conf，在server块内确保包含以下三行：
root /www/wwwroot/your-site/public;
try_files $uri $uri/ /index.php?$query_string;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
执行 nginx -t 验证语法 → systemctl reload nginx 重载配置 → systemctl restart php-fpm-82（注意服务名含版本号，不能只写php-fpm）。
运行目录与入口一致性验证
宝塔方式下，只要【运行目录】设为/public，Nginx配置会自动补全root指令指向public子目录，无需人工干预路径拼接。
命令行方式下，若忘记改Nginx的root指令，即使代码放在public里，请求仍会尝试加载顶层目录下的index.php，触发Fatal error: Uncaught Error: Class 'think\App' not found。
两种方式都必须删除runtime目录内容，但宝塔用户常误以为“上传即生效”，忽略这步；命令行用户则容易在composer update后忘记执行 php think optimize:route 重建路由缓存，导致新路由404。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
