Laravel网站部署到香港服务器,生产环境要配置哪些关键项?

发布人:A5数据发布时间:2026-11-13 14:47阅读量:38

生产环境部署的目标,不只是 Laravel 页面可以打开,而是代码、PHP-FPM、Nginx、数据库、队列、定时任务、证书和日志能够按预期协同工作;出现异常时,也能定位影响并恢复到上一版本。变更前应先核对现状、备份数据与配置,再分步上线,避免同时更换运行环境、数据库结构和网络入口,让故障原因难以区分。

以下以 Ubuntu 服务器、Nginx、PHP-FPM 和 Laravel 项目为例。示例中的 PHP 版本、服务名、目录和域名都需要按实际环境核实;香港服务器的网络线路、访问来源和第三方服务连通性也应纳入验证,不能只凭服务器所在地推断访问效果。

一、现状核对:先画清变更边界

开始操作前,先记录当前版本和服务状态。至少确认以下信息:

核对对象需要确认的内容验证方式
系统与运行环境Ubuntu 版本、PHP 版本、扩展、Composer 版本cat /etc/os-release、php -v、php -m、composer --version
Laravel 项目Laravel 版本、部署目录、当前代码版本、依赖锁文件检查 composer.json、composer.lock 和 Git 提交号
Web 入口Nginx 配置、站点根目录、域名解析、监听端口nginx -T、nginx -t、检查 DNS 记录
后台任务队列驱动、队列进程管理方式、定时任务位置检查 Supervisor、systemd 或 cron 配置
数据与文件数据库类型、备份方式、用户上传文件保存位置核对数据库备份记录及 Laravel storage 目录
网络与证书云平台防火墙、安全组、主机防火墙、证书续期方式检查 80/443 入站规则及续期任务

应用的 PHP 版本必须与 Laravel 版本及依赖要求匹配,不能仅因为服务器已经装有某个 PHP 版本,就直接将其用于生产。部署前可在目标 PHP 环境中检查依赖平台要求:

php -v
php -m
composer check-platform-reqs

composer check-platform-reqs 应在项目依赖已经安装后执行。若提示缺少扩展,应先确认项目实际需要的扩展,再安排安装和 PHP-FPM 重载;不要在高峰期临时替换 PHP 主版本。

香港服务器还要核对实际访问路径:域名的 A、AAAA 记录是否指向预期地址,主机和云平台防火墙是否放行所需端口,应用访问的数据库、邮件服务、支付接口或对象存储是否允许从该服务器出站。若业务面向不同地区的用户,实际访问质量还会受运营商、路由和用户网络影响,应使用目标地区的访问链路验证,而不是仅在服务器本机测试。

A5idc数据提供香港物理服务器租用,覆盖入门建站、Xeon Gold与AMD EPYC等配置,并有SSD或NVMe存储及CN2、国际带宽等方案选择。这些硬件与网络资源可用于部署Laravel网站、业务后台、数据库和接口服务,为生产环境的应用运行与数据存储提供相应的服务器基础。

二、变更准备:备份、兼容与回退先于上线

上线前先固定变更范围:本次是否只发布应用代码,是否同时修改 Nginx 配置、PHP 版本、数据库结构、域名解析或证书。一次尽量只引入一类高风险变化。若必须同时变更,应拆分步骤,并为每一步安排单独的检查点。

至少准备以下内容:

  • 数据库备份和恢复路径:使用现有数据库备份或云平台快照能力,在变更前完成备份,并确认备份可读取。数据库迁移可能改变表结构;部分数据库的 DDL 操作并不保证可以通过事务完整回滚,因此不能把“执行回滚命令”当作备份的替代品。
  • 当前应用版本:保留仍可运行的上一版代码及其依赖信息,记录当前发布目录、Git 提交号和发布时间。
  • 配置副本:保存当前 .env、Nginx 站点配置、PHP-FPM 配置和队列进程配置。配置文件可能包含密钥或数据库密码,应限制副本的读取权限,不要放入公开仓库或工单。
  • 文件存储核对:确认用户上传内容是否在发布目录之外。若上传文件保存在某个发布版本目录内,切换版本时可能导致文件无法访问。
  • 维护窗口与责任人:明确谁执行、谁观察、谁批准回滚;涉及数据库迁移或流量切换时,预留足够的检查时间,避免只留出代码上传时间。

数据库变更优先采用“扩展后收缩”的兼容方式:先添加可与旧代码共存的字段或索引,再发布使用新结构的代码;确认稳定后,另行删除已废弃结构。若迁移会立即重命名、删除旧字段,或新旧代码无法共存,应按一次有停机风险的变更处理,先制定停写、备份与恢复方案。

同时确认回滚到底能恢复什么。切回旧代码通常不能自动撤销数据库迁移,也不能恢复已经被新代码改写的数据。如果新旧代码依赖不同的数据结构,单纯切换软链接可能让旧版本无法启动。

三、分步实施:从入口到应用逐项上线

1. 确认域名、端口和 HTTPS 入口

域名应解析到实际承载站点的服务器地址或前置负载均衡地址。启用 IPv6 记录前,应确认服务器确实有可用的 IPv6 地址、路由和防火墙规则;错误的 AAAA 记录可能造成部分客户端访问失败。

通常只对外开放业务所需的 HTTP/HTTPS 端口,并限制 SSH 管理入口的来源。若申请证书需要 HTTP 验证,签发阶段应保证域名已指向目标入口且验证请求能够到达。证书部署后,要检查自动续期机制;如果由证书工具管理 Nginx 配置,后续修改前应备份配置并了解其更新方式。

Nginx 站点根目录应指向 Laravel 的 public,而不是项目根目录。下面是简化的 HTTP 配置示例,PHP-FPM 套接字路径需先在服务器上核实:

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

    root /srv/www/example/current/public;
    index index.php;

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

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

    location ~* ^/storage/.*\.php(?:$|/) {
        deny all;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
    }
}

上线前先对配置做语法检查,再平滑重载;如果检查失败,不要重载。

sudo nginx -t
sudo systemctl reload nginx

在配置 HTTPS 时,确保证书链、域名和有效期正确,并将 HTTP 跳转到 HTTPS 的行为纳入验证。不要只确认首页能打开:登录、回调地址、Cookie、安全跳转以及应用生成的绝对链接也可能依赖 APP_URL 和 HTTPS 识别设置。

2. 固定应用配置与文件权限

生产环境至少要核对以下配置项:

APP_ENV=production
APP_DEBUG=false
APP_URL=https://example.com

APP_KEY 必须使用项目原有的有效密钥,并在发布间保持稳定。不要在部署时例行重新生成;更换密钥可能导致已加密的数据、Cookie 或会话无法按原方式读取。

数据库连接、会话、缓存、队列和日志驱动应与当前基础设施一致。若应用位于负载均衡器或 CDN 后面,应按 Laravel 版本和实际网络拓扑配置可信代理范围,避免盲目信任任意来源的转发头。HTTPS 相关 Cookie 设置也应与访问方式匹配。

Laravel 的 .env 不应放在 Web 可直接访问的位置,也不应提交到代码仓库。项目代码可由部署用户管理,Web 服务用户只需对必要的缓存、会话、日志和上传目录有读写权限。不要用 chmod -R 777 解决权限问题:它会扩大整个目录树的可写范围,增加文件被意外修改的风险。

较易维护的发布目录结构是让每个版本独立存放代码,同时将 .env 和持久化文件放在共享目录,再链接到当前版本。例如:

/srv/www/example/
├── current -> releases/版本号
├── releases/
│   ├── 旧版本/
│   └── 新版本/
└── shared/
    ├── .env
    └── storage/

需要特别确认 storage 中哪些内容必须跨发布保留。Laravel 的公开文件链接也应指向持久化存储,避免每次发布后链接失效。首次建立目录结构时,先检查已有文件和链接目标,再创建或调整链接,不要直接覆盖仍在使用的目录。

3. 安装依赖并生成生产缓存

将代码放入新的发布目录后,先确认代码版本和锁文件,再安装依赖。以下命令适用于依赖已在 composer.lock 中固定的项目,目录请替换为实际发布目录:

cd /srv/www/example/releases/2026-03-01
composer install --no-dev --prefer-dist --no-interaction --optimize-autoloader
composer check-platform-reqs

确认共享的 .env 和 storage 已正确关联后,再生成配置缓存:

php artisan config:cache

如果项目路由和视图缓存已在目标 Laravel 版本中验证,可按需执行:

php artisan route:cache
php artisan view:cache

路由缓存若因项目路由写法而失败,应先检查失败原因,不要在发布流程中忽略错误后继续切换。使用配置缓存后,应用配置应通过配置文件读取环境变量;不要在业务代码中到处直接调用 env(),否则缓存配置时可能出现与预期不符的结果。

4. 安排数据库迁移,再切换当前版本

执行迁移前,确认目标数据库、备份时间、迁移内容和恢复责任人;尤其要检查是否包含删列、重命名、大表操作或可能长时间锁表的语句。确认兼容性后,再按项目流程执行生产迁移:

php artisan migrate --force

--force 用于允许生产环境执行迁移,不代表迁移天然安全。若迁移失败,应暂停发布,保存错误信息,判断数据库是否已有部分变更;未经确认不要反复执行,也不要直接删除表或字段试图“清理”。

迁移通过后,检查应用是否能连接数据库、关键页面是否能读取和写入必要数据。只有当前版本代码与目标数据库结构兼容,才切换生产入口。

采用软链接切换发布版本时,应先确认 current 本身是指向发布目录的软链接,且新旧目录位于适合原子切换的同一文件系统。以下命令中的版本路径仅为示例:

ln -sfn /srv/www/example/releases/2026-03-01 /srv/www/example/current.next
mv -Tf /srv/www/example/current.next /srv/www/example/current

mv -T 是 GNU/Linux 常见用法,不适用于所有系统;在执行前确认当前目录结构和命令行为。若现有 current 是实体目录而非软链接,不应直接照搬这组命令,应先规划迁移目录结构和切换方式。

代码切换后,队列进程可能仍在使用旧代码。使用 Laravel 队列时,可通过应用缓存通知常驻 worker 在处理完当前任务后重启:

php artisan queue:restart

前提是该命令所用缓存与队列进程共享且可用,并且 Supervisor、systemd 等进程管理器会重新拉起退出的 worker。使用 Horizon 的项目应按项目既有方式通知 Horizon 进程平滑重启。不要在不清楚影响范围时重启所有后台服务。

按从左到右的时间顺序排列准备新发布目录与依赖、确认数据库备份及新旧代码兼容、执行生产迁移、检查数据库连接和关键页面、切换 current 软链接、按需通知队列

定时任务应有明确且唯一的执行安排。常见做法是由一台应用服务器每分钟调用 Laravel 调度器;多台服务器部署时,应避免所有实例无协调地重复执行同一任务,或在任务定义中采用适用的单机执行保护。

5. 建立日志与服务管理基线

生产进程应由 systemd、Supervisor 或其他进程管理器托管,确保异常退出后能够按预期恢复,并能查看启动失败原因。PHP-FPM、Nginx、队列 worker 和定时任务的服务名与日志位置依发行版及安装方式而异,执行前用 systemctl list-units、systemctl status 服务名 或进程管理器自身命令核实,不要猜测服务名称。

Laravel 应用日志应保留足够的排查信息,同时设置合理级别和轮转策略。不要在公开错误页、日志或响应中输出数据库密码、访问密钥、会话内容等敏感数据。Nginx 访问日志与错误日志、PHP-FPM 日志和 Laravel 日志分别记录不同层面的现象,排查时应按时间戳关联,而不是只看应用日志。

四、验证与观察:检查真实请求,不只检查进程

切换后按由外到内的顺序验证,先确认解析和网络入口,再检查站点、应用和后台任务:

  1. 域名与端口:从服务器外部检查域名解析结果和 HTTPS 是否可达。确认云平台安全组、主机防火墙及服务监听地址一致。
  2. Nginx 与证书:检查 nginx -t、站点访问日志和错误日志;确认 HTTP/HTTPS 跳转、证书域名与有效期符合预期。
  3. Laravel 页面与业务路径:访问首页和关键业务流程,包括登录、表单提交、上传、支付或第三方回调等实际使用的功能。静态页面正常不代表数据库写入和会话正常。
  4. 队列与定时任务:确认 worker 由进程管理器托管、任务能够被消费,调度任务没有重复执行或持续失败。
  5. 数据与文件:检查关键读写、上传文件访问、缓存和会话状态。不要只以首页返回 HTTP 200 作为验收标准。
  6. 日志和资源:观察 Laravel、Nginx、PHP-FPM 与系统日志中的新错误,同时关注 CPU、内存、磁盘空间、数据库连接数和队列积压。

如果 Laravel 版本提供适用的健康检查路由,可将其用于基础存活检查;否则使用项目自己的轻量健康端点。健康端点不应暴露环境变量、数据库凭据或详细异常堆栈。对香港服务器,还应从业务目标用户所在网络做外部访问验证;服务器本机 curl 成功只能说明本机到站点的局部路径可用。

四、验证与观察:检查真实请求,不只检查进程配图

五、回滚条件:应用回退不等于数据回退

发布前应把回滚触发条件写清楚,例如关键业务流程持续失败、5xx 错误明显高于变更前基线、队列持续积压、数据库连接异常,或证书与入口配置导致主要用户无法访问。阈值应结合业务基线设定;可将变更前的错误率、响应时间和队列长度记录下来,避免仅凭单次慢请求作出判断。

若问题确认只由应用代码引起,且旧代码仍兼容当前数据库结构,可将 current 切回上一发布目录,再按需让 PHP-FPM 重新载入代码、通知队列 worker 重启,并复测关键业务流程。切换前后都要检查软链接目标,避免把入口指向已经清理的目录。

若涉及 Nginx 配置变更,回退时先恢复备份配置,再执行 nginx -t;检查通过后才重载服务。若证书配置或域名记录也发生变化,应分别核对对应的恢复步骤和生效时间,不能指望切回应用代码自动恢复入口。

若数据库迁移不兼容旧代码,不能直接切回旧版本后就宣布恢复。应根据迁移方案评估是否需要恢复数据库备份、执行经过审核的补偿迁移,或继续向前修复。数据库恢复可能覆盖变更期间产生的新数据,应先判断数据损失范围并由负责人批准。

五、回滚条件:应用回退不等于数据回退配图

建议在发布后的 30 至 60 分钟内保持发布目录、配置副本和数据库备份可用,并持续观察关键业务、日志、队列与资源指标;高风险迁移或流量较大的站点应根据业务周期延长观察窗口。只要主要业务持续异常、数据一致性无法确认,或回退依赖的条件尚未验证,就应停止继续变更并启动既定回滚流程,而不是边扩大变更范围边等待问题自行消失。

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

相关推荐