Chapter 3 code

bin/doctrine-fixtures

@@ -0,0 +1,38 @@
+#!/usr/bin/env php
+<?php
+
+declare(strict_types=1);
+
+use Doctrine\Common\DataFixtures\Executor\ORMExecutor;
+use Doctrine\Common\DataFixtures\Loader;
+use Doctrine\Common\DataFixtures\Purger\ORMPurger;
+use Doctrine\ORM\EntityManager;
+
+require_once 'vendor/autoload.php';
+
+$container = require 'config/container.php';
+
+$entityManager = $container->get(EntityManager::class);
+$config        = $container->get('config');
+
+// Get fixtures directory from config
+$fixturesPath = $config['doctrine']['fixtures'];
+
+if (! is_dir($fixturesPath)) {
+    echo "Fixtures directory not found: {$fixturesPath}\n";
+    exit(1);
+}
+
+// Load fixtures
+$loader = new Loader();
+$loader->loadFromDirectory($fixturesPath);
+
+// Execute fixtures
+$purger   = new ORMPurger();
+$executor = new ORMExecutor($entityManager, $purger);
+
+echo "Loading fixtures from: {$fixturesPath}\n";
+
+$executor->execute($loader->getFixtures());
+
+echo "Fixtures loaded successfully!\n";

composer.json

@@ -27,6 +27,8 @@
     },
     "require": {
         "php": "~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0",
+        "doctrine/data-fixtures": "^2.2",
+        "doctrine/doctrine-fixtures-bundle": "^4.3",
         "dotkernel/dot-cache": "^4.0",
         "ramsey/uuid": "^4.5.0",
         "ramsey/uuid-doctrine": "^2.1.0",

src/App/src/ConfigProvider.php

@@ -56,6 +56,7 @@
  *              class: class-string<MappingDriver>,
  *          },
  *      },
+ *     fixtures: non-empty-string,
  *      migrations: array{
  *          migrations_paths: array<non-empty-string, non-empty-string>,
  *          all_or_nothing: bool,
@@ -165,6 +166,7 @@ private function getDoctrineConfig(): array
                     'class' => MappingDriverChain::class,
                 ],
             ],
+            'fixtures'      => getcwd() . '/src/App/src/Fixture',
             'migrations'    => [
                 'table_storage' => [
                     'table_name'                 => 'doctrine_migration_versions',

src/App/src/Factory/BookHandlerFactory.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Light\App\Factory;
+
+use Light\Book\Handler\GetBooksHandler;
+use Light\Book\Repository\BookRepository;
+use Mezzio\Template\TemplateRendererInterface;
+use Psr\Container\ContainerExceptionInterface;
+use Psr\Container\ContainerInterface;
+use Psr\Container\NotFoundExceptionInterface;
+
+use function assert;
+
+class BookHandlerFactory
+{
+    /**
+     * @throws ContainerExceptionInterface
+     * @throws NotFoundExceptionInterface
+     */
+    public function __invoke(ContainerInterface $container, string $requestedName): GetBooksHandler
+    {
+        $repository = $container->get(BookRepository::class);
+        $template   = $container->get(TemplateRendererInterface::class);
+
+        assert($repository instanceof BookRepository);
+        assert($template instanceof TemplateRendererInterface);
+
+        return new GetBooksHandler($template, $repository);
+    }
+}

src/App/src/Factory/BookRepositoryFactory.php

@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Light\App\Factory;
+
+use Doctrine\ORM\EntityManager;
+use Light\Book\Entity\Book;
+use Light\Book\Repository\BookRepository;
+use Psr\Container\ContainerExceptionInterface;
+use Psr\Container\ContainerInterface;
+use Psr\Container\NotFoundExceptionInterface;
+
+use function assert;
+
+class BookRepositoryFactory
+{
+    /**
+     * @throws ContainerExceptionInterface
+     * @throws NotFoundExceptionInterface
+     */
+    public function __invoke(ContainerInterface $container): BookRepository
+    {
+        $entityManager = $container->get(EntityManager::class);
+
+        $repository = $entityManager->getRepository(Book::class);
+        assert($repository instanceof BookRepository);
+
+        return $repository;
+    }
+}

src/App/src/Fixture/BookLoader.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Light\App\Fixture;
+
+use Doctrine\Bundle\FixturesBundle\Fixture;
+use Doctrine\Persistence\ObjectManager;
+use Light\Book\Entity\Book;
+
+class BookLoader extends Fixture
+{
+    public function load(ObjectManager $manager): void
+    {
+        $book1 = new Book();
+        $book1->setTitle('A Game of Thrones');
+        $book1->setAuthor('George Martin');
+        $manager->persist($book1);
+
+        $book2 = new Book();
+        $book2->setTitle('The Lord of the Rings');
+        $book2->setAuthor('J.R.R. Tolkien');
+        $manager->persist($book2);
+
+        $book3 = new Book();
+        $book3->setTitle('Dune');
+        $book3->setAuthor('Frank Herbert');
+        $manager->persist($book3);
+
+        $manager->flush();
+    }
+}

src/App/templates/layout/default.html.twig

@@ -46,6 +46,7 @@
                                     <div class="dropdown-menu" aria-labelledby="pageDropdown">
                                         <a class="dropdown-item" href="{{ url('page::about') }}">About Us</a>
                                         <a class="dropdown-item" href="{{ url('page::who-we-are') }}">Who We Are</a>
+                                        <a class="dropdown-item" href="{{ url('books::list') }}">Books</a>
                                     </div>
                                 </li>
                                 <li class="nav-item">

src/Book/src/ConfigProvider.php

@@ -6,6 +6,11 @@
 
 use Doctrine\ORM\Mapping\Driver\AttributeDriver;
 use Doctrine\Persistence\Mapping\Driver\MappingDriver;
+use Light\App\Factory\BookHandlerFactory;
+use Light\App\Factory\BookRepositoryFactory;
+use Light\Book\Handler\GetBooksHandler;
+use Light\Book\Repository\BookRepository;
+use Mezzio\Application;
 
 /**
  * @phpstan-type ConfigType array{
@@ -23,6 +28,10 @@
  *          },
  *      },
  * }
+ * @phpstan-type DependenciesType array{
+ *       delegators: array<class-string, array<class-string>>,
+ *       factories: array<class-string, class-string>,
+ *  }
  */
 class ConfigProvider
 {
@@ -32,7 +41,27 @@ class ConfigProvider
     public function __invoke(): array
     {
         return [
-            'doctrine' => $this->getDoctrineConfig(),
+            'dependencies' => $this->getDependencies(),
+            'doctrine'     => $this->getDoctrineConfig(),
+            'templates'    => $this->getTemplates(),
+        ];
+    }
+
+    /**
+     * @return DependenciesType
+     */
+    private function getDependencies(): array
+    {
+        return [
+            'delegators' => [
+                Application::class => [
+                    RoutesDelegator::class,
+                ],
+            ],
+            'factories'  => [
+                GetBooksHandler::class => BookHandlerFactory::class,
+                BookRepository::class  => BookRepositoryFactory::class,
+            ],
         ];
     }
 
@@ -56,4 +85,18 @@ private function getDoctrineConfig(): array
             ],
         ];
     }
+
+    /**
+     * @return array{
+     *     paths: array{page: array{literal-string&non-falsy-string}}
+     * }
+     */
+    private function getTemplates(): array
+    {
+        return [
+            'paths' => [
+                'page' => [__DIR__ . '/../templates/page'],
+            ],
+        ];
+    }
 }

src/Book/src/Handler/GetBooksHandler.php

@@ -0,0 +1,34 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Light\Book\Handler;
+
+use Laminas\Diactoros\Response\HtmlResponse;
+use Light\Book\Repository\BookRepository;
+use Mezzio\Template\TemplateRendererInterface;
+use Psr\Http\Message\ResponseInterface;
+use Psr\Http\Message\ServerRequestInterface;
+use Psr\Http\Server\RequestHandlerInterface;
+
+class GetBooksHandler implements RequestHandlerInterface
+{
+    public function __construct(
+        protected TemplateRendererInterface $template,
+        protected BookRepository $bookRepository,
+    ) {
+    }
+
+    public function handle(ServerRequestInterface $request): ResponseInterface
+    {
+        $titles  = $this->bookRepository->getTitles();
+        $authors = $this->bookRepository->getAuthors();
+
+        return new HtmlResponse(
+            $this->template->render('page::books', [
+                'titles'  => $titles,
+                'authors' => $authors,
+            ])
+        );
+    }
+}

src/Book/src/Repository/BookRepository.php

@@ -5,10 +5,31 @@
 namespace Light\Book\Repository;
 
 use Light\App\Repository\AbstractRepository;
+use Light\Book\Entity\Book;
 
 class BookRepository extends AbstractRepository
 {
     /**
-     * Any other custom methods can be added here
+     * @return array<int, array{id: non-empty-string, title: string}>
      */
+    public function getTitles(): array
+    {
+        $qb = $this->getQueryBuilder()
+            ->select('book.id, book.title')
+            ->from(Book::class, 'book');
+
+        return $qb->getQuery()->getResult();
+    }
+
+    /**
+     * @return array<int, array{id: non-empty-string, author: string}>
+     */
+    public function getAuthors(): array
+    {
+        $qb = $this->getQueryBuilder()
+            ->select('book.id, book.author')
+            ->from(Book::class, 'book');
+
+        return $qb->getQuery()->getResult();
+    }
 }

src/Book/src/RoutesDelegator.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Light\Book;
+
+use Light\Book\Handler\GetBooksHandler;
+use Mezzio\Application;
+use Psr\Container\ContainerInterface;
+
+use function assert;
+
+class RoutesDelegator
+{
+    public function __invoke(ContainerInterface $container, string $serviceName, callable $callback): Application
+    {
+        $app = $callback();
+        assert($app instanceof Application);
+
+        $app->get('/books', [GetBooksHandler::class], 'books::list');
+
+        return $app;
+    }
+}