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

Laravel Breeze: пошаговая настройка на Ubuntu 24.04

Laravel Breeze это стартовый набор экранов аутентификации на Blade и Tailwind, который ставят в готовый проект Laravel. На этой странице вы создадите проект, поставите Breeze, настроите базу и проверите вход и регистрацию на сервере.

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

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

Зайдите на сервер под пользователем, который деплоит проект, и перейдите в каталог проекта. Команда php artisan --version покажет версию Laravel. Если проект ещё не создан, выполните composer create-project laravel/laravel example.com и перейдите в каталог example.com.

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

02Установите Laravel Breeze

Breeze ставят пакетом Composer, затем запускают установщик. Установщик спросит стек: выберите Blade, чтобы получить экраны на Blade и Tailwind. После установки Breeze создаёт маршруты аутентификации и шаблоны в resources/views.

bash
composer require laravel/breeze --dev
php artisan breeze:install

03Настройте базу данных

В свежем проекте Laravel по умолчанию DB_CONNECTION=sqlite. Для MySQL откройте .env и задайте подключение. Пароль берите из настроек MySQL на сервере.

ini
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_DATABASE=example
DB_USERNAME=example
DB_PASSWORD=secret

04Примените миграции

Breeze добавляет таблицы для пользователей и сброса пароля. Запустите миграции командой php artisan migrate. На сервере с APP_ENV=production добавьте ключ --force, иначе команда ждёт подтверждения.

bash
php artisan migrate

05Соберите фронтенд

Экраны Breeze используют Tailwind, поэтому стили нужно собрать. Выполните установку зависимостей и сборку. Готовые файлы появятся в public/build.

bash
npm install
npm run build

06Проверьте вход и регистрацию

Откройте в браузере https://example.com/register и создайте пользователя. Затем выйдите и войдите через /login. Если страницы отдают 404, проверьте маршруты командой php artisan route:list и наличие строк с login и register.

bash
php artisan route:list

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

  • После установки Breeze страницы входа отдают 404.

    Проверьте, что установщик php artisan breeze:install завершился без ошибок и маршруты появились в php artisan route:list. При кэшированных маршрутах выполните php artisan optimize.

  • Регистрация падает с ошибкой базы данных.

    Проверьте DB_CONNECTION и остальные параметры в .env, затем выполните php artisan migrate. После правки .env при кэше конфига нужен php artisan config:cache.

  • Страницы Breeze открываются без стилей.

    Соберите фронтенд командой npm run build и убедитесь, что каталог public/build существует и доступен nginx на чтение.

Deploykin

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

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

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

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

Чем Laravel Breeze отличается от Laravel Jetstream?

Breeze даёт простые экраны аутентификации на Blade и Tailwind. Jetstream добавляет команды, API-токены и двуфакторную аутентификацию на Livewire или Inertia.

Можно ли поставить Breeze в существующий проект?

Да, пакет ставят командой composer require laravel/breeze --dev, затем запускают php artisan breeze:install. Установщик перезапишет часть шаблонов и маршрутов, поэтому сделайте коммит перед установкой.

Нужен ли Node.js для Breeze?

Да, стили Tailwind собираются через npm. Без сборки экраны откроются, но без оформления.

Ещё по теме

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

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