Создание компонента Livewire в Laravel на Ubuntu 24.04
Компонент Livewire 4 создаётся командой php artisan make:livewire counter и по умолчанию получается однофайловым: класс и шаблон лежат в одном файле. На страницу его выводят тегом <livewire:counter />, а скрипты подключают директивой @livewireScripts. Проверка занимает минуту: откройте страницу и нажмите кнопку.
01Проверьте, что Livewire установлен
Зайдите в каталог проекта и убедитесь, что пакет уже стоит. Команда composer show livewire/livewire печатает версию, для Livewire 4 в первой строке будет livewire/livewire 4.x. Если пакета нет, установите его одной командой composer require livewire/livewire.
cd /var/www/example.com
composer show livewire/livewire
02Создайте компонент
Команда php artisan make:livewire counter создаёт однофайловый компонент: класс и шаблон в одном файле. Ключ --mfc создаёт компонент из нескольких файлов, с отдельным классом и отдельным blade-шаблоном. Для первого компонента оставьте поведение по умолчанию.
php artisan make:livewire counter
03Откройте файл компонента
Команда печатает путь созданного файла, обычно это resources/views/livewire/counter.blade.php. В однофайловом компоненте сверху идёт PHP-класс, ниже шаблон Blade. Свойство $count хранит состояние, метод increment увеличивает его, а метод render() не нужен: шаблон встроен в тот же файл.
<?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 или в саму страницу. Без этой директивы кнопка не отправит запрос на сервер.
<!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 перехватил адрес скрипта.
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 PHP Laravel: пошаговая настройка проекта на Ubuntu 24.04 Создайте проект Laravel на PHP 8.3 в Ubuntu 24.04: Composer,.env, MySQL, миграции, nginx, кэш и проверка запуска. Команды и типичные ошибки.
- Руководство · Laravel Filament в Laravel: установка и настройка панели Установка Filament 5 в Laravel на Ubuntu 24.04: панель /admin, пользователь, ресурс Customer, доступ на сервере и проверка входа без ошибки 403.
- Руководство · Laravel Laravel Livewire: установка и первый компонент на Ubuntu 24.04 Установка Livewire 4 в Laravel на Ubuntu 24.04: создание компонента, вывод на страницу, настройка nginx для livewire.min.js и проверка работы в браузере.
- Руководство · Laravel Laravel API: пошаговая настройка на Ubuntu 24.04 Как поднять API в Laravel на Ubuntu 24.04: установка Sanctum, маршруты в routes/api.php, проверка через curl, ответы 401 и 404, кэш и деплой.
- Руководство · Laravel Laravel Eloquent: настройка и проверка на Ubuntu 24.04 Пошаговая настройка Eloquent в Laravel на Ubuntu 24.04: подключение MySQL, миграции, модели, связи, проверка через tinker и маршрут.
- Руководство · Laravel Laravel install: установка фреймворка на Ubuntu 24.04 Пошаговая установка Laravel на Ubuntu 24.04: проверка PHP 8.3, composer create-project, ключ приложения,.env, миграции и запуск через php artisan serve.
Laravel: руководство по установке и настройке: все материалы темы