ThinkPHP怎么部署到服务器_ThinkPHP生产环境部署汇总【技巧】-ThinkPHP-PHP中文网

thinkphp部署核心卡点是环境没对齐、入口没暴露、配置没隔离：需严格匹配php≥7.4及四大扩展，nginx root必须指向public目录并配对重写规则，.env须放项目根目录且app_env不可被预设覆盖。

thinkphp怎么部署到服务器_thinkphp生产环境部署汇总【技巧】

ThinkPHP 部署到服务器不是“丢上去就能跑”，核心卡点往往在三处：**环境没对齐、入口没暴露、配置没隔离**。只要这三点踩准，80% 的线上报错（502、404、DB 连接失败、日志写不进）都能当场排除。

ThinkPHP 6.0+ 强制要求 PHP ≥ 7.4，且 mbstring、json、openssl、pdo_mysql 四个扩展缺一不可——少一个，composer install 就会中断，或者运行时报 Class 'think\Env' not found。

用 php -v 确认版本，别信系统包管理器的“php”软链接，它可能指向旧版
用 php -m | grep -E 'mbstring|json|openssl|pdo_mysql' 逐个验证，pdo_mysql 特别容易漏（Ubuntu/Debian 上需额外装 php-mysql 包）
生产环境务必启用 opcache：opcache.enable=1 和 opcache.validate_timestamps=0（上线后手动清缓存，别让框架自己轮询）
memory_limit 建议设为 256M 或更高，尤其开启调试或大量日志时，500 Internal Server Error 很可能是内存耗尽静默崩溃

ThinkPHP 是单入口框架，所有请求必须经由 public/index.php 路由分发。Nginx 配置里 root 写成项目根目录（比如 /var/www/your_project）是常见错误，会导致 404 Not Found 或直接暴露 app/ 目录。

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

下载

root 必须是 /var/www/your_project/public，不是上层目录
location / 块里的 try_files 推荐用 try_files $uri $uri/ /index.php?$query_string;（比 /index.php?s=$uri&$args 更兼容 POST 数据）
fastcgi_param SCRIPT_FILENAME 必须用 $realpath_root（不是 $document_root），否则 symlink 部署时路径解析会失效
静态资源加 expires 30d 并关掉 access_log，能明显降低 Nginx 日志盘 IO 压力

.env 在生产环境不是“可选项”，而是**环境标识开关**：它只在 APP_ENV 未被预设时才加载。一旦你在 Nginx 的 fastcgi_param 或系统 export APP_ENV=prod 里设了值，框架就直接跳过 .env —— 改了文件也完全无效。

.env 必须放在项目根目录（和 think 命令同级），不能放 config/ 下，也不能嵌套子目录
敏感字段如 DB_PASSWORD 含特殊字符（@、!、空格）必须用单引号包裹：DB_PASSWORD='p@ss!word'
DB_HOST 生产环境禁用 localhost，改用内网 IP（如 10.0.1.5），否则 MySQL 会走 socket，权限策略和网络层行为完全不同
APP_DEBUG=false 必须写在 config/app.php 里，而不是只靠 .env；.env 中的 APP_DEBUG=true 在生产环境属于高危配置

本地开发生成的 runtime/ 下的缓存（cache/、log/、temp/）不能直接拷贝到服务器——路径、权限、时间戳全错，轻则 500，重则日志写满磁盘。

上线脚本里加一句：rm -rf runtime/*，让框架启动时重建干净缓存
用 php think route:list 检查路由是否加载成功（需确保 APP_ENV 正确，否则命令行环境和 Web 环境不一致）
用 php think db:connect 测试数据库连通性（ThinkPHP 6.3+ 支持），比手写 PDO 更贴近框架实际行为
检查 logs/ 目录权限是否为 www-data:www-data（Ubuntu/Debian）或 nginx:nginx（CentOS/RHEL），否则日志写入失败但无提示