当前位置:

首页 > 编程开发 > Laravel怎么配置Nginx_LaravelNginx站点配置方法【操作】

Laravel怎么配置Nginx_LaravelNginx站点配置方法【操作】

Laravel的Nginx配置需将root指向public目录,用try_files重写非静态请求,配置fastcgi_pass对应PHP-FPM。务必设置SCRIPT_FILENAME与PATH_INFO参数防502/500错误。HTTPS重定向应使用$scheme动态判断,避免硬编码环境冲突。

本文目录

    聊Lara vel的Nginx配置,说实话真的不算什么高深的技术活,但偏偏就是这里最容易出问题。很多新手甚至有些经验的开发者,都会在这一步卡住,然后跑去翻日志。先说个最常见的坑:root指向错了。

    location / 要指向 public/ 目录,不是项目根目录

    很多人习惯把 root 设成 Lara vel 项目根目录,比如 /var/www/myapp,结果一访问,好家伙,app/、vendor/ 这些敏感目录直接暴露在浏览器里了,运气不好的还能看到 Index of / 列表。Lara vel 的入口只有一个 public/index.php,所以 Nginx 必须从这里开始接管请求。

    正确做法很简单,root 直接指向 public/ 子目录就行:

    server {
        listen 80;
        server_name example.com;
        root /var/www/myapp/public;  # ← 关键:必须是 public/
        index index.php;
    
        location / {
            try_files $uri $uri/ /index.php?$query_string;
        }
    
        location ~ \.php$ {
            fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
            fastcgi_index index.php;
            fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
            include fastcgi_params;
        }
    }

    这里有几个细节要留意一下:

    • $realpath_root 比 $document_root 更靠谱,尤其在使用了符号链接的部署场景里,它能避免路径解析出错
    • try_files 一定不能漏,少了它,静态资源比如 /css/app.css 就会直接 404
    • fastcgi_pass 要跟你的 PHP-FPM 实际监听地址对应上,常见翻车案例是写成 127.0.0.1:9000 但实际根本没开 TCP 监听

    rewrite 规则不能少,否则 Lara vel 路由 404

    Nginx 默认是不认识 Lara vel 路由的,所有非静态资源的请求都得交给 index.php 去分发。光靠 location / 加 try_files 还不够,碰到一些特殊的 URL——比如带点号的或者多层级嵌套的,就可能被提前截断。

    稳妥的做法是显式重写所有非静态文件请求:

    location / {
        try_files $uri $uri/ @lara vel;
    }
    
    location @lara vel {
        rewrite ^(.*)$ /index.php?$query_string last;
    }

    这里有几个常见误区:

    • 不要用 return 301 或者 proxy_pass,这是 PHP-FPM 场景,不是反向袋里
    • 如果项目用了多语言路由,比如 /zh/about 这种,务必确保 $query_string 被完整传递,否则 app()->getLocale() 可能拿不到正确值
    • 还有人习惯加一条 location ~ /\.ht 的规则,其实 Nginx 根本不读 .htaccess,这完全是冗余配置

    PHP-FPM 权限和 PATH_INFO 配置不到位,502/500 随机出现

    502 Bad Gateway 算是比较好排查的,多半是 PHP-FPM 进程没响应。但真正让人头疼的是 500 错误,而且日志里啥也看不到——因为 SCRIPT_FILENAME 解析错了,或者 PATH_INFO 为空,导致 Lara vel 认不出当前路由。

    关键两行必须存在,而且顺序不能乱:

    fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
    fastcgi_param PATH_INFO $fastcgi_path_info;

    再强调几点:

    • 缺了 PATH_INFO,Lara vel 的 Request::path() 会返回空值,所有路由匹配全部失败
    • 用 $document_root 替代 $realpath_root?在 Lara vel Envoyer、Capistrano 这类用了符号链接的部署方式里,$document_root 可能指向软链本身而不是真实路径,file_exists() 检查直接跪掉
    • PHP-FPM pool 用户(比如 www-data)必须对 storage/ 和 bootstrap/cache/ 有写权限,否则 php artisan config:cache 之后立马给你报错

    HTTPS 和 www 重定向容易写死,后续难调试

    上线之后加 HTTPS 或者强制 www 域名,很多人直接在 server 块里硬编码 return 301 https://...,结果本地开发环境也被强制跳转,CDN 回源也失败,调试起来非常痛苦。

    更安全的做法是依赖 $scheme 和 $host 做动态判断:

    if ($scheme != "https") {
        return 301 https://$host$request_uri;
    }

    这里有几个关键点:

    • 不要用 rewrite ^(.*)$ https://...,rewrite 是字符串替换,$request_uri 本身包含 query string,而 rewrite 默认不会带上它,容易丢参数
    • 如果用了 Cloudflare 或者阿里云 SLB,它们可能会以 HTTP 方式回源,这时候要检查 $_SERVER['HTTP_X_FORWARDED_PROTO'],并在 Lara vel 的 AppServiceProvider 里调用 URL::forceScheme('https')
    • 重定向规则一定要放在主 server 块最前面,否则可能被 location 块拦截,变成 404 而不是跳转

    说到底,Lara vel 的 Nginx 配置难点真不在语法本身,而在于路径解析、权限边界还有环境差异这些细节。哪怕一行 $realpath_root 写错了,或者少了一个分号,都可能让日志里只显示一句 "recv() failed",而你根本不知道问题出在哪。可以确定的是,把这些细节吃透了,后面再怎么折腾都不会慌。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发 laravel
    相关文章 更多
    laravel官网教程下载与安装入门指南
    laravel官网教程下载与安装入门指南

    想开始学习Laravel却卡在第一步?本文手把手教你配置PHP环境、安装Composer并成功创建第一个Laravel项目,避开常见坑点,快速进入开发状态。

    Laravel如何通过命令行动态调整队列顺序_Laravel通过命令行动态调整队列顺序方法【CLI】
    Laravel如何通过命令行动态调整队列顺序_Laravel通过命令行动态调整队列顺序方法【CLI】

    Laravel可通过五种方法动态调整队列消费顺序:多进程独立监听配合信号控制、基于环境变量动态解析队列名、利用调度器注入临时队列指令、通过Redis键前缀模拟队列切换、借助SupervisorRPC接口热重载配置。这些方法绕过了固定优先级限制,实现运行时灵活变更。

    Laravel 登录后重定向到用户个人主页的完整实现
    Laravel 登录后重定向到用户个人主页的完整实现

    Laravel默认登录跳转使用静态路径,需重写LoginController的authenticated()方法,利用Auth::user()获取当前用户ID,动态拼接/profile/{id}路由重定向,避免硬编码路径错误,确保每个用户登录后跳转到其专属个人主页。

    Laravel 查询中处理可空结束日期的动态范围筛选
    Laravel 查询中处理可空结束日期的动态范围筛选

    在Laravel中处理可空结束日期的动态范围筛选,需避免使用whereBetween或固定条件。正确做法是采用闭包条件化查询,利用或逻辑处理end_at为NULL的情况,避免NULL比较导致记录被过滤,实现半开放时间区间的准确查询。

    如何在 Laravel 中通过关联表查询借阅者所借书籍的完整信息
    如何在 Laravel 中通过关联表查询借阅者所借书籍的完整信息

    在Laravel中,通过多表联结查询借阅者历史借书记录,需关联borrowers、books和borrow三张表。使用JOIN与select方法提取书名、ISBN、作者、借还日期及逾期状态,显式声明所有表关联可增强查询可扩展性,并建议为外键添加索引以提升性能。

    Laravel怎样使用事务确保订单与库存一致性_Laravel电商订单事务一致性方法【业务】
    Laravel怎样使用事务确保订单与库存一致性_Laravel电商订单事务一致性方法【业务】

    Laravel通过DB::transaction闭包、手动事务控制、Eloquent模型事件、事务重试及savepoint局部回滚五种机制,确保电商订单创建与库存扣减的原子性,防止超卖与数据不一致,支持高并发下的死锁处理与灵活回滚。

    Laravel怎样处理表单验证规则_Laravel处理表单验证规则方法【验证】
    Laravel怎样处理表单验证规则_Laravel处理表单验证规则方法【验证】

    在Laravel中,表单验证可通过控制器直接调用validate()方法、使用FormRequest类封装验证逻辑、注册自定义规则、正确编写条件规则以及预处理请求数据来实现。这些方法能够确保验证规则生效,并避免常见冲突,同时提高代码可维护性。

    Laravel怎样实现OAuth2社交登录_Laravel实现OAuth2社交登录方法【集成】
    Laravel怎样实现OAuth2社交登录_Laravel实现OAuth2社交登录方法【集成】

    Laravel实现OAuth2社交登录的四种主流方案:使用Socialite快速集成,手动通过Guzzle实现OAuth2三步骤,结合Passport生成BearerToken,以及抽象中间件统一多平台认证。四种方案各有优劣,适用于不同场景,开发者可根据项目需求权衡选择。

    如何在 Laravel 中使用单一登录接口支持多个 Guards(认证守卫)
    如何在 Laravel 中使用单一登录接口支持多个 Guards(认证守卫)

    在Laravel中通过动态切换认证守卫实现统一登录接口,基于请求参数自动选择对应Guard与模型,预定义映射表并复用原生认证方法,统一响应结构,避免重复代码,提升可维护性与扩展性。需正确配置认证源、模型实现令牌功能,并配合限流中间件保障安全。

    Laravel如何对动态内容做条件缓存_Laravel对动态内容做条件缓存方法【逻辑】
    Laravel如何对动态内容做条件缓存_Laravel对动态内容做条件缓存方法【逻辑】

    Laravel动态内容条件缓存采用五种策略:动态键名配合Cache::remember()区分不同条件;中间件基于请求特征拦截复用缓存;ViewComposers按需注入缓存数据;模型事件自动失效关联缓存;路由闭包嵌套缓存并支持运行时开关。这些方法依据用户身份、参数等驱动缓存,避免静态路径局限。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。