把 Laravel 项目放到阿里云服务器上,代码传完只是开始。PHP 版本和扩展是否匹配、Nginx 是否指向正确目录、队列和定时任务有没有运行,都会影响网站能不能正常工作。下面按上线顺序梳理服务器选型、环境准备、部署步骤和常见故障,重点覆盖容易漏掉的后台任务与权限配置。
先规划:服务器怎么选
阿里云服务器的配置要看项目访问量、运行方式和预算。个人博客、企业展示站或测试环境,可以从较低规格的云服务器 ECS 起步;如果应用同时运行数据库、缓存和队列任务,就要给内存和 CPU 留出余量。项目规模变化后,再根据实际负载升级配置,或考虑拆分数据库、增加负载均衡。
地域会影响用户访问体验,服务器通常应尽量靠近主要用户。面向中国大陆用户提供公网服务时,还要按规定办理 ICP 备案。域名解析、备案进度、带宽计费方式和云盘空间也应提前确认,否则代码部署完成,网站仍可能无法正常对外访问。
选系统和安装方式之前,先打开项目的 composer.json,核对 Laravel 要求的 PHP 版本及 OpenSSL、PDO、Mbstring、Fileinfo 等扩展。项目如果还依赖 Redis、MySQL 或其他服务,也要一并考虑资源配置和网络连接方式,避免上线后才发现服务之间无法访问。
部署前准备:理清运行环境和权限
常见的 Linux 部署组合是 Nginx、PHP-FPM 和 MySQL。软件版本尽量通过包管理器或可信的软件源统一管理,并记录环境配置。团队已有 Docker 流程时,也可以用容器固化运行环境,减少开发环境与生产环境不一致的问题。
SSH 登录后创建普通部署用户,不要长期用 root 运行应用。优先配置密钥登录,并限制不必要的远程访问。阿里云安全组只开放业务确实需要的端口,通常包括 SSH 管理端口以及网站使用的 80、443 端口;数据库端口不要直接暴露到公网。
代码可以通过 Git 拉取,也可以由持续集成工具发布。不要把本地的 .env 文件、数据库密码和应用密钥提交到公开仓库。生产环境应在服务器上单独配置这些信息,设置 APP_ENV=production 和 APP_DEBUG=false。调试模式开启时,报错页面可能显示服务器路径、配置等信息。
阿里云服务器 Laravel 上线步骤
- 安装并核对依赖:安装 PHP、Composer、Nginx,以及项目需要的数据库或缓存服务。用 php -v、composer -V 检查版本,再确认 Laravel 所需的 PHP 扩展已安装。不要只看安装命令是否成功,还要核对实际运行版本。
- 发布项目代码:把项目拉取到服务器上的应用目录,在项目根目录执行 composer install –no-dev –optimize-autoloader。生产环境应依据锁定的依赖安装;不要为了临时解决问题随意执行 composer update,否则依赖版本可能发生变化。
- 填写生产环境配置:设置数据库连接、缓存、邮件、队列等参数,并处理应用密钥。首次部署时按项目情况生成密钥;已有线上应用不要轻易更换密钥,否则原有加密数据或会话可能无法正常读取。
- 设置目录权限:确认 PHP-FPM 的运行用户能够写入 storage 和 bootstrap/cache。不要为了省事把整个项目目录设成所有用户都可写;应根据服务运行用户和目录用途逐项设置权限。
- 配置 Nginx:网站根目录必须指向 Laravel 项目的 public 目录,不能指向项目根目录。配置 PHP-FPM 转发后,先检查 Nginx 配置再重新加载服务。确认安全组、防火墙和域名解析无误后,通过浏览器测试访问。
- 执行上线任务:按项目需要运行数据库迁移,例如 php artisan migrate –force。迁移前先备份数据库;完成后再清理或重建配置缓存,并确认队列消费者和计划任务已经配置、能够持续运行。
浏览器能打开首页,不等于部署已经结束。上线后要查看 Laravel 的 storage/logs、Nginx 错误日志和 PHP-FPM 日志,并逐项测试登录、表单提交、文件上传和邮件发送。还要确认 HTTPS 证书正常。涉及用户数据的应用,应提前制定数据库备份和恢复流程;只有备份文件、没有验证过恢复过程,出故障时未必能及时恢复服务。
案例:小型电商后台上线时漏了什么
一个小型 Laravel 电商后台平时访问量不大,但商品导入和订单通知会生成后台任务。团队在阿里云 ECS 上部署 Nginx、PHP-FPM 和 Laravel 应用,单独规划 MySQL,并用 Redis 处理缓存和队列。数据库不开放公网访问,应用通过内网连接数据库;安全组只开放网站所需端口和受限的管理入口。
首次上线后页面可以访问,订单通知却没有发出。检查发现,任务已经写入 Redis,但服务器上没有常驻的队列消费者。团队随后用进程管理工具守护队列进程,并配置定时任务调用 Laravel Scheduler,测试后通知恢复正常。这个问题很容易被忽略:只部署 Web 服务,队列里的任务不会自动执行,计划任务也需要单独配置。
常见问题与维护建议
- 页面出现 403 或 404:先看 Nginx 是否指向 public 目录,再检查伪静态规则、目录权限和 PHP-FPM 配置。
- 出现 500 错误:查看 Laravel 的 storage/logs 和服务日志,重点排查环境变量、PHP 扩展、数据库连接及目录写入权限。生产环境排错时不要开启调试模式。
- 迁移或依赖安装失败:核对 PHP、Composer 和项目锁定的依赖版本,同时检查磁盘空间与网络访问。不要直接删除锁文件来绕过安装问题,先确认失败原因。
- 网站能访问,后台任务却没动静:检查队列消费者是否运行、定时任务是否配置,以及 Redis 等依赖服务能否连接。
- 网站偶尔变慢:先查看 CPU、内存、磁盘和带宽监控,再排查慢查询、日志增长和缓存命中情况。找到具体瓶颈后再扩容或优化,避免只凭感觉增加配置。
阿里云服务器 Laravel 部署完成后,还要持续检查日志、更新依赖并维护备份。先用合适的配置完成上线,再结合监控和实际访问情况调整资源,通常比一开始盲目堆配置更稳妥。对有队列和计划任务的项目,要把这些进程也纳入日常检查,避免前台正常、后台工作却悄悄停掉。