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

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

Filament 5 ставится в готовый проект Laravel двумя командами composer и открывает панель по адресу /admin. На сервере вход в неё без интерфейса FilamentUser заканчивается ошибкой 403, поэтому доступ настраивают сразу. Проверка занимает минуту: вход под созданным пользователем и открытие ресурса.

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

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.

bash
php -v
php artisan --version

02Установите Filament

Пакет ставят через Composer с явным ограничением версии. Затем команда filament:install --panels создаёт провайдер панели app/Providers/Filament/AdminPanelProvider.php и регистрирует её. Панель по умолчанию доступна по адресу /admin.

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

03Создайте пользователя для входа

Команда make:filament-user спрашивает имя, email и пароль и создаёт запись в таблице users. Если таблиц ещё нет, сначала выполните php artisan migrate. На рабочем сервере с APP_ENV=production миграции запускают с флагом --force.

bash
php artisan migrate
php artisan make:filament-user

04Разрешите доступ к панели на сервере

Без интерфейса Filament\Models\Contracts\FilamentUser в модели User Filament пускает в панель только при APP_ENV=local. На сервере с APP_ENV=production вход заканчивается ошибкой 403. Добавьте интерфейс и метод canAccessPanel, который пускает нужных пользователей.

php
<?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. Модель и её таблица должны существовать заранее, иначе ресурс не откроется.

bash
php artisan make:filament-resource Customer

06Соберите кэш Filament после деплоя

На сервере после выкладки кода запускают php artisan filament:optimize: команда кэширует компоненты и Blade-иконки Filament. Перед ней выполняют обычный php artisan optimize. Обе команды запускают от владельца проекта, без sudo, иначе в bootstrap/cache останутся файлы root.

bash
php artisan optimize
php artisan filament:optimize

07Проверьте вход и панель

Откройте https://example.com/admin и войдите под пользователем, которого пускает canAccessPanel. В панели должен быть виден ресурс Customer с таблицей и кнопкой создания записи. Если вход возвращает 403, проверьте APP_ENV в .env и условие в методе canAccessPanel.

bash
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: руководство по установке и настройке: все материалы темы

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