Laravel环境部署前端框架集成:Vue3与React在Laravel中的配置【教程】

千宇吖_1371

千宇吖_1371

2026-06-01

809人浏览

原创

推荐采用前后端分离架构:Laravel 作为纯 API 后端提供 RESTful 接口与安全认证,Vue3/React 作为独立前端通过 Vite 构建并代理请求,统一由 Sanctum 处理会话认证,关键权限必须在后端中间件强制校验。

laravel环境部署前端框架集成:vue3与react在laravel中的配置【教程】

在 Laravel 中集成 Vue3 或 React,核心是明确项目结构定位:是“Laravel 内嵌前端”(单体式),还是“前后端分离”(API 服务 + 独立前端)。两种路径配置差异明显,选错会导致跨域、热更新失效、认证异常等问题。下面按实际开发高频场景分步说明。

Vue3 集成:推荐 Vite + Laravel API 模式

现代 Laravel 项目默认使用 Vite,不再依赖 Laravel Mix。这种方式让 Vue3 完全独立运行,开发体验接近纯前端项目。

  • 在 Laravel 根目录执行:npm create vite@latest frontend -- --template vue,新建 frontend/ 目录作为 Vue3 项目
  • 修改 frontend/vite.config.js,设置代理避免开发跨域:
    server: { proxy: { '/api': { target: 'http://localhost:8000', changeOrigin: true } } }
  • 后端启用 Sanctum cookie 认证:确保 config/sanctum.php 中 'stateful' => ['localhost:5173'](Vite 默认端口)已添加
  • 前端 Axios 配置需开启凭证:axios.defaults.withCredentials = true,并确保请求头携带 X-XSRF-TOKEN(Sanctum 自动注入)

React 集成:同理用 Vite,但注意路由与 SSR 兼容性

React 项目同样建议独立于 Laravel 目录,尤其当未来可能接入 SSR(如 Next.js)或静态托管时。

HISUI 前端框架开发指南(IRIS版)
HISUI 前端框架开发指南(IRIS版)

HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库,专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考,支持声明式与编程式两种初始化方式,提供 $cm/$m 数据访问方法。

下载
  • 创建 React 项目:npx create-react-app frontend --template typescript 或更轻量的 npm create vite@latest frontend -- --template react
  • 在 frontend/src/setupProxy.js(CRA)或 vite.config.js(Vite)中配置 API 代理到 http://localhost:8000
  • 认证统一走 Sanctum:登录接口返回 session cookie 后,后续请求自动携带;无需手动管理 token
  • 若使用 React Router v6,页面级权限控制可结合 useEffect 调用 /api/user 验证登录态,但关键权限(如编辑、删除)必须由 Laravel 后端中间件(auth:sanctum)强制校验

Laravel UI 脚手架:仅适合快速原型或小团队维护

该方案将 Vue/React 代码直接放在 resources/js/ 下,由 Laravel 的 Vite 构建流程统一编译。优点是部署简单(一个 Nginx 配置即可),缺点是前端生态受限、调试不便。

  • 安装:composer require laravel/ui,然后运行 php artisan ui vue --inertia(推荐 Inertia 版本)或 php artisan ui react
  • 运行 npm install && npm run dev,前端资源会输出到 public/build/
  • 关键点:Inertia 模式下,页面跳转不刷新,由 Laravel 返回 JSON 数据,Vue/React 组件接收并渲染——它模糊了前后端边界,但牺牲了前端框架原生能力(如 SEO、PWA)

跨域与生产部署关键项

无论哪种集成方式,以下配置必须检查:

  • 后端 CORS:安装 fruitcake/laravel-cors,在 app/Http/Kernel.php 的 api 中间件组中启用 HandleCors::class
  • 环境变量:前端通过 VITE_API_BASE_URL 读取 API 地址,避免硬编码;Laravel .env 中设 SESSION_DOMAIN=localhost(本地开发)或对应域名(生产)
  • 生产构建:Vue3/React 运行 npm run build,输出静态文件;Nginx 需同时配置 Laravel 后端(/api/* 转发)和前端静态资源(root /path/to/frontend/dist)

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2923

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

6383

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

7270

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

7118

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

1023

5

C语言变量命名
C语言变量命名

c语言变量名规则是:1、变量名以英文字母开头;2、变量名中的字母是区分大小写的;3、变量名不能是关键字;4、变量名中不能包含空格、标点符号和类型说明符。php中文网还提供c语言变量的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

3769

3

c语言入门自学零基础
c语言入门自学零基础

C语言是当代人学习及生活中的必备基础知识,应用十分广泛,本专题为大家c语言入门自学零基础的相关文章,以及相关课程,感兴趣的朋友千万不要错过了。

2023.07.25

2488

9

c语言运算符的优先级顺序
c语言运算符的优先级顺序

c语言运算符的优先级顺序是括号运算符 > 一元运算符 > 算术运算符 > 移位运算符 > 关系运算符 > 位运算符 > 逻辑运算符 > 赋值运算符 > 逗号运算符。本专题为大家提供c语言运算符相关的各种文章、以及下载和课程。

2023.08.02

1420

5

c语言数据结构
c语言数据结构

数据结构是指将数据按照一定的方式组织和存储的方法。它是计算机科学中的重要概念,用来描述和解决实际问题中的数据组织和处理问题。数据结构可以分为线性结构和非线性结构。线性结构包括数组、链表、堆栈和队列等,而非线性结构包括树和图等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.09

1358

4

热门下载

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

精品课程

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

共1课时 | 225人学习

Composer手册
Composer手册

共0课时 | 0人学习