您如何在生产环境中部署和优化 Laravel？

Question

Accepted Answer

在生产环境中部署 Laravel 涉及一系列**优化命令**（缓存 config/routes/views）、安全配置、运行适当的 web 服务器堆栈以及管理队列和调度程序。Laravel 提供特定的 Artisan 命令来优化生产环境。

## 生产环境优化命令

```bash
# cache config, routes, and views → significant speedup (skip recompilation per request)
php artisan config:cache        # merge & cache all config into one file
php artisan route:cache          # cache compiled routes
php artisan view:cache           # precompile Blade templates
php artisan event:cache
# or all at once:
php artisan optimize

composer install --optimize-autoloader --no-dev    # optimized autoloader, no dev deps
```

这些缓存命令对**生产环境性能至关重要** — 它们预先计算 config、routes 和 views，使得 PHP 不需要在每次请求时重新解析/重新编译它们，能带来显著的速度提升。（注意：配置缓存后，`env()` 仅在配置文件中工作 — 代码必须通过 `config()` 来读取。）

## 安全的生产配置

```bash
# .env (production)
APP_ENV=production
APP_DEBUG=false          # ❗ MUST be false — debug=true leaks sensitive info/stack traces
APP_KEY=...               # generated, kept secret
```

```text
✓ APP_DEBUG=false (leaking debug info is a serious security risk)
✓ Keep secrets in .env (gitignored) / environment; never commit them
✓ Use HTTPS; set secure session/cookie settings
```

## 服务器堆栈和支持进程

```text
✓ Web server: NGINX + PHP-FPM (the standard PHP production stack)
✓ Database: a real DB (MySQL/PostgreSQL) with migrations run on deploy (php artisan migrate)
✓ Queue workers: run via Supervisor (or Laravel Horizon for Redis) — keep them alive
✓ Scheduler: ONE cron entry running `schedule:run` every minute
✓ Cache/sessions: Redis (shared, fast) — especially for multi-server, keep app STATELESS
✓ Use OPcache (PHP bytecode cache) — a major PHP-level speedup
```

## 托管部署选项

```text
Laravel Forge (server provisioning), Vapor (serverless on AWS), or platforms
(Envoyer for zero-downtime deploys) automate much of this.
```

## 为什么这很重要

在生产环境中部署和优化 Laravel 是正确、安全且高效地将应用程序投入运行的基本知识 — 它涉及特定于 Laravel 的步骤，这些步骤与开发环境不同。

**生产优化命令**尤其重要且经常被忽视：`config:cache`、`route:cache`、`view:cache`（或 `optimize`）预先计算配置、路由和模板，使得 PHP 不需要在每次请求时重新解析它们，从而提供有意义且必要的性能提升 — 在生产环境中跳过这些命令会导致明显的性能损失。

以下几个方面也是安全关键的：**`APP_DEBUG=false`** 是必需的（调试模式会向攻击者泄露敏感的堆栈跟踪和配置 — 这是一个严重的安全漏洞）、密钥必须保持在版本控制之外、HTTPS 和安全会话是必需的。

理解适当的**服务器堆栈**（NGINX + PHP-FPM、带有在部署时运行的迁移的真实数据库、用于 PHP 级性能的 OPcache）和**支持进程**（通过 Supervisor/Horizon 保持活动的队列工作程序、调度程序的单个 cron 条目、Redis 用于共享缓存/会话，特别是在多服务器无状态设置中）对于运行一个可工作的、高性能的生产部署是必要的。

了解托管选项（Forge、Vapor、Envoyer 用于零停机部署）也很有价值。

由于每个真实的 Laravel 应用程序都必须正确部署才能快速和安全 — 并且由于部署错误（跳过优化缓存、保留调试开启、错误处理队列/调度程序）会导致实际的性能和安全问题 — 理解 Laravel 的生产部署和优化（缓存命令、安全配置、服务器堆栈和支持进程）是用于交付生产就绪应用程序的重要高级知识、一个经常相关的、专业上至关重要的话题。