需配置PHP版本及扩展、创建网站并指定PHP版本、将运行目录设为/public、配置Nginx伪静态规则、开启PATH_INFO并设置runtime目录权限。

如果您希望在宝塔面板中快速搭建支持ThinkPHP框架运行的Web环境,则需配置兼容PHP版本、启用必要扩展、设置正确的伪静态规则及目录权限。以下是实现该目标的具体操作步骤:
一、安装匹配的PHP版本并启用扩展
ThinkPHP 6.x 推荐使用 PHP 7.4 及以上版本,且必须启用 pdo、pdo_mysql、mbstring、openssl、curl、fileinfo 等扩展。宝塔面板支持多PHP版本共存,可为站点单独指定版本与扩展。
1、登录宝塔面板,在左侧菜单点击【软件商店】,搜索“PHP”,找到 PHP 7.4 或 PHP 8.0(根据所用ThinkPHP版本选择),点击【安装】。
2、安装完成后,点击已安装PHP版本右侧的【设置】按钮,进入【安装扩展】选项卡。
立即学习“PHP免费学习笔记(深入)”;
3、勾选 pdo_mysql、mbstring、openssl、curl、fileinfo,点击【安装】,等待全部扩展状态显示为“已安装”。
二、创建网站并配置PHP版本
新建一个独立站点,绑定域名或使用临时端口访问,同时将该站点关联到上一步安装的PHP版本,确保运行时调用正确解释器。
1、在宝塔面板左侧点击【网站】→【添加站点】。
2、填写域名(可填 localhost 或测试域名)、根目录路径(如 /www/wwwroot/thinkphp),其他选项保持默认。
3、在【PHP版本】下拉框中,选择已安装的 PHP 7.4(或对应版本),点击【提交】。
三、上传ThinkPHP项目并调整目录结构
ThinkPHP 默认入口文件位于 public/ 目录下,宝塔默认网站根目录指向项目根目录,需将网站运行目录切换至 public 子目录,否则路由和资源路径将失效。
1、通过【文件】管理器进入刚创建的网站根目录(如 /www/wwwroot/thinkphp)。
2、上传完整ThinkPHP项目压缩包,解压后确认存在 public/、app/、config/ 等标准目录。
3、返回【网站】列表,点击该站点右侧【设置】→【网站目录】,将【运行目录】修改为 /public,勾选【重载Apache/Nginx配置】,点击【保存】。
四、配置ThinkPHP专用伪静态规则
Nginx环境下需启用pathinfo或兼容模式以支持ThinkPHP的URL路由解析;Apache则依赖 .htaccess,但宝塔默认禁用,故推荐统一配置Nginx伪静态。
1、在站点【设置】中点击【伪静态】选项卡。
2、删除原有内容,粘贴以下ThinkPHP 6.x 兼容规则:
location / { try_files $uri $uri/ /index.php?$query_string; }
3、若使用ThinkPHP 5.x,替换为:location / { try_files $uri $uri/ /index.php?s=$uri&$args; }
4、点击【保存】,系统自动重载Nginx配置。
五、设置目录权限与关闭PATH_INFO限制
部分PHP版本默认关闭PATH_INFO,而ThinkPHP部分部署方式依赖该特性;同时 runtime 目录需可写,否则日志与缓存无法生成。
1、进入【网站】→【设置】→【配置文件】,在 location ~ \.php(.*)$ 块内查找 fastcgi_param PATH_INFO,并确认其未被注释;若无此行,手动添加:fastcgi_param PATH_INFO $fastcgi_path_info;
2、返回【文件】管理器,进入网站根目录下的 runtime/ 子目录,右键【权限】,将权限设为 755,并勾选【递归设置子目录文件权限】。
3、在终端中执行命令修正 owner:chown -R www:www /www/wwwroot/thinkphp/runtime











