云服务器部署ThinkPHP项目,生产环境需要配置哪些关键服务?

发布人:A5数据发布时间:2026-11-05 09:20阅读量:90

生产环境部署 ThinkPHP 项目,通常要把请求入口、PHP 运行环境、数据库、HTTPS、日志和进程管理配置完整,并确认它们之间的版本与路径一致。下面以 Ubuntu 24.04、Nginx、PHP 8.3-FPM 和 MySQL 为例,适用于已经具备可运行代码、准备首次上线的项目;ThinkPHP 版本、Composer 依赖或业务组件有特殊要求时,应优先按项目要求调整 PHP 版本和扩展。

生产环境部署概览配图

操作前准备好域名及 DNS 解析、服务器 SSH 权限、项目代码、生产环境配置,以及数据库连接信息。以下路径和域名均为示例:项目发布目录为 /var/www/thinkapp,域名为 example.com,部署账户为 deploy。请替换成实际值,不要把示例中的密码或密钥直接用于生产环境。

ThinkPHP 生产环境的运行基础,既包括 PHP、Web 服务与数据库,也离不开与业务负载相匹配的计算、存储和网络资源。A5idc数据提供香港、美国、日本、韩国、中国台湾、新加坡及马来西亚等地区的物理服务器,涵盖 Xeon 与 AMD EPYC 平台,并有 SSD、NVMe 等存储配置,可为企业网站、业务后台、数据库和接口服务提供部署资源。不同地区及产品系列提供相应的线路与配置选择,便于承载不同区域的访问与业务需求。

一、确认项目要求与服务器条件

先在项目根目录查看 composer.json,确认 PHP 版本约束、必需扩展、ThinkPHP 版本以及启动说明。若项目使用队列、定时任务、Redis 或其他服务,也要提前确认其运行方式;它们不是每个 ThinkPHP 项目的必需项。

服务器上先检查系统版本、磁盘和内存:

cat /etc/os-release
df -h
free -h

再检查代码目录中的依赖要求:

cd /path/to/project
grep -nE '"php"|ext-' composer.json

如果代码在本地或代码仓库中,先确认版本库内没有生产密钥、数据库密码、用户上传文件或本地调试配置。生产环境的 .env 应单独管理,不要提交到公开仓库。

本文后续命令以 Ubuntu 24.04 的 PHP 8.3 软件包为例。若服务器不是该版本,先用以下命令核对可用包和服务名称,不要直接照搬版本号:

apt-cache policy php-fpm
systemctl list-unit-files | grep -E 'php.*fpm|nginx|mysql'

二、安装并验证运行服务

更新软件包索引并安装 Nginx、PHP-FPM、PHP CLI、MySQL 扩展及常见项目依赖。实际需要的扩展以项目要求为准,下面的包名适用于 Ubuntu 24.04 软件仓库中的 PHP 8.3:

sudo apt update
sudo apt install -y nginx php8.3-fpm php8.3-cli \
  php8.3-mysql php8.3-mbstring php8.3-xml php8.3-curl \
  php8.3-zip php8.3-gd unzip git composer

安装后分别检查版本、扩展和服务状态:

php -v
php -m
sudo systemctl status nginx --no-pager
sudo systemctl status php8.3-fpm --no-pager

预期能看到 PHP 8.3 版本信息,php -m 中包含项目所需扩展,Nginx 与 PHP-FPM 服务状态为 active (running)。如果 php 命令与 PHP-FPM 的版本不同,或缺少扩展,应先统一版本并补装对应扩展,再继续部署。

设置服务开机启动:

sudo systemctl enable --now nginx php8.3-fpm

若数据库部署在本机,可安装并启动 MySQL;若使用独立数据库,应跳过本机数据库安装,改为确认云平台网络规则和数据库侧访问策略。

sudo apt install -y mysql-server
sudo systemctl enable --now mysql
sudo systemctl status mysql --no-pager

不要为了图方便让数据库监听公网地址。应用服务器连接独立数据库时,应仅开放应用服务器所需的来源地址和端口,并使用专用数据库账号,而不是数据库管理员账号。

三、准备发布目录并安装项目依赖

生产环境建议把代码、运行时数据和公开入口分开管理。以下示例用 releases 保存每次发布,用 current 指向当前版本;Nginx 只公开版本目录下的 public。

sudo install -d -o deploy -g www-data -m 2750 /var/www/thinkapp/releases
sudo install -d -o deploy -g www-data -m 2750 /var/www/thinkapp/shared

将代码放入新的发布目录,例如:

sudo -u deploy mkdir -p /var/www/thinkapp/releases/20250101-01

实际传输代码时可使用 Git、构建产物或安全的文件传输方式。不要把整份本地开发环境直接复制到服务器;至少应排除本地 .env、缓存、开发依赖和不应公开的文件。随后进入项目根目录安装生产依赖:

cd /var/www/thinkapp/releases/20250101-01
composer install --no-dev --prefer-dist --no-interaction --optimize-autoloader

若项目提供 composer.lock,应一并部署并按锁定版本安装。不要在生产服务器上随意执行 composer update,否则依赖可能发生变化。安装后可检查关键依赖和自动加载文件:

test -f vendor/autoload.php && echo "autoload ready"
composer check-platform-reqs

composer check-platform-reqs 若报告缺少 PHP 扩展或版本不符合要求,应先解决依赖问题,不要通过忽略平台检查强行上线。

四、配置生产环境与文件权限

将项目提供的生产配置模板复制为 .env,并按项目版本填写数据库连接、应用密钥、缓存等参数。ThinkPHP 不同版本及项目封装的环境变量名称可能不同,应以项目配置文件和部署文档为准,不要假设所有项目都使用同一套变量名。

例如,配置内容通常需要覆盖以下信息:

APP_DEBUG=false
APP_ENV=production

DB_TYPE=mysql
DB_HOST=127.0.0.1
DB_NAME=thinkapp
DB_USER=thinkapp_user
DB_PASS=替换为独立的强密码
DB_PORT=3306

这些变量名称仅作格式示例,必须确认应用实际读取它们。生产环境应关闭调试模式,避免异常页面向访客展示文件路径、SQL 或环境信息;应用密钥应使用项目支持的生成方式创建,并妥善保存。不要把密码放进 Shell 历史、工单或公开代码仓库。

示例中仅限制 .env 的读取权限,实际属主和权限要兼顾部署账户与 PHP-FPM 运行用户:

sudo chown deploy:www-data .env
sudo chmod 640 .env

确保 Web 用户只对运行时目录拥有写权限。ThinkPHP 项目常见的运行时目录包括 runtime,但具体路径以项目结构为准:

sudo chown -R www-www-data runtime
sudo find runtime -type d -exec chmod 750 {} \;
sudo find runtime -type f -exec chmod 640 {} \;

上述递归权限命令只应针对确认过的运行时目录执行,不要对整个项目目录设置 777,也不要将上传目录、日志目录与代码目录混为一谈。若项目需要写入上传目录,应单独建立目录并限定权限,同时确认上传文件不会被当作可执行 PHP 文件处理。

如果数据库在本机,创建专用数据库和账号时,使用强密码并限制账号来源。以下 SQL 仅为结构示例,执行前替换数据库名、账号和密码;不要直接授予 <em>.</em> 的全局权限:

CREATE DATABASE thinkapp CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'thinkapp_user'@'localhost' IDENTIFIED BY '替换为强密码';
GRANT ALL PRIVILEGES ON thinkapp.* TO 'thinkapp_user'@'localhost';

执行后验证登录权限:

mysql -u thinkapp_user -p -h 127.0.0.1 thinkapp

数据库迁移属于有数据影响的操作。首次上线前先确认迁移脚本、备份方案和恢复方式;不要把某条迁移命令视为所有 ThinkPHP 项目的通用命令。应按项目提供的迁移工具执行,并在变更前备份数据库。

五、配置 Nginx 请求入口

Nginx 的站点根目录必须指向 ThinkPHP 项目的 public 目录,不能指向项目根目录。这样可以避免 .env、依赖目录和应用代码被当作静态文件访问。

五、配置 Nginx 请求入口配图

创建站点配置:

sudo nano /etc/nginx/sites-available/thinkapp

参考配置如下。此示例使用 PHP 8.3-FPM 的 Unix Socket;如果服务器上的 Socket 路径不同,以 /run/php/ 中实际文件为准。

server {
    listen 80;
    server_name example.com www.example.com;

    root /var/www/thinkapp/current/public;
    index index.php index.html;

    access_log /var/log/nginx/thinkapp_access.log;
    error_log  /var/log/nginx/thinkapp_error.log;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        try_files $uri =404;
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    }

    location ~ /\.(?!well-known) {
        deny all;
    }
}

启用站点并检查配置:

sudo ln -s /etc/nginx/sites-available/thinkapp /etc/nginx/sites-enabled/thinkapp
sudo nginx -t

验证结果应包含 syntax is ok 和 test is successful。若提示 Socket 不存在,先检查 PHP-FPM 的监听配置和实际文件:

ls -l /run/php/
sudo grep -R "^listen =" /etc/php/8.3/fpm/pool.d/

确认配置无误后重载 Nginx:

sudo systemctl reload nginx

再检查 Nginx 是否正常运行:

sudo systemctl status nginx --no-pager

若请求返回 404,检查站点 root 是否指向实际 public 目录、入口文件是否存在,以及 try_files 是否适配项目路由规则。若返回 502,优先检查 PHP-FPM 服务状态和 fastcgi_pass 路径。不要通过把项目根目录设为网站根目录来规避入口问题。

六、建立当前版本并启用 HTTPS

确认代码、环境配置和入口配置都已就绪后,建立 current 软链接:

cd /var/www/thinkapp
sudo -u deploy ln -s releases/20250101-01 current

首次执行前确认 current 不存在;若已有软链接,不要直接用不清楚影响范围的覆盖命令。切换软链接前,应记录当前指向,以便回滚。

DNS 解析正确且 80 端口可从外部访问后,再申请证书。以下示例使用 Certbot 的 Nginx 插件;若证书由云平台或其他证书服务提供,应按其方式配置 Nginx,不要重复申请或覆盖现有证书。

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d example.com -d www.example.com

按提示选择是否将 HTTP 跳转到 HTTPS。完成后检查证书和 Nginx 配置:

sudo nginx -t
sudo systemctl reload nginx
sudo certbot certificates

证书续期可先做模拟检查:

sudo certbot renew --dry-run

防火墙只开放业务所需端口。通常网站需要 80、443,SSH 管理端口应限制来源;启用防火墙前先确认 SSH 端口已放行,避免把自己锁在服务器之外。云平台安全组与系统防火墙都要检查,不能只配置其中一层。

七、按需配置队列、定时任务与日志

只有项目实际使用队列时,才需要启动队列消费者。应根据项目框架版本和队列组件文档确认命令,再使用 systemd 或其他进程管理方式托管;不要依赖 SSH 会话中直接运行的后台命令,因为会话断开或进程异常后可能停止。

定时任务同样按项目要求配置。上线前确认任务执行频率、并发行为和失败记录方式,避免多个服务器重复执行同一任务,或在任务未完成时再次启动。项目若没有队列或定时任务需求,不必为了“生产环境完整”而额外引入服务。

日志至少分清 Nginx 访问日志、Nginx 错误日志、PHP-FPM 日志和应用日志。可先检查最近记录:

sudo tail -n 50 /var/log/nginx/thinkapp_error.log
sudo journalctl -u php8.3-fpm -n 50 --no-pager

应用日志位置由项目配置决定,常见位置在 runtime 下。确认日志目录可写、磁盘空间充足,并设置保留和轮转策略;不要把调试日志长期保持在高强度级别,也不要将日志目录设置为 Web 可直接访问的目录。

八、逐项验收与异常处理

上线后按从外到内的顺序检查,能更快区分 DNS、网络、Nginx、PHP 和应用配置问题。

检查对象操作预期结果
DNSdig +short example.com返回指向服务器或前置服务的地址
Nginx 配置sudo nginx -t配置检查通过
服务状态systemctl is-active nginx php8.3-fpm两项均返回 active
本机 HTTPcurl -I -H 'Host: example.com' http://127.0.0.1/返回预期的 HTTP 状态码,不出现 502
HTTPScurl -I https://example.com/TLS 握手正常,响应符合应用预期
页面路由浏览器访问首页和一条非首页路由页面正常,路由可用
数据库访问需要数据库的功能连接成功,读写符合预期
日志检查 Nginx、PHP-FPM 和应用日志无持续性致命错误

curl 返回 200 并不代表所有业务都已正常,例如登录、上传和数据库写入仍需分别验证。若应用故意返回 301、302 或需要登录后才返回 200,应按业务预期判断,而不是把所有非 200 响应都当成故障。

常见异常可按以下方向处理:

  • 403 Forbidden:检查 public 目录及其父目录的执行和读取权限、Nginx 用户权限,以及 Nginx 配置是否命中正确站点。
  • 404 Not Found:检查域名对应的 server_name、root、入口文件和 ThinkPHP 路由规则;确认请求没有落到默认站点。
  • 502 Bad Gateway:检查 PHP-FPM 是否运行、Socket 路径是否一致、Nginx 是否有权限访问 Socket。
  • 页面报数据库连接错误:核对生产环境变量是否被应用加载、数据库地址和端口、账号来源限制及数据库服务状态;查看日志时不要公开完整连接密码。
  • 白屏或异常详情暴露:确认生产调试模式已关闭,再结合应用日志定位错误。不要以隐藏错误页面代替修复运行问题。
  • HTTPS 证书异常:确认域名解析、证书覆盖的域名、证书有效期和 Nginx 实际加载的证书路径;变更配置后先执行 nginx -t。

九、发布回滚与最终检查

采用版本目录和 current 软链接的好处,是出现问题时可切回上一版代码。发布新版本前记录当前指向:

readlink -f /var/www/thinkapp/current

只有在新版本目录、配置、依赖和静态资源均已准备好后,才切换链接。回滚时将 current 指回已记录的旧版本,再检查并重载 Nginx:

cd /var/www/thinkapp
sudo -u deploy ln -sfn releases/旧版本目录 current
sudo nginx -t && sudo systemctl reload nginx

该操作会让后续请求使用旧代码,但不能自动撤销数据库结构变更、已发送消息或用户数据写入。数据库迁移应单独设计回滚方案;迁移不可逆或会丢数据时,先备份并评估恢复步骤,不要直接删除表或覆盖数据。若新旧代码依赖不同配置,也要确认回滚版本仍能读取当前环境配置。

首次上线验收时,至少确认以下项目:

  • 项目 PHP 版本和扩展满足依赖约束,Composer 依赖安装成功。
  • Nginx 网站根目录指向 public,.env 和应用代码不能通过 Web 直接读取。
  • PHP-FPM、Nginx 及所需数据库服务状态正常,并设置了开机启动。
  • 生产环境关闭调试模式,数据库使用专用账号,密钥未提交到代码仓库。
  • HTTPS 可访问,证书续期检查通过;云平台安全组和系统防火墙仅开放所需端口。
  • 首页、关键路由、数据库读写及项目实际使用的队列或定时任务均完成验证。
  • 应用日志可写且可查,磁盘空间与日志保留策略已检查。
  • 已记录当前版本、配置变更和数据库备份位置,并确认代码回滚与数据库恢复路径分别可执行。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7600.html

相关推荐