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

Laravel Livewire: установка и первый компонент на Ubuntu 24.04

Livewire 4 ставится в существующий проект Laravel одной командой Composer, компонент создаётся через php artisan make:livewire. На Ubuntu 24.04 с nginx чаще всего ломается доставка скрипта /livewire-<хеш>/livewire.min.js: отдельный location для .js отдаёт 404, и компоненты на странице не реагируют.

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

01Проверьте окружение Laravel

Зайдите в каталог проекта и убедитесь, что Laravel отвечает и версия PHP подходит. Livewire 4 работает на Laravel 11 и новее, PHP 8.3 из Ubuntu 24.04 достаточно. Если проекта ещё нет, его создаёт composer create-project laravel/laravel example.com, но эта страница начинается с готового приложения.

bash
cd /var/www/example.com
php artisan --version
php -v

02Установите Livewire

Пакет ставится через Composer без дополнительных флагов. После установки в composer.json появится livewire/livewire, а сервис-провайдер подключится автоматически. Отдельный php artisan livewire:install в Livewire 4 не нужен.

bash
composer require livewire/livewire

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

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

bash
php artisan make:livewire counter

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

В шаблоне Blade компонент вставляют тегом <livewire:counter />. Скрипты Livewire подключаются директивой @livewireScripts в <head> или перед </body>. Без неё разметка отрисуется, но кнопки не будут отправлять запросы.

text
<!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, как и остальные динамические маршруты.

nginx
location ~ \.js$ {
    try_files $uri /index.php?$query_string;
}

06Примените конфиг nginx

Проверьте синтаксис и перезагрузите nginx без остановки службы. Если nginx -t сообщает об ошибке, правьте файл до перезагрузки: иначе старый конфиг продолжит работать, а новый не применится.

bash
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: руководство по установке и настройке: все материалы темы

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