部署
介绍
当您准备将 Laravel 应用程序部署到生产环境时,有一些重要的事情可以确保您的应用程序尽可能高效地运行。在本文档中,我们将介绍一些确保您的 Laravel 应用程序正确部署的良好起点。
服务器要求
Laravel 框架有一些系统要求。您应该确保您的 Web 服务器具有以下最低 PHP 版本和扩展:
- PHP >= 8.0
- 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 服务器管理和部署服务,例如 Laravel Forge。
请确保像下面的配置一样,您的 Web 服务器将所有请求指向您应用程序的 public/index.php
文件。您绝不应尝试将 index.php
文件移动到项目根目录,因为从项目根目录提供应用程序将暴露许多敏感配置文件给公共互联网:
server {
listen 80;
listen [::]:80;
server_name example.com;
root /srv/example.com/public;
add_header X-Frame-Options "SAMEORIGIN";
add_header X-Content-Type-Options "nosniff";
index index.php;
charset utf-8;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location = /favicon.ico { access_log off; log_not_found off; }
location = /robots.txt { access_log off; log_not_found off; }
error_page 404 /index.php;
location ~ \.php$ {
fastcgi_pass unix:/var/run/php/php8.0-fpm.sock;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
include fastcgi_params;
}
location ~ /\.(?!well-known).* {
deny all;
}
}
优化
自动加载优化
在部署到生产环境时,请确保您优化 Composer 的类自动加载映射,以便 Composer 可以快速找到加载给定类的正确文件:
composer install --optimize-autoloader --no-dev
除了优化自动加载器,您还应始终确保在项目的源代码控制库中包含 composer.lock
文件。当存在 composer.lock
文件时,项目的依赖项可以更快地安装。
优化配置加载
在将应用程序部署到生产环境时,您应确保在部署过程中运行 config:cache
Artisan 命令:
php artisan config:cache
此命令将所有 Laravel 的配置文件合并为一个缓存文件,这大大减少了框架在加载配置值时必须进行的文件系统访问次数。
如果您在部署过程中执行 config:cache
命令,您应确保仅在配置文件中调用 env
函数。一旦配置被缓存,.env
文件将不会被加载,所有对 .env
变量的 env
函数调用将返回 null
。
优化路由加载
如果您正在构建一个具有许多路由的大型应用程序,您应确保在部署过程中运行 route:cache
Artisan 命令:
php artisan route:cache
此命令将所有路由注册减少为一个方法调用,存储在缓存文件中,从而提高了注册数百个路由时的路由注册性能。
优化视图加载
在将应用程序部署到生产环境时,您应确保在部署过程中运行 view:cache
Artisan 命令:
php artisan view:cache
此命令预编译所有 Blade 视图,以便它们不会按需编译,从而提高每个返回视图的请求的性能。
调试模式
您在 config/app.php 配置文件中的调试选项决定了关于错误的信息实际显示给用户的多少。默认情况下,此选项设置为遵循存储在应用程序的 .env
文件中的 APP_DEBUG
环境变量的值。
在您的生产环境中,此值应始终为 false
。如果在生产环境中将 APP_DEBUG
变量设置为 true
,您将面临将敏感配置值暴露给应用程序最终用户的风险。
使用 Forge / Vapor 部署
Laravel Forge
如果您还没有准备好管理自己的服务器配置,或者不熟悉配置运行强大 Laravel 应用程序所需的各种服务,Laravel Forge 是一个很好的替代方案。
Laravel Forge 可以在各种基础设施提供商(如 DigitalOcean、Linode、AWS 等)上创建服务器。此外,Forge 安装和管理构建强大 Laravel 应用程序所需的所有工具,例如 Nginx、MySQL、Redis、Memcached、Beanstalk 等。
想要获取使用 Laravel Forge 部署的完整指南吗?请查看 Laravel Bootcamp 和 Forge 在 Laracasts 上提供的视频系列。
Laravel Vapor
如果您希望获得一个完全无服务器、自动扩展的部署平台,专为 Laravel 调整,请查看 Laravel Vapor。Laravel Vapor 是一个为 Laravel 提供的无服务器部署平台,由 AWS 提供支持。在 Vapor 上启动您的 Laravel 基础设施,享受无服务器的可扩展简单性。Laravel Vapor 由 Laravel 的创建者精心调整,以便与框架无缝协作,因此您可以继续像往常一样编写 Laravel 应用程序。