17370845950

ThinkPHP上线需严守三大要点：public必须为Web根目录，runtime目录须逐级赋权并验证写入，APP_DEBUG必须显式设为false并清缓存；任一遗漏将导致500错误、路由失效或敏感信息泄露。

ThinkPHP 部署本身不复杂，但「上线流程复杂度」取决于你是否跳过关键检查项——多数线上问题（500 错误、路由失效、静态资源 404）都源于部署时的环境错配或权限遗漏，而非框架本身。

确认 PHP 环境和扩展是否达标

ThinkPHP 6.x 要求 PHP >= 7.2（推荐 8.0+），且必须启用 curl、mbstring、openssl、pdo_mysql（或对应数据库扩展）。常见错误是服务器默认没开 mbstring，导致路由解析失败，报 Class "think\App" not found 或空白页。

• 用 php -m | grep -E "(curl|mbstring|openssl|pdo)" 快速核对
• 若用宝塔/AMH，进 PHP 设置 → 安装扩展，别只点「安装」就走，要重启 PHP 服务
• ThinkPHP 6 的 composer install 必须在目标服务器执行（或带 --no-dev），不能直接复制本地 vendor 目录（Windows 和 Linux 的符号链接、文件权限表现不同）

public 目录必须为 Web 根目录

这是最常被忽略的硬性要求。ThinkPHP 不允许将整个项目放 Web 根下（如 Apache 的 /var/www/html/），否则 app、config、runtime 等敏感目录可被直接访问。

• Nginx 示例配置中，root 必须指向 /path/to/your/project/public，不是项目根目录
• Apache 需启用 mod_rewrite，且确保 .htaccess 在 public 下生效（AllowOverride All）
• 如果只能把项目放子目录（如 https://site.com/tp6/），需在 config/app.php 中设置 'base_url' => '/tp6'，并调整 Nginx 的 location 块加前缀重写

runtime 目录权限和写入测试

runtime 是日志、缓存、模板编译的落盘目录，部署后首次访问常因权限不足直接报 500，错误日志却可能被卡在写不进去的状态里。

• 执行 chmod -R 755 runtime/（Linux）或确保 Web 进程用户（如 www-data 或 nginx）有读写权限
• 手动创建一个测试文件验证：php -r "file_put_contents('runtime/test.txt', 'ok'); echo file_get_contents('runtime/test.txt');"
• 若用宝塔，别只依赖「一键部署」按钮——它可能漏掉 runtime 子目录（如 runtime/log、runtime/cache）的权限继承

关闭调试模式并清空缓存

上线前不关 APP_DEBUG = true，等于把路由映射、SQL 查询、环境变量全暴露给用户；不清缓存则可能加载旧路由或配置，导致行为不一致。

• 修改 env 文件：把 APP_DEBUG=true 改成 APP_DEBUG=false
• 执行 php think clear（TP6）或 php think cache:clear（TP8），不是删 runtime 目录就完事——有些缓存存在 OPcache 或 Redis 中
• 检查 config/app.php 中的 'app_status' 是否为 'production'，部分中间件逻辑依赖此值

真正卡住上线的，往往不是「会不会部署」，而是没意识到 public 是唯一合法入口、runtime 权限要逐级验证、以及 env 文件里的 APP_DEBUG 必须显式关掉——这三个点漏一个，就可能花半小时查日志，最后发现只是少改了一行配置。