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

Laravel install: установка фреймворка на Ubuntu 24.04

Laravel ставится одной командой Composer, если на сервере уже есть PHP 8.3 с нужными расширениями и Composer. Свежий проект сразу работает на SQLite, поэтому база для первого запуска не нужна. Проверить установку можно командой php artisan --version и запуском встроенного сервера.

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

01Проверьте PHP и Composer

Ubuntu 24.04 ставит PHP 8.3, а Laravel 13 требует PHP 8.3 и выше, так что версия из репозитория подходит. Проверьте версию PHP и наличие Composer: без него команда создания проекта не выполнится. Если Composer не установлен, поставьте его по официальной инструкции getcomposer.org.

bash
php -v
composer --version

02Установите расширения PHP

Laravel нужны расширения mbstring, xml, curl, zip, bcmath и intl, а для работы с MySQL ещё и php8.3-mysql. Пакет php8.3-cli нужен для artisan, php8.3-fpm понадобится позже для сайта под nginx. После установки перезапустите FPM, чтобы расширения подхватились.

bash
sudo apt update
sudo apt install -y php8.3-cli php8.3-fpm php8.3-mbstring php8.3-xml php8.3-curl php8.3-zip php8.3-bcmath php8.3-intl php8.3-mysql
sudo systemctl restart php8.3-fpm

03Создайте проект Laravel

Перейдите в каталог /var/www и создайте проект командой composer create-project. Последний аргумент это каталог проекта, здесь /var/www/example.com. Composer скачает Laravel и все зависимости, установка занимает несколько минут.

bash
cd /var/www
composer create-project laravel/laravel example.com

04Проверьте версию Laravel

Команда php artisan --version показывает установленную версию фреймворка. Если она вывелась без ошибок, установка прошла и зависимости на месте. Ошибка про отсутствующий файл vendor/autoload.php значит, что composer install не завершился.

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

05Создайте ключ приложения

Ключ шифрования создаёт php artisan key:generate, он записывает значение в APP_KEY в .env. Без ключа Laravel отвечает ошибкой No application encryption key has been specified.. Ключ создают один раз: новый разлогинивает всех пользователей и ломает зашифрованные данные.

bash
php artisan key:generate

06Настройте.env и базу данных

В свежем проекте DB_CONNECTION=sqlite, и файл базы Laravel создаёт сам, так что для первого запуска править ничего не нужно. Для MySQL поставьте DB_CONNECTION=mysql и заполните DB_HOST, DB_DATABASE, DB_USERNAME и DB_PASSWORD. Драйвер php8.3-mysql к этому моменту уже установлен.

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

07Выполните миграции

Миграции создают таблицы пользователей, кэша, очередей и сессий. На рабочем сервере с APP_ENV=production добавьте --force, иначе команда ждёт подтверждения. Для SQLite файл базы создаётся при первом запуске миграций.

bash
php artisan migrate

08Запустите приложение и проверьте результат

Встроенный сервер поднимает php artisan serve, по умолчанию он слушает 127.0.0.1:8000. Откройте адрес в браузере: должна открыться стартовая страница Laravel. Для доступа снаружи укажите --host=0.0.0.0, а на рабочем сервере отдавайте проект через nginx с root в /var/www/example.com/public.

bash
php artisan serve
curl -I http://127.0.0.1:8000

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

  • composer create-project падает с сообщением о несовместимости PHP или отсутствующем расширении.

    Проверьте php -v и php -m: нужен PHP 8.3 и расширения mbstring, xml, curl, zip, bcmath, intl. Установите недостающие пакеты php8.3-* и повторите команду.

  • Сайт отдаёт 500, в storage/logs/laravel.log запись No application encryption key has been specified.

    Выполните php artisan key:generate. Если конфиг уже закэширован, после этого запустите php artisan config:cache.

  • php artisan migrate на сервере зависает и ждёт подтверждения.

    При APP_ENV=production команда требует флаг --force: php artisan migrate --force.

  • composer install или php artisan optimize падают с Permission denied после смены владельца storage и bootstrap/cache на www-data.

    Запускайте эти команды без sudo, от владельца проекта. www-data получает запись в эти каталоги через группу: sudo chown -R $USER:www-data storage bootstrap/cache и sudo chmod -R ug+rwX storage bootstrap/cache.

Deploykin

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

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

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

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

Какая версия PHP нужна для Laravel?

Текущий Laravel 13 требует PHP 8.3 и выше. PHP 8.3 из Ubuntu 24.04 подходит, отдельная установка другой версии не нужна.

Нужен ли MySQL для первого запуска Laravel?

Нет. В свежем проекте DB_CONNECTION=sqlite, и Laravel создаёт файл базы сам. MySQL подключают в .env позже, когда он действительно нужен.

Где взять Composer, если команда composer не найдена?

Composer ставят отдельно по инструкции на getcomposer.org. После установки проверьте composer --version и повторите создание проекта.

Как проверить, что Laravel установился правильно?

Запустите php artisan --version: команда покажет версию фреймворка. Затем поднимите php artisan serve и откройте http://127.0.0.1:8000, должна открыться стартовая страница.

Ещё по теме

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

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