Laravel如何集成Inertia.js与Vue/React？（安装配置）_网络技术

Laravel 集成 Inertia.js 的核心是服务端用 Inertia::render() 返回组件，前端用 @inertiajs/vue3 或 @inertiajs/react 接管导航；需安装适配器、配置 HandleInertiaRequests 中间件、创建 app.blade.php 根模板，并在控制器中返回 Inertia 响应。

在 Laravel 中集成 Inertia.js，核心是让服务端能响应 Inertia 请求并返回页面组件，同时前端通过 Inertia 的客户端接管常规跳转和表单提交。它不替换 Laravel 的路由和控制器逻辑，而是“包裹”原有流程——后端仍用 Blade 渲染逻辑（但实际不返回 HTML），前端用 Vue 或 React 渲染页面。

1. 安装 Inertia 服务端支持（Laravel）

使用 Composer 安装官方适配器：

Vue 项目：运行 composer require inertiajs/inertia-laravel
React 项目：同样安装该包（服务端适配器通用，与前端框架无关）

发布配置文件（可选但推荐）：php artisan vendor:publish --provider="Inertia\\ServiceProvider"，会生成 config/inertia.php，可自定义页面组件根路径、SSR 配置等。

2. 配置中间件与根布局

Inertia 要求所有 Inertia 请求都经过 Inertia\Inertia 中间件处理。Laravel 10+ 默认已注册 HandleInertiaRequests 中间件（位于 app/Http/Middleware/HandleInertiaRequests.php），确保它被应用到 web 路由组：

检查 app/Providers/RouteServiceProvider.php 中是否在 withMiddleware 方法里调用了 $middleware->group('web', ...)
确认 app/Http/Kernel.php 的 $middlewareGroups['web'] 包含 App\Http\Middleware\HandleInertiaRequests::class

该中间件负责注入共享数据（如认证用户）、设置页面标题、处理 SSR 等。默认根模板是 resources/views/app.blade.php，需手动创建，内容只需一个空的和加载前端资源的 script 标签（后续由 Vite/Webpack 注入）。

3. 前端初始化（Vue 或 React）

以 Vue 为例（使用 Vite）：

安装依赖：npm install @inertiajs/vue3 vue@^3.4.0
在 resources/js/app.js 中初始化：

（示例代码，非可执行）

import { createApp, h } from 'vue'
import { createInertiaApp } from '@inertiajs/vue3'
import { resolvePageComponent } from 'laravel-vite-plugin/inertia-helpers'
createInertiaApp({
title: (title) => ${title} - MyApp,
resolve: (name) => resolvePageComponent(./Pages/${name}.vue, import.meta.glob('./Pages/*/.vue')),
setup({ el, App, props, plugin }) {
const app = createApp({ render: () => h(App, props) })
app.use(plugin)
app.mount(el)
},
})

React 类似，安装 @inertiajs/react，用 createInertiaApp + React.createElement 初始化，页面组件放在 Pages/ 目录下，扩展名用 .jsx 或 .tsx。

4. 控制器中返回 Inertia 响应

不再返回 view()，改用 Inertia::render()：

return Inertia::render('Dashboard') → 对应 resources/js/Pages/Dashboard.vue
传参用第二个参数：Inertia::render('User/Edit', ['user' => $user])，这些数据会作为 props 传给前端组件
支持重定向：return redirect()->route('users.index')->with('success', 'Updated!')，Inertia 自动处理 XHR 重定向并保留 flash 消息

注意：所有 Inertia 页面必须通过控制器返回，不能直接访问 /dashboard 的 URL（除非服务端有对应路由和控制器方法）。

基本上就这些。关键点是服务端走 Inertia 响应流，前端用 Inertia 客户端接管导航，两者通过 JSON 通信。不复杂但容易忽略中间件或根模板配置。

# php # vue # react # laravel # html # js # 前端 # json # composer # vue3 # vite # npm # 中间件 # webpack # 前端框架 # require # class

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】