Laravel框架Linux服务器配置技巧

Linux 服务器上部署与优化 Laravel 的实用技巧

一 基础环境快速搭建

• 更新系统并安装组件：PHP（含常用扩展）、Composer、Web 服务器（Nginx/Apache）、数据库（MySQL）。示例：sudo apt update && sudo apt install php php-fpm php-mysql php-curl php-mbstring php-xml php-zip php-gd php-bcmath nginx mysql-server；Composer：curl -sS https://getcomposer.org/installer | php && sudo mv composer.phar /usr/local/bin/composer。
• Web 服务器根目录必须指向 Laravel 的 public 目录；Nginx 常用配置要点：root 指向 public、try_files $uri $uri/ /index.php?$query_string、location ~ .php$ 使用 fastcgi_pass（如 unix:/var/run/php/php7.4-fpm.sock）、安全头 X-Frame-Options/X-XSS-Protection/X-Content-Type-Options、屏蔽隐藏文件。
• 应用初始化：复制 .env.example 为 .env 并配置数据库连接；生成密钥 php artisan key:generate；执行迁移 php artisan migrate。
• 文件权限：确保 storage 与 bootstrap/cache 可写（如 chown -R www-data:www-data，chmod -R 775），避免因权限导致日志、缓存、会话写入失败。

二 性能与安全优化

• PHP 运行时：启用并调优 OPcache（如 opcache.enable=1、opcache.memory_consumption=128、opcache.max_accelerated_files=10000、opcache.revalidate_freq=60），合理设置 memory_limit，避免过高或过低。
• Web 层与传输：优先使用 Nginx + PHP-FPM；启用 Gzip 压缩；启用 HTTP/2 提升并发与加载速度。
• Laravel 框架：生产环境执行 php artisan config:cache、route:cache、view:cache；使用队列（如 php artisan queue:work --daemon）处理耗时任务；引入 Laravel Octane（Swoole/RoadRunner）提升请求吞吐。
• 数据库与查询：为高频查询字段建立索引；使用 Eager Loading 解决 N+1；必要时使用查询缓存。
• 前端资源：通过 Laravel Mix 合并与压缩 CSS/JS（npm run production）。
• 安全头与防护：配置 X-Frame-Options、X-XSS-Protection、X-Content-Type-Options；隐藏敏感文件与目录。

三 进程管理与队列常驻

• PHP-FPM 进程管理：按内存与并发调优 pm.max_children、pm.start_servers、pm.min_spare_servers、pm.max_spare_servers；静态文件由 Nginx 直接服务，动态请求转发给 PHP-FPM。
• 队列常驻与高可用：使用 Supervisor 管理队列进程，示例配置要点：command=php /var/www/your-app/artisan queue:work --queue=high,default --tries=3；process_name=%(program_name)s_%(process_num)02d；numprocs 按负载设置（如 2–4）；autostart=true、autorestart=true、redirect_stderr=true、stdout_logfile=/var/log/laravel-queue.log。
• 任务分层：将邮件、短信、图片处理等耗时任务放入队列，Web 进程只负责请求响应，显著降低 TTFB。

四 监控排错与维护

• 日志与实时排查：查看 Nginx 错误日志（/var/log/nginx/error.log）、PHP-FPM 日志（/var/log/phpX.Y-fpm.log 或 pool 日志）、Laravel 应用日志（storage/logs/laravel.log）；生产禁用 APP_DEBUG，避免泄露敏感信息。
• 性能分析：开发环境可引入 Laravel Debugbar 定位慢查询与 N+1；生产环境建议使用 New Relic/Datadog 等 APM 做全链路监控与告警。
• 部署与回滚：使用 Git 管理代码，部署流程建议：git pull → composer install --optimize-autoloader --no-dev → php artisan migrate --force → 重启队列/Supervisor → 清缓存；出现问题时按版本快速回滚。

五 一键检查清单