README

Be careful, this is an experimental bundle

no tests
a lot of bugs
confusing structure

A Symfony bundle that extends EasyAdmin to work with any data source — files, APIs, arrays, or custom iterators — without requiring Doctrine ORM.

Features

🗂️ Non-Doctrine CRUD — Use EasyAdmin's powerful interface for files, APIs, or any iterable data
⚡ Batch Actions — Full support for EasyAdmin batch actions with automatic DTO resolution
🎨 EasyAdmin Fields — Reuse any EasyAdmin field types (IdField, TextField, etc.)
🔧 Custom Actions — Create custom actions and batch operations
🎯 Simple Integration — Extend AbstractMapperController and implement MapperControllerInterface

Requirements

PHP 8.1 or higher
Symfony 6.1 or higher
EasyAdmin Bundle 4.x

Installation

Step 1: Install via Composer

composer require wertelko/easyadmin-mapper

Step 2: Register the Bundle

Add the bundle to your config/bundles.php:

<?php

return [
    // ... other bundles
    Wertelko\EasyadminMapperBundle\EasyadminMapperBundle::class => ['all' => true],
];

Usage Examples

Create a controller that extends AbstractMapperController:

<?php

namespace App\Controller\Admin;

use EasyCorp\Bundle\EasyAdminBundle\Config\Action;
use EasyCorp\Bundle\EasyAdminBundle\Config\Actions;
use EasyCorp\Bundle\EasyAdminBundle\Config\Crud;
use EasyCorp\Bundle\EasyAdminBundle\Dto\BatchActionDto;
use EasyCorp\Bundle\EasyAdminBundle\Field\DateTimeField;
use EasyCorp\Bundle\EasyAdminBundle\Field\IdField;
use EasyCorp\Bundle\EasyAdminBundle\Field\TextField;
use Symfony\Component\Finder\Finder;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;
use Wertelko\EasyadminMapperBundle\Controller\AbstractMapperController;

class TestController extends AbstractMapperController
{
    public function configureActions(Actions $actions): Actions
    {
        return parent::configureActions($actions)
            ->add(Crud::PAGE_INDEX,
                Action::new('removeFile', 'Delete')
                    ->createAsBatchAction()
                    ->linkToRoute('admin_files')
            );
    }

    public function configureFields(string $pageName): iterable
    {
        yield IdField::new('pathname');
        yield TextField::new('size')->formatValue(fn($value) => $this->formatBytes($value));
        yield DateTimeField::new('mtime', 'Modified');
    }

    #[Route('/admin/files', name: 'admin_files')]
    public function index(BatchActionDto $actionDto): Response
    {
        // Handle batch actions
        if ($actionDto->getName()) {
            return call_user_func([$this, $actionDto->getName()], $actionDto);
        }

        // Load your data from any source
        $finder = new Finder();
        $files = $finder->files()->in($this->getParameter('kernel.cache_dir'));

        // Render the EasyAdmin table
        return $this->renderTable($files, 'Cache files');
    }

    public function removeFile(BatchActionDto $actionDto): Response
    {
        foreach ($actionDto->getEntityIds() as $filename) {
            $path = $this->getParameter('kernel.cache_dir') . $filename;
            if (file_exists($path)) {
                unlink($path);
            }
        }

        $this->addFlash('success', sprintf('%d files deleted.', count($actionDto->getEntityIds())));

        return $this->redirectToRoute('admin_files');
    }

    private function formatBytes(int $bytes): string
    {
        $units = ['B', 'KB', 'MB', 'GB'];
        $i = 0;
        while ($bytes >= 1024 && $i < count($units) - 1) {
            $bytes /= 1024;
            $i++;
        }
        return round($bytes, 2) . ' ' . $units[$i];
    }
}

Working with API Data

<?php

namespace App\Controller\Admin;

use EasyCorp\Bundle\EasyAdminBundle\Field\TextField;
use EasyCorp\Bundle\EasyAdminBundle\Field\EmailField;
use Symfony\Component\Routing\Attribute\Route;
use Symfony\Contracts\HttpClient\HttpClientInterface;
use Wertelko\EasyadminMapperBundle\Controller\AbstractMapperController;

class UsersController extends AbstractMapperController
{
    public function __construct(
        private HttpClientInterface $httpClient
    ) {}

    public function configureFields(string $pageName): iterable
    {
        yield IdField::new('id');
        yield TextField::new('name');
        yield EmailField::new('email');
    }

    #[Route('/admin/api-users', name: 'admin_api_users')]
    public function index(): Response
    {
        $response = $this->httpClient->request('GET', 'https://api.example.com/users');
        $users = $response->toArray();

        return $this->renderTable($users);
    }
}

Working with Array Data

public function configureFields(string $pageName): iterable
{
    yield IdField::new('id');
    yield TextField::new('level');
    yield DateTimeField::new('message');
}

#[Route('/admin/logs', name: 'admin_logs')]
public function logs(): Response
{
    $logs = [
        ['id' => 1, 'level' => 'ERROR', 'message' => 'Database connection failed'],
        ['id' => 2, 'level' => 'WARNING', 'message' => 'Disk space low'],
        ['id' => 3, 'level' => 'INFO', 'message' => 'Cache cleared'],
    ];

    return $this->renderTable($logs);
}

Working with Filters

<?php

namespace App\Controller\Admin;

use EasyCorp\Bundle\EasyAdminBundle\Field\TextField;
use EasyCorp\Bundle\EasyAdminBundle\Field\EmailField;
use Symfony\Component\Routing\Attribute\Route;
use Symfony\Contracts\HttpClient\HttpClientInterface;
use Wertelko\EasyadminMapperBundle\Controller\AbstractMapperController;
use Wertelko\EasyadminMapperBundle\Config\FiltersConfig;
use EasyCorp\Bundle\EasyAdminBundle\Filter\ArrayFilter;
use Wertelko\EasyadminMapperBundle\Dto\Filter\FilterDto;

class UsersController extends AbstractMapperController
{
    public function __construct(
        private HttpClientInterface $httpClient
    ) {}

    public function configureFields(string $pageName): iterable
    {
        yield IdField::new('id');
        yield TextField::new('name');
        yield EmailField::new('email');
    }

    #[Route('/admin/api-users', name: 'admin_api_users')]
    public function index(FilterDto $filterDto): Response
    {
        // Preprocess request if you need
        if ($role = $filterDto->get('role')) {
            $response = $this->httpClient->request('GET', 'https://api.example.com/users?role=' . $role);
        } else {
            $response = $this->httpClient->request('GET', 'https://api.example.com/users');
        }
        
        
        $users = $response->toArray();

        return $this->renderTable($users);
    }
    
    public function configureFilters(FiltersConfig $filters): FiltersConfig
    {
        return $filters->add(
            ArrayFilter::new('role')->setChoices(['admin' => 'admin', 'user' => 'user'])
            fn($item, $filterValue) => dd($item, $filterValue) // should return true for pass item in to table,
            // this callback run after (postprocess) get data from API
            // you can omit this callback
            // and catch filter values in controller with FilterDto for preprocess request

        );
    }
}

How It Works

The bundle provides:

AbstractMapperController — Base controller with renderTable() method that converts any iterable/array into an EasyAdmin-compatible table
MapperControllerInterface — Marker interface that identifies your controllers as mapper controllers
BatchActionDtoValueResolver — Custom argument resolver that injects BatchActionDto into your controller actions for handling batch operations

Configuration

The bundle automatically registers its services. No additional configuration is required.

License

This bundle is released under the MIT License.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

If you encounter any issues or have questions, please open an issue on GitHub.

wertelko / easyadmin-mapper

Maintainers

Package info

Statistics

Security