{"id":360646,"date":"2024-05-21T00:57:18","date_gmt":"2024-05-21T00:57:18","guid":{"rendered":"http:\/\/savepearlharbor.com\/?p=360646"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T21:00:00","slug":"","status":"publish","type":"post","link":"https:\/\/savepearlharbor.com\/?p=360646","title":{"rendered":"\u0422\u0438\u043f\u0438\u0447\u043d\u044b\u0439 Swagger \u0431\u0435\u0437 \u0433\u043c\u043e<\/span>"},"content":{"rendered":"
<\/div>\n
\n
\n
\n
\n

\u041a\u0442\u043e \u0438\u0437 \u043d\u0430\u0441 \u043d\u0435 \u0431\u044b\u043b \u043e\u0434\u0443\u0440\u043c\u0430\u043d\u0435\u043d \u0441\u043a\u0430\u0437\u043a\u0430\u043c\u0438 \u043f\u0440\u043e \u0441\u0432\u0430\u0433\u0435\u0440? \u041c\u043e\u043b, \u0434\u043e\u0431\u0430\u0432\u044c \u044d\u0442\u0443 \u0432\u043e\u043b\u0448\u0435\u0431\u043d\u0443\u044e \u0448\u0442\u0443\u043a\u0443 \u2014 \u0434\u0430 \u0437\u0430\u0436\u0438\u0432\u0435\u0448\u044c! \u041d\u043e \u043f\u043b\u0430\u0442\u0430 \u0437\u0430 \u043c\u0430\u0433\u0438\u044e \u2014 \u0437\u0435\u043b\u0435\u043d\u043e\u0435 \u0431\u043e\u043b\u043e\u0442\u043e \u043d\u043e\u0442\u0430\u0446\u0438\u0439. \u0410 \u043d\u0435\u043b\u044c\u0437\u044f \u043b\u0438 \u043e\u0431\u043e\u0439\u0442\u0438\u0441\u044c \u0442\u043e\u043b\u044c\u043a\u043e \u0442\u0438\u043f\u0438\u0437\u0430\u0446\u0438\u0435\u0439 \u0441\u0430\u043c\u043e\u0433\u043e php? (\u0421\u043f\u043e\u0439\u043b\u0435\u0440: \u043e\u043d\u0436\u043e\u043c)<\/p>\n\n

\u0426\u0435\u043b\u044c \u2014 \u043f\u0440\u0435\u0432\u0440\u0430\u0442\u0438\u0442\u044c \u044d\u0442\u043e\u0442 \u0441\u0438\u043c\u043f\u0430\u0442\u0438\u0447\u043d\u044b\u0439 Symfony \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440<\/p>\n

<?php  declare(strict_types=1); \/\/ ... class LoginController extends AbstractController {     #[Route('\/api\/login', methods: ['POST'])]     #[Tag(name: 'login')]     public function __invoke(         LoginRequest $request,         LoginService $service,         UserResponse $response     ): UserResponse     {         $user = $service->login($request);          return $response->with($user);     } }<\/code><\/pre>\n
\u0412 \u0442\u0430\u043a\u0443\u044e \u0434\u043e \u0431\u043e\u043b\u0438 \u0437\u043d\u0430\u043a\u043e\u043c\u0443\u044e \u0448\u0442\u0443\u043a\u0443<\/p>\n
\n\u041e\u0441\u0442\u043e\u0440\u043e\u0436\u043d\u043e! Swagger \u043f\u043e\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u0442 OpenApi \u0431\u0435\u0437 \u043f\u0440\u0438\u043a\u0440\u0430\u0441<\/summary>\n
\n
\"\u041d\u0435<\/p>\n
\u041d\u0435 \u0441\u0430\u043c\u0430\u044f \u0433\u043e\u0432\u043e\u0440\u043b\u0438\u0432\u0430\u044f, \u0437\u0430\u0442\u043e \u043f\u0440\u0430\u0432\u0434\u0438\u0432\u0430 \u0438 \u043d\u0435\u0437\u0430\u0442\u0440\u0430\u0442\u043d\u0430<\/figcaption><\/div>\n<\/figure>\n<\/div>\n<\/details>\n
\u0422\u043e \u0435\u0441\u0442\u044c \u0441\u043d\u0430\u0447\u0430\u043b\u0430 \u0442\u0438\u043f\u0438\u0437\u0438\u0440\u0443\u0435\u043c \u0432\u0445\u043e\u0434\u043d\u044b\u0435\/\u0432\u044b\u0445\u043e\u0434\u043d\u044b\u0435 \u0434\u0430\u043d\u043d\u044b\u0435, \u0430 \u0437\u0430\u0442\u0435\u043c \u043f\u0440\u0435\u0432\u0440\u0430\u0442\u0438\u043c \u0442\u0438\u043f\u044b \u0432 \u043d\u043e\u0442\u0430\u0446\u0438\u0438. \u0412 \u043f\u0443\u0442\u044c!<\/p>\n
\u0428\u0430\u0433 1. \u0422\u0438\u043f\u0438\u0437\u0430\u0446\u0438\u044f \u0437\u0430\u043f\u0440\u043e\u0441\u0430<\/h2>\n
\u0427\u0442\u043e\u0431\u044b \u0432 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440 \u0432\u043c\u0435\u0441\u0442\u043e \u0431\u0430\u0437\u043e\u0432\u043e\u0433\u043e Request<\/code> \u043e\u0431\u044a\u0435\u043a\u0442\u0430 \u043f\u0435\u0440\u0435\u0434\u0430\u0432\u0430\u043b\u0441\u044f \u0434\u0442\u043e, \u0432\u043e\u0437\u044c\u043c\u0435\u043c \u0433\u043e\u0442\u043e\u0432\u0443\u044e \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0443 prugala\/symfony-request-dto<\/a>. \u0422\u0430\u043c \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f \u043c\u0435\u0445\u0430\u043d\u0438\u0437\u043c ValueResolver<\/a>, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043f\u043e\u0442\u043e\u043c \u043c\u043e\u0436\u043d\u043e, \u043d\u0435 \u0441\u0442\u0435\u0441\u043d\u044f\u044f\u0441\u044c, \u043f\u0435\u0440\u0435\u0434\u0435\u043b\u0430\u0442\u044c \u043f\u043e\u0434 \u0441\u0435\u0431\u044f.<\/p>\n
<?php  declare(strict_types=1);  class LoginRequest implements RequestDtoInterface {     #[NotBlank]     #[Email]     public string $login;      #[NotBlank]     public string $password; }<\/code><\/pre>\n
\u0414\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0435 \u0443\u0441\u043b\u043e\u0432\u0438\u044f \u043d\u0430\u0434 \u043f\u043e\u043b\u044f\u043c\u0438 \u2014 \u043f\u0440\u0438\u044f\u0442\u043d\u044b\u0439 \u0431\u043e\u043d\u0443\u0441, \u043d\u043e \u043d\u0435 \u0441\u0442\u043e\u0438\u0442 \u044d\u0442\u0438\u043c \u0441\u0438\u043b\u044c\u043d\u043e \u0443\u0432\u043b\u0435\u043a\u0430\u0442\u044c\u0441\u044f. \u0417\u0434\u0435\u0441\u044c \u0443\u043c\u0435\u0441\u0442\u043d\u0430 \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u0442\u0438\u043f\u043e\u0432, \u043d\u043e \u043d\u0435 \u0434\u0430\u043d\u043d\u044b\u0445.<\/p>\n
\u041e\u0442\u043b\u0438\u0447\u043d\u043e, \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u043c \u0434\u0430\u043b\u044c\u0448\u0435<\/em> \u00a9<\/p>\n
\u0428\u0430\u0433 2. \u0422\u0438\u043f\u0438\u0437\u0430\u0446\u0438\u044f \u043e\u0442\u0432\u0435\u0442\u0430<\/h2>\n
Symfony \u0431\u0443\u0445\u0442\u0438\u0442, \u043a\u043e\u0433\u0434\u0430 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u043d\u0435 Response \u043e\u0431\u044a\u0435\u043a\u0442. \u041a\u043e\u043d\u0435\u0447\u043d\u0430\u044f? \u041a \u0441\u0447\u0430\u0441\u0442\u044c\u044e, \u0440\u0430\u0437\u0440\u0443\u043b\u0438\u0442\u044c \u0441\u0438\u0442\u0443\u0430\u0446\u0438\u044e \u043c\u043e\u0436\u043d\u043e, \u0435\u0441\u043b\u0438 \u0437\u0430\u0430\u0431\u0443\u0437\u0438\u0442\u044c \u0441\u043e\u0431\u044b\u0442\u0438\u0435 kernel.view<\/code>:<\/p>\n
\n\u0420\u0435\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044f<\/summary>\n
\n
services:     App\\Listener\\ResponseListener:         tags:             - { name: kernel.event_listener, event: kernel.view}<\/code><\/pre>\n
<?php  declare(strict_types=1);  namespace App\\Listener;  use App\\Dto\\ResponseJsonInterface; use Symfony\\Component\\HttpFoundation\\JsonResponse; use Symfony\\Component\\HttpKernel\\Event\\ViewEvent; use Symfony\\Component\\Serializer\\SerializerInterface;  class ResponseListener {     public function __construct(         private readonly SerializerInterface $serializer,     ) {     }      public function __invoke(ViewEvent $event): void     {         $response = $event->getControllerResult();          if (!($response instanceof ResponseJsonInterface)) {             return;         }                  $jsonResponse = $this->json($response);          $event->setResponse($jsonResponse);     }      protected function json(mixed $data, int $status = 200, array $headers = [], array $context = []): JsonResponse     {         $json = $this->serializer->serialize($data, 'json', array_merge([             'json_encode_options' => JsonResponse::DEFAULT_ENCODING_OPTIONS                 | JSON_UNESCAPED_UNICODE                 | JSON_UNESCAPED_SLASHES                 | JSON_PRETTY_PRINT,         ], $context));          return new JsonResponse($json, $status, $headers, true);     } } <\/code><\/pre>\n<\/p>\n<\/div>\n<\/details>\n
\u0411\u043b\u0430\u0433\u043e\u0434\u0430\u0440\u044f \u044d\u0442\u043e\u043c\u0443 \u043c\u043e\u0436\u043d\u043e \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0442\u044c \u043e\u0431\u044b\u0447\u043d\u044b\u0439 \u0434\u0442\u043e, \u0430 \u0432\u043e\u0442, \u043a\u0441\u0442\u0430\u0442\u0438, \u0438 \u043e\u043d:<\/p>\n
<?php  declare(strict_types=1);  class UserResponse implements ResponseJsonInterface {     public int $id;     public string $email;     public int $special;      public function __construct(private readonly SpecialService $specialService)     {     }      public function with(User $user): self     {         $this->id = $user->id();         $this->email = $user->email();         $this->special = $this->specialService->special($user);          return $this;     } }<\/code><\/pre>\n
\u0422\u0435\u043f\u0435\u0440\u044c \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440 \u043d\u0435 \u043d\u0430 \u0441\u043b\u043e\u0432\u0430\u0445, \u0430 \u043d\u0430 \u0434\u0435\u043b\u0435 \u0441\u043e\u0431\u043b\u044e\u0434\u0430\u0435\u0442 \u0437\u0430\u044f\u0432\u043b\u0435\u043d\u043d\u044b\u0435 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u044b! (\u0437\u0432\u0443\u0447\u0438\u0442, \u0434\u0430?)<\/p>\n
\u0428\u0430\u0433 3. \u0417\u0430\u0432\u043e\u0434\u0438\u043c \u0441\u0432\u0430\u0433\u0435\u0440<\/h2>\n
\u0414\u043b\u044f \u044d\u0442\u043e\u0433\u043e \u0432\u043e\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c\u0441\u044f \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u043e\u0439 nelmio\/NelmioApiDocBundle<\/a>. \u0412 \u043d\u0435\u0439 \u0443\u0436\u0435 \u0438\u0437 \u043a\u043e\u0440\u043e\u0431\u043a\u0438 \u0435\u0441\u0442\u044c \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u044c \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u043a\u043b\u0430\u0441\u0441\u044b \u0434\u043b\u044f \u043d\u043e\u0442\u0430\u0446\u0438\u0439:<\/p>\n
<?php  #[Route('\/api\/login', methods: ['POST'])] #[RequestBody(content: new Model(type: LoginRequest::class))] #[Response(response: 200, content: new Model(type: UserResponse::class))] #[Tag(name: 'login')] public function __invoke(         LoginRequest $request,         LoginService $service,         UserResponse $response ): UserResponse { \/\/... }<\/code><\/pre>\n
\u0412\u0440\u043e\u0434\u0435 \u0431\u044b \u043f\u043e\u0447\u0442\u0438 \u0442\u043e, \u0447\u0442\u043e \u043d\u0430\u0434\u043e! \u041d\u043e \u0434\u0443\u0431\u043b\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435 \u0432\u0441\u0435 \u0440\u0430\u0432\u043d\u043e \u043e\u0441\u0442\u0430\u0435\u0442\u0441\u044f \ud83d\ude41<\/p>\n
\u0415\u0441\u043b\u0438 \u0438\u0437\u043c\u0435\u043d\u0438\u0442\u044c \u0441\u0438\u0433\u043d\u0430\u0442\u0443\u0440\u0443 \u043c\u0435\u0442\u043e\u0434\u0430 \u0438 \u043d\u0435 \u043e\u0431\u043d\u043e\u0432\u0438\u0442\u044c \u043d\u043e\u0442\u0430\u0446\u0438\u0438, \u0442\u043e.. \u043d\u0438\u043a\u0430\u043a\u043e\u0439 \u043e\u0448\u0438\u0431\u043a\u0438 \u043d\u0435 \u0432\u043e\u0437\u043d\u0438\u043a\u043d\u0435\u0442, \u0438 \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u043d\u0435\u0430\u043a\u0442\u0443\u0430\u043b\u044c\u043d\u0430\u044f<\/em> \u0434\u043e\u043a\u0430. \u041d\u0435\u043d\u0430\u0432\u044f\u0437\u0447\u0438\u0432\u0430\u044f \u043f\u043e\u043f\u044b\u0442\u043a\u0430<\/a> \u043f\u043e\u0434\u0442\u043e\u043b\u043a\u043d\u0443\u0442\u044c \u0430\u0432\u0442\u043e\u0440\u0430 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0438 \u043a \u0434\u043e\u0431\u0430\u0432\u043b\u0435\u043d\u0438\u044e \u043e\u0431\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0430 \u0442\u0438\u043f\u043e\u0432 \u043e\u0441\u0442\u0430\u043b\u0430\u0441\u044c \u0431\u0435\u0437\u043e\u0442\u0432\u0435\u0442\u043d\u043e\u0439.<\/p>\n
\u0428\u0430\u0433 4. \u041a\u0430\u0441\u0442\u043e\u043c<\/h2>\n
\u0420\u0430\u0441\u0448\u0438\u0440\u0438\u043c NelmioApiDocBundle \u0441 \u043f\u043e\u043c\u043e\u0449\u044c\u044e vodevel\/api-doc-bundle-type-describer<\/a>. \u042d\u0442\u043e\u0442 \u0431\u0430\u043d\u0434\u043b \u0445\u043e\u0442\u044c \u0438 \u043f\u0440\u0438\u043c\u0438\u0442\u0438\u0432\u0435\u043d, \u043d\u043e \u0434\u0435\u043b\u0430\u0435\u0442 \u0447\u0442\u043e \u0434\u043e\u0301\u043b\u0436\u043d\u043e:<\/p>\n
<?php  #[Route('\/api\/login', methods: ['POST'])] #[Tag(name: 'login')] public function __invoke(   LoginRequest $request,    LoginService $service,   UserResponse $response ): UserResponse  {   \/\/ ...   }   use OpenApi\\Attributes\\RequestBody;  #[RequestBody] class LoginRequest implements RequestDtoInterface {   \/\/ ...   }   use OpenApi\\Attributes\\Response;  #[Response] class UserResponse implements ResponseJsonInterface {    \/\/ ...  }<\/code><\/pre>\n
\u0423 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u0430 \u0432\u0441\u0435 \u0435\u0449\u0435 \u043e\u0441\u0442\u0430\u043b\u0430\u0441\u044c \u043d\u043e\u0442\u0430\u0446\u0438\u044f #[Tag]<\/code>, \u0431\u0435\u0437 \u043a\u043e\u0442\u043e\u0440\u043e\u0439 \u043e\u043d \u043f\u0440\u043e\u0441\u0442\u043e \u043d\u0435 \u0431\u0443\u0434\u0435\u0442 \u0437\u0430\u043c\u0435\u0447\u0435\u043d \u0438 \u043e\u0431\u0440\u0430\u0431\u043e\u0442\u0430\u043d. \u0410 \u0443 \u0434\u0442\u043e \u043f\u043e\u044f\u0432\u0438\u043b\u0438\u0441\u044c \u0430\u0442\u0440\u0438\u0431\u0443\u0442\u044b #[RequestBody]<\/code>, #[Response]<\/code>. \u041d\u043e \u0434\u0443\u0431\u043b\u0438\u0440\u0443\u044e\u0449\u0438\u0445 \u043d\u043e\u0442\u0430\u0446\u0438\u0439 \u043d\u0435\u0442. \u0422\u043e\u0447\u043d\u043e \u043d\u0435\u0442? \u0414\u0430 \u0433\u043e\u0432\u043e\u0440\u044e \u0436\u0435!<\/p>\n
\u0428\u0430\u0433 5. \u0421\u0442\u0440\u0430\u0448\u043d\u043e, \u0432\u044b\u0440\u0443\u0431\u0430\u0439<\/h2>\n
\u0425\u043e\u0442\u0438\u0442\u0435 \u043f\u043e\u043f\u0440\u043e\u0431\u043e\u0432\u0430\u0442\u044c, \u043d\u043e \u0431\u043e\u0438\u0442\u0435\u0441\u044c \u043f\u0440\u0435\u0432\u0440\u0430\u0442\u0438\u0442\u044c \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u0432 \u0442\u044b\u043a\u0432\u0443? \u042f \u0442\u043e\u0436\u0435. \u041f\u043e\u044d\u0442\u043e\u043c\u0443 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0430 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u043a\u0440\u0430\u0439\u043d\u0435 \u0434\u0435\u043b\u0438\u043a\u0430\u0442\u043d\u043e<\/em>. \u041c\u0435\u0442\u043e\u0434\u044b \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u043e\u0432, \u0443 \u043a\u043e\u0442\u043e\u0440\u044b\u0445 \u0443\u0436\u0435 \u0435\u0441\u0442\u044c \u043d\u043e\u0442\u0430\u0446\u0438\u0438, \u043d\u0435 \u0437\u0430\u0442\u0440\u043e\u043d\u0435\u0442.<\/p>\n
\u041a\u0441\u0442\u0430\u0442\u0438, \u0435\u0441\u043b\u0438 \u0432 \u0434\u0442\u043e \u0438\u043c\u044f \u043f\u043e\u043b\u044f \u043d\u0435\u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e \u0433\u043e\u0432\u043e\u0440\u044f\u0449\u0435\u0435, \u0442\u043e \u043c\u043e\u0436\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c Property:<\/p>\n
<?php  #[RequestBody] class LoginRequest implements RequestDtoInterface {     #[Property(description: \"It\u2019s an email, dude!\", example: 'test@test.test')]     #[NotBlank]     #[Email]     public string $login;<\/code><\/pre>\n
Professional!<\/p>\n
[\u0418\u0437 \u043d\u0435\u0432\u043e\u0448\u0435\u0434\u0448\u0435\u0433\u043e]<\/h2>\n
\n\u041a\u0430\u043a \u0437\u0430\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0441\u043f\u0438\u0441\u043e\u043a \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u044b\u0445 \u043e\u0442\u0432\u0435\u0442\u043e\u0432, \u0430 \u043d\u0435 \u0442\u043e\u043b\u044c\u043a\u043e \u043e\u0434\u0438\u043d \u0443\u0441\u043f\u0435\u0448\u043d\u044b\u0439?<\/summary>\n
\n
\u041f\u043e\u0434\u043b\u043e\u0432\u0438\u043b\u0438! \u0422\u0430\u043a\u043e\u0439 \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u0438 \u043d\u0435\u0442 (\u043d\u0443, \u043a\u0440\u043e\u043c\u0435 \u043a\u0430\u043a \u0432\u0440\u0443\u0447\u043d\u0443\u044e \u0440\u0430\u0441\u043f\u0438\u0441\u0430\u0442\u044c). \u0414\u043b\u044f \u0438\u0441\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u0439 \u043c\u043e\u0436\u043d\u043e \u0431\u044b\u043b\u043e \u0431\u044b \u0435\u0449\u0435 \u0447\u0442\u043e-\u0442\u043e \u043f\u0440\u0438\u0434\u0443\u043c\u0430\u0442\u044c (\u0430\u043d\u043d\u043e\u0442\u0430\u0446\u0438\u0438 \u0441 \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u043e\u0439 \u0447\u0435\u0440\u0435\u0437 \u0441\u043d\u0438\u0444\u0435\u0440, \u0438\u043b\u0438 \u0430\u043d\u0430\u043b\u0438\u0437 AST). \u041d\u043e \u043d\u0435 \u043d\u0430\u0441\u0442\u043e\u043b\u044c\u043a\u043e \u044f \u043b\u044e\u0431\u043b\u044e \u0441\u043f\u0438\u0441\u043e\u043a \u043e\u0442\u0432\u0435\u0442\u043e\u0432. \u0410 \u0432\u044b?<\/p>\n<\/div>\n<\/details>\n
\n\u041f\u043e\u0447\u0435\u043c\u0443 \u0434\u043b\u044f \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u044f \u0434\u0442\u043e \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f \u0438 \u0438\u043d\u0442\u0435\u0440\u0444\u0435\u0439\u0441\u044b, \u0438 \u0430\u0442\u0440\u0438\u0431\u0443\u0442\u044b?<\/summary>\n
\n
\u0427\u0442\u043e\u0431\u044b \u043f\u043e\u0434\u0447\u0435\u0440\u043a\u043d\u0443\u0442\u044c \u0438\u0445 \u043d\u0435\u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u044c, \u0432\u0435\u0434\u044c \u044d\u0442\u043e \u0434\u0432\u0435 \u0440\u0430\u0437\u043d\u044b\u0435 \u043e\u0442\u0432\u0435\u0442\u0441\u0442\u0432\u0435\u043d\u043d\u043e\u0441\u0442\u0438 \u0442\u0430\u043a \u0442\u043e. \u041c\u043e\u0436\u043d\u043e \u0434\u043e\u0431\u0438\u0442\u044c\u0441\u044f \u0438\u0445 \u043e\u0434\u043d\u043e\u043e\u0431\u0440\u0430\u0437\u0438\u044f, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u043c\u0435\u0445\u0430\u043d\u0438\u0437\u043c \u0430\u0442\u0440\u0438\u0431\u0443\u0442\u043e\u0432, \u043d\u043e \u0438\u0445 \u043d\u0435 \u0442\u0430\u043a \u0443\u0434\u043e\u0431\u043d\u043e \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0442\u044c, \u043a\u0430\u043a \u0438\u043d\u0442\u0435\u0440\u0444\u0435\u0439\u0441\u044b. \u0410 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u0442\u043e\u043b\u044c\u043a\u043e \u0438\u043d\u0442\u0435\u0440\u0444\u0435\u0439\u0441\u044b \u043d\u0435 \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u0441\u044f, \u0442\u0430\u043a \u043a\u0430\u043a \u0434\u043b\u044f \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u043f\u043e\u0440\u043e\u0439 \u043d\u0443\u0436\u043d\u0430 \u043d\u0430\u0447\u0438\u043d\u043a\u0430.<\/p>\n<\/div>\n<\/details>\n
\n\u041f\u0435\u0440\u0435\u0447\u0438\u0441\u043b\u044f\u0442\u044c Response \u043e\u0431\u044a\u0435\u043a\u0442 \u0432 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430\u0445 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u0430 \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u043e?<\/summary>\n
\n
\u0413\u043b\u0430\u0432\u043d\u044b\u043c \u043e\u0431\u0440\u0430\u0437\u043e\u043c \u044d\u0442\u043e \u0441\u0434\u0435\u043b\u0430\u043d\u043e \u0434\u043b\u044f \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0438 DI. \u0415\u0441\u043b\u0438 \u0445\u043e\u0442\u0438\u0442\u0435 \u0438\u043c\u043c\u0443\u0442\u0430\u0431\u0435\u043b\u044c\u043d\u044b\u0439 \u043e\u0431\u044a\u0435\u043a\u0442, \u0442\u043e \u043c\u043e\u0436\u043d\u043e \u0438 \u0442\u0430\u043a:<\/p>\n
<?php  public function __invoke(   LoginRequest $request,    LoginService $service,    SpecialService $specialService ): UserResponse {    $user = $service->login($request);     return new UserResponse($specialService, $user); }<\/code><\/pre>\n<\/p>\n<\/div>\n<\/details>\n
\n\u0410 \u0435\u0441\u043b\u0438 \u043d\u0430\u0434\u043e \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0442\u044c \u043d\u0435 \u043e\u0431\u044a\u0435\u043a\u0442, \u0430 \u0441\u043f\u0438\u0441\u043e\u043a \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u0432, \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u0441\u043f\u0438\u0441\u043e\u043a \u044e\u0437\u0435\u0440\u043e\u0432?<\/summary>\n
\n
\u0416\u0438\u0437\u043d\u044c \u043f\u043e\u043a\u0430\u0437\u0430\u043b\u0430, \u0447\u0442\u043e \u0433\u043e\u043b\u044b\u0435 \u0441\u043f\u0438\u0441\u043a\u0438 — \u0442\u0430\u043a\u043e\u0435 \u0441\u0435\u0431\u0435. \u0420\u0430\u043d\u043e \u0438\u043b\u0438 \u043f\u043e\u0437\u0434\u043d\u043e, \u043d\u043e \u043f\u043e\u044f\u0432\u044f\u0442\u0441\u044f \u043c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u0435 (\u043f\u0430\u0433\u0438\u043d\u0430\u0446\u0438\u044f, \u0430\u0433\u0440\u0435\u0433\u0430\u0446\u0438\u044f, \u0434\u043b\u044f \u043e\u0442\u043b\u0430\u0434\u043a\u0438 \u0434\u043e\u043f.\u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044f). \u041f\u043e\u044d\u0442\u043e\u043c\u0443 \u0434\u043b\u044f \u0441\u043f\u0438\u0441\u043a\u0430 \u0442\u043e\u0436\u0435 \u043b\u0443\u0447\u0448\u0435 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u043e\u0431\u044a\u0435\u043a\u0442 \u0441 \u043a\u043b\u044e\u0447\u043e\u043c «data» («items», «collection», «list»). <\/p>\n
\u041d\u043e \u0435\u0441\u043b\u0438 \u0432\u043e\u043f\u0440\u043e\u0441 \u0441\u0442\u043e\u0438\u0442 \u0440\u0435\u0431\u0440\u043e\u043c (\u0430\u043f\u0438 \u0443\u0436\u0435 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u0435\u0442), \u0442\u043e \u0432\u043e\u0442:<\/p>\n
<?php  class UserListController extends BaseController {     #[Route('user\/list', methods: ['GET'])]     #[Tag(name: 'user')]     public function __invoke(       UserListRequest $request,        UserListService $userListService,       SpecialService $specialService     ): UserListResponse     {         $users = $userListService->userList($request);          return UserListResponse::new($users, $specialService);     } }   #[Response] #[Schema(type: 'array', items: new Items(ref: new Model(type: UserResponse::class)))] class UserListResponse extends ArrayIterator implements ResponseJsonInterface {     public static function new(array $users, SpecialService $specialService)     {         $data = [];         foreach ($users as $user) {             $userResponse = new UserResponse($specialService);             $data[] = $userResponse->with($user);         }          return new UserListResponse($data);     } } <\/code><\/pre>\n<\/p>\n<\/div>\n<\/details>\n
\n\u0415\u0441\u043b\u0438 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u044b \u0442\u0430\u043a\u0438\u0435 \u0442\u043e\u043d\u043a\u0438\u0435, \u043c\u043e\u0436\u0435\u0442 \u0432\u043b\u043e\u0436\u0438\u0442\u044c\u0441\u044f \u0432 \u0441\u043e\u0437\u0434\u0430\u043d\u0438\u0435 \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u0438, \u0432\u043c\u0435\u0441\u0442\u043e \u0441\u043e\u0437\u0434\u0430\u043d\u0438\u044f \u043a\u043b\u0430\u0441\u0441\u043e\u0432?<\/summary>\n
\n
\u041c\u043e\u0436\u043d\u043e \u043e\u043f\u0438\u0441\u0430\u0442\u044c \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440 \u0434\u0435\u043a\u043b\u0430\u0440\u0430\u0442\u0438\u0432\u043d\u043e, \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u0447\u0435\u0440\u0435\u0437 yaml:<\/p>\n
api\/login:    method: POST    request: LoginRequest    service: LoginService    response: UserResponse<\/code><\/pre>\n
\u041d\u0443, \u0438\u043b\u0438 \u0435\u0449\u0435 \u0447\u0443\u0442\u044c \u0431\u043e\u043b\u0435\u0435 \u0433\u0438\u0431\u043a\u0443\u044e \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0443, \u0430 \u043f\u043e\u0442\u043e\u043c \u0441\u043a\u0430\u0440\u043c\u043b\u0438\u0432\u0430\u0442\u044c \u0435\u0435 \u0448\u0430\u0431\u043b\u043e\u043d\u043d\u043e\u043c\u0443 \u043c\u0435\u0442\u043e\u0434\u0443. \u041d\u043e \u0437\u0430\u0447\u0435\u043c? (\u0430\u0433\u0430, \u0441\u0430\u043c \u043f\u0440\u0438\u0434\u0443\u043c\u0430\u043b \u0443\u043f\u043e\u0440\u043e\u0442\u044b\u0439 \u0432\u043e\u043f\u0440\u043e\u0441 \u0438 \u043d\u0435 \u0437\u043d\u0430\u0435\u0442 \u0437\u0430\u0447\u0435\u043c). \u0427\u0442\u043e\u0431\u044b \u0433\u0430\u0440\u0430\u043d\u0442\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0441\u043e\u0431\u043b\u044e\u0434\u0435\u043d\u0438\u044f \u0430\u0440\u0445\u0438\u0442\u0435\u043a\u0442\u0443\u0440\u044b \u0442\u043e\u043d\u043a\u0438\u0445 \u0434\u043e \u043f\u0440\u043e\u0437\u0440\u0430\u0447\u043d\u043e\u0441\u0442\u0438 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u043e\u0432? \u041e\u043f\u0442\u0438\u043c\u0438\u0437\u0430\u0446\u0438\u044f? \u0414\u0430 \u043d\u0435, \u0432\u0441\u0435 \u044d\u0442\u043e \u0448\u043b\u044f\u043f\u0430. \u041a\u043e\u0434 \u043a\u0443\u0434\u0430 \u043b\u0443\u0447\u0448\u0435, \u0447\u0435\u043c \u043a\u043e\u043d\u0444\u0438\u0433.<\/p>\n<\/div>\n<\/details>\n
\n\u041c\u043e\u0436\u043d\u043e \u043b\u0438 \u0432 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u0435 \u043e\u0434\u043d\u043e\u0432\u0440\u0435\u043c\u0435\u043d\u043d\u043e \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u0438\u0437 \u0440\u043e\u0443\u0442\u0430 \u0438 \u0434\u0442\u043e, \u0432\u043b\u043e\u0436\u0435\u043d\u043d\u044b\u0435 \u0434\u0442\u043e, \u0437\u0430\u043f\u0440\u043e\u0441\u044b \u0441 \u0440\u0430\u0437\u043d\u044b\u043c\u0438 Content-type?<\/summary>\n
\n
\u0414\u0430:<\/p>\n
<?php  #[Route('\/api\/post\/{id}\/like', methods: ['POST'])] #[Tag(name: 'post')] public function __invoke(int id, LikeRequest $likeRequest, ...<\/code><\/pre>\n
\u041c\u043e\u0436\u043d\u043e \u0434\u0430\u0436\u0435 \u043f\u043e\u0434\u043a\u0440\u0443\u0442\u0438\u0442\u044c ValueResolver, \u0447\u0442\u043e\u0431\u044b \u043e\u043d \u043f\u0440\u043e\u0442\u0430\u043b\u043a\u0438\u0432\u0430\u043b \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u0438\u0437 \u0440\u043e\u0443\u0442\u0430 \u0432\u043d\u0443\u0442\u0440\u044c \u0434\u0442\u043e. \u0410 \u0435\u0449\u0435 \u043f\u043e\u0434\u043e\u0431\u0440\u0430\u0442\u044c \u043d\u0443\u0436\u043d\u044b\u0439 \u043d\u0430\u0431\u043e\u0440 \u0441\u0435\u0440\u0438\u0430\u043b\u0438\u0437\u0430\u0442\u043e\u0440\u043e\u0432, \u043d\u043e\u0440\u043c\u0430\u043b\u0430\u0439\u0437\u0435\u0440\u043e\u0432, \u044d\u043a\u0441\u0442\u0440\u0430\u043a\u0442\u043e\u0440\u043e\u0432 \u0438 \u0434\u0440\u0443\u0433\u0438\u0445 \u0447\u0430\u0441\u0442\u043e \u0443\u043f\u043e\u043c\u0438\u043d\u0430\u0435\u043c\u044b\u0445 \u0441 \u044d\u0442\u0438\u043c \u043c\u0435\u0445\u0430\u043d\u0438\u0437\u043c\u043e\u043c \u0441\u043b\u043e\u0432. \u0422\u0435\u0445\u043d\u0438\u0447\u0435\u0441\u043a\u0438\u0445  \u0441\u0442\u043e\u043f\u043e\u0440\u043e\u0432 \u043d\u0435\u0442. \u041f\u0440\u0438\u043c\u0435\u0440 \u043a\u0430\u0441\u0442\u043e\u043c\u043d\u043e\u0433\u043e \u0440\u0430\u0441\u0447\u0435\u0445\u043b\u0435\u043d\u0438\u044f json \u0437\u0430\u043f\u0440\u043e\u0441\u0430 (\u0434\u043b\u044f \u043b\u044e\u0431\u043e\u043f\u044b\u0442\u043d\u044b\u0445):<\/p>\n
<?php  $extractor = new PropertyInfoExtractor([], [new PhpDocExtractor(), new CustomReflectionExtractor()]); $normalizer = [     new CustomDateTimeNormalizer(),     new DateTimeNormalizer(),     new ArrayDenormalizer(),     new ObjectNormalizer(null, null, null, $extractor), ];  $this->serializer = new Serializer($normalizer, [new JsonEncoder(), new XmlEncoder()]);  try {     $request = $serializer->denormalize($payload, $argument->getType(), null, [         AbstractObjectNormalizer::DISABLE_TYPE_ENFORCEMENT => true,     ]); } catch (Exception $exception) {     $this->assertSpecificProblem($exception);     $violations = ConstraintViolationList::createFromMessage($exception->getMessage());     throw new RequestValidationException($violations); }  $this->fullValidation($request);  public function fullValidation($object): void {     $violations = $this->validator->validate($object);      if ($violations->count()) {         throw new RequestValidationException($violations);     }      foreach ($object as $value) {         if (             ($value instanceof RequestJsonDtoInterface)             || ($value instanceof RequestFileInterface)             || (is_iterable($value))         ) {             $this->fullValidation($value);         }     } }<\/code><\/pre>\n<\/p>\n<\/div>\n<\/details>\n
\n\u0417\u0430\u0447\u0435\u043c \u043d\u0443\u0436\u043d\u044b \u0434\u0442\u043e, \u043f\u043e\u0447\u0435\u043c\u0443 \u043d\u0435 \u0432\u0437\u044f\u0442\u044c \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0438\u0435 \u043c\u043e\u0434\u0435\u043b\u0438?<\/summary>\n
\n
\u0414\u0443\u043c\u0430\u043b\u0438 \u0442\u0443\u0442 \u0431\u0443\u0434\u0435\u0442 \u043e\u0447\u0435\u0440\u0435\u0434\u043d\u043e\u0439 \u0445\u043e\u043b\u0438\u0432\u0430\u0440\u043d\u044b\u0439 \u0442\u0435\u043a\u0441\u0442? \u041d\u0435 \u0431\u043b\u0430\u0433\u043e\u0434\u0430\u0440\u0438\u0442\u0435 \ud83d\ude09<\/p>\n<\/div>\n<\/details>\n<\/div>\n<\/div>\n<\/div>\n
<\/div>\n

 \u0441\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u0438  https:\/\/habr.com\/ru\/articles\/775056\/<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
<\/div>\n
\n
\n
\n
\n
\u041a\u0442\u043e \u0438\u0437 \u043d\u0430\u0441 \u043d\u0435 \u0431\u044b\u043b \u043e\u0434\u0443\u0440\u043c\u0430\u043d\u0435\u043d \u0441\u043a\u0430\u0437\u043a\u0430\u043c\u0438 \u043f\u0440\u043e \u0441\u0432\u0430\u0433\u0435\u0440? \u041c\u043e\u043b, \u0434\u043e\u0431\u0430\u0432\u044c \u044d\u0442\u0443 \u0432\u043e\u043b\u0448\u0435\u0431\u043d\u0443\u044e \u0448\u0442\u0443\u043a\u0443 \u2014 \u0434\u0430 \u0437\u0430\u0436\u0438\u0432\u0435\u0448\u044c! \u041d\u043e \u043f\u043b\u0430\u0442\u0430 \u0437\u0430 \u043c\u0430\u0433\u0438\u044e \u2014 \u0437\u0435\u043b\u0435\u043d\u043e\u0435 \u0431\u043e\u043b\u043e\u0442\u043e \u043d\u043e\u0442\u0430\u0446\u0438\u0439. \u0410 \u043d\u0435\u043b\u044c\u0437\u044f \u043b\u0438 \u043e\u0431\u043e\u0439\u0442\u0438\u0441\u044c \u0442\u043e\u043b\u044c\u043a\u043e \u0442\u0438\u043f\u0438\u0437\u0430\u0446\u0438\u0435\u0439 \u0441\u0430\u043c\u043e\u0433\u043e php? (\u0421\u043f\u043e\u0439\u043b\u0435\u0440: \u043e\u043d\u0436\u043e\u043c)<\/p>\n\n
\u0426\u0435\u043b\u044c \u2014 \u043f\u0440\u0435\u0432\u0440\u0430\u0442\u0438\u0442\u044c \u044d\u0442\u043e\u0442 \u0441\u0438\u043c\u043f\u0430\u0442\u0438\u0447\u043d\u044b\u0439 Symfony \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440<\/p>\n
<?php  declare(strict_types=1); \/\/ ... class LoginController extends AbstractController {     #[Route('\/api\/login', methods: ['POST'])]     #[Tag(name: 'login')]     public function __invoke(         LoginRequest $request,         LoginService $service,         UserResponse $response     ): UserResponse     {         $user = $service->login($request);          return $response->with($user);     } }<\/code><\/pre>\n
\u0412 \u0442\u0430\u043a\u0443\u044e \u0434\u043e \u0431\u043e\u043b\u0438 \u0437\u043d\u0430\u043a\u043e\u043c\u0443\u044e \u0448\u0442\u0443\u043a\u0443<\/p>\n
\n\u041e\u0441\u0442\u043e\u0440\u043e\u0436\u043d\u043e! Swagger \u043f\u043e\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u0442 OpenApi \u0431\u0435\u0437 \u043f\u0440\u0438\u043a\u0440\u0430\u0441<\/summary>\n
\n
\n
\u041d\u0435 \u0441\u0430\u043c\u0430\u044f \u0433\u043e\u0432\u043e\u0440\u043b\u0438\u0432\u0430\u044f, \u0437\u0430\u0442\u043e \u043f\u0440\u0430\u0432\u0434\u0438\u0432\u0430 \u0438 \u043d\u0435\u0437\u0430\u0442\u0440\u0430\u0442\u043d\u0430<\/figcaption><\/div>\n<\/figure>\n<\/div>\n<\/details>\n
\u0422\u043e \u0435\u0441\u0442\u044c \u0441\u043d\u0430\u0447\u0430\u043b\u0430 \u0442\u0438\u043f\u0438\u0437\u0438\u0440\u0443\u0435\u043c \u0432\u0445\u043e\u0434\u043d\u044b\u0435\/\u0432\u044b\u0445\u043e\u0434\u043d\u044b\u0435 \u0434\u0430\u043d\u043d\u044b\u0435, \u0430 \u0437\u0430\u0442\u0435\u043c \u043f\u0440\u0435\u0432\u0440\u0430\u0442\u0438\u043c \u0442\u0438\u043f\u044b \u0432 \u043d\u043e\u0442\u0430\u0446\u0438\u0438. \u0412 \u043f\u0443\u0442\u044c!<\/p>\n
\u0428\u0430\u0433 1. \u0422\u0438\u043f\u0438\u0437\u0430\u0446\u0438\u044f \u0437\u0430\u043f\u0440\u043e\u0441\u0430<\/h2>\n
\u0427\u0442\u043e\u0431\u044b \u0432 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440 \u0432\u043c\u0435\u0441\u0442\u043e \u0431\u0430\u0437\u043e\u0432\u043e\u0433\u043e Request<\/code> \u043e\u0431\u044a\u0435\u043a\u0442\u0430 \u043f\u0435\u0440\u0435\u0434\u0430\u0432\u0430\u043b\u0441\u044f \u0434\u0442\u043e, \u0432\u043e\u0437\u044c\u043c\u0435\u043c \u0433\u043e\u0442\u043e\u0432\u0443\u044e \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0443 prugala\/symfony-request-dto<\/a>. \u0422\u0430\u043c \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f \u043c\u0435\u0445\u0430\u043d\u0438\u0437\u043c ValueResolver<\/a>, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043f\u043e\u0442\u043e\u043c \u043c\u043e\u0436\u043d\u043e, \u043d\u0435 \u0441\u0442\u0435\u0441\u043d\u044f\u044f\u0441\u044c, \u043f\u0435\u0440\u0435\u0434\u0435\u043b\u0430\u0442\u044c \u043f\u043e\u0434 \u0441\u0435\u0431\u044f.<\/p>\n
<?php  declare(strict_types=1);  class LoginRequest implements RequestDtoInterface {     #[NotBlank]     #[Email]     public string $login;      #[NotBlank]     public string $password; }<\/code><\/pre>\n
\u0414\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0435 \u0443\u0441\u043b\u043e\u0432\u0438\u044f \u043d\u0430\u0434 \u043f\u043e\u043b\u044f\u043c\u0438 \u2014 \u043f\u0440\u0438\u044f\u0442\u043d\u044b\u0439 \u0431\u043e\u043d\u0443\u0441, \u043d\u043e \u043d\u0435 \u0441\u0442\u043e\u0438\u0442 \u044d\u0442\u0438\u043c \u0441\u0438\u043b\u044c\u043d\u043e \u0443\u0432\u043b\u0435\u043a\u0430\u0442\u044c\u0441\u044f. \u0417\u0434\u0435\u0441\u044c \u0443\u043c\u0435\u0441\u0442\u043d\u0430 \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u0442\u0438\u043f\u043e\u0432, \u043d\u043e \u043d\u0435 \u0434\u0430\u043d\u043d\u044b\u0445.<\/p>\n
\u041e\u0442\u043b\u0438\u0447\u043d\u043e, \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u043c \u0434\u0430\u043b\u044c\u0448\u0435<\/em> \u00a9<\/p>\n
\u0428\u0430\u0433 2. \u0422\u0438\u043f\u0438\u0437\u0430\u0446\u0438\u044f \u043e\u0442\u0432\u0435\u0442\u0430<\/h2>\n
Symfony \u0431\u0443\u0445\u0442\u0438\u0442, \u043a\u043e\u0433\u0434\u0430 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u043d\u0435 Response \u043e\u0431\u044a\u0435\u043a\u0442. \u041a\u043e\u043d\u0435\u0447\u043d\u0430\u044f? \u041a \u0441\u0447\u0430\u0441\u0442\u044c\u044e, \u0440\u0430\u0437\u0440\u0443\u043b\u0438\u0442\u044c \u0441\u0438\u0442\u0443\u0430\u0446\u0438\u044e \u043c\u043e\u0436\u043d\u043e, \u0435\u0441\u043b\u0438 \u0437\u0430\u0430\u0431\u0443\u0437\u0438\u0442\u044c \u0441\u043e\u0431\u044b\u0442\u0438\u0435 kernel.view<\/code>:<\/p>\n
\n\u0420\u0435\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044f<\/summary>\n
\n
services:     App\\Listener\\ResponseListener:         tags:             - { name: kernel.event_listener, event: kernel.view}<\/code><\/pre>\n
<?php  declare(strict_types=1);  namespace App\\Listener;  use App\\Dto\\ResponseJsonInterface; use Symfony\\Component\\HttpFoundation\\JsonResponse; use Symfony\\Component\\HttpKernel\\Event\\ViewEvent; use Symfony\\Component\\Serializer\\SerializerInterface;  class ResponseListener {     public function __construct(         private readonly SerializerInterface $serializer,     ) {     }      public function __invoke(ViewEvent $event): void     {         $response = $event->getControllerResult();          if (!($response instanceof ResponseJsonInterface)) {             return;         }                  $jsonResponse = $this->json($response);          $event->setResponse($jsonResponse);     }      protected function json(mixed $data, int $status = 200, array $headers = [], array $context = []): JsonResponse     {         $json = $this->serializer->serialize($data, 'json', array_merge([             'json_encode_options' => JsonResponse::DEFAULT_ENCODING_OPTIONS                 | JSON_UNESCAPED_UNICODE                 | JSON_UNESCAPED_SLASHES                 | JSON_PRETTY_PRINT,         ], $context));          return new JsonResponse($json, $status, $headers, true);     } } <\/code><\/pre>\n<\/p>\n<\/div>\n<\/details>\n
\u0411\u043b\u0430\u0433\u043e\u0434\u0430\u0440\u044f \u044d\u0442\u043e\u043c\u0443 \u043c\u043e\u0436\u043d\u043e \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0442\u044c \u043e\u0431\u044b\u0447\u043d\u044b\u0439 \u0434\u0442\u043e, \u0430 \u0432\u043e\u0442, \u043a\u0441\u0442\u0430\u0442\u0438, \u0438 \u043e\u043d:<\/p>\n
<?php  declare(strict_types=1);  class UserResponse implements ResponseJsonInterface {     public int $id;     public string $email;     public int $special;      public function __construct(private readonly SpecialService $specialService)     {     }      public function with(User $user): self     {         $this->id = $user->id();         $this->email = $user->email();         $this->special = $this->specialService->special($user);          return $this;     } }<\/code><\/pre>\n
\u0422\u0435\u043f\u0435\u0440\u044c \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440 \u043d\u0435 \u043d\u0430 \u0441\u043b\u043e\u0432\u0430\u0445, \u0430 \u043d\u0430 \u0434\u0435\u043b\u0435 \u0441\u043e\u0431\u043b\u044e\u0434\u0430\u0435\u0442 \u0437\u0430\u044f\u0432\u043b\u0435\u043d\u043d\u044b\u0435 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u044b! (\u0437\u0432\u0443\u0447\u0438\u0442, \u0434\u0430?)<\/p>\n
\u0428\u0430\u0433 3. \u0417\u0430\u0432\u043e\u0434\u0438\u043c \u0441\u0432\u0430\u0433\u0435\u0440<\/h2>\n
\u0414\u043b\u044f \u044d\u0442\u043e\u0433\u043e \u0432\u043e\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c\u0441\u044f \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u043e\u0439 nelmio\/NelmioApiDocBundle<\/a>. \u0412 \u043d\u0435\u0439 \u0443\u0436\u0435 \u0438\u0437 \u043a\u043e\u0440\u043e\u0431\u043a\u0438 \u0435\u0441\u0442\u044c \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u044c \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u043a\u043b\u0430\u0441\u0441\u044b \u0434\u043b\u044f \u043d\u043e\u0442\u0430\u0446\u0438\u0439:<\/p>\n
<?php  #[Route('\/api\/login', methods: ['POST'])] #[RequestBody(content: new Model(type: LoginRequest::class))] #[Response(response: 200, content: new Model(type: UserResponse::class))] #[Tag(name: 'login')] public function __invoke(         LoginRequest $request,         LoginService $service,         UserResponse $response ): UserResponse { \/\/... }<\/code><\/pre>\n
\u0412\u0440\u043e\u0434\u0435 \u0431\u044b \u043f\u043e\u0447\u0442\u0438 \u0442\u043e, \u0447\u0442\u043e \u043d\u0430\u0434\u043e! \u041d\u043e \u0434\u0443\u0431\u043b\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435 \u0432\u0441\u0435 \u0440\u0430\u0432\u043d\u043e \u043e\u0441\u0442\u0430\u0435\u0442\u0441\u044f \ud83d\ude41<\/p>\n
\u0415\u0441\u043b\u0438 \u0438\u0437\u043c\u0435\u043d\u0438\u0442\u044c \u0441\u0438\u0433\u043d\u0430\u0442\u0443\u0440\u0443 \u043c\u0435\u0442\u043e\u0434\u0430 \u0438 \u043d\u0435 \u043e\u0431\u043d\u043e\u0432\u0438\u0442\u044c \u043d\u043e\u0442\u0430\u0446\u0438\u0438, \u0442\u043e.. \u043d\u0438\u043a\u0430\u043a\u043e\u0439 \u043e\u0448\u0438\u0431\u043a\u0438 \u043d\u0435 \u0432\u043e\u0437\u043d\u0438\u043a\u043d\u0435\u0442, \u0438 \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u043d\u0435\u0430\u043a\u0442\u0443\u0430\u043b\u044c\u043d\u0430\u044f<\/em> \u0434\u043e\u043a\u0430. \u041d\u0435\u043d\u0430\u0432\u044f\u0437\u0447\u0438\u0432\u0430\u044f \u043f\u043e\u043f\u044b\u0442\u043a\u0430<\/a> \u043f\u043e\u0434\u0442\u043e\u043b\u043a\u043d\u0443\u0442\u044c \u0430\u0432\u0442\u043e\u0440\u0430 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0438 \u043a \u0434\u043e\u0431\u0430\u0432\u043b\u0435\u043d\u0438\u044e \u043e\u0431\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0430 \u0442\u0438\u043f\u043e\u0432 \u043e\u0441\u0442\u0430\u043b\u0430\u0441\u044c \u0431\u0435\u0437\u043e\u0442\u0432\u0435\u0442\u043d\u043e\u0439.<\/p>\n
\u0428\u0430\u0433 4. \u041a\u0430\u0441\u0442\u043e\u043c<\/h2>\n
\u0420\u0430\u0441\u0448\u0438\u0440\u0438\u043c NelmioApiDocBundle \u0441 \u043f\u043e\u043c\u043e\u0449\u044c\u044e vodevel\/api-doc-bundle-type-describer<\/a>. \u042d\u0442\u043e\u0442 \u0431\u0430\u043d\u0434\u043b \u0445\u043e\u0442\u044c \u0438 \u043f\u0440\u0438\u043c\u0438\u0442\u0438\u0432\u0435\u043d, \u043d\u043e \u0434\u0435\u043b\u0430\u0435\u0442 \u0447\u0442\u043e \u0434\u043e\u0301\u043b\u0436\u043d\u043e:<\/p>\n
<?php  #[Route('\/api\/login', methods: ['POST'])] #[Tag(name: 'login')] public function __invoke(   LoginRequest $request,    LoginService $service,   UserResponse $response ): UserResponse  {   \/\/ ...   }   use OpenApi\\Attributes\\RequestBody;  #[RequestBody] class LoginRequest implements RequestDtoInterface {   \/\/ ...   }   use OpenApi\\Attributes\\Response;  #[Response] class UserResponse implements ResponseJsonInterface {    \/\/ ...  }<\/code><\/pre>\n
\u0423 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u0430 \u0432\u0441\u0435 \u0435\u0449\u0435 \u043e\u0441\u0442\u0430\u043b\u0430\u0441\u044c \u043d\u043e\u0442\u0430\u0446\u0438\u044f #[Tag]<\/code>, \u0431\u0435\u0437 \u043a\u043e\u0442\u043e\u0440\u043e\u0439 \u043e\u043d \u043f\u0440\u043e\u0441\u0442\u043e \u043d\u0435 \u0431\u0443\u0434\u0435\u0442 \u0437\u0430\u043c\u0435\u0447\u0435\u043d \u0438 \u043e\u0431\u0440\u0430\u0431\u043e\u0442\u0430\u043d. \u0410 \u0443 \u0434\u0442\u043e \u043f\u043e\u044f\u0432\u0438\u043b\u0438\u0441\u044c \u0430\u0442\u0440\u0438\u0431\u0443\u0442\u044b #[RequestBody]<\/code>, #[Response]<\/code>. \u041d\u043e \u0434\u0443\u0431\u043b\u0438\u0440\u0443\u044e\u0449\u0438\u0445 \u043d\u043e\u0442\u0430\u0446\u0438\u0439 \u043d\u0435\u0442. \u0422\u043e\u0447\u043d\u043e \u043d\u0435\u0442? \u0414\u0430 \u0433\u043e\u0432\u043e\u0440\u044e \u0436\u0435!<\/p>\n
\u0428\u0430\u0433 5. \u0421\u0442\u0440\u0430\u0448\u043d\u043e, \u0432\u044b\u0440\u0443\u0431\u0430\u0439<\/h2>\n
\u0425\u043e\u0442\u0438\u0442\u0435 \u043f\u043e\u043f\u0440\u043e\u0431\u043e\u0432\u0430\u0442\u044c, \u043d\u043e \u0431\u043e\u0438\u0442\u0435\u0441\u044c \u043f\u0440\u0435\u0432\u0440\u0430\u0442\u0438\u0442\u044c \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u0432 \u0442\u044b\u043a\u0432\u0443? \u042f \u0442\u043e\u0436\u0435. \u041f\u043e\u044d\u0442\u043e\u043c\u0443 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0430 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u043a\u0440\u0430\u0439\u043d\u0435 \u0434\u0435\u043b\u0438\u043a\u0430\u0442\u043d\u043e<\/em>. \u041c\u0435\u0442\u043e\u0434\u044b \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u043e\u0432, \u0443 \u043a\u043e\u0442\u043e\u0440\u044b\u0445 \u0443\u0436\u0435 \u0435\u0441\u0442\u044c \u043d\u043e\u0442\u0430\u0446\u0438\u0438, \u043d\u0435 \u0437\u0430\u0442\u0440\u043e\u043d\u0435\u0442.<\/p>\n
\u041a\u0441\u0442\u0430\u0442\u0438, \u0435\u0441\u043b\u0438 \u0432 \u0434\u0442\u043e \u0438\u043c\u044f \u043f\u043e\u043b\u044f \u043d\u0435\u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e \u0433\u043e\u0432\u043e\u0440\u044f\u0449\u0435\u0435, \u0442\u043e \u043c\u043e\u0436\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c Property:<\/p>\n
<?php  #[RequestBody] class LoginRequest implements RequestDtoInterface {     #[Property(description: \"It\u2019s an email, dude!\", example: 'test@test.test')]     #[NotBlank]     #[Email]     public string $login;<\/code><\/pre>\n
Professional!<\/p>\n
[\u0418\u0437 \u043d\u0435\u0432\u043e\u0448\u0435\u0434\u0448\u0435\u0433\u043e]<\/h2>\n
\n\u041a\u0430\u043a \u0437\u0430\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0441\u043f\u0438\u0441\u043e\u043a \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u044b\u0445 \u043e\u0442\u0432\u0435\u0442\u043e\u0432, \u0430 \u043d\u0435 \u0442\u043e\u043b\u044c\u043a\u043e \u043e\u0434\u0438\u043d \u0443\u0441\u043f\u0435\u0448\u043d\u044b\u0439?<\/summary>\n
\n
\u041f\u043e\u0434\u043b\u043e\u0432\u0438\u043b\u0438! \u0422\u0430\u043a\u043e\u0439 \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u0438 \u043d\u0435\u0442 (\u043d\u0443, \u043a\u0440\u043e\u043c\u0435 \u043a\u0430\u043a \u0432\u0440\u0443\u0447\u043d\u0443\u044e \u0440\u0430\u0441\u043f\u0438\u0441\u0430\u0442\u044c). \u0414\u043b\u044f \u0438\u0441\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u0439 \u043c\u043e\u0436\u043d\u043e \u0431\u044b\u043b\u043e \u0431\u044b \u0435\u0449\u0435 \u0447\u0442\u043e-\u0442\u043e \u043f\u0440\u0438\u0434\u0443\u043c\u0430\u0442\u044c (\u0430\u043d\u043d\u043e\u0442\u0430\u0446\u0438\u0438 \u0441 \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u043e\u0439 \u0447\u0435\u0440\u0435\u0437 \u0441\u043d\u0438\u0444\u0435\u0440, \u0438\u043b\u0438 \u0430\u043d\u0430\u043b\u0438\u0437 AST). \u041d\u043e \u043d\u0435 \u043d\u0430\u0441\u0442\u043e\u043b\u044c\u043a\u043e \u044f \u043b\u044e\u0431\u043b\u044e \u0441\u043f\u0438\u0441\u043e\u043a \u043e\u0442\u0432\u0435\u0442\u043e\u0432. \u0410 \u0432\u044b?<\/p>\n<\/div>\n<\/details>\n
\n\u041f\u043e\u0447\u0435\u043c\u0443 \u0434\u043b\u044f \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u044f \u0434\u0442\u043e \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f \u0438 \u0438\u043d\u0442\u0435\u0440\u0444\u0435\u0439\u0441\u044b, \u0438 \u0430\u0442\u0440\u0438\u0431\u0443\u0442\u044b?<\/summary>\n
\n
\u0427\u0442\u043e\u0431\u044b \u043f\u043e\u0434\u0447\u0435\u0440\u043a\u043d\u0443\u0442\u044c \u0438\u0445 \u043d\u0435\u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u044c, \u0432\u0435\u0434\u044c \u044d\u0442\u043e \u0434\u0432\u0435 \u0440\u0430\u0437\u043d\u044b\u0435 \u043e\u0442\u0432\u0435\u0442\u0441\u0442\u0432\u0435\u043d\u043d\u043e\u0441\u0442\u0438 \u0442\u0430\u043a \u0442\u043e. \u041c\u043e\u0436\u043d\u043e \u0434\u043e\u0431\u0438\u0442\u044c\u0441\u044f \u0438\u0445 \u043e\u0434\u043d\u043e\u043e\u0431\u0440\u0430\u0437\u0438\u044f, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u043c\u0435\u0445\u0430\u043d\u0438\u0437\u043c \u0430\u0442\u0440\u0438\u0431\u0443\u0442\u043e\u0432, \u043d\u043e \u0438\u0445 \u043d\u0435 \u0442\u0430\u043a \u0443\u0434\u043e\u0431\u043d\u043e \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0442\u044c, \u043a\u0430\u043a \u0438\u043d\u0442\u0435\u0440\u0444\u0435\u0439\u0441\u044b. \u0410 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u0442\u043e\u043b\u044c\u043a\u043e \u0438\u043d\u0442\u0435\u0440\u0444\u0435\u0439\u0441\u044b \u043d\u0435 \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u0441\u044f, \u0442\u0430\u043a \u043a\u0430\u043a \u0434\u043b\u044f \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u043f\u043e\u0440\u043e\u0439 \u043d\u0443\u0436\u043d\u0430 \u043d\u0430\u0447\u0438\u043d\u043a\u0430.<\/p>\n<\/div>\n<\/details>\n
\n\u041f\u0435\u0440\u0435\u0447\u0438\u0441\u043b\u044f\u0442\u044c Response \u043e\u0431\u044a\u0435\u043a\u0442 \u0432 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430\u0445 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u0430 \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u043e?<\/summary>\n
\n
\u0413\u043b\u0430\u0432\u043d\u044b\u043c \u043e\u0431\u0440\u0430\u0437\u043e\u043c \u044d\u0442\u043e \u0441\u0434\u0435\u043b\u0430\u043d\u043e \u0434\u043b\u044f \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0438 DI. \u0415\u0441\u043b\u0438 \u0445\u043e\u0442\u0438\u0442\u0435 \u0438\u043c\u043c\u0443\u0442\u0430\u0431\u0435\u043b\u044c\u043d\u044b\u0439 \u043e\u0431\u044a\u0435\u043a\u0442, \u0442\u043e \u043c\u043e\u0436\u043d\u043e \u0438 \u0442\u0430\u043a:<\/p>\n
<?php  public function __invoke(   LoginRequest $request,    LoginService $service,    SpecialService $specialService ): UserResponse {    $user = $service->login($request);     return new UserResponse($specialService, $user); }<\/code><\/pre>\n<\/p>\n<\/div>\n<\/details>\n
\n\u0410 \u0435\u0441\u043b\u0438 \u043d\u0430\u0434\u043e \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0442\u044c \u043d\u0435 \u043e\u0431\u044a\u0435\u043a\u0442, \u0430 \u0441\u043f\u0438\u0441\u043e\u043a \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u0432, \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u0441\u043f\u0438\u0441\u043e\u043a \u044e\u0437\u0435\u0440\u043e\u0432?<\/summary>\n
\n
\u0416\u0438\u0437\u043d\u044c \u043f\u043e\u043a\u0430\u0437\u0430\u043b\u0430, \u0447\u0442\u043e \u0433\u043e\u043b\u044b\u0435 \u0441\u043f\u0438\u0441\u043a\u0438 — \u0442\u0430\u043a\u043e\u0435 \u0441\u0435\u0431\u0435. \u0420\u0430\u043d\u043e \u0438\u043b\u0438 \u043f\u043e\u0437\u0434\u043d\u043e, \u043d\u043e \u043f\u043e\u044f\u0432\u044f\u0442\u0441\u044f \u043c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u0435 (\u043f\u0430\u0433\u0438\u043d\u0430\u0446\u0438\u044f, \u0430\u0433\u0440\u0435\u0433\u0430\u0446\u0438\u044f, \u0434\u043b\u044f \u043e\u0442\u043b\u0430\u0434\u043a\u0438 \u0434\u043e\u043f.\u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044f). \u041f\u043e\u044d\u0442\u043e\u043c\u0443 \u0434\u043b\u044f \u0441\u043f\u0438\u0441\u043a\u0430 \u0442\u043e\u0436\u0435 \u043b\u0443\u0447\u0448\u0435 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u043e\u0431\u044a\u0435\u043a\u0442 \u0441 \u043a\u043b\u044e\u0447\u043e\u043c «data» («items», «collection», «list»). <\/p>\n
\u041d\u043e \u0435\u0441\u043b\u0438 \u0432\u043e\u043f\u0440\u043e\u0441 \u0441\u0442\u043e\u0438\u0442 \u0440\u0435\u0431\u0440\u043e\u043c (\u0430\u043f\u0438 \u0443\u0436\u0435 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u0435\u0442), \u0442\u043e \u0432\u043e\u0442:<\/p>\n
<?php  class UserListController extends BaseController {     #[Route('user\/list', methods: ['GET'])]     #[Tag(name: 'user')]     public function __invoke(       UserListRequest $request,        UserListService $userListService,       SpecialService $specialService     ): UserListResponse     {         $users = $userListService->userList($request);          return UserListResponse::new($users, $specialService);     } }   #[Response] #[Schema(type: 'array', items: new Items(ref: new Model(type: UserResponse::class)))] class UserListResponse extends ArrayIterator implements ResponseJsonInterface {     public static function new(array $users, SpecialService $specialService)     {         $data = [];         foreach ($users as $user) {             $userResponse = new UserResponse($specialService);             $data[] = $userResponse->with($user);         }          return new UserListResponse($data);     } } <\/code><\/pre>\n<\/p>\n<\/div>\n<\/details>\n
\n\u0415\u0441\u043b\u0438 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u044b \u0442\u0430\u043a\u0438\u0435 \u0442\u043e\u043d\u043a\u0438\u0435, \u043c\u043e\u0436\u0435\u0442 \u0432\u043b\u043e\u0436\u0438\u0442\u044c\u0441\u044f \u0432 \u0441\u043e\u0437\u0434\u0430\u043d\u0438\u0435 \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u0438, \u0432\u043c\u0435\u0441\u0442\u043e \u0441\u043e\u0437\u0434\u0430\u043d\u0438\u044f \u043a\u043b\u0430\u0441\u0441\u043e\u0432?<\/summary>\n
\n
\u041c\u043e\u0436\u043d\u043e \u043e\u043f\u0438\u0441\u0430\u0442\u044c \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440 \u0434\u0435\u043a\u043b\u0430\u0440\u0430\u0442\u0438\u0432\u043d\u043e, \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u0447\u0435\u0440\u0435\u0437 yaml:<\/p>\n
api\/login:    method: POST    request: LoginRequest    service: LoginService    response: UserResponse<\/code><\/pre>\n
\u041d\u0443, \u0438\u043b\u0438 \u0435\u0449\u0435 \u0447\u0443\u0442\u044c \u0431\u043e\u043b\u0435\u0435 \u0433\u0438\u0431\u043a\u0443\u044e \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0443, \u0430 \u043f\u043e\u0442\u043e\u043c \u0441\u043a\u0430\u0440\u043c\u043b\u0438\u0432\u0430\u0442\u044c \u0435\u0435 \u0448\u0430\u0431\u043b\u043e\u043d\u043d\u043e\u043c\u0443 \u043c\u0435\u0442\u043e\u0434\u0443. \u041d\u043e \u0437\u0430\u0447\u0435\u043c? (\u0430\u0433\u0430, \u0441\u0430\u043c \u043f\u0440\u0438\u0434\u0443\u043c\u0430\u043b \u0443\u043f\u043e\u0440\u043e\u0442\u044b\u0439 \u0432\u043e\u043f\u0440\u043e\u0441 \u0438 \u043d\u0435 \u0437\u043d\u0430\u0435\u0442 \u0437\u0430\u0447\u0435\u043c). \u0427\u0442\u043e\u0431\u044b \u0433\u0430\u0440\u0430\u043d\u0442\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0441\u043e\u0431\u043b\u044e\u0434\u0435\u043d\u0438\u044f \u0430\u0440\u0445\u0438\u0442\u0435\u043a\u0442\u0443\u0440\u044b \u0442\u043e\u043d\u043a\u0438\u0445 \u0434\u043e \u043f\u0440\u043e\u0437\u0440\u0430\u0447\u043d\u043e\u0441\u0442\u0438 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u043e\u0432? \u041e\u043f\u0442\u0438\u043c\u0438\u0437\u0430\u0446\u0438\u044f? \u0414\u0430 \u043d\u0435, \u0432\u0441\u0435 \u044d\u0442\u043e \u0448\u043b\u044f\u043f\u0430. \u041a\u043e\u0434 \u043a\u0443\u0434\u0430 \u043b\u0443\u0447\u0448\u0435, \u0447\u0435\u043c \u043a\u043e\u043d\u0444\u0438\u0433.<\/p>\n<\/div>\n<\/details>\n
\n\u041c\u043e\u0436\u043d\u043e \u043b\u0438 \u0432 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u0435 \u043e\u0434\u043d\u043e\u0432\u0440\u0435\u043c\u0435\u043d\u043d\u043e \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u0438\u0437 \u0440\u043e\u0443\u0442\u0430 \u0438 \u0434\u0442\u043e, \u0432\u043b\u043e\u0436\u0435\u043d\u043d\u044b\u0435 \u0434\u0442\u043e, \u0437\u0430\u043f\u0440\u043e\u0441\u044b \u0441 \u0440\u0430\u0437\u043d\u044b\u043c\u0438 Content-type?<\/summary>\n
\n
\u0414\u0430:<\/p>\n
<?php  #[Route('\/api\/post\/{id}\/like', methods: ['POST'])] #[Tag(name: 'post')] public function __invoke(int id, LikeRequest $likeRequest, ...<\/code><\/pre>\n
\u041c\u043e\u0436\u043d\u043e \u0434\u0430\u0436\u0435 \u043f\u043e\u0434\u043a\u0440\u0443\u0442\u0438\u0442\u044c ValueResolver, \u0447\u0442\u043e\u0431\u044b \u043e\u043d \u043f\u0440\u043e\u0442\u0430\u043b\u043a\u0438\u0432\u0430\u043b \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u0438\u0437 \u0440\u043e\u0443\u0442\u0430 \u0432\u043d\u0443\u0442\u0440\u044c \u0434\u0442\u043e. \u0410 \u0435\u0449\u0435 \u043f\u043e\u0434\u043e\u0431\u0440\u0430\u0442\u044c \u043d\u0443\u0436\u043d\u044b\u0439 \u043d\u0430\u0431\u043e\u0440 \u0441\u0435\u0440\u0438\u0430\u043b\u0438\u0437\u0430\u0442\u043e\u0440\u043e\u0432, \u043d\u043e\u0440\u043c\u0430\u043b\u0430\u0439\u0437\u0435\u0440\u043e\u0432, \u044d\u043a\u0441\u0442\u0440\u0430\u043a\u0442\u043e\u0440\u043e\u0432 \u0438 \u0434\u0440\u0443\u0433\u0438\u0445 \u0447\u0430\u0441\u0442\u043e \u0443\u043f\u043e\u043c\u0438\u043d\u0430\u0435\u043c\u044b\u0445 \u0441 \u044d\u0442\u0438\u043c \u043c\u0435\u0445\u0430\u043d\u0438\u0437\u043c\u043e\u043c \u0441\u043b\u043e\u0432. \u0422\u0435\u0445\u043d\u0438\u0447\u0435\u0441\u043a\u0438\u0445  \u0441\u0442\u043e\u043f\u043e\u0440\u043e\u0432 \u043d\u0435\u0442. \u041f\u0440\u0438\u043c\u0435\u0440 \u043a\u0430\u0441\u0442\u043e\u043c\u043d\u043e\u0433\u043e \u0440\u0430\u0441\u0447\u0435\u0445\u043b\u0435\u043d\u0438\u044f json \u0437\u0430\u043f\u0440\u043e\u0441\u0430 (\u0434\u043b\u044f \u043b\u044e\u0431\u043e\u043f\u044b\u0442\u043d\u044b\u0445):<\/p>\n
<?php  $extractor = new PropertyInfoExtractor([], [new PhpDocExtractor(), new CustomReflectionExtractor()]); $normalizer = [     new CustomDateTimeNormalizer(),     new DateTimeNormalizer(),     new ArrayDenormalizer(),     new ObjectNormalizer(null, null, null, $extractor), ];  $this->serializer = new Serializer($normalizer, [new JsonEncoder(), new XmlEncoder()]);  try {     $request = $serializer->denormalize($payload, $argument->getType(), null, [         AbstractObjectNormalizer::DISABLE_TYPE_ENFORCEMENT => true,     ]); } catch (Exception $exception) {     $this->assertSpecificProblem($exception);     $violations = ConstraintViolationList::createFromMessage($exception->getMessage());     throw new RequestValidationException($violations); }  $this->fullValidation($request);  public function fullValidation($object): void {     $violations =<\/code><\/pre>\n<\/div>\n<\/details>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[],"tags":[],"class_list":["post-360646","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/360646","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=360646"}],"version-history":[{"count":0,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/360646\/revisions"}],"wp:attachment":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=360646"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=360646"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=360646"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}