Laravel 本地跑得好好的,上线 500;队列不消费、定时任务不跑、上传文件 403。部署不是把代码传上去,是把 PHP、权限、队列和缓存都配对。
部署栈
- Nginx:静态文件和反代 PHP-FPM
- PHP-FPM:跑 Laravel
- Composer:装依赖
- Redis:缓存和队列
- Supervisor:守护队列进程
- MySQL/Postgres:数据库
上线步骤
composer install --no-dev --optimize-autoloader
cp .env.example .env
php artisan key:generate
php artisan migrate --force
php artisan config:cache
php artisan route:cache
php artisan view:cache
生产环境别用 php artisan serve;它只适合本地开发。
Nginx 配置
root /var/www/app/public;
index index.php;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass unix:/run/php/app.sock;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
include fastcgi_params;
}
root 必须指向 public,别把 .env 暴露出去。
权限
storage 和 bootstrap/cache 要可写,但别给 777;用 www-data 用户和组,权限 775。

队列
[program:laravel-worker]
command=php /var/www/app/artisan queue:work redis --sleep=3 --tries=3
numprocs=2
autostart=true
autorestart=true
user=www-data
队列进程挂了要自动重启;失败任务进 failed_jobs,定期重试或清理。
定时任务
* * * * * cd /var/www/app && php artisan schedule:run >> /dev/null 2>&1
Laravel 的调度器靠这一条 cron 驱动,别为每个任务单独写 cron。

新加坡还是美国
- 新加坡:东南亚用户近,适合面向 SEA 的业务
- 美国:北美市场、成本和机型选择多
- 香港:大陆和亚洲用户近
应用、数据库和 Redis 同区域,别跨洲查库;队列 worker 跟应用同机或同区。

性能
开 OPcache、配置缓存、路由缓存;队列和 web 分开进程,别让重任务拖慢页面。
安全
APP_DEBUG=false,别把堆栈暴露给用户.env不进 Git,权限 600- 数据库账号最小权限
- HTTPS 和 HSTS
- 定期更新依赖,看安全公告
Composer
生产用 --no-dev,锁文件进 Git;别在服务器上跑 composer update。
环境变量
.env 不进代码库,权限 600;多环境用不同文件,别把生产密钥带到测试。
日志
日志按天切,权限可写;500 先看 storage/logs 和 Nginx 错误日志。
备份
数据库每天、代码和上传文件每周;备份放另一处,恢复演练每季度一次。
OPcache
生产开 OPcache,改代码后重置;配置缓存后别再改 .env,否则不生效。
队列失败
failed_jobs 要监控,失败任务重试或清理;别让队列表无限涨。
节点
应用和 Redis 同区,队列延迟低;数据库跨区会拖慢所有任务。
日志权限
storage 和 bootstrap/cache 可写,其他目录只读;权限错是 500 的常见原因。
部署脚本
拉代码、装依赖、迁移、缓存、重启队列,写成脚本;别手工一步步敲。
回滚
代码和数据库迁移都要能回滚;迁移前备份,别只回代码不回库。
监控
看 5xx、队列长度、失败任务和 TTFB;队列堆积通常比页面慢更早出现。
安全清单
APP_DEBUG 关、.env 600、数据库最小权限、HTTPS;依赖定期更新。
队列监控
队列长度、失败数和处理时间设告警;堆积通常比页面慢更早出现。
上线检查
依赖、迁移、缓存、队列、定时、权限六项逐项确认,别漏 .env 和 key。
性能调优
开 OPcache、配置/路由缓存,队列异步化;数据库慢查询先加索引。
回滚演练
代码回滚和数据库回滚分开练;只回代码不回库,数据可能对不上。
长期
依赖、PHP 和 Laravel 版本定期升级;别等 EOL 才动。
文档
部署步骤写成一页,新同事照着能上线。
合规
日志和用户数据按当地法规保留,别无限存。
总结建议
部署是工程,不是传文件。
最后
上线前把 checklist 走完。
最后补充
先把流程跑通。
常见问题 FAQ
Q1:Laravel 要多大配置?
2 核 4G 起步,队列和并发多就 4 核 8G;内存比 CPU 更先到顶。
Q2:队列不消费怎么办?
看 Supervisor 状态、Redis 连接和 failed_jobs;先重启 worker,再查日志。
Q3:新加坡还是美国节点?
用户在哪放哪;应用和数据库同区域,别跨洲。
Q4:部署要停机吗?
小版本可以热更,大版本用维护模式或蓝绿;迁移前备份。
Q5:500 错误先看哪?
看 Laravel 日志、Nginx 错误日志和 PHP-FPM 日志;权限和 .env 是常见原因。
总结
Laravel 部署的核心是 Nginx root、PHP-FPM、storage 权限、队列 Supervisor 和 schedule cron。节点跟用户走,应用和数据库同区;生产关 debug,依赖定期更新。
需要一台 Laravel 机器,可以按小时开一台萤光云新加坡 VPS,先把队列和定时任务跑通。
队列和定时任务先跑通,再谈扩容和多机部署,别急着上集群。







