Увійти Реєстрація
Вакансії
Вакансії Laravel Компанії Статистика
Підготовка
Як підготуватися Співбесіди Тестування Документація
Блог
Всі статті Серії
Екосистема
Пакети Ресурси Проєкти Інструменти Події Відео
Інше
Про нас Реклама
Новини 05 серпня 2026

Laravel Head: новий офіційний пакет для керування мета-тегами, Open Graph та JSON-LD

Laravel Head - це новий офіційний пакет від команди розробників Laravel з відкритим кодом, продемонстрований на сцені під час основної доповіді Тейлора Отвелла на Laracon US 2026. Пакет надає зручний fluent API для всього, що потрапляє в елемент <head> вашого документа: заголовки, мета-описи, канонічні URL, теги Open Graph, директиви для роботів, структуровані дані JSON-LD та підказки щодо ресурсів. Метадані розв'язуються для кожного запиту окремо і працюють з Blade, Livewire та Inertia додатками.

Основні можливості пакету

Пакет охоплює широкий спектр функціональності:

  • П'ятирівнева пріоритетність - дефолтні налаштування сторінки, метадані групи маршрутів, метадані маршруту, runtime метадані та метадані помилок об'єднуються поле за полем
  • Метадані на рівні маршрутів - метод withHead() для маршрутів, груп, ресурсів та singleton'ів, який зберігає прості масиви і залишається сумісним з кешованими маршрутами
  • Open Graph та картки X - методи og(), ogImage(), ogVideo() та ogAudio(), з Twitter-тегами, що автоматично генеруються з тих самих заголовків, описів та зображень
  • JSON-LD схеми - білдери для article, blogPosting, product, offer, brand, breadcrumbs, faq, organization, person, webPage та webSite, плюс можливість реєстрації власних типів
  • Продуктивність та виявлення - preload(), prefetch(), preconnect(), dnsPrefetch(), paginate(), alternates() та feed()
  • Метадані браузера та додатків - кольори теми з медіа-запитами, favicon'и, іконки Apple touch та метод pwa() для встановлюваних веб-додатків
  • Метадані сторінок помилок - заголовок, опис та значення robots для кожного статусу, які реєструються один раз у service provider

П'ятирівнева система розв'язання метаданих

Метадані сторінки формуються з п'яти рівнів, упорядкованих від найнижчого до найвищого пріоритету: дефолтні налаштування сторінки, метадані групи маршрутів, метадані маршруту, runtime метадані та метадані помилок. Вищі рівні замінюють нижчі поле за полем, тому runtime заголовок замінює заголовок маршруту, не торкаючись опису маршруту.

Дефолтні налаштування для всього сайту реєструються в service provider:

use Laravel\Head\Enums\OgType;
use Laravel\Head\Facades\Head;
use Laravel\Head\HeadBuilder;

Head::defaults(function (HeadBuilder $head) {
    $head
        ->title('Laravel', suffix: ' - Laravel')
        ->description('Build something great.')
        ->canonical()
        ->og(siteName: 'Laravel', type: OgType::Website)
        ->searchableByRobots()
        ->preconnect('https://fonts.example.com');
});

Суфікс, зареєстрований у defaults, переноситься на вищі рівні, тому Head::title('About') відрендериться як About - Laravel. Передайте exact: true, коли заголовок повинен ігнорувати успадкований префікс або суфікс. Виклик canonical() без аргументів використовує URL поточного запиту і нормалізує його до https, що можна вимкнути через forceHttps: false.

Директиви robots приймають сирий рядок, випадки enum RobotsRule або список, що змішує обидва варіанти. Скорочення searchableByRobots() та hiddenFromRobots() рендерять all та none відповідно.

Метадані безпосередньо на маршрутах

Для сторінок, метадані яких відомі заздалегідь, withHead() прикріплює їх безпосередньо до визначення маршруту:

Route::view('/contact', 'contact')
    ->name('contact')
    ->withHead(
        title: 'Contact Us',
        description: 'Get in touch.',
    );

Метод працює на групах у будь-якій позиції в ланцюжку, а також на resource та singleton маршрутах:

Route::withHead(robots: 'noindex, nofollow')
    ->prefix('admin')
    ->name('admin.')
    ->group(function () {
        Route::get('/dashboard', DashboardController::class)
            ->name('dashboard')
            ->withHead(title: 'Dashboard');
    });

Під капотом withHead() записує прості масиви через нативний API метаданих маршрутів Laravel - еквівалент виклику metadata() з атрибутами, вкладеними під ключем head - тому кешування маршрутів як і раніше працює. Іменовані аргументи навмисно обмежені вбудованими властивостями пакету, щоб статичний аналіз виявляв друкарські помилки; все, що реєструється власним білдером тегів, передається через масив extensions.

Runtime метадані

Все, що невідомо до моменту надходження запиту, встановлюється під час виконання через фасад:

public function show(Post $post)
{
    Head::title($post->title)
        ->description($post->description)
        ->when($post->isDraft(), fn ($head) => $head->hiddenFromRobots());
    
    return view('posts.show', ['post' => $post]);
}

Поля з одним значенням приймають останній виклик. Поля, що повторюються, зберігають кілька записів, але повторне використання того самого ключа оновлює попередній - для ogImage() URL є ключем, тому виклик двічі з однаковим URL об'єднує атрибути замість створення двох тегів.

Open Graph, картки X та схеми

title та description документа автоматично заповнюють відсутні og:title та og:description. Зареєструйте тип картки Twitter у ваших defaults, і теги картки будуть отримані з тих самих значень:

use Laravel\Head\Enums\TwitterCard;

Head::defaults(fn (HeadBuilder $head) => $head->twitter(
    card: TwitterCard::SummaryWithLargeImage,
));

Встановлення заголовка, опису та ogImage() на сторінці створює обидва набори тегів, з twitter() та twitterImage() доступними, коли сторінці потрібен інший соціальний контент.

Структуровані дані використовують окремий фасад Schema з білдерами, що вкладаються:

use Laravel\Head\Enums\OfferAvailability;
use Laravel\Head\Facades\Schema;

Head::schema(
    Schema::product()
        ->name($product->name)
        ->offers(
            Schema::offer()
                ->price($product->price)
                ->currency('USD')
                ->availability(OfferAvailability::InStock)
        )
);

Хлібні крихти та FAQ приймають масиви оптом - Schema::breadcrumbs()->items([...]) призначає позиції в заданому порядку. Невідомі фабричні методи створюють загальний об'єкт схеми, і ви можете зареєструвати типізований клас з атрибутом #[SchemaType] для будь-чого, для чого потрібні першокласні методи. Недійсний JSON-LD викидає виняток поза production і логує попередження в production.

Рендеринг у Blade, Livewire та Inertia

Blade та Livewire обидва рендерять розв'язані теги за допомогою директиви @head у макеті:

<head>
    <meta charset="utf-8">
    @head
</head>

Директива рендериться синхронно, тому метадані повинні бути визначені до рендерингу макета. Livewire не потребує додаткової конфігурації - резолвер має область запиту, тому кожне відвідування wire:navigate отримує документ, чий head відображає маршрут призначення.

Inertia отримує найбільше функціональності. Коли Inertia встановлено, пакет ділиться розв'язаним head як масивом відрендерених рядків елементів під пропсом head на кожному об'єкті сторінки:

{
  "props": {
    "head": [
      "<title data-inertia=\"title\">Dashboard - Laravel</title>",
      "<meta data-inertia=\"description\" name=\"description\" content=\"Your application overview.\">"
    ]
  }
}

Ви вмикаєте опцію serverHead Inertia - доступну в Inertia 3.5 і пізніше - всюди, де ви викликаєте createInertiaApp(), включаючи вашу точку входу SSR, якщо вона у вас є. Кожен елемент несе стабільний ключ data-inertia, який Inertia приймає і підтримує синхронізованим між відвідуваннями, миттєвими відвідуваннями та навігацією вперед/назад. Оскільки @head поміщає теги у початкову HTML-відповідь, краулери та боти попереднього перегляду посилань читають їх без запуску JavaScript, і клієнтський компонент <Head> не потрібен.

Теги, які ніколи не змінюються протягом сесії - viewport, колірна схема, favicon'и, маніфест - можна зареєструвати окремо за допомогою Head::inertiaGlobals(). Вони виключаються з пропса head, рендеряться без атрибутів володіння і ніколи не оновлюються після першої відповіді.

Якщо ви додаєте це до існуючого додатка Inertia, видаліть колбеки заголовків з app.tsx та ssr.tsx і перенесіть все, що зараз знаходиться в компоненті <Head> Inertia, щоб вони ніколи не керували одним і тим самим елементом.

Встановлення та використання

Laravel Head вимагає PHP 8.3 та Laravel 13.17 або новіше, і встановлюється через Composer:

composer require laravel/head

Далі зареєструйте defaults у service provider і додайте @head до вашого макета. Додатки, які хочуть отримати розв'язані метадані як дані, а не розмітку, можуть викликати Head::toArray(), який повертає заголовки, значення Open Graph, схеми JSON-LD та решту як структурований масив.

Повна документація доступна в офіційних документах Laravel, а вихідний код знаходиться в репозиторії laravel/head на GitHub.

6

Читати в документації

Коментарі

Увійдіть, щоб залишити коментар

Будьте першим, хто залишить коментар!

Читайте також

Commit ID для реплік
Новини 17 листопада 2026

Commit ID у Laravel 13.40: як дізнатися, що репліка вже наздогнала primary

Laravel 13.40 додав DB::getLastCommitId(), DB::hasCommitId() і DB::mergeCommitIds(): тепер можна не вгадувати затримку реплікації, а спитати репліку, чи має вона потрібний запис. Розбираємо, що повертають MySQL, MariaDB і PostgreSQL, як побудувати на цьому middleware для сесії та завдання черги і що треба ввімкнути на сервері.

9
Laravel Reverb
Новини 17 листопада 2026

Laravel Reverb: вразливість із повтором підписаних запитів і виправлення для кількох застосунків

2 листопада Laravel опублікувала advisory GHSA-j4w9-pvrg-rwjp: Reverb до 1.12.0 не перевіряв auth_timestamp, тож перехоплений підписаний запит до HTTP API лишався дійсним назавжди. Серйозність низька, а оновлення до 1.13.0 заодно виправляє whisper-и на серверах із кількома застосунками.

Вакансії за темою

Optimizee Group
67 днів тому

Product Lead (Strategy + Full Stack)

Product Lead з відповідальністю за розробку та лідерство. Гібридна роль: 60% управління продуктом (дорожна карта, пріоритизація, аналітика) та 40% full stack розробки на PHP Laravel. Потрібен досвід розробника (5+ років), знання бекенду, баз даних, здатність приймати продуктові рішення та керувати командою. Основний стек: PHP 8.2+, Laravel 12, MySQL, Redis, Alpine.js, Livewire.

Full stack developer (e-commerce)

Laravel Київ Офіс B2B Middle ₴100 000-140 000

Full Stack розробник для постійної in-house роботи над розвитком e-commerce продукту: адаптивні веб-інтерфейси (desktop, tablet, mobile), backend, інтеграції з зовнішніми системами через REST API, оптимізація БД, пошуку та фільтрації. Стек: PHP, Laravel, JavaScript, HTML, CSS, Blade, Tailwind CSS, MySQL. Вимоги: комерційний досвід PHP/Laravel від 3 років, впевнене володіння JavaScript, HTML, CSS, знання Git, Composer, Linux, принципів ООП та SOLID.

Starlight Media
5 днів тому

Senior Full-Stack Developer (PHP / Go / Vue.js)

Senior Full-Stack розробник матиме розвивати й підтримувати існуючі веб-платформи, писати модулі, сервіси та API, а також розробляти клієнтську частину на Vue.js і Vanilla JS. Основний стек: PHP 8.x з Yii2 та/або Laravel, Go для сервісів, MySQL/MariaDB, REST API і Webhooks. Вимоги: досвід від 3 років, знання ООП і шаблонів проєктування, ES6+, Vue.js, SPA, Git, Docker і Composer; англійська B1-B2.

Пакети за темою

Seotools

artesaos/seotools

Інструменти оптимізації для пошукових систем (SEO) для Laravel та Lumen, що допомагають генерувати метатеги, карти сайту та інші елементи для поліпшення видимості сайту в пошукових системах.

3,366 v1.4.1 13 11

Wireui

wireui/wireui

Набір компонентів для TALL стека, що забезпечує готові до використання UI-елементи для швидкого розроблення веб-додатків.

1,790 v2.6.0 13 11