Laravel Sail: установка и запуск на Ubuntu 24.04
Sail это обёртка над Docker Compose для локальной разработки Laravel. Он поднимает контейнеры с PHP, MySQL и другими службами, а команды запускаются через vendor/bin/sail. На сервере Ubuntu 24.04 Sail ставят отдельно: в свежем проекте Laravel его нет.
01Проверьте, что Docker и проект Laravel готовы
Sail работает поверх Docker, поэтому нужны docker и плагин docker compose. Проверьте их одной командой. Затем убедитесь, что вы находитесь в каталоге проекта Laravel: artisan и composer.json должны быть на месте. Если проекта ещё нет, создайте его командой composer create-project laravel/laravel example.com.
docker compose version
cd /var/www/example.com
php artisan --version
02Установите Sail в проект
Sail это dev-зависимость, в свежий проект Laravel он не входит. Поставьте пакет командой composer require laravel/sail --dev. После установки в vendor/bin/ появится скрипт sail, через него выполняются все дальнейшие команды. Если скрипта нет, значит пакет не установился: проверьте вывод Composer.
composer require laravel/sail --dev
ls -l vendor/bin/sail
03Сгенерируйте compose.yaml
Команда php artisan sail:install создаёт в корне проекта файл compose.yaml с описанием контейнеров. Она спросит, какие службы подключить: выберите MySQL, если база нужна. Для неинтерактивного запуска передайте службы списком через --with. Файл можно править вручную, но при повторном запуске команда его перезапишет.
php artisan sail:install --with=mysql
04Задайте подключение к MySQL в.env
Sail не подменяет параметры базы: в свежем проекте Laravel стоит DB_CONNECTION=sqlite. Откройте .env и укажите MySQL, хост mysql (имя службы из compose.yaml), базу, пользователя и пароль. Эти же значения должны совпадать с переменными службы mysql в compose.yaml. После правки .env перезапустите контейнеры.
DB_CONNECTION=mysql
DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=sail
DB_PASSWORD=password
05Запустите контейнеры
Команда ./vendor/bin/sail up -d собирает образы и поднимает службы в фоне. Первый запуск занимает несколько минут: скачиваются образы PHP и MySQL. Флаг -d оставляет терминал свободным. Список запущенных контейнеров показывает ./vendor/bin/sail ps.
./vendor/bin/sail up -d
./vendor/bin/sail ps
06Выполните миграции и проверьте artisan
Миграции запускаются внутри контейнера приложения: ./vendor/bin/sail artisan migrate. Команда ./vendor/bin/sail artisan --version показывает версию Laravel и подтверждает, что artisan работает через Sail. Если APP_KEY пуст, создайте ключ командой ./vendor/bin/sail artisan key:generate, но только когда контейнеры уже запущены.
./vendor/bin/sail artisan migrate
./vendor/bin/sail artisan --version
07Проверьте сайт и базу
Откройте http://localhost в браузере: должна появиться стартовая страница Laravel. Подключение к MySQL проверяется командой ./vendor/bin/sail mysql с запросом SELECT 1;. Если страница не открывается, посмотрите логи контейнеров командой ./vendor/bin/sail logs.
./vendor/bin/sail mysql -e "SELECT 1;"
./vendor/bin/sail logs
Частые ошибки
-
vendor/bin/sailне найден послеcomposer install --no-dev.Sail это dev-зависимость,
--no-devеё не ставит. Верните пакет командойcomposer require laravel/sail --dev. -
Сайт открывается, но Laravel отвечает ошибкой базы: в
.envосталсяDB_CONNECTION=sqlite.Укажите
DB_CONNECTION=mysqlи параметрыDB_HOST=mysql,DB_DATABASE,DB_USERNAME,DB_PASSWORD, затем перезапустите контейнеры командой./vendor/bin/sail down && ./vendor/bin/sail up -d. -
php artisan key:generateчерез Sail падает, потому что контейнеры ещё не запущены.Сначала поднимите службы командой
./vendor/bin/sail up -d, затем выполните./vendor/bin/sail artisan key:generate. -
Порт 80 занят другим веб-сервером, и
sail upзавершается ошибкой привязки порта.Остановите nginx или apache2 на хосте либо измените проброс порта в
compose.yaml, например на8080:80, и открывайте сайт поhttp://localhost:8080.
Deploykin
Как это делается в Deploykin
В Deploykin сайт на Laravel создаётся из панели: стек под приложение, key:generate и storage:link выполняются при создании, а доступы к базе сами попадают в .env. Деплой идёт без простоя, с миграциями и кэшами, а очереди держат демоны Horizon или Queue Worker.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Чем Sail отличается от Laravel Herd?
Sail запускает проект в Docker-контейнерах и работает на Linux, macOS и Windows. Herd это отдельное приложение для macOS и Windows с собственным PHP и nginx, без Docker.
Как обновить Laravel в проекте с Sail?
Обновите зависимости командой ./vendor/bin/sail composer update и выполните ./vendor/bin/sail artisan migrate. Версию Laravel покажет ./vendor/bin/sail artisan --version.
Можно ли использовать Sail на рабочем сервере?
Sail предназначен для разработки: он поднимает отладочные контейнеры и открывает порты. На сервере Laravel ставят с nginx и PHP-FPM, а Sail оставляют для локальной машины.
Где смотреть ошибки контейнеров Sail?
Команда ./vendor/bin/sail logs показывает логи всех служб, а ./vendor/bin/sail logs mysql только логи базы. Логи Laravel лежат в storage/logs/laravel.log.
Ещё по теме
- Руководство · 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: руководство по установке и настройке: все материалы темы