Админ-панель Laravel на Filament: пошаговая настройка
Админ-панель в Laravel собирают на Filament 5: он ставится двумя командами и открывается по адресу /admin. Пользователя для входа создаёт php artisan make:filament-user, а на рабочем сервере вход дополнительно разрешают в модели User через интерфейс FilamentUser.
01Проверьте окружение и версию Laravel
Панель ставится в готовый проект Laravel 13 на PHP 8.3. Filament 5 требует PHP 8.2 и выше, поэтому PHP 8.3 из Ubuntu 24.04 подходит. Проверьте версию фреймворка и убедитесь, что вы находитесь в каталоге проекта.
cd /var/www/example.com
php artisan --version
02Установите Filament 5
Пакет ставят через Composer с явным ограничением мажорной версии. После установки запускают установщик панели: он создаёт провайдер app/Providers/Filament/AdminPanelProvider.php и регистрирует маршрут /admin. Обе команды выполняются от владельца проекта, без sudo.
composer require filament/filament:"^5.0"
php artisan filament:install --panels
03Создайте пользователя для входа
Команда make:filament-user спрашивает имя, email и пароль и записывает пользователя в таблицу users. Если база ещё не создана, сначала выполните миграции. На рабочем сервере миграции запускают с флагом --force, иначе команда ждёт подтверждения.
php artisan migrate --force
php artisan make:filament-user
04Разрешите вход в панель на сервере
Без интерфейса FilamentUser Filament пускает в панель только при APP_ENV=local. На сервере с APP_ENV=production вход заканчивается ошибкой 403. Добавьте в модель User интерфейс и метод canAccessPanel, который возвращает true для нужных пользователей. Файл app/Models/User.php после правки выглядит так: подключён интерфейс FilamentUser и добавлен метод с типом возврата bool.
<?php
namespace App\Models;
use Filament\Models\Contracts\FilamentUser;
use Filament\Panel;
use Illuminate\Foundation\Auth\User as Authenticatable;
class User extends Authenticatable implements FilamentUser
{
public function canAccessPanel(Panel $panel): bool
{
return true;
}
}
05Создайте ресурс для модели
Ресурс связывает модель с таблицей и формой в панели. Команда make:filament-resource Customer создаёт класс ресурса с таблицей и формой для модели Customer. Модель и её таблица должны существовать заранее.
php artisan make:filament-resource Customer
06Закэшируйте компоненты после деплоя
После выкладки кода запустите filament:optimize: команда кэширует компоненты и Blade-иконки Filament. Общий кэш Laravel включает php artisan optimize, он кэширует конфиг, маршруты, события и шаблоны. Обе команды пишут в bootstrap/cache и выполняются от владельца проекта.
php artisan optimize
php artisan filament:optimize
07Проверьте вход в панель
Откройте https://example.com/admin и войдите под созданным пользователем. Маршруты панели показывает php artisan route:list с фильтром по admin. Если вход возвращает 403, вернитесь к модели User и проверьте реализацию FilamentUser.
php artisan route:list --path=admin
Частые ошибки
-
На сервере с APP_ENV=production вход в /admin заканчивается ошибкой 403 Forbidden.
Модель User не реализует Filament\Models\Contracts\FilamentUser. Добавьте интерфейс и метод canAccessPanel(Panel $panel): bool, который пускает нужных пользователей.
-
После деплоя панель открывается, но старые настройки и ресурсы не видны.
Запустите php artisan filament:optimize и php artisan optimize от владельца проекта. Кэш конфига означает, что правка.env действует только после новой команды optimize или config:clear.
-
composer install и php artisan optimize падают с Permission denied у владельца проекта.
Каталоги storage и bootstrap/cache отданы целиком www-data через chown. Верните владельца: sudo chown -R $USER:www-data storage bootstrap/cache и sudo chmod -R ug+rwX storage bootstrap/cache.
-
После входа в панель компоненты 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.
Deploykin
Как это делается в Deploykin
В Deploykin сайт на Laravel создаётся из панели: стек под приложение, key:generate и storage:link выполняются при создании, а доступы к базе сами попадают в .env. Деплой идёт без простоя, с миграциями и кэшами, а очереди держат демоны Horizon или Queue Worker.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Что такое laravel moonshine и чем он отличается от Filament?
Moonshine это отдельный пакет админ-панели для Laravel со своими командами установки и своими шаблонами. В этом руководстве панель собирается на Filament 5, команды и файлы для Moonshine здесь не приводятся.
Почему на сервере панель отдаёт 403, а локально вход работает?
Локально APP_ENV=local, и Filament пускает любого пользователя. На сервере APP_ENV=production, и без интерфейса FilamentUser в модели User вход запрещён. Добавьте интерфейс и метод canAccessPanel.
Нужно ли ставить Livewire отдельно для Filament?
Нет. Filament 5 построен на Livewire, и зависимость ставится вместе с пакетом. Отдельный composer require livewire/livewire нужен, когда Livewire используется в обычных страницах приложения.
Как сменить адрес /admin на другой?
Адрес задаётся в провайдере app/Providers/Filament/AdminPanelProvider.php, который создаёт filament:install --panels. После правки выполните php artisan optimize и php artisan filament:optimize.
Ещё по теме
- Руководство · 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: руководство по установке и настройке: все материалы темы