香港服务器部署Laravel 11应用要准备什么?运行环境与启动验证怎么安排

发布人:A5数据发布时间:2026-10-29 15:04阅读量:90

香港服务器首次部署 Laravel 11,准备工作不只是让 php artisan serve 能访问页面,还要把 PHP-FPM、Nginx、数据库、环境变量、文件权限和 HTTPS 入口连接起来,并确认重启后应用仍能正常运行。下面以 Ubuntu 24.04、Nginx、PHP 8.3 和 MySQL 为例,适用于已准备好 Laravel 11 项目代码、计划部署到生产或预发布环境的场景。

香港机房不会改变 Laravel 的安装方式,但访问延迟、DNS 解析和服务器防火墙会影响上线验证。正式操作前,应确认域名已指向服务器公网 IP,TCP 80、443 端口可从外部访问;SSH 管理端口应仅向可信来源开放。本文中的域名、目录和数据库名称均为示例,需替换为实际值。

一、部署前准备与边界确认

建议先准备以下信息:

项目示例核验方式
操作系统Ubuntu 24.04 LTScat /etc/os-release
PHP8.3,且不低于 Laravel 11 的 PHP 8.2 要求php -v
域名app.example.comdig +short app.example.com
项目目录/var/www/laravel-app部署后检查目录与文件
数据库MySQL,独立应用账号登录数据库验证连接
代码来源Git 仓库或已构建的发布包检查 composer.lock、artisan

PHP 扩展必须与项目的 composer.lock 和实际功能对应。常见基础扩展包括 mbstring、xml、curl、zip、mysql、bcmath 和 intl;图像处理等功能还可能需要额外扩展。部署前可在项目开发或构建环境运行 composer check-platform-reqs,不要仅凭网页能打开就判断依赖齐全。

如果项目使用队列、定时任务、Redis、对象存储或外部邮件服务,需要把对应服务和凭据纳入部署清单。它们不是所有 Laravel 应用的必选项,不应为了“完整部署”而盲目安装。

二、安装 Web 与 PHP 运行环境

先通过 SSH 登录服务器,更新软件包索引并安装 Nginx、PHP-FPM、常用扩展和 MySQL。以下命令适用于 Ubuntu 24.04 默认软件源;如果软件源中没有对应 PHP 包,先检查系统版本和软件源,不要直接混用其他发行版的软件包。

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

确认关键服务和版本:

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

预期能看到 PHP 8.3.x,扩展列表包含项目依赖的模块,且 Nginx、PHP-FPM、MySQL 状态为 active (running)。若服务未运行,先用 sudo journalctl -u php8.3-fpm -n 50 --no-pager 或对应服务名查看日志,再处理启动错误。

如主机启用了 UFW,应确认规则允许 HTTP、HTTPS,并保留当前 SSH 管理通道。以下操作会调整防火墙规则,只适用于已确认使用 UFW 且已核对 SSH 规则的服务器;变更前记录现有规则,避免误关远程连接。

sudo ufw status verbose
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

不要在未确认 SSH 端口规则时启用或重置防火墙。云平台安全组或上游防火墙也需要独立检查,系统内放行端口不代表公网一定可达。

三、部署项目代码并准备配置

将项目放到固定目录。下面示例假定代码通过 Git 获取,且项目入口目录中存在 artisan 和 composer.json。如果使用发布包,可按相同原则解压到目标目录,并核对文件归属。

sudo mkdir -p /var/www/laravel-app
sudo chown -R "$USER":www-data /var/www/laravel-app
cd /var/www/laravel-app
git clone <仓库地址> .

如果目录已经包含代码,不要再次执行克隆;先确认当前目录和文件,避免覆盖已有部署。检查 Laravel 版本及依赖锁文件:

test -f artisan && test -f composer.json && test -f composer.lock
grep -n '"laravel/framework"' composer.lock | head

安装 Composer 时应使用可信的软件包来源,并通过项目要求的 Composer 版本检查依赖。若服务器尚未安装 Composer,不建议从不明来源复制可执行文件。安装完成后运行:

composer --version
composer check-platform-reqs

配置生产环境变量。可以从项目模板复制 .env.example,但不要将包含真实密码的 .env 提交到代码仓库,也不要把它放在 Web 根目录下。

cd /var/www/laravel-app
cp .env.example .env

编辑 .env,至少确认以下配置:

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

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_app
DB_USERNAME=laravel_user
DB_PASSWORD=替换为随机生成的强密码

如果使用本机 MySQL,127.0.0.1 通常表示 TCP 连接;若配置为 localhost,某些客户端可能改用 Unix socket。不要把数据库端口直接暴露到公网。生产环境的 APP_DEBUG 必须为 false,否则错误页面可能泄露路径、配置或请求信息。

生成应用密钥前,先确认这是新应用,或确认已有密钥已按安全流程保存。对已运行的应用随意更换 APP_KEY,可能导致加密数据和会话无法解密。

php artisan key:generate

预期 .env 中出现非空的 APP_KEY。若项目已有有效密钥,不要重复生成;应按项目的密钥管理流程处理。

四、创建数据库并安装应用依赖

通过本机 MySQL 管理账号创建数据库和仅供应用使用的账号。以下示例中的密码需替换,且不要复用服务器登录密码。

sudo mysql

在 MySQL 提示符中执行:

CREATE DATABASE laravel_app
  CHARACTER SET utf8mb4
  COLLATE utf8mb4_unicode_ci;

CREATE USER 'laravel_user'@'127.0.0.1'
  IDENTIFIED BY '替换为随机生成的强密码';

GRANT ALL PRIVILEGES ON laravel_app.* TO 'laravel_user'@'127.0.0.1';
FLUSH PRIVILEGES;
EXIT;

上例把权限限制在应用数据库范围内。若连接方式、MySQL 用户匹配规则或数据库部署位置不同,应按实际配置调整账号主机部分,并从应用服务器验证连接,不要为了省事授予全局管理权限。

安装生产依赖:

cd /var/www/laravel-app
composer install --no-dev --prefer-dist --optimize-autoloader

预期命令以成功状态结束,并生成或更新 vendor 目录。若出现 PHP 扩展缺失,依据报错安装对应扩展后再执行;若提示 composer.lock 与 composer.json 不一致,应先在开发环境修正并重新生成锁文件,不要在生产服务器上用 composer update 临时改写依赖版本。

对已经有数据的数据库,运行迁移前必须先备份,并确认迁移脚本与当前应用版本兼容。首次部署空数据库时,执行:

php artisan migrate --force

--force 用于生产环境执行迁移,不表示迁移没有风险。迁移可能新增、修改或删除结构;涉及数据转换时,应先验证迁移逻辑,并制定数据库恢复方案。预期输出显示迁移完成,随后可检查迁移状态:

php artisan migrate:status

如果迁移失败,不要反复执行不清楚影响范围的 SQL,也不要直接删除迁移记录。先查看 Laravel 日志和数据库报错,判断是否已部分执行,再决定修复或恢复备份。

五、设置权限与 Nginx 入口

Laravel 需要写入 storage 和 bootstrap/cache,但应用代码不应整体对 Web 服务用户开放写权限。以下示例假设当前部署账号已加入 www-data 组;若没有,先通过服务器账户管理流程加入并重新登录。变更权限前确认目录确实是该应用目录,避免对系统路径执行递归操作。

cd /var/www/laravel-app
sudo chown -R "$USER":www-data .
sudo chmod -R 2775 storage bootstrap/cache

预期 PHP-FPM 对这两个目录具备写入权限。其他代码文件不需要对所有用户可写。若部署流程与 PHP-FPM 使用不同账号,应按实际用户组配置权限,而不是使用 chmod -R 777。

创建 Nginx 站点配置,将站点根目录指向 Laravel 的 public,不能指向项目根目录。配置中的域名、路径和 PHP-FPM socket 必须与服务器一致。

sudo tee /etc/nginx/sites-available/laravel-app >/dev/null <<'EOF'
server {
    listen 80;
    server_name app.example.com;

    root /var/www/laravel-app/public;
    index index.php;

    charset utf-8;

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

    location = /favicon.ico {
        access_log off;
        log_not_found off;
    }

    location = /robots.txt {
        access_log off;
        log_not_found off;
    }

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

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

启用站点前先检查 PHP-FPM socket 是否存在:

ls -l /run/php/php8.3-fpm.sock

启用配置并测试语法:

sudo ln -s /etc/nginx/sites-available/laravel-app \
  /etc/nginx/sites-enabled/laravel-app
sudo nginx -t

如果 sites-enabled 中已存在同名链接,不要重复创建;先核对链接目标。nginx -t 应返回配置语法检查成功。只有检查通过后再重载服务:

sudo systemctl reload nginx

从服务器本机检查 HTTP 响应:

curl -I -H 'Host: app.example.com' http://127.0.0.1/

Laravel 可能返回 200 或将请求重定向到其他页面;核心是请求已到达站点且没有 Nginx 配置错误。若返回默认欢迎页,通常表示站点未启用、域名匹配不正确或默认站点优先响应。

六、配置 HTTPS、缓存与应用启动验证

申请证书前,确认域名 A 记录(以及实际使用时的 AAAA 记录)指向正确服务器,并能从公网访问 TCP 80。若 DNS 尚未生效或端口未开放,证书验证可能失败。Ubuntu 可使用 Certbot 的 Nginx 插件;安装来源应符合服务器的软件源策略。

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

按提示选择证书和 HTTP 跳转策略。完成后检查 Nginx 配置,并从外部或服务器发起 HTTPS 请求:

sudo nginx -t
curl -I https://app.example.com

预期能建立 TLS 连接并收到 HTTP 响应。若证书签发失败,先检查 DNS 解析、80 端口连通性和域名拼写,不要通过关闭证书校验掩盖问题。证书自动续期可用模拟续期检查:

sudo certbot renew --dry-run

随后生成 Laravel 缓存。确认 .env 已填写正确后执行:

cd /var/www/laravel-app
php artisan config:cache
php artisan route:cache
php artisan view:cache

若 route:cache 报错,可能与路由定义不兼容缓存有关;按项目实际情况处理,不要把失败命令当作部署成功。配置缓存后,修改 .env 必须重新构建配置缓存,否则应用可能继续读取旧配置。

首次部署可检查应用状态与日志:

php artisan about
tail -n 50 storage/logs/laravel.log
sudo journalctl -u php8.3-fpm -n 50 --no-pager
sudo tail -n 50 /var/log/nginx/error.log

还应通过浏览器或 curl 验证一个真实应用路由、数据库读写功能及登录等关键业务流程。单独访问首页成功,不能证明数据库、上传和队列都已正常工作。

如果应用依赖队列,应配置独立的常驻进程管理,而不是依赖 SSH 会话中的 php artisan queue:work。例如使用 systemd 时,服务单元应指定应用目录、运行用户、PHP 路径和队列命令,并设置自动重启策略;创建后需执行 systemctl daemon-reload、启动服务,再检查 systemctl status 和队列日志。队列是否需要、监听哪些队列,应由项目配置决定。定时任务同理,只有项目确实使用调度任务时才添加每分钟执行 schedule:run 的计划任务。

七、常见异常与处理顺序

现象优先检查处理方向
浏览器显示 Nginx 404 或默认页server_name、站点链接、root 路径确认入口指向 public,运行 nginx -t 后重载
页面返回 502PHP-FPM 状态、socket 路径、Nginx 错误日志对齐 fastcgi_pass 与实际 socket,修复后重载
页面出现 500Laravel 日志、.env、PHP 扩展和权限先查具体异常;不要打开生产环境调试页
数据库连接失败数据库服务、账号主机、密码、库名及 .env从应用服务器验证连接;更新配置缓存后再测
上传或缓存目录报权限错误storage、bootstrap/cache 的属主与组只修正应用所需目录权限,不给整个项目开放写入
HTTPS 证书签发失败DNS、80 端口、安全组和域名记录修复网络条件后重试,避免反复申请无效证书

排查时先判断请求是否抵达服务器,再区分 Nginx、PHP-FPM、Laravel 和数据库层。不要在未定位问题前删除缓存目录、清空数据库或覆盖整个项目目录。

七、常见异常与处理顺序配图

八、上线验收与回滚检查项

部署完成后,至少逐项确认:

  • 域名解析到预期服务器,公网 80/443 端口可达,HTTPS 证书有效。
  • Nginx、PHP-FPM、MySQL 状态正常,重启服务器后服务仍能自动启动。
  • APP_ENV=production、APP_DEBUG=false,数据库凭据未进入代码仓库。
  • 首页及关键业务路由可用,数据库操作符合预期,Laravel 与 Nginx 日志无持续报错。
  • 应用只通过 public 目录对外服务,storage 和 bootstrap/cache 可写,其他代码目录没有不必要的写权限。
  • 队列、定时任务和文件上传仅在项目需要时纳入验收,并分别验证其实际运行结果。

首次上线前应保留上一版本代码、当前 .env 的安全备份,以及数据库备份;备份文件应限制访问权限,不应放在 Web 可访问目录。回滚时先停止或切换到兼容版本,再恢复上一版本代码和配置,随后重建配置缓存并检查服务日志。数据库迁移不能一概通过 migrate:rollback 撤销:若迁移涉及数据删除或不可逆转换,应依据预先验证过的恢复方案从备份恢复,并确认应用代码版本与数据库结构匹配后再开放流量。

Laravel 应用的运行表现与服务器的计算、内存、存储及网络资源密切相关。A5idc数据提供中国香港、美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的物理服务器,香港方案涵盖 Xeon Gold 与 AMD EPYC 平台,并配有 SSD 或 NVMe 存储,可为网站、业务后台、数据库和接口服务提供部署资源基础。不同地区与产品系列提供不同配置和线路选择,适合支撑多种 Laravel 业务场景。

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

相关推荐