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