Laravel 11.x 中文文档

简体中文

English

简体中文

English

主题

视图 ​

介绍 ​

当然，从路由和控制器直接返回整个 HTML 文档字符串是不实际的。幸运的是，视图提供了一种方便的方法来将所有 HTML 放在单独的文件中。

视图将控制器/应用程序逻辑与表示逻辑分开，并存储在 resources/views 目录中。在使用 Laravel 时，视图模板通常使用 Blade 模板语言 编写。一个简单的视图可能如下所示：

blade
<!-- 视图存储在 resources/views/greeting.blade.php -->

<html>
    <body>
        <h1>Hello, {{ $name }}</h1>
    </body>
</html>

由于此视图存储在 resources/views/greeting.blade.php，我们可以使用全局 view 助手返回它，如下所示：

php
Route::get('/', function () {
    return view('greeting', ['name' => 'James']);
});
lightbulb

想了解更多关于如何编写 Blade 模板的信息？请查看完整的 Blade 文档 以开始。

在 React / Vue 中编写视图 ​

许多开发人员开始倾向于使用 React 或 Vue 编写他们的前端模板，而不是通过 Blade 在 PHP 中编写。Laravel 通过 Inertia 使这一过程变得简单，这个库使得将 React / Vue 前端与 Laravel 后端连接起来变得轻而易举，而无需构建 SPA 的典型复杂性。

我们的 Breeze 和 Jetstream 入门套件 为您提供了一个很好的起点，用于构建由 Inertia 驱动的 Laravel 应用程序。此外，Laravel Bootcamp 提供了一个完整的演示，展示了如何构建由 Inertia 驱动的 Laravel 应用程序，包括 Vue 和 React 的示例。

创建和渲染视图 ​

您可以通过在应用程序的 resources/views 目录中放置一个带有 .blade.php 扩展名的文件或使用 make:view Artisan 命令来创建视图：

shell
php artisan make:view greeting

.blade.php 扩展名通知框架该文件包含一个 Blade 模板。Blade 模板包含 HTML 以及 Blade 指令，允许您轻松地回显值、创建 "if" 语句、迭代数据等。

一旦创建了视图，您可以使用全局 view 助手从应用程序的路由或控制器返回它：

php
Route::get('/', function () {
    return view('greeting', ['name' => 'James']);
});

视图也可以使用 View facade 返回：

php
use Illuminate\Support\Facades\View;

return View::make('greeting', ['name' => 'James']);

如您所见，传递给 view 助手的第一个参数对应于 resources/views 目录中视图文件的名称。第二个参数是一个数据数组，该数据应在视图中可用。在这种情况下，我们传递了 name 变量，该变量使用 Blade 语法 在视图中显示。

嵌套视图目录 ​

视图也可以嵌套在 resources/views 目录的子目录中。"点" 符号可以用来引用嵌套视图。例如，如果您的视图存储在 resources/views/admin/profile.blade.php，您可以从应用程序的路由/控制器中返回它，如下所示：

php
return view('admin.profile', $data);
exclamation

视图目录名称不应包含 . 字符。

创建第一个可用视图 ​

使用 View facade 的 first 方法，您可以创建给定视图数组中第一个存在的视图。如果您的应用程序或包允许视图自定义或覆盖，这可能会很有用：

php
use Illuminate\Support\Facades\View;

return View::first(['custom.admin', 'admin'], $data);

确定视图是否存在 ​

如果您需要确定视图是否存在，可以使用 View facade。exists 方法将返回 true，如果视图存在：

php
use Illuminate\Support\Facades\View;

if (View::exists('admin.profile')) {
    // ...
}

向视图传递数据 ​

如您在前面的示例中所见，您可以将数据数组传递给视图，以便该数据在视图中可用：

php
return view('greetings', ['name' => 'Victoria']);

以这种方式传递信息时，数据应为键/值对的数组。在向视图提供数据后，您可以使用数据的键在视图中访问每个值，例如 <?php echo $name; ?>。

作为将完整数据数组传递给 view 助手函数的替代方法，您可以使用 with 方法将单个数据添加到视图中。with 方法返回视图对象的实例，以便您可以在返回视图之前继续链接方法：

php
return view('greeting')
            ->with('name', 'Victoria')
            ->with('occupation', 'Astronaut');

与所有视图共享数据 ​

有时，您可能需要与应用程序渲染的所有视图共享数据。您可以使用 View facade 的 share 方法来实现。通常，您应该在服务提供者的 boot 方法中放置对 share 方法的调用。您可以将它们添加到 App\Providers\AppServiceProvider 类中，或者生成一个单独的服务提供者来容纳它们：

php
<?php

namespace App\Providers;

use Illuminate\Support\Facades\View;

class AppServiceProvider extends ServiceProvider
{
    /**
     * 注册任何应用程序服务。
     */
    public function register(): void
    {
        // ...
    }

    /**
     * 启动任何应用程序服务。
     */
    public function boot(): void
    {
        View::share('key', 'value');
    }
}

视图作曲器 ​

视图作曲器是视图渲染时调用的回调或类方法。如果您希望在每次渲染视图时将数据绑定到视图，视图作曲器可以帮助您将逻辑组织到一个位置。如果同一个视图由应用程序中的多个路由或控制器返回，并且总是需要特定的数据，视图作曲器可能特别有用。

通常，视图作曲器将在应用程序的 服务提供者 中注册。在此示例中，我们假设 App\Providers\AppServiceProvider 将容纳此逻辑。

我们将使用 View facade 的 composer 方法注册视图作曲器。Laravel 不包含类视图作曲器的默认目录，因此您可以自由地组织它们。例如，您可以创建一个 app/View/Composers 目录来容纳应用程序的所有视图作曲器：

php
<?php

namespace App\Providers;

use App\View\Composers\ProfileComposer;
use Illuminate\Support\Facades;
use Illuminate\Support\ServiceProvider;
use Illuminate\View\View;

class AppServiceProvider extends ServiceProvider
{
    /**
     * 注册任何应用程序服务。
     */
    public function register(): void
    {
        // ...
    }

    /**
     * 启动任何应用程序服务。
     */
    public function boot(): void
    {
        // 使用基于类的作曲器...
        Facades\View::composer('profile', ProfileComposer::class);

        // 使用基于闭包的作曲器...
        Facades\View::composer('welcome', function (View $view) {
            // ...
        });

        Facades\View::composer('dashboard', function (View $view) {
            // ...
        });
    }
}

现在我们已经注册了作曲器，每次渲染 profile 视图时，App\View\Composers\ProfileComposer 类的 compose 方法将被执行。让我们看看作曲器类的示例：

php
<?php

namespace App\View\Composers;

use App\Repositories\UserRepository;
use Illuminate\View\View;

class ProfileComposer
{
    /**
     * 创建一个新的配置文件作曲器。
     */
    public function __construct(
        protected UserRepository $users,
    ) {}

    /**
     * 将数据绑定到视图。
     */
    public function compose(View $view): void
    {
        $view->with('count', $this->users->count());
    }
}

如您所见，所有视图作曲器都是通过 服务容器 解析的，因此您可以在作曲器的构造函数中类型提示任何所需的依赖项。

将作曲器附加到多个视图 ​

您可以通过将视图数组作为 composer 方法的第一个参数传递，将视图作曲器附加到多个视图：

php
use App\Views\Composers\MultiComposer;
use Illuminate\Support\Facades\View;

View::composer(
    ['profile', 'dashboard'],
    MultiComposer::class
);

composer 方法还接受 * 字符作为通配符，允许您将作曲器附加到所有视图：

php
use Illuminate\Support\Facades;
use Illuminate\View\View;

Facades\View::composer('*', function (View $view) {
    // ...
});

视图创建者 ​

视图 "创建者" 与视图作曲器非常相似；然而，它们在视图实例化后立即执行，而不是等到视图即将渲染时。要注册视图创建者，请使用 creator 方法：

php
use App\View\Creators\ProfileCreator;
use Illuminate\Support\Facades\View;

View::creator('profile', ProfileCreator::class);

优化视图 ​

默认情况下，Blade 模板视图是按需编译的。当执行渲染视图的请求时，Laravel 将确定视图的编译版本是否存在。如果文件存在，Laravel 将确定未编译视图是否比编译视图更早修改。如果编译视图不存在，或者未编译视图已被修改，Laravel 将重新编译视图。

在请求期间编译视图可能会对性能产生小的负面影响，因此 Laravel 提供了 view:cache Artisan 命令来预编译应用程序使用的所有视图。为了提高性能，您可能希望在部署过程中运行此命令：

shell
php artisan view:cache

您可以使用 view:clear 命令清除视图缓存：

shell
php artisan view:clear

版权所有 © 2024-2025 laravel.wiki