К содержимому

Создание компонента Livewire в Laravel на Ubuntu 24.04

Компонент Livewire 4 создаётся командой php artisan make:livewire counter и по умолчанию получается однофайловым: класс и шаблон лежат в одном файле. На страницу его выводят тегом <livewire:counter />, а скрипты подключают директивой @livewireScripts. Проверка занимает минуту: откройте страницу и нажмите кнопку.

Руководство Laravel 2 мин чтения

01Проверьте, что Livewire установлен

Зайдите в каталог проекта и убедитесь, что пакет уже стоит. Команда composer show livewire/livewire печатает версию, для Livewire 4 в первой строке будет livewire/livewire 4.x. Если пакета нет, установите его одной командой composer require livewire/livewire.

bash
cd /var/www/example.com
composer show livewire/livewire

02Создайте компонент

Команда php artisan make:livewire counter создаёт однофайловый компонент: класс и шаблон в одном файле. Ключ --mfc создаёт компонент из нескольких файлов, с отдельным классом и отдельным blade-шаблоном. Для первого компонента оставьте поведение по умолчанию.

bash
php artisan make:livewire counter

03Откройте файл компонента

Команда печатает путь созданного файла, обычно это resources/views/livewire/counter.blade.php. В однофайловом компоненте сверху идёт PHP-класс, ниже шаблон Blade. Свойство $count хранит состояние, метод increment увеличивает его, а метод render() не нужен: шаблон встроен в тот же файл.

php
<?php

use Livewire\Component;

new class extends Component
{
    public int $count = 0;

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

<div>
    <p>Нажатий: {{ $count }}</p>
    <button wire:click="increment">Увеличить</button>
</div>

04Выведите компонент на странице

В шаблоне страницы, например resources/views/welcome.blade.php, поставьте тег <livewire:counter />. Тег выводит компонент, но скрипты Livewire подключает директива @livewireScripts в layout или в саму страницу. Без этой директивы кнопка не отправит запрос на сервер.

php
<!DOCTYPE html>
<html lang="ru">
<head>
    <meta charset="utf-8">
    <title>Счётчик</title>
    @livewireStyles
</head>
<body>
    <livewire:counter />
    @livewireScripts
</body>
</html>

05Проверьте работу в браузере

Откройте страницу по адресу сайта и нажмите кнопку «Увеличить». Число нажатий должно вырасти без перезагрузки страницы. Если кнопка не реагирует, откройте консоль браузера: 404 на livewire.min.js значит, что nginx перехватил адрес скрипта.

bash
curl -I http://example.com/

Частые ошибки

  • Компоненты Livewire не реагируют, в консоли браузера 404 на livewire.min.js.

    Скрипт по адресу /livewire-<хеш>/livewire.min.js перехватил location nginx для статических .js с try_files $uri =404;. В этом location отдайте запрос в index.php: try_files $uri /index.php?$query_string;, затем выполните sudo nginx -t и sudo systemctl reload nginx.

  • После make:livewire counter не находится app/Livewire/Counter.php и resources/views/livewire/counter.blade.php.

    В Livewire 4 по умолчанию создаётся однофайловый компонент, класс и шаблон лежат в одном файле. Отдельные файлы появляются только с ключом --mfc.

  • Кнопка в компоненте ничего не делает, в консоли браузера ошибка Livewire is not defined.

    В шаблоне страницы нет директивы @livewireScripts. Добавьте её перед закрывающим тегом </body> или в layout, который использует страница.

Deploykin

Как это делается в Deploykin

В Deploykin сайт на Laravel создаётся из панели: стек под приложение, key:generate и storage:link выполняются при создании, а доступы к базе сами попадают в .env. Деплой идёт без простоя, с миграциями и кэшами, а очереди держат демоны Horizon или Queue Worker.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Где лежит файл созданного компонента Livewire 4?

Команда php artisan make:livewire counter печатает путь, обычно это resources/views/livewire/counter.blade.php. В этом файле сверху PHP-класс, ниже шаблон Blade.

Чем отличается компонент с ключом --mfc?

Без ключа создаётся однофайловый компонент: класс и шаблон в одном файле. С ключом --mfc создаются отдельные файлы класса и шаблона.

Нужно ли писать метод render() в компоненте?

В однофайловом компоненте Livewire 4 метод render() не нужен, шаблон встроен в тот же файл. Метод с return view(...) пишут в компоненте из нескольких файлов.

Почему компонент выводится, но кнопка не работает?

Скорее всего, в шаблоне нет директивы @livewireScripts. Она подключает скрипты Livewire, без неё браузер не отправляет запросы компонента.

Ещё по теме

Laravel: руководство по установке и настройке: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.