add-responder

Add a Custom Responder — Sylius Stack

Ask the user if not provided:

• The resource (ModelName) and the target operation.
• The responder class name. Default: {Purpose}Responder (e.g. ExportGridToXlsxResponder, BookPdfResponder).
• The format to return (file stream, PDF, XLSX, raw JSON with a specific structure, redirect, …). This drives the body.

If the user only needs a custom redirect after a Create/Update/Delete, do not create a responder — suggest the operation flags:

new Create(
    redirectToRoute: 'app_admin_author_show',
    redirectArguments: ['id' => 'resource.getAuthor().getId()'],
)

If the user only needs extra variables in the default Twig template, use /sylius-stack:add-twig-context instead.

---

1. Create the responder class

src/Responder/{ResponderName}.php

<?php

declare(strict_types=1);

namespace App\Responder;

use Sylius\Resource\Context\Context;
use Sylius\Resource\Metadata\Operation;
use Sylius\Resource\State\ResponderInterface;
use Symfony\Component\HttpFoundation\Response;

final readonly class {ResponderName} implements ResponderInterface
{
    public function __construct(
        // TODO: inject the services needed to build the response (renderer, http client, serializer…)
    ) {
    }

    public function respond(mixed $data, Operation $operation, Context $context): mixed
    {
        // TODO: transform $data into a Symfony Response and return it
        //       examples: new Response($body), new StreamedResponse(...), new BinaryFileResponse(...)
        return new Response();
    }
}

For a streaming / download response, follow this pattern (see also add-grid-export for a concrete CSV example):

use Symfony\Component\HttpFoundation\StreamedResponse;

$response = new StreamedResponse(function () use ($data) {
    // write bytes to php://output
});
$response->headers->set('Content-Type', 'application/pdf');
$response->headers->set('Content-Disposition', 'attachment; filename="export.pdf"');

return $response;