Introduction

UX DataTables is a Symfony bundle that integrates the powerful DataTables JavaScript library into your Symfony applications with a clean PHP API.

Who Is This For?

Use this bundle when you need interactive HTML tables in a Symfony 7/8 app and want:

• PHP-first column and option configuration (not hand-written DataTables JS)
• Doctrine server-side processing without reinventing Ajax contracts
• Optional Symfony UX Stimulus wiring, extensions, Mercure, and API Platform

If you only need a static HTML table, stick with Twig. If your frontend is a SPA that already owns DataTables, you may not need the Twig/Stimulus layer.

What is DataTables?

DataTables is a highly flexible tool for creating interactive HTML tables with features like:

• Pagination
• Instant search and filtering
• Multi-column sorting
• Ajax data loading
• Server-side processing
• Export to CSV, Excel, PDF

Why UX DataTables?

This bundle provides a Symfony-native way to work with DataTables:

PHP-First Configuration

Configure your tables entirely in PHP with a fluent API:

use Pentiminax\UX\DataTables\Column\NumberColumn;
use Pentiminax\UX\DataTables\Column\TextColumn;
use Pentiminax\UX\DataTables\Model\AbstractDataTable;
use Pentiminax\UX\DataTables\Model\DataTable;

final class UsersDataTable extends AbstractDataTable
{
    public function configureColumns(): iterable
    {
        yield TextColumn::new('name', 'Name');
        yield NumberColumn::new('age', 'Age');
    }

    public function configureDataTable(DataTable $table): DataTable
    {
        return $table
            ->pageLength(25)
            ->searching(true);
    }
}

Stimulus Integration

Built on Symfony UX StimulusBundle, the bundle automatically handles JavaScript initialization through Stimulus controllers.

Twig Helper

Render tables with a simple Twig function:

{{ render_datatable(table) }}

Doctrine Integration

Use the #[AsDataTable] attribute to create tables backed by Doctrine entities with automatic server-side processing:

#[AsDataTable(User::class)]
final class UsersDataTable extends AbstractDataTable
{
    public function configureColumns(): iterable
    {
        yield TextColumn::new('id', 'ID');
        yield TextColumn::new('email', 'Email');
    }
}

Architecture Overview

┌─────────────────────────────────────────────────────┐
│                    Controller                        │
│  ┌───────────────────────────────────────────────┐  │
│  │      Injected AbstractDataTable service        │  │
│  └───────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────┐
│                     DataTable                        │
│  ┌─────────┐  ┌─────────┐  ┌────────────────────┐  │
│  │ Columns │  │ Options │  │     Extensions     │  │
│  └─────────┘  └─────────┘  └────────────────────┘  │
└─────────────────────────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────┐
│                   Twig Template                      │
│         {{ render_datatable(table) }}               │
└─────────────────────────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────┐
│              Stimulus Controller                     │
│           (Auto-initialized by Symfony UX)          │
└─────────────────────────────────────────────────────┘