ThinkPHP项目部署到云服务器的核心是配齐PHP、Web服务器、数据库和项目四层关键参数：PHP需满足版本与扩展要求并调优配置；Web服务器须指向public目录并配置重写规则；数据库连接应通过.env环境变量管理且权限最小化；项目须关闭调试、设为生产模式、设置正确目录权限及强制HTTPS。

ThinkPHP项目部署到云服务器，核心是让框架能稳定运行、安全访问、正确连接数据。环境参数不是越多越好，而是要配对、配准、配稳。关键参数集中在PHP、Web服务器、数据库和项目自身四层，缺一不可。

PHP运行环境参数

ThinkPHP对PHP版本和扩展有明确要求，不满足会直接报错或功能异常：

• PHP版本：TP6推荐PHP 8.0，TP8必须PHP 8.0+；避免使用PHP 8.3及以上（已知兼容问题）
• 必需扩展：pdo_mysql（数据库）、mbstring（中文处理）、openssl（HTTPS/加密）、fileinfo（文件上传校验）、curl（HTTP请求）
• 关键配置项：在php.ini中确认以下值合理
  max_execution_time = 300（避免长任务超时）
  memory_limit = 256M（TP6默认缓存较占内存）
  upload_max_filesize = 20M（如需上传商品图等）
  date.timezone = Asia/Shanghai（防止日志时间错乱）

Nginx/Apache服务参数

Web服务器必须将请求精准导向public/目录，并支持URL重写：

• 根目录设置：虚拟主机的root必须指向项目public子目录，不是项目根目录
• 伪静态规则（Nginx示例）：
  location / { try_files $uri $uri/ /index.php?$query_string; }
location ~ \.php$ { include fastcgi_params; fastcgi_pass unix:/var/run/php/php8.0-fpm.sock; }
• PATH_INFO支持：ThinkPHP默认用PATH_INFO模式解析路由，需确保Nginx未禁用fastcgi_split_path_info，或改用QUERY_STRING模式并在config/app.php中设'url_common' => true

数据库连接参数

不能硬编码在config/database.php里，应通过环境变量隔离：

btpanel phpsite 宝塔面板PHP网站

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

下载

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

• .env文件内容示例：
  DATABASE_TYPE=mysql
DATABASE_HOST=rm-xxx.mysql.rds.aliyuncs.com（RDS内网地址更安全）
  DATABASE_NAME=shop_db
DATABASE_USERNAME=tp_user
DATABASE_PASSWORD=StrongPass123!
DATABASE_PORT=3306
DATABASE_CHARSET=utf8mb4
• 权限最小化：数据库账号仅授予SELECT, INSERT, UPDATE, DELETE权限，禁用DROP, CREATE, ALTER

项目运行时参数

这些参数决定项目是“开发中”还是“真上线”：

• 调试开关：APP_DEBUG = false（必须关闭，否则泄露路径、SQL、配置）
• 应用模式：APP_ENV = production（触发框架生产级行为，如缓存自动开启）
• 目录权限：runtime/和public/uploads/需755或775（Web用户可写），其余目录644
• SSL强制跳转：若启用HTTPS，在Nginx配置中加return 301 https://$host$request_uri;（80端口）

配齐这四层参数，项目就能跑起来；但真正稳定，还得靠日志监控（runtime/log/）、定期清理缓存、以及每次上线前检查.env是否被误提交到Git。