部署ThinkPHP项目需先配置PHP环境、Web服务器及数据库，确保PHP版本≥7.2，安装Composer并启用URL重写；上传项目文件后，将Web根目录指向public目录；修改config/database.php中的数据库连接信息，关闭debug模式；配置Apache或Nginx的重写规则以隐藏index.php；设置runtime和uploads目录的读写权限，并删除install.php等安装脚本以提升安全性；最后通过访问域名启动项目，遇错可查runtime/log日志定位问题。
ThinkPHP 是一款流行的国产 PHP 框架，以其简洁的语法和快速开发能力受到许多开发者喜爱。将 PHP 项目部署到 ThinkPHP 框架中，关键在于环境配置、目录结构规范以及运行模式设置。下面是一份清晰的部署与运行配置教程，帮助你顺利上线 ThinkPHP 项目。
准备运行环境
ThinkPHP 依赖标准的 PHP 运行环境，部署前需确保服务器满足基本要求：
- PHP 版本：根据使用的 ThinkPHP 版本选择对应支持的 PHP 版本。例如，ThinkPHP 6.0 要求 PHP >= 7.2；推荐使用 PHP 7.4 或 8.0+。
- Web 服务器：Apache 或 Nginx 均可。Apache 需开启 mod_rewrite 模块以支持 URL 重写；Nginx 需正确配置 rewrite 规则。
- 数据库支持：如使用 MySQL，确保已安装 pdo_mysql 扩展。
- Composer 工具：用于安装和管理 ThinkPHP 及其依赖。
可通过命令 php -v 和 composer --version 验证环境是否就绪。
部署 ThinkPHP 项目文件
将本地开发完成的 ThinkPHP 项目上传至服务器指定目录（如 /www/wwwroot/your-site）。
立即学习“PHP免费学习笔记（深入）”；
注意标准目录结构：
- /app — 应用代码目录
- /public — 入口文件和静态资源，应设为 Web 根目录
- /config — 配置文件
- /vendor — Composer 依赖库
确保 Web 服务器的根目录指向项目的 public 文件夹，保障安全，防止源码泄露。
配置数据库与运行参数
打开 config/database.php 文件，修改数据库连接信息：
'debug' => false,'hostname' => '127.0.0.1',
'database' => 'your_db_name',
'username' => 'your_db_user',
'password' => 'your_db_password',
'hostport' => '3306',
'dbname' => 'your_db_name',
生产环境务必关闭 debug 模式，避免暴露敏感信息。
其他配置如缓存、日志路径等也可在 config 目录下对应文件中调整。
配置 Web 服务器规则
URL 重写是 ThinkPHP 正常运行的关键，需配置服务器隐藏 index.php 入口。
Apache 配置：确保项目根目录（public）下有 .htaccess 文件，内容如下：
RewriteEngine OnRewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L] Nginx 配置：
在站点配置中添加：
location / {if (!-e $request_filename) {
rewrite ^/(.*)$ /index.php?s=/$1 last;
}
}
保存后重启 Nginx 服务。
设置目录权限与安全
ThinkPHP 在运行时需要对某些目录有写权限：
- /runtime — 日志、缓存存储目录，需赋予 Web 用户（如 www-data）读写权限。
- /public/uploads — 如有文件上传功能，也需开放写入权限。
执行命令：
chmod -R 755 runtime/chown -R www-data:www-data runtime/
同时建议删除或重命名 public/install.php 等安装脚本，防止二次安装风险。
基本上就这些。完成以上步骤后，访问域名即可看到项目首页。若出现白屏或错误，查看 runtime/log 目录下的日志文件定位问题。ThinkPHP 部署不复杂，但细节决定成败。
