Laravel Livewire: установка и первый компонент на Ubuntu 24.04
Livewire 4 ставится в существующий проект Laravel одной командой Composer, компонент создаётся через php artisan make:livewire. На Ubuntu 24.04 с nginx чаще всего ломается доставка скрипта /livewire-<хеш>/livewire.min.js: отдельный location для .js отдаёт 404, и компоненты на странице не реагируют.
01Проверьте окружение Laravel
Зайдите в каталог проекта и убедитесь, что Laravel отвечает и версия PHP подходит. Livewire 4 работает на Laravel 11 и новее, PHP 8.3 из Ubuntu 24.04 достаточно. Если проекта ещё нет, его создаёт composer create-project laravel/laravel example.com, но эта страница начинается с готового приложения.
cd /var/www/example.com
php artisan --version
php -v
02Установите Livewire
Пакет ставится через Composer без дополнительных флагов. После установки в composer.json появится livewire/livewire, а сервис-провайдер подключится автоматически. Отдельный php artisan livewire:install в Livewire 4 не нужен.
composer require livewire/livewire
03Создайте компонент
Команда php artisan make:livewire counter по умолчанию создаёт однофайловый компонент: класс и шаблон лежат в одном файле. Ключ --mfc создаёт компонент из нескольких файлов, с отдельным классом и Blade-шаблоном. Для первого опыта хватит однофайлового варианта.
php artisan make:livewire counter
04Выведите компонент на страницу
В шаблоне Blade компонент вставляют тегом <livewire:counter />. Скрипты Livewire подключаются директивой @livewireScripts в <head> или перед </body>. Без неё разметка отрисуется, но кнопки не будут отправлять запросы.
<!DOCTYPE html>
<html lang="ru">
<head>
<meta charset="utf-8">
<title>Счётчик</title>
@livewireStyles
</head>
<body>
<livewire:counter />
@livewireScripts
</body>
</html>
05Разрешите адрес livewire.min.js в nginx
Скрипт Livewire 4 отдаёт сам Laravel по адресу вида /livewire-<хеш>/livewire.min.js, хеш зависит от APP_KEY. Если в конфиге nginx есть отдельный location для .js с try_files $uri =404;, этот адрес получает 404. Такой location должен отдавать запрос в index.php, как и остальные динамические маршруты.
location ~ \.js$ {
try_files $uri /index.php?$query_string;
}
06Примените конфиг nginx
Проверьте синтаксис и перезагрузите nginx без остановки службы. Если nginx -t сообщает об ошибке, правьте файл до перезагрузки: иначе старый конфиг продолжит работать, а новый не применится.
sudo nginx -t
sudo systemctl reload nginx
07Проверьте работу компонента
Откройте страницу с компонентом в браузере и нажмите кнопку счётчика: число должно меняться без перезагрузки страницы. Во вкладке Network найдите запрос к /livewire-<хеш>/livewire.min.js и убедитесь, что он вернул 200, а не 404. Если скрипт не загрузился, компоненты останутся статичной разметкой.
Частые ошибки
-
Компоненты Livewire не реагируют на клики, в консоли браузера 404 на
livewire.min.js.Отдельный location nginx для
.jsперехватил адрес/livewire-<хеш>/livewire.min.js. Замените в нёмtry_files $uri =404;наtry_files $uri /index.php?$query_string;, затем выполнитеsudo nginx -tиsudo systemctl reload nginx. -
После
composer require livewire/livewireстраница падает с ошибкойNo application encryption key has been specified.В
.envпустойAPP_KEY. Выполнитеphp artisan key:generate, а если конфиг закэширован, затемphp artisan config:cache. -
Компонент выведен на страницу, но в HTML нет тега script, и Livewire не инициализируется.
В шаблоне пропущена директива
@livewireScripts. Добавьте её перед</body>, а@livewireStylesв<head>.
Deploykin
Как это делается в Deploykin
В Deploykin сайт на Laravel создаётся из панели: стек под приложение, key:generate и storage:link выполняются при создании, а доступы к базе сами попадают в .env. Деплой идёт без простоя, с миграциями и кэшами, а очереди держат демоны Horizon или Queue Worker.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Чем Livewire отличается от Vue в Laravel?
Livewire пишет логику компонента на PHP и не требует отдельной сборки JavaScript. Vue подключают через Inertia или как отдельный фронтенд, и логика живёт в JS-файлах.
Нужен ли Node.js для Livewire?
Нет. Livewire 4 отдаёт свой скрипт через Laravel, сборка фронтенда для него не нужна.
Почему после деплоя перестали работать компоненты Livewire?
Проверьте адрес /livewire-<хеш>/livewire.min.js в Network: после смены APP_KEY хеш меняется, а старый location nginx может отдавать 404. Также выполните php artisan optimize, чтобы обновить кэш представлений.
Как создать компонент из нескольких файлов?
Выполните php artisan make:livewire counter --mfc. Класс и отдельный Blade-шаблон появятся в проекте, и в render() нужно будет вернуть view('livewire.counter').
Ещё по теме
- Руководство · 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 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 Inertia Laravel: пошаговая настройка на Ubuntu 24.04 Подключите Inertia к Laravel на Ubuntu 24.04: установка пакетов, настройка Vite, создание страницы и проверка через curl и браузер.
Laravel: руководство по установке и настройке: все материалы темы