Skip to content

前端

介绍

Laravel 是一个后端框架,可提供构建现代 Web 应用程序所需的所有功能,例如路由验证缓存队列文件存储等。但是,我们认为为开发人员提供精美的全栈体验非常重要,包括构建应用程序前端的强大方法。

使用 Laravel 构建应用程序时,有两种主要方法可以解决前端开发问题,您选择哪种方法取决于您是想利用 PHP 还是使用 JavaScript 框架(如 Vue 和 React)来构建前端。我们将在下面讨论这两个选项,以便您可以就应用程序前端开发的最佳方法做出明智的决定。

使用 PHP

PHP 和 Blade

过去,大多数 PHP 应用程序使用简单的 HTML 模板向浏览器呈现 HTML,其中穿插着 PHP echo 语句,这些语句呈现在请求期间从数据库中检索的数据

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 应用程序的期望越来越成熟,许多开发人员发现需要构建更动态的前端,其交互感觉更精致。有鉴于此,一些开发人员选择开始使用 JavaScript 框架(如 Vue 和 React)构建其应用程序的前端。

其他一些公司则更愿意坚持使用他们熟悉的后端语言,他们已经开发了允许构建现代 Web 应用程序 UI 的解决方案,同时仍然主要使用他们选择的后端语言。例如,在 Rails 生态系统中,这刺激了 TurboHotwireStimulus 等库的创建。

在 Laravel 生态系统中,主要使用 PHP 创建现代、动态前端的需求导致了 Laravel LivewireAlpine.js 的创建。

Livewire

Laravel Livewire 是一个框架,用于构建由 Laravel 提供支持的前端,这些前端感觉充满活力、现代感和生动性,就像使用 Vue 和 React 等现代 JavaScript 框架构建的前端一样。

使用 Livewire 时,您将创建 Livewire“组件”,这些组件呈现 UI 的离散部分,并公开可从应用程序前端调用和交互的方法和数据。例如,一个简单的 “Counter” 组件可能如下所示:

php
<?php

namespace App\Http\Livewire;

use Livewire\Component;

class Counter extends Component
{
    public $count = 0;

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

    public function render()
    {
        return view('livewire.counter');
    }
}

并且,计数器的相应模板将编写如下:

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

如您所见,Livewire 使您能够编写新的 HTML 属性,例如 wire:click,用于连接 Laravel 应用程序的前端和后端。此外,您可以使用简单的 Blade 表达式呈现组件的当前状态。

对于许多人来说,Livewire 通过 Laravel 彻底改变了前端开发,使他们能够在构建现代、动态的 Web 应用程序的同时,保持 Laravel 的舒适状态。通常,使用 Livewire 的开发人员也会利用 Alpine.js 将 JavaScript “撒”到他们的前端,只在需要的地方,例如为了渲染对话框窗口。

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

入门套件

如果您想使用 PHP 和 Livewire 构建前端,您可以利用我们的 Breeze 或 Jetstream 初学者工具包来快速启动您的应用程序开发。这两个初学者工具包都使用 BladeTailwind 构建应用程序的后端和前端身份验证流程,以便您可以简单地开始构建您的下一个伟大创意。

使用 Vue / React

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

然而,如果没有额外的工具,将 Laravel 与 Vue 或 React 配对将使我们需要解决各种复杂的问题,例如客户端路由、数据激活和身份验证。客户端路由通常通过使用固执己见的 Vue / React 框架(如 NuxtNext)来简化;然而,当将 Laravel 这样的后端框架与这些前端框架配对时,数据激活和身份验证仍然是一个复杂且繁琐的问题。

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

Inertia

值得庆幸的是,Laravel 提供了两全其美的服务。Inertia 弥合了 Laravel 应用程序和现代 Vue 或 React 前端之间的差距,允许您使用 Vue 或 React 构建成熟的现代前端,同时利用 Laravel 路由和控制器进行路由、数据激活和身份验证——所有这些都在单个代码存储库中。通过这种方法,您可以享受 Laravel 和 Vue / React 的全部功能,而不会削弱任何一种工具的功能。

将 Inertia 安装到 Laravel 应用程序中后,您将像往常一样编写路由和控制器。但是,您将返回一个 Inertia 页面,而不是从控制器返回 Blade 模板:

php
<?php

namespace App\Http\Controllers;

use App\Http\Controllers\Controller;
use App\Models\User;
use Inertia\Inertia;
use Inertia\Response;

class UserController extends Controller
{
    /**
     * 显示给定用户的配置文件
     */
    public function show(string $id): Response
    {
        return Inertia::render('Users/Profile', [
            'user' => User::findOrFail($id)
        ]);
    }
}

Inertia 页面对应于 Vue 或 React 组件,通常存储在应用程序的 resources/js/Pages 目录中。通过 Inertia::render 方法提供给页面的数据将用于水合页面组件的 “props”:

vue
<script setup>
import Layout from '@/Layouts/Authenticated.vue';
import { Head } from '@inertiajs/vue3';

const props = defineProps(['user']);
</script>

<template>
    <Head title="User Profile" />

    <Layout>
        <template #header>
            <h2 class="font-semibold text-xl text-gray-800 leading-tight">
                Profile
            </h2>
        </template>

        <div class="py-12">
            Hello, {{ user.name }}
        </div>
    </Layout>
</template>

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

服务器端渲染

如果您因为应用程序需要服务器端渲染而担心深入研究 Inertia,请不要担心。Inertia 提供服务器端渲染支持。而且,通过 Laravel Forge 部署应用程序时,确保 Inertia 的服务器端渲染过程始终运行是一件轻而易举的事。

入门套件

如果您想使用 Inertia 和 Vue / React 构建前端,您可以利用我们的 Breeze 或 Jetstream 初学者工具包来快速启动您的应用程序开发。这两个初学者工具包都使用 Inertia、Vue / React、TailwindVite 构建应用程序的后端和前端身份验证流程,以便您可以开始构建下一个大创意。

打包资源

无论你是选择使用 Blade 和 Livewire 还是 Vue / React 和 Inertia 来开发前端,你都可能需要将应用程序的 CSS 捆绑到生产就绪的资产中。当然,如果你选择使用 Vue 或 React 构建应用程序的前端,你还需要将组件捆绑到浏览器就绪的 JavaScript 资产中。

默认情况下,Laravel 使用 Vite 来捆绑您的资源。Vite 在本地开发期间提供闪电般的构建时间和近乎即时的热模块替换 (HMR)。在所有新的 Laravel 应用程序中,包括那些使用我们的入门套件的应用程序,您都会找到一个 vite.config.js 文件,该文件加载了我们的轻量级 Laravel Vite 插件,使 Vite 与 Laravel 应用程序一起使用变得愉快。

开始使用 Laravel 和 Vite 的最快方法是使用 Laravel Breeze 开始您的应用程序开发,Laravel Breeze 是我们最简单的入门工具包,通过提供前端和后端身份验证脚手架来快速启动您的应用程序。

NOTE

有关将 Vite 与 Laravel 结合使用的更多详细文档,请参阅我们关于捆绑和编译资源的专用文档