Laravel 中文文档

主题

前端 ​

简介 ​

Laravel 是一个后端框架，提供了构建现代 Web 应用所需的所有功能，如路由、验证、缓存、队列、文件存储等。然而，我们认为为开发者提供美观的全栈体验非常重要，包括构建应用前端的强大方法。

使用 Laravel 构建应用时，前端开发有两种主要方式，选择哪种方式取决于你希望通过 PHP 还是使用 React、Svelte 和 Vue 等 JavaScript 框架来构建前端。我们将在下面讨论这两种选项，以便你能就应用的前端开发最佳方式做出明智的决定。

使用 PHP ​

PHP 和 Blade ​

过去，大多数 PHP 应用使用简单的 HTML 模板（其中穿插 PHP echo 语句来渲染请求期间从数据库检索的数据）向浏览器渲染 HTML：

blade
<div>
    <?php foreach ($users as $user): ?>
        Hello, <?php echo $user->name; ?> <br />
    <?php endforeach; ?>
</div>

在 Laravel 中，这种渲染 HTML 的方式仍然可以使用视图和 Blade 来实现。Blade 是一种极其轻量的模板语言，提供了方便、简短的语法来显示数据、遍历数据等：

blade
<div>
    @foreach ($users as $user)
        Hello, {{ $user->name }} <br />
    @endforeach
</div>

以这种方式构建应用时，表单提交和其他页面交互通常会从服务器接收全新的 HTML 文档，整个页面由浏览器重新渲染。即使在今天，许多应用仍然非常适合使用简单的 Blade 模板来构建前端。

不断增长的期望 ​

然而，随着用户对 Web 应用的期望日益成熟，许多开发者发现需要构建更具动态性、交互更加精致的前端。鉴于此，一些开发者选择使用 React、Svelte 和 Vue 等 JavaScript 框架来构建应用的前端。

另一些开发者更愿意坚持使用他们熟悉的后端语言，他们开发了允许在主要使用后端语言的同时构建现代 Web 应用 UI 的解决方案。例如，在 Rails 生态系统中，这催生了 Turbo、Hotwire 和 Stimulus 等库的创建。

在 Laravel 生态系统中，主要使用 PHP 创建现代动态前端的需求促成了 Laravel Livewire 和 Alpine.js 的诞生。

Livewire ​

Laravel Livewire 是一个用于构建 Laravel 驱动的前端框架，它让前端感觉动态、现代且充满活力，就像使用 React、Svelte 和 Vue 等现代 JavaScript 框架构建的前端一样。

使用 Livewire 时，你将创建 Livewire "组件"，它们渲染 UI 的一个独立部分，并公开可以从应用前端调用和交互的方法和数据。例如，一个简单的"计数器"组件可能如下所示：

php
<?php

use Livewire\Component;

new class extends Component
{
    public $count = 0;

    public function increment()
    {
        $this->count++;
    }
};
?>

<div>
    <button wire:click="increment">+</button>
    <h1>{{ $count }}</h1>
</div>

如你所见，Livewire 使你能够编写新的 HTML 属性（如 wire:click）来连接 Laravel 应用的前端和后端。此外，你可以使用简单的 Blade 表达式渲染组件的当前状态。

对于许多人来说，Livewire 彻底改变了使用 Laravel 进行前端开发的方式，让他们能够在 Laravel 的舒适环境中构建现代、动态的 Web 应用。通常，使用 Livewire 的开发者还会使用 Alpine.js 仅在需要的地方"点缀"JavaScript，例如渲染对话框窗口。

如果你是 Laravel 新手，我们建议先熟悉视图和 Blade 的基本用法。然后，查阅官方的 Laravel Livewire 文档，了解如何使用交互式 Livewire 组件将你的应用提升到新的水平。

入门套件 ​

如果你想使用 PHP 和 Livewire 构建前端，可以利用我们的 Livewire 入门套件来快速启动应用的开发。

使用 React、Svelte 或 Vue ​

虽然可以使用 Laravel 和 Livewire 构建现代前端，但许多开发者仍然更喜欢利用 React、Svelte 或 Vue 等 JavaScript 框架的强大功能。这使开发者能够利用通过 NPM 提供的丰富的 JavaScript 包和工具生态系统。

然而，如果没有额外的工具，将 Laravel 与 React、Svelte 或 Vue 配对使用将需要解决各种复杂问题，如客户端路由、数据 hydration 和认证。客户端路由通常可以通过使用 Next 和 Nuxt 等约定式的 React / Svelte / Vue 框架来简化；然而，当将 Laravel 等后端框架与这些前端框架配对时，数据 hydration 和认证仍然是复杂且繁琐的问题。

此外，开发者需要维护两个独立的代码仓库，通常需要在两个仓库之间协调维护、发布和部署。虽然这些问题并非不可克服，但我们不认为这是一种高效或愉快的应用程序开发方式。

Inertia ​

幸运的是，Laravel 提供了两全其美的方案。Inertia 弥合了 Laravel 应用程序与现代 React、Svelte 或 Vue 前端之间的差距，允许你使用 React、Svelte 或 Vue 构建完整的现代前端，同时利用 Laravel 路由和 controller 进行路由、数据 hydration 和认证——所有这些都在一个代码仓库中。通过这种方式，你可以享受 Laravel 和 React / Svelte / Vue 的全部功能，而不会削弱任何一个工具的能力。

在 Laravel 应用程序中安装 Inertia 后，你将像平常一样编写路由和 controller。但是，你将从 controller 返回 Inertia 页面，而不是 Blade 模板：

php
<?php

namespace App\Http\Controllers;

use App\Models\User;
use Inertia\Inertia;
use Inertia\Response;

class UserController extends Controller
{
    /**
     * 显示给定用户的个人资料。
     */
    public function show(string $id): Response
    {
        return Inertia::render('users/show', [
            'user' => User::findOrFail($id)
        ]);
    }
}

Inertia 页面对应一个 React、Svelte 或 Vue 组件，通常存储在应用程序的 resources/js/pages 目录中。通过 Inertia::render 方法传递给页面的数据将用于 hydrate 页面组件的"props"：

jsx
import Layout from '@/layouts/authenticated';
import { Head } from '@inertiajs/react';

export default function Show({ user }) {
    return (
        <Layout>
            <Head title="Welcome" />
            <h1>Welcome</h1>
            <p>Hello {user.name}, welcome to Inertia.</p>
        </Layout>
    )
}

如你所见，Inertia 允许你在构建前端时充分利用 React、Svelte 或 Vue 的全部功能，同时在 Laravel 驱动的后端和 JavaScript 驱动的前端之间提供轻量级的桥梁。

服务端渲染 ​

如果你因为应用程序需要服务端渲染而对使用 Inertia 感到犹豫，不用担心。Inertia 提供了服务端渲染支持。而且，当通过 Laravel Cloud 或 Laravel Forge 部署应用程序时，确保 Inertia 的服务端渲染进程始终运行是非常轻松的。

入门套件 ​

如果你想使用 Inertia 和 React / Svelte / Vue 构建前端，可以利用我们的 React、Svelte 或 Vue 应用入门套件来快速启动应用的开发。这些入门套件使用 Inertia、React / Svelte / Vue、Tailwind 和 Vite 搭建应用的后端和前端认证流程，让你可以开始构建下一个伟大的创意。

资源打包 ​

无论你选择使用 Blade 和 Livewire 还是 React / Svelte / Vue 和 Inertia 来开发前端，你都可能需要将应用的 CSS 打包为生产就绪的资源。当然，如果你选择使用 React、Svelte 或 Vue 构建应用前端，还需要将组件打包为浏览器可用的 JavaScript 资源。

默认情况下，Laravel 使用 Vite 来打包你的资源。Vite 提供了闪电般的构建速度和本地开发期间近乎即时的热模块替换（HMR）。在所有新的 Laravel 应用中（包括使用我们入门套件的应用），你会找到一个 vite.config.js 文件，它加载了我们轻量级的 Laravel Vite 插件，使 Vite 与 Laravel 应用配合使用变得非常愉快。

使用 Laravel 和 Vite 入门的最快方式是使用我们的应用入门套件开始应用开发，它通过提供前端和后端认证脚手架来快速启动你的应用。

NOTE

有关在 Laravel 中使用 Vite 的更详细文档，请参阅我们关于打包和编译资源的专用文档。