ubuntu上thinkphp项目部署指南

作者：袖梨 2026-06-04

在Ubuntu操作系统上部署ThinkPHP框架项目，需要经历环境依赖安装、项目代码上传、Web服务器配置以及生产环境安全优化等一系列关键步骤。以下内容将分阶段详述完整流程，为开发者提供清晰的操作路径。

ubuntu上thinkphp项目如何部署

一、环境准备

在正式部署之前，需要预先安装Web服务器（推荐Nginx或Apache）、PHP运行环境（含所需扩展）、Composer依赖管理工具以及数据库系统（MySQL或MariaDB）。以Ubuntu 22.04及以上版本为例，建议采用Nginx + PHP-FPM的组合方案以获取更优性能：

# 更新系统包sudo apt update && sudo apt upgrade -y# 安装Nginxsudo apt install nginx -y# 安装PHP 8.1（或更高版本）及扩展（ThinkPHP必需）sudo apt install php php-cli php-fpm php-mysql php-curl php-gd php-mbstring php-xml php-zip -y# 安装Composer（PHP依赖管理工具）curl -sS https://getcomposer.org/installer | phpsudo mv composer.phar /usr/local/bin/composer

关键说明：ThinkPHP 6.x版本要求PHP≥7.1，为获得更佳性能推荐使用PHP 8.0或更高版本。必须安装的PHP扩展包括pdo_mysql（数据库连接）、mbstring（多字节字符串处理）、xml（XML解析）等。

二、部署ThinkPHP项目

1. 上传项目代码

将本地开发完成的ThinkPHP项目传输至Ubuntu服务器，建议存放到/var/www/目录下（操作时需具备root权限）：

# 进入Web目录cd /var/www# 使用Git克隆项目（或scp/rsync上传）git clone https://github.com/top-think/think.git your_project# 或直接创建项目（Composer方式，推荐）composer create-project topthink/think your_project

提示：项目目录名称（例如your_project）可根据实际需求自行定义。

2. 安装项目依赖

进入项目目录后，通过Composer工具安装所有依赖包：

cd /var/www/your_projectcomposer install --no-dev --optimize-autoloader

说明：参数--no-dev用于跳过开发依赖的安装（可降低资源占用），--optimize-autoloader则对自动加载机制进行性能优化。

3. 配置数据库

编辑项目根目录下的.env文件，填写正确的数据库连接参数：

nano /var/www/your_project/.env

根据实际数据库信息调整以下配置项：

[DATABASE]TYPE=mysqlHOSTNAME=127.0.0.1DATABASE=your_db_nameUSERNAME=your_db_userPASSWORD=your_db_passwordPORT=3306PREFIX=tp_

说明：若尚未创建数据库，需先登录MySQL进行创建：

sudo mysql -u root -pCREATE DATABASE your_db_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;CREATE USER 'your_db_user'@'localhost' IDENTIFIED BY 'your_db_password';GRANT ALL PRIVILEGES ON your_db_name.* TO 'your_db_user'@'localhost';FLUSH PRIVILEGES;EXIT;

4. 设置目录权限

ThinkPHP的runtime目录承担缓存与日志写入功能，必须赋予可写权限。同时，项目目录的所有权应归属于Web服务器用户（通常为www-data）：

# 设置项目目录所有者sudo chown -R www-data:www-data /var/www/your_project# 设置runtime目录权限（755可写）sudo chmod -R 755 /var/www/your_project/runtime

三、配置Web服务器（Nginx）

1. 创建Nginx虚拟主机

新建Nginx配置文件（以项目域名为例，如your_domain.com）：

sudo nano /etc/nginx/sites-available/your_domain.conf

写入以下配置内容（关键参数详见注释）：

server {listen 80;server_name your_domain.com www.your_domain.com;# 替换为你的域名或IProot /var/www/your_project/public;# 必须指向public目录（入口文件所在）index index.php index.html;# URL重写（支持PATHINFO，解决路由失效问题）location / {try_files $uri $uri/ /index.php?$query_string;}# PHP请求转发（关键：关联PHP-FPM）location ~ .php$ {include snippets/fastcgi-php.conf;# 引入FastCGI配置fastcgi_pass unix:/run/php/php8.1-fpm.sock; # 根据PHP版本调整（如php7.4-fpm.sock）fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;include fastcgi_params;}# 禁止访问.env文件（防止敏感信息泄露）location ~ /.env {deny all;}# 日志记录access_log /var/log/nginx/your_domain_access.log;error_log /var/log/nginx/your_domain_error.log;}

关键提醒：

  1. root必须指向public目录（ThinkPHP的入口文件index.php所在）；
  2. try_files规则确保路由正常工作（将请求转发至index.php）；
  3. fastcgi_pass需与PHP-FPM的监听地址一致（详见下一步）。

2. 启用站点配置

建立符号链接，将配置文件关联至sites-enabled目录：

sudo ln -s /etc/nginx/sites-available/your_domain.conf /etc/nginx/sites-enabled/

3. 测试并重启Nginx

检查配置文件的语法正确性：

sudo nginx -t

若输出syntax is ok，则重启Nginx使配置生效：

sudo systemctl restart nginx

四、生产环境优化

1. 关闭调试模式

修改config/app.php文件，关闭调试模式以防止敏感信息外泄：

'app_debug' => false,'app_trace' => false,

2. 隐藏入口文件（可选）

借助Nginx重写规则隐藏public目录（需调整项目结构，将public设为根目录）：

# 在server块中添加location / {rewrite ^/(.*)$ /public/$1 last;}

3. 启用HTTPS（推荐）

利用Let’s Encrypt免费证书提升网站安全性：

# 安装Certbotsudo apt install certbot python3-certbot-nginx -y# 获取证书并自动配置Nginxsudo certbot --nginx -d your_domain.com -d www.your_domain.com

说明：证书有效期为90天，到期后可通过sudo certbot renew命令自动续期。

五、常见问题排查

1. 502 Bad Gateway

  1. 原因：PHP-FPM未运行或Nginx配置中的fastcgi_pass路径错误。
  2. 解决：
    # 检查PHP-FPM状态sudo systemctl status php8.1-fpm# 若未运行，启动服务sudo systemctl start php8.1-fpm# 确认Nginx中的fastcgi_pass路径（需与PHP-FPM的listen一致）

2. 路由失效

  1. 原因：Nginx未配置try_files规则，无法将路由请求转发至index.php。
  2. 解决：检查Nginx配置中的location /块，确保包含try_files $uri $uri/ /index.php?$query_string;。

3. 权限问题

  1. 原因：Web服务器用户（www-data）无权访问项目目录。
  2. 解决：
    sudo chown -R www-data:www-data /var/www/your_projectsudo chmod -R 755 /var/www/your_project

依照本文所述流程，从环境准备到项目部署，再到服务器配置与安全优化，每个环节均落实到位后，ThinkPHP应用即可在Ubuntu服务器上稳定运行。通过配置的域名访问项目首页，即可检验部署成果。

相关文章

精彩推荐