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

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

Laravel не является готовой CMS, но на нём собирают админку и публичную часть за один вечер: проект создаётся composer, панель управления даёт Filament, интерактив на страницах даёт Livewire.

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

01Проверьте PHP и Composer на сервере

Ubuntu 24.04 ставит PHP 8.3, а Laravel 13 требует PHP 8.3 и выше, так что версия из репозитория подходит. Убедитесь, что установлены CLI, FPM и расширения, без которых composer и artisan падают на mbstring, xml, curl, zip, bcmath, intl и драйвере базы. Если пакета нет, он ставится одной командой apt.

bash
php -v
composer --version
sudo apt install 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

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

Проект создаётся в каталоге /var/www/example.com, который потом станет корнем сайта в nginx. Команда composer create-project скачивает свежий Laravel и выполняет установочные скрипты. Версию фреймворка показывает php artisan --version.

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

03Сгенерируйте APP_KEY

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

bash
php artisan key:generate

04Подключите MySQL вместо SQLite

Свежий проект Laravel по умолчанию работает с SQLite: DB_CONNECTION=sqlite. Для MySQL в .env меняют драйвер и задают хост, базу, пользователя и пароль. Базу и пользователя создают заранее в консоли MySQL.

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

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

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

bash
php artisan migrate --force

06Настройте nginx и PHP-FPM

Корень сайта в nginx смотрит в /var/www/example.com/public, поэтому .env и код вне public наружу не отдаются. Запросы к несуществующим файлам уходят в index.php. После правки конфиг проверяют sudo nginx -t и перезагружают nginx.

nginx
server {
    listen 80;
    server_name example.com;
    root /var/www/example.com/public;

    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    }
}

07Выдайте права на storage и bootstrap/cache

Владелец файлов проекта это пользователь, который деплоит. www-data пишет только в storage и bootstrap/cache, доступ даёт группа. Остальные файлы www-data только читает, поэтому composer install и php artisan optimize запускают без sudo от владельца проекта.

bash
sudo chown -R $USER:www-data storage bootstrap/cache
sudo chmod -R ug+rwX storage bootstrap/cache

08Установите Filament и создайте панель

Filament 5 требует PHP 8.2 и выше и работает поверх Livewire. Пакет ставят через composer, затем filament:install --panels создаёт app/Providers/Filament/AdminPanelProvider.php и панель по адресу /admin. Пользователя для входа создаёт make:filament-user.

bash
composer require filament/filament:"^5.0"
php artisan filament:install --panels
php artisan make:filament-user

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

  • После sudo chown -R www-data:www-data storage bootstrap/cache команды composer install и php artisan optimize падают у владельца проекта с Permission denied, а запущенные через sudo оставляют файлы root, которые PHP-FPM не может перезаписать.

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

  • Вход в панель Filament на сервере заканчивается ошибкой 403 Forbidden, хотя пользователь создан.

    Модель User не реализует Filament\Models\Contracts\FilamentUser, а APP_ENV не local. Добавьте интерфейс и метод canAccessPanel(Panel $panel): bool, который пускает нужных пользователей.

  • Компоненты Livewire не реагируют, в консоли браузера 404 на livewire.min.js.

    Location nginx для статических .js с try_files $uri =404; перехватил адрес /livewire-<хеш>/livewire.min.js. Отдайте такие запросы в index.php: try_files $uri /index.php?$query_string;, затем sudo nginx -t и sudo systemctl reload nginx.

  • После правки .env настройки не меняются, а env() вне файлов config/ возвращает null.

    Конфиг закэширован командой php artisan optimize. Выполните php artisan optimize заново или php artisan config:clear, и новые значения из .env начнут действовать.

Deploykin

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

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

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

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

Laravel это CMS?

Laravel это фреймворк, а не готовая CMS: он даёт маршруты, базу, авторизацию и шаблоны, а панель управления собирают на Filament. Публичную часть и модели пишут под задачу сайта.

Какое основное преимущество использования фреймворка Laravel?

Готовая инфраструктура для типовой задачи: миграции, очереди, авторизация, кэш и шаблоны уже в проекте. Панель на Filament и интерактив на Livewire добавляются двумя пакетами composer.

Почему в панель Filament не пускает на сервере?

Filament пускает без настройки только при APP_ENV=local. На рабочем сервере модель User должна реализовать FilamentUser с методом canAccessPanel, иначе вход даёт 403.

Где Laravel хранит ошибки 500?

В storage/logs/laravel.log. При APP_DEBUG=false посетитель видит только общую страницу, а подробности остаются в логе.

Ещё по теме

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

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