Now we start the administration side of our library. We’ll use EasyAdminBundle, which builds a complete back office very quickly: CRUD screens, entity management, and a lot of saved time.
Requirements
EasyAdmin needs:
- PHP 8.2 or higher
- Symfony 6.4 or higher (we’re on Symfony 8)
- Doctrine ORM (already installed with
--webapp)
Installation
In the VS Code terminal:
composer require easycorp/easyadmin-bundle
What Got Added
Once Composer and Symfony Flex are done, here’s what changed:
| File | What it is |
|---|---|
composer.json | EasyAdmin added (version 5.x) |
config/packages/twig_component.yaml | Twig Components: not part of EasyAdmin itself, but required to render its interface |
config/routes/easyadmin.yaml | Loads the admin routes |
config/bundles.php | Registers TwigComponentBundle and EasyAdminBundle |
Here is the route file:
# config/routes/easyadmin.yaml
easyadmin:
resource: .
type: easyadmin.routes
New Console Commands
EasyAdmin also adds Maker commands that generate classes for us. List them with:
symfony console
You’ll find, among others:
make:admin:dashboardmake:admin:crud
Generating the Dashboard
symfony console make:admin:dashboard
We keep the default answers:
- Class name:
DashboardController - Directory:
src/Controller/Admin/
The command creates src/Controller/Admin/DashboardController.php. Inside you’ll find:
- the
/adminroute, declared with the#[AdminDashboard]attribute - an
index()method with three commented options for what the dashboard should display configureDashboard(), which sets the dashboard titleconfigureMenuItems(), which builds the side menu, starting with a Dashboard item and its Font Awesome icon
#[AdminDashboard(routePath: '/admin', routeName: 'admin')]
class DashboardController extends AbstractDashboardController
{
public function index(): Response
{
return parent::index();
}
public function configureDashboard(): Dashboard
{
return Dashboard::new()
->setTitle('Minibib');
}
public function configureMenuItems(): iterable
{
yield MenuItem::linkToDashboard('Dashboard', 'fa fa-home');
}
}
Opening the Admin
Go to http://127.0.0.1:8000/admin instead of /home: you’ll see the “Welcome to EasyAdmin 5” page, with links to the documentation.
Recap
composer require easycorp/easyadmin-bundleinstalls EasyAdmin- Flex adds the routes, bundles and Twig Components automatically
make:admin:dashboardgenerates the dashboard controller- The admin lives at
/admin
Exercise · Customize the dashboard
Change the dashboard title to “Mini Library” and add a “Catalog” section to the menu, below the Dashboard item.
Show the solution
public function configureDashboard(): Dashboard
{
return Dashboard::new()
->setTitle('Mini Library');
}
public function configureMenuItems(): iterable
{
yield MenuItem::linkToDashboard('Dashboard', 'fa fa-home');
yield MenuItem::section('Catalog');
}
MenuItem::section() adds a heading to the menu: handy to group the CRUDs we’re about to create (books, authors, categories).
What’s Next
We’ll replace the welcome page with our own dashboard template.
This is Chapter 5 of the Mini Library course. Follow along to build a complete Symfony 8 + EasyAdmin digital library application from scratch.