Laravel Breeze: пошаговая настройка на Ubuntu 24.04
Laravel Breeze это стартовый набор экранов аутентификации на Blade и Tailwind, который ставят в готовый проект Laravel. На этой странице вы создадите проект, поставите Breeze, настроите базу и проверите вход и регистрацию на сервере.
01Проверьте, что Laravel установлен
Зайдите на сервер под пользователем, который деплоит проект, и перейдите в каталог проекта. Команда php artisan --version покажет версию Laravel. Если проект ещё не создан, выполните composer create-project laravel/laravel example.com и перейдите в каталог example.com.
cd /var/www/example.com
php artisan --version
02Установите Laravel Breeze
Breeze ставят пакетом Composer, затем запускают установщик. Установщик спросит стек: выберите Blade, чтобы получить экраны на Blade и Tailwind. После установки Breeze создаёт маршруты аутентификации и шаблоны в resources/views.
composer require laravel/breeze --dev
php artisan breeze:install
03Настройте базу данных
В свежем проекте Laravel по умолчанию DB_CONNECTION=sqlite. Для MySQL откройте .env и задайте подключение. Пароль берите из настроек MySQL на сервере.
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, иначе команда ждёт подтверждения.
php artisan migrate
05Соберите фронтенд
Экраны Breeze используют Tailwind, поэтому стили нужно собрать. Выполните установку зависимостей и сборку. Готовые файлы появятся в public/build.
npm install
npm run build
06Проверьте вход и регистрацию
Откройте в браузере https://example.com/register и создайте пользователя. Затем выйдите и войдите через /login. Если страницы отдают 404, проверьте маршруты командой php artisan route:list и наличие строк с login и register.
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 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: руководство по установке и настройке: все материалы темы