POST Endpoint for Entity Creation

API Resource

src/ApiResource/Admin/BookDto.php

use ApiPlatform\Metadata\ApiResource;
use ApiPlatform\Metadata\Post;
use ApiPlatform\Metadata\Put;
use App\ApiInput\BookInputDto;
use App\ApiState\Admin\Book\BookCreateProcessor;

#[ApiResource(
    shortName: 'Admin/Book',
    routePrefix: '/admin',
    operations: [
        // ...
        new Post(
            uriTemplate: '/books',
            input: BookInputDto::class,
            processor: BookCreateProcessor::class
        ),
        // ...
    ]
)]
class BookDto
{
    // ...
}

Input DTO

src/ApiInput/BookInputDto.php

namespace App\ApiInput;

class BookInputDto
{
    public string $title;
    public string $description;
}

State Processor

src/ApiState/Book/BookCreateProcessor.php

use ApiPlatform\Metadata\Operation;
use Doctrine\ORM\EntityManagerInterface;
use App\ApiInput\BookInputDto;
use App\ApiResource\BookDto;
use App\Entity\Book;
use App\Repository\BookRepository;
use Rekalogika\ApiLite\State\AbstractProcessor;

/**
 * @extends AbstractProcessor<BookInputDto,BookDto>
 */
class BookCreateProcessor extends AbstractProcessor
{
    public function __construct(
        private EntityManagerInterface $entityManager,
        private BookRepository $bookRepository
    ) {
    }

    public function process(
        mixed $data,
        Operation $operation,
        array $uriVariables = [],
        array $context = []
    ) {
        // Check for authorization
        $this->denyAccessUnlessGranted('add', $this->bookRepository);

        // Map the input DTO to the Book entity. In more complex scenarios,
        // using the mapper can be impractical, and you need to do it according
        // to the requirement of your domain logic.
        $book = $this->map($data, Book::class);

        // Persist the entity and flush the changes
        $this->entityManager->persist($book);
        $this->entityManager->flush();

        // Map the resulting Book to the output DTO, and return it.
        return $this->map($book, BookDto::class);
    }
}