Если видео недоступно для просмотра, попробуйте выключить блокировщик рекламы.

Каждая страница любого сайта, содержит свое собственное содержимое и общие части, такие как футер или боковое меню. Существует два подхода по работе с этими общими частями.

Включение

До эры фреймворков, фактически, был ровно один способ выделять общие части. Он сводился к созданию двух шаблонов: хедера (шапка сайта) и футера (подвал). Затем, эти шаблоны включались во всех остальных шаблонах, отвечающих за основную часть страницы. Выглядело это так:

<?= include('header.php'); ?>

<div id="page-content">
    <!-- Тут основная часть -->
</div>

<?= include('footer.php'); ?>

Такой подход все еще популярен в самописных решениях и в популярных CMS. Где-то в силу исторических причин, где-то потому, что его очень просто понять и начать использовать.

С другой стороны, у такого подхода слишком много недостатков, из-за которых фреймворки отказались от него:

  • Футер и Хедер хранят куски кода, которые сами по себе не являются правильным HTML. В хедере открывающие теги, в футере закрывающие. Из-за этого крайне легко ошибиться и потом долго искать незакрытый тег.
  • Страница разбитая на хедер и футер не дает увидеть всю картину целиком. Придется скакать туда сюда для понимания того, что из себя представляет страница.
  • Появляется очень много дублирования из-за постоянных вставок хедера и футера
  • Все сильно усложняется, если хедеры и футеры могут быть разными
  • Невозможно обработать ситуацию, когда страницы имеют более сложное разбиение и включение хедера и футера не поможет.

Макеты

Это совершенно другой подход при работе с шаблонами. Он строится не от шаблона конкретного обработчика (экшена), а от макета. Макет – это базовая структура страницы, в которую вставляются данные, сгенерированные конкретным обработчиком. Для работы макетов недостаточно стандартных PHP файлов с HTML разметкой. Разработчикам шаблонизаторов приходится придумывать специальные маркеры, которые указывают куда и какой блок можно поместить.

В Laravel используется шаблонизатор Blade. Фактически, Blade, это свой собственный язык, с помощью которого создаются шаблоны. Blade-специфичные команды в шаблонах начинаются со знака @ и называются директивами. Большинство директив похожи на вызов функций, в которые передаются аргументы.

<!-- Хранится в resources/views/layouts/app.blade.php -->
<html>
    <head>
        <title>Hexlet Blog - @yield('title')</title>
    </head>
    <body>
        <div class="container">
            @yield('content')
        </div>
    </body>
</html>

В макете выше, используется директива @yield. Она указывает на то, куда будет вставлен контент конкретного обработчика.

В шаблоне самого обработчика, используется директива @section, которая определяет блок контента. Каждый такой блок имеет собственное имя, что позволяет одновременно делать вставку сразу множества блоков. Это особенно удобно для сложных макетов, где кроме самого контента, есть и другие блоки, специфичные для конкретных страниц.

<!-- Хранится в resources/views/about.blade.php -->

@extends('layouts.app')

<!-- Секция, содержимое которой обычный текст. -->
@section('title', 'О блоге')

<!-- Секция, содержащая HTML блок. Имеет открывающую и закрывающую часть. -->
@section('content')
    <h1>О блоге</h1>
    <p>Эксперименты с Ларавелем на Хекслете</p>
@endsection

Директива @extends указывает на макет, внутрь которого должны попасть данные из текущего шаблона. В эту директиву передается путь относительно директории resources/views. Обратите внимание что вместо / используется точка.

Далее идут секции. У каждой секции есть имя, благодаря которому можно точечно управлять местом ее отображения. Выше создаются две секции content и title. Одна из них отображается в теге <title>, другая внутри <body> и является центральной контентной частью страницы.

Имена выбираются произвольно. Количество секций не ограничено. Количество макетов тоже.

Несмотря на наличие макетов, иногда бывает полезно иметь общий шаблон, который вставляется в конкретных местах. Blade позволяет создавать и включать такие шаблоны с помощью директивы @include:

<html>
    <head>
        <title>Hexlet Blog - @yield('title')</title>
        @include('shared.metatags')
    </head>
    <body>
        <div class="container">
            @yield('content')
        </div>
    </body>
</html>

Код подобный тому что выше, часто встречается в тех проектах где несколько макетов. Как правило, их общие части выносят в обшие шаблоны, которые затем включаются через @include. Хорошей практикой считается помещать общие шаблоны в директорию resources/views/shared. Так легче понять какие шаблоны можно переиспользовать.

Самостоятельная работа

  1. Создайте макет resources/views/layouts/app.blade.php со следующим содержимым:

    <!doctype html>
    <html lang="{{ str_replace('_', '-', app()->getLocale()) }}">
        <head>
            <meta charset="utf-8">
            <meta name="viewport" content="width=device-width, initial-scale=1">
            <title>Hexlet Blog - @yield('title')</title>
            <meta name="csrf-token" content="{{ csrf_token() }}">
            <meta name="csrf-param" content="_token" />
            <link href="{{ asset('css/app.css') }}" rel="stylesheet">
            <script src="{{ asset('js/app.js') }}"></script>
        </head>
        <body>
            <div class="container mt-4">
                <h1>@yield('header')</h1>
                <div>
                    @yield('content')
                </div>
            </div>
        </body>
    </html>
    
  2. Переделайте шаблон about.blade.php так как показано в уроке (возможно понадобится почистить кеши php artisan view:clear).

  3. Прочитайте про CSRF.

  4. Зафиксируйте изменения в git (Дальше этот пункт повторяться не будет. Не забывайте фиксировать любые изменения в git)


Дополнительные материалы

  1. Документация Blade
Мы учим программированию с нуля до стажировки и работы. Попробуйте наш бесплатный курс «Введение в программирование» или полные программы обучения по Node, PHP, Python и Java.

Хекслет

Подробнее о том, почему наше обучение работает →