ThinkPHP部署到云服务器如何操作 新手指南

核心是环境稳、目录对、配置准；新手易卡在漏public目录、伪静态未配致404、runtime不可写致白屏，需确保LNMP环境（PHP7.4+/8.0）、public为网站根目录、Nginx加if重写规则、runtime可写且APP_DEBUG关闭。

ThinkPHP部署到云服务器，核心是环境搭得稳、目录放得对、配置调得准。新手最容易卡在三处：把整个项目扔进网站根目录（漏了public）、重写规则没配导致404、runtime目录不可写引发白屏。只要避开这几个坑，流程其实很清晰。

一、先配好基础环境（LNMP）

推荐用宝塔面板，不用记命令，点几下就装好Nginx、PHP、MySQL。如果手动部署，注意几点：

• PHP版本选7.4或8.0（ThinkPHP 6.x兼容性最好），必须安装php-fpm和常用扩展（mbstring、curl、pdo_mysql）
• 开启opcache并确认opcache.enable_cli = 1，否则自动加载会失效，报Class think\App not found
• MySQL建库时用utf8mb4编码，避免emoji存不进去

二、上传项目要认准public目录

ThinkPHP 6+采用入口分离结构，public才是真正的Web根目录。不能把整个项目文件夹直接丢进/www/wwwroot/xxx，否则：

• .htaccess或Nginx重写规则不生效
• 敏感目录（如app/、config/）可能被直接访问
• 路由全部404

正确做法：把本地项目的public目录内容上传到网站根目录；其余目录（app、config、runtime等）上传到上一级，比如/www/wwwroot/xxx/下再建一个thinkphp文件夹放它们。

立即学习“PHP免费学习笔记（深入）”；

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

三、Nginx配置必须加重写规则

Apache用户要确保mod_rewrite开启且站点配置中AllowOverride All；Nginx用户必须在server块里加：

别用try_files，ThinkPHP依赖s=参数解析PATH_INFO。宝塔用户可在站点设置里直接选择“ThinkPHP”伪静态模板，省去手写。

四、关键目录权限与运行配置

部署后常见白屏或500，多数因权限或配置问题：

• runtime目录必须存在且可写：chmod -R 755 runtime（Linux）；Windows主机需确认IIS或Apache用户有写入权限
• APP_DEBUG上线前务必设为false，同时检查config/app.php里是否用了Env::get(APP_DEBUG, false)，而不是硬编码
• 数据库配置写在.env里更安全，但别把它一起传上去——应通过宝塔的“环境变量”功能或Nginx的fastcgi_param注入

不复杂但容易忽略。