ThinkPHP项目部署完整流程详解-ThinkPHP-PHP中文网

thinkphp部署失败主因是public目录未设为web根目录、vendor/autoload.php未加载或url重写失效；需确保documentroot/root指向public、执行composer install --no-dev、配置thinkphp专用重写规则，并保证opcache.enable_cli=1及runtime目录洁净可写。

thinkphp项目部署完整流程详解

ThinkPHP项目部署失败，八成卡在 public 目录没设对、vendor/autoload.php 没加载或 URL 重写没生效——不是代码有问题，是运行时环境链断了。

Web 服务器根目录必须指向 `public` 目录

这是最常被跳过的硬性前提。ThinkPHP 6+ 采用「前端控制器」结构，所有请求必须经由 public/index.php 入口统一调度。若把整个项目（含 app/、config/、vendor/）直接扔进 /var/www/html，会导致：

app/ 和 config/ 目录暴露在 Web 可访问路径下，存在源码泄露风险
index.php 找不到 vendor/autoload.php（因相对路径错位），报 Class 'think\App' not found
静态资源（如 public/static/）404，CSS/JS 加载失败

实操建议：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

Apache：在虚拟主机配置中明确指定 DocumentRoot "/path/to/your/project/public"，并确保对应 <directory></directory> 块内有 AllowOverride All
Nginx：root 指令必须写成 root /path/to/your/project/public;，不是项目根目录
宝塔面板：新建站点后，在「网站设置 → 根目录」里手动改为 public 子目录

`composer install --no-dev` 必须在服务器上执行

本地开发时的 vendor/ 目录不能直接复制上传。原因有三：

本地和服务器 PHP 版本、扩展可能不同，autoload_classmap.php 等缓存文件不兼容
开发依赖（如 phpunit、faker）不该出现在生产环境
若用 Git 部署，vendor/ 通常被 .gitignore 排除，上传后为空

实操建议：

上传前删掉本地 vendor/ 和 runtime/ 目录
上传 composer.json 和 composer.lock 后，在项目根目录执行：
composer install --no-dev --optimize-autoloader
确认执行后 vendor/autoload.php 存在且可读，php -m | grep opcache 输出非空，且 opcache.enable_cli=1 已启用（否则 php think 命令会失败）

Nginx/Apache 伪静态规则不能套用 Laravel 或 WordPress 模板

ThinkPHP 的路由解析依赖 s= 参数（PATH_INFO 模式），和 Laravel 的 try_files 行为完全不同。错用规则会导致：

访问 /index/index 404，但加 /index.php/index/index 能通
后台登录页跳转后丢失 session，因路由未正确分发到控制器

实操建议：

Nginx：在 server 块内使用标准规则：

location / {<br>    if (!-e $request_filename) {<br>        rewrite ^(.*)$ /index.php?s=$1 last;<br>    }<br>}

Apache：确认 .htaccess 在 public/ 目录下，内容为：

RewriteEngine On<br>RewriteCond %{REQUEST_FILENAME} !-d<br>RewriteCond %{REQUEST_FILENAME} !-f<br>RewriteRule ^(.*)$ index.php?s=$1 [QSA,PT,L]

禁用「自动匹配伪静态」功能，手动粘贴 ThinkPHP 专用规则

`runtime` 和 `log` 目录权限与清空策略

线上关闭 APP_DEBUG = false 后，错误默认写入 runtime/log/。白屏却不报错，基本是这个目录不可写或已塞满旧日志。

runtime/ 必须存在且 Web 进程可写（Linux 下常用 chown -R www-data:www-data runtime + chmod -R 755 runtime）
不要上传本地生成的 runtime/cache/、runtime/log/、runtime/temp/ —— 它们应为空目录结构，由运行时动态创建
若部署后路由缓存失效，执行 php think clear 清除所有缓存，而非手动删文件
检查 config/app.php 中 'runtime_path' 是否被硬编码为绝对路径（如 /Users/xxx/runtime），应保持为相对路径 __DIR__ . '/../runtime/'