Laravel Filament — админ-панель

ОБЯЗАТЕЛЬНОДЛЯ НОВИЧКОВ

Разработчику

Laravel Filament — админ-панель

В Livewire вы собирали кнопки, поля и списки вручную. Filament — готовая админ-панель поверх Livewire: таблицы с сортировкой и поиском, формы создания и редактирования, удаление, фильтры — из одного PHP-класса Resource.

Типичный сценарий: публичный сайт на Blade/Livewire, а внутренняя панель /admin для менеджеров — на Filament.

Задача	Инструмент
Публичный сайт, мало форм	Blade + 1431
Интерактив на Laravel	Livewire 1434
Внутренняя админка, CRUD сущностей	Filament (эта статья)
Отдельный React/Vue	Sanctum 1433

Что такое Resource

Resource в Filament — описание одной модели Eloquent для админки:

какие поля в форме (form());
какие колонки в таблице (table());
какие страницы: список, создать, редактировать (getPages()).

Filament генерирует UI сам; писать десятки Blade-файлов для каждой сущности не нужно.

Подготовка модели Task

Нужен Laravel-проект с моделью Task (как в 1434):

php artisan make:model Task -m

В миграции:

$table->string('title');
$table->boolean('done')->default(false);

php artisan migrate

app/Models/Task.php:

protected $fillable = ['title', 'done'];

$fillable обязателен — иначе Filament не сохранит поля из формы.

Установка Filament

composer require filament/filament:"^3.2" -W
php artisan filament:install --panels

Мастер создаёт панель admin (маршруты, layout, стили).

php artisan serve

Откройте /admin. Создайте пользователя:

php artisan make:filament-user

В Filament 3 вход — по email и паролю из таблицы users, как в обычном Laravel.

Resource для Task

php artisan make:filament-resource Task --generate

--generate подставляет поля из миграции/модели в черновик формы и таблицы.

Фрагмент app/Filament/Resources/TaskResource.php:

<?php

namespace App\Filament\Resources;

use App\Filament\Resources\TaskResource\Pages;
use App\Models\Task;
use Filament\Forms;
use Filament\Forms\Form;
use Filament\Resources\Resource;
use Filament\Tables;
use Filament\Tables\Table;

class TaskResource extends Resource
{
    protected static ?string $model = Task::class;

    protected static ?string $navigationIcon = 'heroicon-o-clipboard-document-list';

    public static function form(Form $form): Form
    {
        return $form->schema([
            Forms\Components\TextInput::make('title')
                ->required()
                ->maxLength(200),
            Forms\Components\Toggle::make('done'),
        ]);
    }

    public static function table(Table $table): Table
    {
        return $table
            ->columns([
                Tables\Columns\TextColumn::make('id')->sortable(),
                Tables\Columns\TextColumn::make('title')->searchable(),
                Tables\Columns\IconColumn::make('done')->boolean(),
                Tables\Columns\TextColumn::make('created_at')->dateTime(),
            ])
            ->actions([
                Tables\Actions\EditAction::make(),
                Tables\Actions\DeleteAction::make(),
            ])
            ->bulkActions([
                Tables\Actions\BulkActionGroup::make([
                    Tables\Actions\DeleteBulkAction::make(),
                ]),
            ]);
    }

    public static function getPages(): array
    {
        return [
            'index' => Pages\ListTasks::route('/'),
            'create' => Pages\CreateTask::route('/create'),
            'edit' => Pages\EditTask::route('/{record}/edit'),
        ];
    }
}

Разбор блоков

Метод	Назначение
`$model`	С какой Eloquent-моделью работает Resource
`form()->schema([...])`	Поля на страницах Create/Edit
`table()->columns([...])`	Колонки списка; `searchable()` — строка поиска
`actions`	Кнопки в строке (редактировать, удалить)
`bulkActions`	Действия над выделенными строками
`getPages()`	URL внутри `/admin/tasks/...`

В боковом меню панели появится пункт Tasks с полным CRUD.

Связь Filament и Livewire

Filament строит интерфейс из компонентов Livewire (TextInput, TextColumn). Вы можете:

держать публичный каталог на своём Livewire-компоненте;
вести справочник задач в Filament на /admin.

Оба подхода живут в одном composer.json и одной БД.

Права доступа

По умолчанию в панель входят пользователи из users. Для учебного проекта достаточно одного админа.

В production подключают Policies, роли (Spatie Laravel Permission) или встроенные хуки Filament canAccessPanel(). Тема прав — отдельная статья; для старта важно: URL /admin не публикуйте без авторизации в интернете.

Частые ошибки

Симптом	Причина
404 на `/admin`	Не выполнен `filament:install --panels`
Пустое меню	Resource не в `App\Filament\Resources` или опечатка в namespace
403 при входе	Нет пользователя — `make:filament-user`
Поле не сохраняется	Нет в `$fillable` или не добавлено в `form()`

Что попробовать

ToggleColumn::make('done') — переключатель прямо в таблице.
Tables\Filters\TernaryFilter::make('done') — фильтр «выполнено / нет».
Публичный список — Livewire, правки данных — Filament.

Связанные материалы

См. также

Другие статьи этого же раздела в боковом меню (как на странице «О разделе»).

Laravel Filament — админ-панель