Filament 5: адмін-панелі
20 питань · ~20 хв · Версія v3.0
Увійдіть, щоб продовжити
Ресурси й схеми, таблиці й фільтри, дії й сповіщення, менеджери зв'язків, віджети, доступ і мультитенантність - питання всіх рівнів, від junior до senior.
- За спробу
- 20
- У пулі
- 48
- Проходжень
- 0
- Середній бал
- -
- Пройшли на 70%+
- -
Питання для підготовки
31 питанняFilament - фреймворк Server-Driven UI для Laravel: інтерфейси (адмінки, панелі) описуються на PHP через структуровані об'єкти, а не верстку.
public static function form(Schema $schema): Schema
{
return $schema->components([
TextInput::make('title')->required(),
Select::make('status')->options(Status::class),
]);
}
- Побудований на Livewire, Alpine.js і Tailwind CSS.
- Будівельні блоки: Resources, Forms, Tables, Actions, Infolists, Widgets.
- Компоненти ініціалізуються статичними
make()-методами; динамічні значення задаються замиканнями з утилітамиGet/Set.
Ресурс - це опис того, як модель виглядає в адмінці: таблиця, форма й сторінки навколо них.
php artisan make:filament-resource Vacancy --generate
Команда створює клас ресурсу, сторінки List/Create/Edit, а форму й таблицю виносить в окремі файли (Schemas/VacancyForm.php, Tables/VacancyTable.php). Прапорці --embed-schemas і --embed-table лишають їх усередині класу ресурсу.
Дві головні частини - форма й таблиця:
public static function form(Schema $schema): Schema
{
return $schema->components([
TextInput::make('title')
->required()
->maxLength(255),
Select::make('level')
->options(VacancyLevel::class)
->required(),
Toggle::make('is_published'),
]);
}
public static function table(Table $table): Table
{
return $table
->columns([
TextColumn::make('title')->searchable()->sortable(),
TextColumn::make('company.name')->label('Компанія'),
IconColumn::make('is_published')->boolean(),
])
->filters([
SelectFilter::make('level')->options(VacancyLevel::class),
]);
}
Що це дає без додаткового коду: список із пошуком, сортуванням і пагінацією, форми створення й редагування з валідацією, масові дії, фільтри.
На чому побудовано: Livewire відповідає за реактивність без написання JS, Alpine - за дрібні взаємодії в браузері, Tailwind - за оформлення. Тому Filament - це PHP-код, а не окремий фронтенд-застосунок.
Що варто знати одразу: форма й таблиця - це звичайні PHP-масиви обʼєктів, тож видимість поля, опції списку чи доступність дії задаються замиканнями й можуть залежати від користувача та стану запису.
Filament будує таблицю з Eloquent-запиту, тож усі звичайні проблеми продуктивності лишаються - але ховаються за декларативним синтаксисом.
N+1 у колонках. Колонка зі звʼязком робить запит на рядок:
TextColumn::make('company.name') // + 1 запит на кожен рядок
Лікується модифікацією запиту таблиці:
public static function getEloquentQuery(): Builder
{
return parent::getEloquentQuery()->with(['company', 'technologies']);
}
Лічильники. ->counts('vacancies') замість завантаження всієї колекції заради count().
Дорогі обчислення в state(). Замикання виконується для кожного рядка, тож звернення до бази всередині - те саме N+1, лише написане інакше.
Сортування й пошук за звʼязком роблять join, і без індексу на зовнішньому ключі це помітно:
TextColumn::make('company.name')
->searchable() // where по приєднаній таблиці
->sortable()
Що ще сповільнює адмінку:
->paginated([10, 25, 50, 'all'])з опцієюallна великій таблиці вивантажує все в памʼять одним кліком користувача.- Глобальний пошук по багатьох ресурсах виконує запит на кожен зареєстрований ресурс.
- Мініатюри без кешу:
ImageColumn, що генерує прев'ю на льоту, робить це для кожного рядка. - Опції
Selectбез->searchable()вивантажують усі записи довідника у форму.
Як шукати причину: Debugbar або Telescope на сторінці ресурсу покажуть кількість запитів. Таблиця на 25 рядків має вкладатися в одиниці запитів; десятки - ознака незавантаженого звʼязку.
Filament бере на себе багато перевірок, але не всі. Корисно чітко знати межу.
Що Filament робить сам:
- доступ до панелі - через
canAccessPanel()(на продакшені обов'язковий); - політики ресурсів -
viewAny,create,update,deleteперевіряються для сторінок і вбудованих дій; - приховані й вимкнені дії не можна викликати навіть підробленим запитом: дія, для якої
visible()повернувfalse, вважається вимкненою й не виконується на сервері; - вимкнені поля (
disabled()) не зберігаються, якщо явно не дозволитиsaved(); Selectза замовчуванням перевіряє, що обране значення є серед дозволених опцій;- HTML у
TextColumn/TextEntryзhtml()чиmarkdown()санітизується.
Що лишається на вас:
- власний Blade. Якщо виводите HTML з
RichEditorу своєму шаблоні - санітизуйте (str($html)->sanitizeHtml()) або використовуйтеRichContentRenderer. Санітайзер Filament пропускає атрибутиstyle, тож для недовіреного вмісту може знадобитися суворіший; - імпорт і експорт не перевіряють політики для кожного запису. Користувач з доступом до експорту отримає все, що поверне запит, - обмежуйте його через
modifyQueryUsing(); - фільтри списків - не межа безпеки. Звуження опцій у модальній таблиці (
tableSelect) лише відображення; дозволені записи задають запитом на кшталтrecordSelectOptionsQuery(); unique()не враховує глобальні скоупи й тенантів - для мультиорендних даних єscopedUnique();- файли.
preserveFilenames()на дискахlocal/publicвідкриває шлях до завантаження виконуваних файлів - краще випадкові імена йstoreFileNamesIn(); - CSV-формули. Значення, що починаються з
=,+,-,@, у файлах експорту чи «невдалих рядків» імпорту Excel може виконати як формулу.
Окремий нюанс - middleware. Панель збирає власний стек middleware і не використовує групу web застосунку. Middleware, додане в web (наприклад, заголовки CSP), на маршрутах панелі не спрацює - його треба реєструвати в $panel->middleware([...]).
Практичний підсумок: політика на кожну модель ресурсу, canAccessPanel() з перевіркою конкретної панелі, і обережність скрізь, де дані виходять за межі панелі: свої шаблони, файли, експорт.
За замовчуванням масова дія завантажує всі вибрані моделі в пам'ять і передає Eloquent-колекцію в action(). Коли користувач натискає «вибрати все» на таблиці з 200 000 рядків, це легко перевищує ліміт пам'яті PHP.
Порційна обробка:
use Filament\Actions\BulkAction;
use Illuminate\Support\LazyCollection;
BulkAction::make('archive')
->chunkSelectedRecords(250)
->action(function (LazyCollection $records) {
$records->each->update(['archived_at' => now()]);
})
Записи підтягуються пачками, $records стає LazyCollection - пам'ять стала, а код майже не змінюється.
Без завантаження моделей взагалі:
use Illuminate\Support\Collection;
BulkAction::make('archive')
->fetchSelectedRecords(false)
->action(fn (Collection $records) => Order::whereKey($records)->update(['archived_at' => now()]))
Тут $records - лише ідентифікатори, а оновлення - один SQL-запит.
Ціна fetchSelectedRecords(false). Filament завантажує моделі не просто так:
- щоб перевірити політику для кожного запису (
authorizeIndividualRecords('update')); - щоб спрацювали події моделі (
updating,deleted, спостерігачі, журнал активності, очищення кешу, Scout-індексація).
Масовий update()/delete() через запит обходить і те, і те. Для DeleteBulkAction це означає: без deleting-подій не видаляться файли, не оновиться пошуковий індекс, не запишеться аудит.
Як обирати:
| Потреба | Підхід |
|---|---|
| потрібні політики й події, записів сотні | за замовчуванням |
| потрібні політики й події, записів тисячі | chunkSelectedRecords() |
| чиста операція над даними, подій немає | fetchSelectedRecords(false) |
| дуже довга операція | поставити джобу в чергу з ідентифікаторами |
Звіт про часткові невдачі. Якщо частина записів не обробилася, $action->reportBulkProcessingFailure() додасть причину в підсумкове сповіщення («3 з 50 замовлень не вдалося архівувати»), а authorizeIndividualRecords() так само повідомляє про записи, відкинуті політикою.
Довгі операції в HTTP-запиті ризикують тайм-аутом. Для них краще: дія ставить джобу (Bus::batch по пачках ідентифікаторів) і надсилає сповіщення в базу даних, коли все готово.
Прочитати - ще не значить знати
20 питань, по одному на екран, ~20 хв. Після завершення - розбір кожної помилки з посиланням на питання.