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

Laravel Sail: установка и запуск на Ubuntu 24.04

Sail это обёртка над Docker Compose для локальной разработки Laravel. Он поднимает контейнеры с PHP, MySQL и другими службами, а команды запускаются через vendor/bin/sail. На сервере Ubuntu 24.04 Sail ставят отдельно: в свежем проекте Laravel его нет.

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

01Проверьте, что Docker и проект Laravel готовы

Sail работает поверх Docker, поэтому нужны docker и плагин docker compose. Проверьте их одной командой. Затем убедитесь, что вы находитесь в каталоге проекта Laravel: artisan и composer.json должны быть на месте. Если проекта ещё нет, создайте его командой composer create-project laravel/laravel example.com.

bash
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.

bash
composer require laravel/sail --dev
ls -l vendor/bin/sail

03Сгенерируйте compose.yaml

Команда php artisan sail:install создаёт в корне проекта файл compose.yaml с описанием контейнеров. Она спросит, какие службы подключить: выберите MySQL, если база нужна. Для неинтерактивного запуска передайте службы списком через --with. Файл можно править вручную, но при повторном запуске команда его перезапишет.

bash
php artisan sail:install --with=mysql

04Задайте подключение к MySQL в.env

Sail не подменяет параметры базы: в свежем проекте Laravel стоит DB_CONNECTION=sqlite. Откройте .env и укажите MySQL, хост mysql (имя службы из compose.yaml), базу, пользователя и пароль. Эти же значения должны совпадать с переменными службы mysql в compose.yaml. После правки .env перезапустите контейнеры.

ini
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.

bash
./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, но только когда контейнеры уже запущены.

bash
./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.

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

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