Laravel11配置cors怎么配置登录

梦杰姑娘_7514

梦杰姑娘_7514

2026-09-24

353人浏览

原创

登录接口本身不依赖cors配置,但前后端分离时浏览器会因跨域触发options预检;laravel 11默认不启用cors中间件,仅当前端与后端域名或端口不同、使用fetch/axios发起请求且未设mode:'no-cors'时才需配置;推荐使用laravel/sanctum,其已集成基础cors支持并适配cookie+csrf机制,无需额外安装laravel-cors包。

laravel11配置cors怎么配置登录

登录接口本身不依赖 CORS 配置,但前后端分离场景下,前端(如 Vue)调用 Laravel 11 的登录 API 时,浏览器会因跨域触发预检请求(OPTIONS),若后端未正确响应,登录请求会被拦截——所以“配置 CORS”本质是让登录请求能顺利发出并收到响应。

确认是否真需要手动配 CORS

Laravel 11 默认不启用 CORS 中间件。只有当你满足以下全部条件时,才需配置:

  • 前端(Vue/React)部署在 不同域名或端口(如 http://localhost:5173)
  • 后端 API 部署在 Laravel(如 http://localhost:8000)
  • 登录请求使用 fetch / axios 发起,且未设 mode: 'no-cors'(该模式无法读取响应,不可用于登录)

推荐方案:用 laravel/sanctum + 自带 CORS 支持

对登录这类有状态操作,Laravel 11 官方推荐 Sanctum(而非 Passport),它天然适配 Cookie + CSRF 机制,且默认已集成基础 CORS 配置:

Laravel
Laravel

避免常见的Laravel错误:N+1查询、批量赋值、缓存陷阱及队列序列化陷阱。

下载
  • 安装:运行 composer require laravel/sanctum
  • 发布配置:执行 php artisan vendor:publish --provider="Laravel\Sanctum\SanctumServiceProvider"
  • 运行迁移:php artisan migrate
  • config/sanctum.php 中设置允许的前端地址:
    'stateful' => ['localhost:5173', '127.0.0.1:5173'](根据你的 Vue 开发端口调整)

此时无需额外装 fruitcake/laravel-cors,Sanctum 会自动处理登录、登出、CSRF token 获取等跨域请求。

如果坚持用 fruitcake/laravel-cors(非推荐)

仅当不用 Sanctum、且必须用自定义登录逻辑时才考虑。步骤如下:

  • 安装:composer require fruitcake/laravel-cors
  • 发布配置:php artisan vendor:publish --provider="Fruitcake\Cors\CorsServiceProvider"
  • 编辑 config/cors.php,重点改这两项:
    'paths' => ['api/login', 'sanctum/csrf-cookie', 'api/*'],
    'supports_credentials' => true,
  • 确保登录路由加了 middleware('auth:sanctum') 或你自己的认证中间件,且控制器中返回标准 JSON 响应(不要重定向)

关键细节不能漏

  • 前端请求必须带 credentials: 'include'(fetch)或 withCredentials: true(axios),否则 Cookie 不会发送,登录态无法建立
  • Laravel 11 默认开启 SESSION_SECURE_COOKIE=true,开发环境(HTTP)必须在 .env 中改为 SESSION_SECURE_COOKIE=false,否则浏览器拒绝写入 Cookie
  • 登录成功后,后续请求需携带同一域下的 Cookie,服务端才能识别用户;Workerman 等长连接服务要同步 Session,得走 Redis 共享(另文详述)

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2024.04.09

817

10

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

2024.04.09

795

9

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2024.04.09

2368

10

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.10

3321

7

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

2025.08.05

4650

22

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

2025.08.05

3116

13

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

2025.08.05

5949

7

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

2026.03.04

1356

29

Laravel 框架安装指南
Laravel 框架安装指南

本指南详解 Laravel 框架安装全流程,涵盖 PHP 8.1+ 环境配置、Composer 依赖管理工具安装及国内镜像源优化。重点演示使用 composer create-project 命令创建 Laravel 10/11 项目,解决常见安装错误与依赖冲突。从环境搭建到项目初始化,助您快速完成 Laravel 开发环境部署,为后续 Web 应用开发奠定基础。适合 PHP 初学者与框架迁移开发者参考。

2026.04.09

175

6

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
如何安装 Composer
如何安装 Composer

共1课时 | 180人学习

Composer手册
Composer手册

共0课时 | 0人学习