部署ThinkPHP API需确保PHP≥7.2、安装必要扩展及Composer；上传项目后执行composer install，配置.env与runtime权限；Nginx指向public目录并设置重写规则：if (!-e $request_filename) { rewrite ^(.*)$ /index.php?s=$1 last; }；重启Nginx并确认PHP-FPM运行，访问接口返回JSON即成功。
将 PHP 项目部署到服务器并运行 ThinkPHP API 接口，关键在于环境配置、项目上传、路径设置和 Web 服务器（如 Nginx 或 Apache）的正确解析。以下是 ThinkPHP API 项目的完整部署与运行配置方法。
确认服务器环境要求
ThinkPHP 6（常见版本）对环境有明确要求，部署前需确保服务器满足条件：
-
• PHP 版本 ≥ 7.2（推荐 7.4 或 8.0）
• 支持 PDO、OpenSSL、MBstring、CURL 等扩展
• Composer 已安装（用于依赖管理）
• Web 服务器：Nginx 或 Apache
• 建议使用 Linux 系统（如 CentOS、Ubuntu）
可通过命令检查 PHP 环境：
php -vphp -m | grep -E "pdo|openssl|mbstring|curl"
上传并配置 ThinkPHP 项目
将本地开发完成的 ThinkPHP API 项目上传至服务器指定目录，例如：/www/wwwroot/api.example.com
立即学习“PHP免费学习笔记（深入）”；
-
• 使用 FTP、SCP 或 Git 克隆项目代码
• 进入项目根目录执行 composer install 安装依赖
• 配置 .env 文件（数据库连接、APP_DEBUG 等）
• 确保 runtime 目录可写（chmod -R 755 runtime）
示例 .env 配置：
APP_DEBUG = falseDB_HOST = 127.0.0.1
DB_NAME = your_dbname
DB_USER = root
DB_PWD = your_password
Web 服务器配置（以 Nginx 为例）
ThinkPHP 使用路由重写功能，必须配置 URL 重写规则，确保访问 /api/user 能正确路由到入口文件。
编辑 Nginx 站点配置文件（通常位于 /etc/nginx/sites-available/ 或宝塔面板中修改）：
server {
listen 80;
server_name api.example.com;
root /www/wwwroot/api.example.com/public;
index index.php index.html;
location / {
if (!-e $request_filename) {
rewrite ^(.*)$ /index.php?s=$1 last;
break;
}
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass 127.0.0.1:9000;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
保存后重启 Nginx：
nginx -t # 检查语法systemctl reload nginx
测试接口与权限设置
完成部署后，通过浏览器或 Postman 访问 API 接口，例如：
http://api.example.com/api/user/list若返回正常 JSON 数据，说明部署成功。若出现 404 或空白页，请检查：
-
• public/index.php 是否为入口文件
• .env 是否加载成功
• runtime 目录是否有写权限
• Nginx 是否指向 public 目录
• PHP-FPM 是否正在运行
关闭调试模式避免信息泄露：
在 .env 中设置 APP_DEBUG = false基本上就这些。只要环境正确、路径清晰、重写规则配置到位，ThinkPHP API 项目就能稳定运行。
