Laravel网站部署到香港服务器,生产环境要配置哪些关键项?
生产环境部署的目标,不只是 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 进程平滑重启。不要在不清楚影响范围时重启所有后台服务。

定时任务应有明确且唯一的执行安排。常见做法是由一台应用服务器每分钟调用 Laravel 调度器;多台服务器部署时,应避免所有实例无协调地重复执行同一任务,或在任务定义中采用适用的单机执行保护。
5. 建立日志与服务管理基线
生产进程应由 systemd、Supervisor 或其他进程管理器托管,确保异常退出后能够按预期恢复,并能查看启动失败原因。PHP-FPM、Nginx、队列 worker 和定时任务的服务名与日志位置依发行版及安装方式而异,执行前用 systemctl list-units、systemctl status 服务名 或进程管理器自身命令核实,不要猜测服务名称。
Laravel 应用日志应保留足够的排查信息,同时设置合理级别和轮转策略。不要在公开错误页、日志或响应中输出数据库密码、访问密钥、会话内容等敏感数据。Nginx 访问日志与错误日志、PHP-FPM 日志和 Laravel 日志分别记录不同层面的现象,排查时应按时间戳关联,而不是只看应用日志。
四、验证与观察:检查真实请求,不只检查进程
切换后按由外到内的顺序验证,先确认解析和网络入口,再检查站点、应用和后台任务:
- 域名与端口:从服务器外部检查域名解析结果和 HTTPS 是否可达。确认云平台安全组、主机防火墙及服务监听地址一致。
- Nginx 与证书:检查
nginx -t、站点访问日志和错误日志;确认 HTTP/HTTPS 跳转、证书域名与有效期符合预期。 - Laravel 页面与业务路径:访问首页和关键业务流程,包括登录、表单提交、上传、支付或第三方回调等实际使用的功能。静态页面正常不代表数据库写入和会话正常。
- 队列与定时任务:确认 worker 由进程管理器托管、任务能够被消费,调度任务没有重复执行或持续失败。
- 数据与文件:检查关键读写、上传文件访问、缓存和会话状态。不要只以首页返回 HTTP 200 作为验收标准。
- 日志和资源:观察 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



