ThinkPHP 8.0+项目宝塔上线需三步：①安装PHP 8.1/8.2并启用fileinfo等扩展；②网站根目录设为public、启用thinkphp伪静态、关闭防跨站；③删除.env、关闭APP_DEBUG、chown runtime可写。
想把ThinkPHP 8.0+项目快速上线，又怕配错PHP版本导致ParseError、改错根目录引发404、漏关APP_DEBUG暴露数据库密码——这些问题在宝塔面板里其实都有确定解法，不需要懂Linux命令也能一次跑通。
确认并安装兼容的PHP版本
ThinkPHP 8.0+强制要求PHP ≥ 8.0.0，低于此版本会直接报ParseError: syntax error, unexpected token "|"，因为框架大量使用联合类型语法，PHP 7.x完全无法识别。
登录宝塔面板 → 左侧【软件商店】→ 搜索“PHP” → 找到PHP 8.1或8.2（不推荐8.0，因8.0已停止安全更新）→ 点击【安装】→ 勾选fileinfo、mbstring、openssl、curl、pdo_mysql、ctype、json → 点击【极速安装】。
安装完成后，进【已安装】列表，点击对应PHP版本右侧【设置】→【服务管理】→ 确认状态为“正在运行”。【切勿跳过这步：未重启PHP服务会导致phpinfo()仍显示旧版本】
立即学习“PHP免费学习笔记（深入）”；
创建站点并强制指向public目录
ThinkPHP 8.0入口文件index.php位于public子目录内，若网站根目录设在项目顶层，所有请求将绕过框架路由，直接返回404或暴露敏感文件结构。
左侧【网站】→【添加站点】→ 填写域名（测试可用test.local）→ 根目录填/www/wwwroot/think8 → PHP版本下拉选择刚装好的PHP 8.1 → 提交。
上传完整项目压缩包至该根目录 → 解压 → 确认存在public/、app/、config/等标准目录。
返回【网站】列表 → 点击站点右侧【设置】→【网站目录】→ 将【运行目录】从空值改为/public → 勾选【重载Nginx配置】→ 【保存】。
配置ThinkPHP专用伪静态与关键安全项
方法一：使用宝塔内置规则（推荐）
站点【设置】→【伪静态】→ 下拉选择【thinkphp】→ 【保存】→ 【重载配置】。
方法二：手动粘贴Nginx规则（当自动模板失效时）
删除原有内容 → 粘贴以下代码：
location / {<br> try_files $uri $uri/ /index.php?$query_string;<br>}
这一步必须做：进入【网站】→【SSL】→【其他】→ 关闭【防跨站攻击(open_basedir)】。否则runtime目录写入失败、日志无法生成，且错误日志只显示“Permission denied”，无具体路径提示。
最后，用SSH连接服务器，执行：chown -R www:www /www/wwwroot/think8/runtime → 确保runtime可写。
环境变量与调试开关硬性处理
第一步：删除项目根目录下的.env文件。该文件若被Web直接访问，会泄露DB_HOST、DB_PASSWORD等全部配置，线上环境等同于敞开数据库大门。
第二步：关闭调试模式。打开宝塔【文件】管理器 → 进入/www/wwwroot/think8/public/index.php → 找到define('APP_DEBUG', true); → 改为define('APP_DEBUG', false);。
第三步：验证是否生效。浏览器访问http://your-domain.com/index.php?s=/index/index，能正常显示首页；再访问http://your-domain.com/app/，应返回403或404；访问http://your-domain.com/.env，必须返回404。
