Laravel CMS: пошаговая настройка на Ubuntu 24.04
Laravel не является готовой CMS, но на нём собирают админку и публичную часть за один вечер: проект создаётся composer, панель управления даёт Filament, интерактив на страницах даёт Livewire.
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.
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.
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: новый ключ разлогинивает всех и ломает зашифрованные данные.
php artisan key:generate
04Подключите MySQL вместо SQLite
Свежий проект Laravel по умолчанию работает с SQLite: DB_CONNECTION=sqlite. Для MySQL в .env меняют драйвер и задают хост, базу, пользователя и пароль. Базу и пользователя создают заранее в консоли MySQL.
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 его снимает.
php artisan migrate --force
06Настройте nginx и PHP-FPM
Корень сайта в nginx смотрит в /var/www/example.com/public, поэтому .env и код вне public наружу не отдаются. Запросы к несуществующим файлам уходят в index.php. После правки конфиг проверяют sudo nginx -t и перезагружают 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 от владельца проекта.
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.
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 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: руководство по установке и настройке: все материалы темы