部署
简介
当您准备好将 Laravel 应用程序部署到生产环境时,您可以做一些重要的事情来确保应用程序尽可能高效地运行。在本文档中,我们将介绍一些很好的起点,以确保您的 Laravel 应用程序得到正确部署。
服务器要求
Laravel 框架有一些系统要求。您应确保您的 Web 服务器具有以下最低 PHP 版本和扩展:
- PHP >= 8.2
- Ctype PHP 扩展
- cURL PHP 扩展
- DOM PHP 扩展
- Fileinfo PHP 扩展
- Filter PHP 扩展
- Hash PHP 扩展
- Mbstring PHP 扩展
- OpenSSL PHP 扩展
- PCRE PHP 扩展
- PDO PHP 扩展
- Session PHP 扩展
- Tokenizer PHP 扩展
- XML PHP 扩展
服务器配置
Nginx
如果您要将应用程序部署到运行 Nginx 的服务器上,则可以使用以下配置文件作为配置 Web 服务器的起点。最有可能的是,此文件需要根据服务器的配置进行自定义。如果您希望获得服务器管理方面的帮助,请考虑使用像 Laravel Cloud 这样的完全托管的 Laravel 平台。
请确保,如下面的配置所示,您的 Web 服务器将所有请求定向到应用程序的 public/index.php
文件。您永远不应尝试将 index.php
文件移动到项目的根目录,因为从项目根目录提供应用程序会将许多敏感的配置文件暴露给公共互联网
1server { 2 listen 80; 3 listen [::]:80; 4 server_name example.com; 5 root /srv/example.com/public; 6 7 add_header X-Frame-Options "SAMEORIGIN"; 8 add_header X-Content-Type-Options "nosniff"; 9 10 index index.php;11 12 charset utf-8;13 14 location / {15 try_files $uri $uri/ /index.php?$query_string;16 }17 18 location = /favicon.ico { access_log off; log_not_found off; }19 location = /robots.txt { access_log off; log_not_found off; }20 21 error_page 404 /index.php;22 23 location ~ ^/index\.php(/|$) {24 fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;25 fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;26 include fastcgi_params;27 fastcgi_hide_header X-Powered-By;28 }29 30 location ~ /\.(?!well-known).* {31 deny all;32 }33}
FrankenPHP
FrankenPHP 也可用于服务您的 Laravel 应用程序。FrankenPHP 是一个用 Go 编写的现代 PHP 应用程序服务器。要使用 FrankenPHP 服务 Laravel PHP 应用程序,您可以简单地调用其 php-server
命令
1frankenphp php-server -r public/
要利用 FrankenPHP 支持的更强大的功能,例如其 Laravel Octane 集成、HTTP/3、现代压缩或将 Laravel 应用程序打包为独立二进制文件的能力,请查阅 FrankenPHP 的 Laravel 文档。
目录权限
Laravel 需要写入 bootstrap/cache
和 storage
目录,因此您应确保 Web 服务器进程所有者具有写入这些目录的权限。
优化
当将应用程序部署到生产环境时,有各种文件应该被缓存,包括您的配置、事件、路由和视图。Laravel 提供了一个方便的 optimize
Artisan 命令,它将缓存所有这些文件。此命令通常应作为应用程序部署过程的一部分调用
1php artisan optimize
optimize:clear
方法可用于删除 optimize
命令生成的所有缓存文件以及默认缓存驱动程序中的所有键
1php artisan optimize:clear
在以下文档中,我们将讨论 optimize
命令执行的每个细粒度优化命令。
缓存配置
当将应用程序部署到生产环境时,您应确保在部署过程中运行 config:cache
Artisan 命令
1php artisan config:cache
此命令会将 Laravel 的所有配置文件合并到一个缓存文件中,从而大大减少框架在加载配置值时必须访问文件系统的次数。
如果您在部署过程中执行 config:cache
命令,则应确保仅从配置文件中调用 env
函数。配置缓存后,.env
文件将不会被加载,并且所有对 .env
变量的 env
函数的调用都将返回 null
。
缓存事件
您应在部署过程中缓存应用程序的自动发现事件到监听器的映射。这可以通过在部署期间调用 event:cache
Artisan 命令来完成
1php artisan event:cache
缓存路由
如果您正在构建具有许多路由的大型应用程序,则应确保在部署过程中运行 route:cache
Artisan 命令
1php artisan route:cache
此命令将所有路由注册减少为缓存文件中的单个方法调用,从而提高了注册数百个路由时路由注册的性能。
缓存视图
当将应用程序部署到生产环境时,您应确保在部署过程中运行 view:cache
Artisan 命令
1php artisan view:cache
此命令预编译所有 Blade 视图,以便它们不会按需编译,从而提高每个返回视图的请求的性能。
调试模式
config/app.php
配置文件中的 debug 选项确定了实际向用户显示多少关于错误的信息。默认情况下,此选项设置为遵循 APP_DEBUG
环境变量的值,该变量存储在应用程序的 .env
文件中。
在生产环境中,此值应始终为 false
。如果 APP_DEBUG
变量在生产环境中设置为 true
,您将面临将敏感配置值暴露给应用程序最终用户的风险。
健康检查路由
Laravel 包含一个内置的健康检查路由,可用于监视应用程序的状态。在生产环境中,此路由可用于向正常运行时间监视器、负载均衡器或 Kubernetes 等编排系统报告应用程序的状态。
默认情况下,健康检查路由在 /up
提供服务,如果应用程序在没有异常的情况下启动,则返回 200 HTTP 响应。否则,将返回 500 HTTP 响应。您可以在应用程序的 bootstrap/app
文件中配置此路由的 URI
1->withRouting(2 web: __DIR__.'/../routes/web.php',3 commands: __DIR__.'/../routes/console.php',4 health: '/up', 5 health: '/status', 6)
当对此路由发出 HTTP 请求时,Laravel 还会调度 Illuminate\Foundation\Events\DiagnosingHealth
事件,允许您执行与应用程序相关的其他健康检查。在此事件的监听器中,您可以检查应用程序的数据库或缓存状态。如果检测到应用程序存在问题,您可以简单地从监听器抛出异常。
使用 Laravel Cloud 或 Forge 部署
Laravel Cloud
如果您想要一个为 Laravel 优化的完全托管的、自动扩展的部署平台,请查看 Laravel Cloud。Laravel Cloud 是一个强大的 Laravel 部署平台,提供托管计算、数据库、缓存和对象存储。
在 Cloud 上启动您的 Laravel 应用程序,并爱上其可扩展的简易性。Laravel Cloud 由 Laravel 的创建者进行微调,可与框架无缝协作,因此您可以像以前一样继续编写 Laravel 应用程序。
Laravel Forge
如果您更喜欢管理自己的服务器,但不熟悉配置运行强大的 Laravel 应用程序所需的各种服务,那么 Laravel Forge 是一个适用于 Laravel 应用程序的 VPS 服务器管理平台。
Laravel Forge 可以在各种基础设施提供商(如 DigitalOcean、Linode、AWS 等)上创建服务器。此外,Forge 安装和管理构建强大的 Laravel 应用程序所需的所有工具,例如 Nginx、MySQL、Redis、Memcached、Beanstalk 等。