{"id":483681,"date":"2026-06-15T12:06:29","date_gmt":"2026-06-15T12:06:29","guid":{"rendered":"https:\/\/savepearlharbor.com\/?p=483681"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T21:00:00","slug":"","status":"publish","type":"post","link":"https:\/\/savepearlharbor.com\/?p=483681","title":{"rendered":"OpenAPI \u0431\u0435\u0437 #[OA\\&#8230;]: \u043a\u0430\u043a \u044f \u0441\u0434\u0435\u043b\u0430\u043b \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u0434\u043b\u044f Symfony"},"content":{"rendered":"<div xmlns=\"http:\/\/www.w3.org\/1999\/xhtml\">\n<h2><\/h2>\n<p>\u0412 <a href=\"https:\/\/habr.com\/ru\/articles\/891048\/\" rel=\"noopener noreferrer nofollow\">\u043f\u0440\u043e\u0448\u043b\u043e\u0439 \u0441\u0442\u0430\u0442\u044c\u0435<\/a> \u044f \u0443\u0436\u0435 \u0440\u0430\u0441\u0441\u043a\u0430\u0437\u044b\u0432\u0430\u043b, \u043a\u0430\u043a \u043e\u0434\u043d\u0430\u0436\u0434\u044b \u0443\u0441\u0442\u0440\u043e\u0438\u043b\u0441\u044f \u043d\u0430 \u0440\u0430\u0431\u043e\u0442\u0443 \u0438 \u043f\u043e\u043b\u0443\u0447\u0438\u043b \u043f\u0430\u0447\u043a\u0443 \u00ab\u0438\u043d\u0442\u0435\u0440\u0435\u0441\u043d\u044b\u0445\u00bb \u0437\u0430\u0434\u0430\u0447: \u0432\u0440\u0443\u0447\u043d\u0443\u044e \u0441\u0438\u043d\u0445\u0440\u043e\u043d\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u0442\u044c OpenAPI, \u043e\u0444\u043e\u0440\u043c\u043b\u0435\u043d\u043d\u044b\u0439 \u0432 \u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u044f\u0445 \u043a \u043a\u043e\u0434\u0443, \u0441 \u0441\u0430\u043c\u0438\u043c \u043a\u043e\u0434\u043e\u043c \u0432 \u0434\u0435\u0441\u044f\u0442\u043a\u0435 \u0441\u0435\u0440\u0432\u0438\u0441\u043e\u0432.<\/p>\n<p>\u0422\u043e\u0433\u0434\u0430 \u044d\u0442\u043e \u0437\u0432\u0443\u0447\u0430\u043b\u043e \u043a\u0430\u043a \u043d\u0430\u0447\u0430\u043b\u043e \u0430\u043d\u0435\u043a\u0434\u043e\u0442\u0430, \u043d\u043e \u043c\u043d\u0435 \u0431\u044b\u043b\u043e \u043d\u0435 \u0434\u043e \u0441\u043c\u0435\u0445\u0430.<\/p>\n<p>\u0421 \u0442\u0435\u0445 \u043f\u043e\u0440 \u044f \u0441\u043c\u0435\u043d\u0438\u043b \u0440\u0430\u0431\u043e\u0442\u0443. \u0418, \u043a\u0430\u043a \u0431\u0443\u0434\u0442\u043e \u0432\u0441\u0435\u043b\u0435\u043d\u043d\u0430\u044f \u0440\u0435\u0448\u0438\u043b\u0430 \u043f\u0440\u043e\u0432\u0435\u0440\u0438\u0442\u044c \u043c\u043e\u0451 \u0447\u0443\u0432\u0441\u0442\u0432\u043e \u044e\u043c\u043e\u0440\u0430, \u044f \u0441\u043d\u043e\u0432\u0430 \u0432\u0438\u0436\u0443 API, \u0433\u0434\u0435 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u0436\u0438\u0432\u0451\u0442 \u0440\u044f\u0434\u043e\u043c \u0441 \u043a\u043e\u0434\u043e\u043c \u0432 \u0440\u0443\u0447\u043d\u044b\u0445 <code>#[OA\\...]<\/code> \u0430\u0442\u0440\u0438\u0431\u0443\u0442\u0430\u0445.<\/p>\n<p>\u0418 \u044d\u0442\u043e \u0432\u0430\u0436\u043d\u044b\u0439 \u043c\u043e\u043c\u0435\u043d\u0442. \u042d\u0442\u043e \u043d\u0435 \u0438\u0441\u0442\u043e\u0440\u0438\u044f \u043f\u0440\u043e \u043e\u0434\u043d\u0443 \u043a\u043e\u043d\u043a\u0440\u0435\u0442\u043d\u0443\u044e \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u044e, \u043e\u0434\u0438\u043d \u043d\u0435\u0443\u0434\u0430\u0447\u043d\u044b\u0439 \u043f\u0440\u043e\u0435\u043a\u0442 \u0438\u043b\u0438 \u043e\u0434\u0438\u043d \u0441\u0442\u0430\u0440\u044b\u0439 \u0441\u0435\u0440\u0432\u0438\u0441, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0432\u0441\u0435 \u0431\u043e\u044f\u0442\u0441\u044f \u0442\u0440\u043e\u0433\u0430\u0442\u044c. \u042f \u0432\u0438\u0436\u0443 \u044d\u0442\u043e\u0442 \u043f\u043e\u0434\u0445\u043e\u0434 \u0432 \u0440\u0430\u0437\u043d\u044b\u0445 \u043c\u0435\u0441\u0442\u0430\u0445.<\/p>\n<p>Symfony \u0443\u0436\u0435 \u0437\u043d\u0430\u0435\u0442 \u043c\u0430\u0440\u0448\u0440\u0443\u0442\u044b. \u041a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440 \u0443\u0436\u0435 \u0437\u043d\u0430\u0435\u0442 \u0432\u0445\u043e\u0434\u043d\u044b\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b. DTO \u0443\u0436\u0435 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 request. View object \u0443\u0436\u0435 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 response. \u041d\u043e \u043f\u043e\u0432\u0435\u0440\u0445 \u044d\u0442\u043e\u0433\u043e \u0432\u0441\u0451 \u0440\u0430\u0432\u043d\u043e \u0447\u0430\u0441\u0442\u043e \u043f\u0438\u0448\u0435\u0442\u0441\u044f \u0435\u0449\u0451 \u043e\u0434\u0438\u043d \u0441\u043b\u043e\u0439:<\/p>\n<pre><code class=\"php\">#[OA\\Post(    path: '\/v1\/completions',    requestBody: new OA\\RequestBody(...),    responses: [        new OA\\Response(            response: 200,            description: 'Completion result',            content: new OA\\JsonContent(...),        ),    ],)]#[Route('\/v1\/completions', methods: ['POST'])]public function __invoke(CreateCompletionRequest $request): JsonResponse{    \/\/ ...}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:87px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u042f \u043d\u0435 \u0441\u0447\u0438\u0442\u0430\u044e OpenAPI \u043f\u0440\u043e\u0431\u043b\u0435\u043c\u043e\u0439. OpenAPI \u043f\u043e\u043b\u0435\u0437\u0435\u043d. Swagger UI \u043f\u043e\u043b\u0435\u0437\u0435\u043d. \u041a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 API \u043f\u043e\u043b\u0435\u0437\u0435\u043d.<\/p>\n<p>\u041f\u0440\u043e\u0431\u043b\u0435\u043c\u0430 \u0432 \u0434\u0440\u0443\u0433\u043e\u043c: \u043c\u044b \u0447\u0430\u0441\u0442\u043e \u0432\u0440\u0443\u0447\u043d\u0443\u044e \u0434\u0443\u0431\u043b\u0438\u0440\u0443\u0435\u043c \u0442\u043e, \u0447\u0442\u043e \u0443\u0436\u0435 \u0435\u0441\u0442\u044c \u0432 \u043a\u043e\u0434\u0435.<\/p>\n<p>\u041f\u043e\u043c\u0435\u043d\u044f\u043b DTO \u2014 \u043d\u0435 \u0437\u0430\u0431\u0443\u0434\u044c \u043f\u043e\u043c\u0435\u043d\u044f\u0442\u044c OpenAPI. \u041f\u043e\u043c\u0435\u043d\u044f\u043b response \u2014 \u043d\u0435 \u0437\u0430\u0431\u0443\u0434\u044c \u043f\u043e\u043c\u0435\u043d\u044f\u0442\u044c OpenAPI. \u041f\u043e\u043c\u0435\u043d\u044f\u043b status code \u2014 \u043d\u0435 \u0437\u0430\u0431\u0443\u0434\u044c \u043f\u043e\u043c\u0435\u043d\u044f\u0442\u044c OpenAPI. \u041d\u0435 \u043f\u043e\u043c\u0435\u043d\u044f\u043b \u2014 \u0432 \u043b\u0443\u0447\u0448\u0435\u043c \u0441\u043b\u0443\u0447\u0430\u0435 \u2013 \u0431\u0430\u0433.<\/p>\n<p>\u042f \u0443\u0436\u0435 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u043b\u0435\u0442 \u0437\u0430\u043d\u0438\u043c\u0430\u044e\u0441\u044c \u044d\u0442\u0438\u043c \u0432\u043e\u043f\u0440\u043e\u0441\u043e\u043c \u0438 \u0441\u0447\u0438\u0442\u0430\u044e, \u0447\u0442\u043e \u0432 \u0431\u043e\u043b\u044c\u0448\u0438\u043d\u0441\u0442\u0432\u0435 \u0441\u043b\u0443\u0447\u0430\u0435\u0432 API-\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u0434\u043e\u043b\u0436\u043d\u0430 \u0432\u044b\u0442\u0435\u043a\u0430\u0442\u044c \u0438\u0437 \u043a\u043e\u0434\u0430, \u0430 \u043d\u0435 \u0436\u0438\u0442\u044c \u0440\u044f\u0434\u043e\u043c \u0441 \u043d\u0438\u043c \u043a\u0430\u043a \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0439 \u0440\u0443\u0447\u043d\u043e\u0439 \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442.<\/p>\n<p>\u0418\u043c\u0435\u043d\u043d\u043e \u043f\u043e\u044d\u0442\u043e\u043c\u0443 \u044f \u0441\u0434\u0435\u043b\u0430\u043b <a href=\"https:\/\/github.com\/sunrise-studio-development\/symfony-openapi\" rel=\"noopener noreferrer nofollow\"><code>sunrise-studio\/symfony-openapi<\/code><\/a>.<\/p>\n<h3>\u0427\u0442\u043e \u044f \u0445\u043e\u0442\u0435\u043b \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u044c<\/h3>\n<p>\u042f \u0445\u043e\u0442\u0435\u043b, \u0447\u0442\u043e\u0431\u044b \u043e\u0431\u044b\u0447\u043d\u044b\u0439 Symfony \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440 \u0432\u044b\u0433\u043b\u044f\u0434\u0435\u043b \u043f\u0440\u0438\u043c\u0435\u0440\u043d\u043e \u0442\u0430\u043a:<\/p>\n<pre><code class=\"php\">declare(strict_types=1);namespace App\\Http\\Controller;use App\\Http\\Request\\CreateCompletionRequest;use App\\Http\\View\\CompletionView;use App\\Service\\CompletionService;use Symfony\\Component\\HttpKernel\\Attribute\\MapRequestPayload;use Symfony\\Component\\Routing\\Attribute\\Route;#[Route('\/v1\/completions', methods: ['POST'])]final readonly class CreateCompletionController{    public function __construct(        private CompletionService $completionService,    ) {    }    public function __invoke(        #[MapRequestPayload] CreateCompletionRequest $request,    ): CompletionView {        return new CompletionView(            text: $this-&gt;completionService-&gt;complete($request-&gt;prompt),        );    }}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>Request DTO:<\/p>\n<pre><code class=\"php\">declare(strict_types=1);namespace App\\Http\\Request;final readonly class CreateCompletionRequest{    public function __construct(        public string $prompt,    ) {    }}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>View object:<\/p>\n<pre><code class=\"php\">declare(strict_types=1);namespace App\\Http\\View;final readonly class CompletionView{    public function __construct(        public string $text,    ) {    }}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u041c\u0430\u0440\u0448\u0440\u0443\u0442 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 path \u0438 method.<br \/><code>#[MapRequestPayload]<\/code> \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442, \u043e\u0442\u043a\u0443\u0434\u0430 \u0432\u0437\u044f\u0442\u044c \u0432\u0445\u043e\u0434\u043d\u044b\u0435 \u0434\u0430\u043d\u043d\u044b\u0435.<br \/>Request DTO \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 request body.<br \/>Return type \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 response.<br \/>View object \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 \u0444\u043e\u0440\u043c\u0443 \u043e\u0442\u0432\u0435\u0442\u0430.<\/p>\n<p>\u041f\u043e \u043c\u043e\u0435\u0439 \u0437\u0430\u0434\u0443\u043c\u043a\u0435, \u044d\u0442\u043e\u0433\u043e \u0443\u0436\u0435 \u0434\u043e\u043b\u0436\u043d\u043e \u0431\u044b\u0442\u044c \u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e, \u0447\u0442\u043e\u0431\u044b \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u044c OpenAPI-\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442.<\/p>\n<p>\u041d\u0435 \u0432\u0441\u0435\u0433\u0434\u0430. \u0415\u0441\u0442\u044c corner cases. \u041d\u043e \u0434\u043b\u044f \u0431\u043e\u043b\u044c\u0448\u0438\u043d\u0441\u0442\u0432\u0430 API methods, \u043f\u043e \u043c\u043e\u0435\u043c\u0443 \u043e\u043f\u044b\u0442\u0443, \u044d\u0442\u043e\u0433\u043e \u0434\u0435\u0439\u0441\u0442\u0432\u0438\u0442\u0435\u043b\u044c\u043d\u043e \u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e.<\/p>\n<h3>\u0410 \u0447\u0442\u043e \u0435\u0441\u043b\u0438&#8230;<\/h3>\n<p>\u0412\u043e \u0432\u0440\u0435\u043c\u0435\u043d\u0430 \u0418\u0418-\u0430\u0436\u0438\u043e\u0442\u0430\u0436\u0430 \u043c\u043e\u0436\u043d\u043e, \u043a\u043e\u043d\u0435\u0447\u043d\u043e, \u0440\u0435\u0448\u0438\u0442\u044c \u043f\u0440\u043e\u0431\u043b\u0435\u043c\u0443 \u043f\u0440\u0438\u043c\u0435\u0440\u043d\u043e \u0442\u0430\u043a:<\/p>\n<pre><code class=\"php\">declare(strict_types=1);namespace App\\Command;use App\\Ai\\ArtificialIntelligenceInterface;use Symfony\\Component\\Console\\Attribute\\AsCommand;use Symfony\\Component\\Console\\Command\\Command;use Symfony\\Component\\Console\\Input\\InputInterface;use Symfony\\Component\\Console\\Output\\OutputInterface;#[AsCommand('app:generate-openapi')]final readonly class GenerateOpenApiCommand extends Command{    public function __construct(        private ArtificialIntelligenceInterface $ai,    ) {        parent::__construct();    }    protected function execute(InputInterface $input, OutputInterface $output): int    {        $document = $this-&gt;ai-&gt;complete(            &lt;&lt;&lt;'PROMPT'            Analyze all Symfony controllers in src\/Http\/Controller.            Generate a valid OpenAPI 3.1 JSON document based on routes,            request DTOs and response types.            Return only raw JSON without Markdown, comments or explanations.            PROMPT,        );        file_put_contents(__DIR__ . '\/..\/..\/var\/openapi.json', $document);        return Command::SUCCESS;    }}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u042f \u043d\u0435 \u0441\u0435\u0440\u044c\u0451\u0437\u043d\u043e.<\/p>\n<p>\u041e\u0447\u0435\u043d\u044c \u043d\u0430\u0434\u0435\u044e\u0441\u044c, \u0447\u0442\u043e \u0442\u0430\u043a \u043d\u0438\u043a\u0442\u043e \u043d\u0435 \u0434\u0435\u043b\u0430\u0435\u0442.<\/p>\n<p>\u042f \u043d\u0435 \u043c\u043e\u0433 \u043d\u0435 \u043f\u043e\u0434\u0435\u043b\u0438\u0442\u044c\u0441\u044f \u044d\u0442\u043e\u0439 \u0448\u0443\u0442\u043a\u043e\u0439, \u043c\u0435\u043d\u044f \u043e\u043d\u0430 \u043f\u043e\u0437\u0430\u0431\u0430\u0432\u0438\u043b\u0430, \u043d\u0430\u0434\u0435\u044e\u0441\u044c \u0438 \u0432\u0430\u0441!<\/p>\n<p>\u0418 \u0434\u0435\u043b\u043e \u0434\u0430\u0436\u0435 \u043d\u0435 \u0432 \u0442\u043e\u043c, \u0447\u0442\u043e \u0418\u0418 \u043c\u043e\u0436\u0435\u0442 \u043e\u0448\u0438\u0431\u0438\u0442\u044c\u0441\u044f. \u041e\u043d \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u043e \u043e\u0448\u0438\u0431\u0451\u0442\u0441\u044f. \u0412\u043e\u043f\u0440\u043e\u0441 \u0442\u043e\u043b\u044c\u043a\u043e \u0432 \u0442\u043e\u043c, \u043d\u0430\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0443\u0432\u0435\u0440\u0435\u043d\u043d\u043e \u0438 \u043d\u0430\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u043f\u043e\u0437\u0434\u043d\u043e \u0432\u044b \u044d\u0442\u043e \u0437\u0430\u043c\u0435\u0442\u0438\u0442\u0435.<\/p>\n<figure class=\"\"><img decoding=\"async\" src=\"https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/upload_files\/1de\/995\/280\/1de9952803018fd5032354972af2f2e9.png\" alt=\"\u042f, \u0437\u0430\u0441\u0442\u0430\u0432\u043b\u044f\u044e \u0441\u0432\u043e\u0439 \u043c\u043e\u0437\u0433 \u0440\u0430\u0431\u043e\u0442\u0430\u0442\u044c \u0431\u0435\u0437 \u0418\u0418\" title=\"\u042f, \u0437\u0430\u0441\u0442\u0430\u0432\u043b\u044f\u044e \u0441\u0432\u043e\u0439 \u043c\u043e\u0437\u0433 \u0440\u0430\u0431\u043e\u0442\u0430\u0442\u044c \u0431\u0435\u0437 \u0418\u0418\" width=\"500\" height=\"185\" sizes=\"auto, (max-width: 780px) 100vw, 50vw\" srcset=\"https:\/\/habrastorage.org\/r\/w780\/getpro\/habr\/upload_files\/1de\/995\/280\/1de9952803018fd5032354972af2f2e9.png 780w,&#10;       https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/upload_files\/1de\/995\/280\/1de9952803018fd5032354972af2f2e9.png 781w\" loading=\"lazy\" decode=\"async\"\/><\/p>\n<div><figcaption>\u042f, \u0437\u0430\u0441\u0442\u0430\u0432\u043b\u044f\u044e \u0441\u0432\u043e\u0439 \u043c\u043e\u0437\u0433 \u0440\u0430\u0431\u043e\u0442\u0430\u0442\u044c \u0431\u0435\u0437 \u0418\u0418<\/figcaption><\/div>\n<\/figure>\n<h3>\u0427\u0442\u043e \u0434\u0435\u043b\u0430\u0435\u0442 \u043f\u0430\u043a\u0435\u0442<\/h3>\n<p><a href=\"https:\/\/github.com\/sunrise-studio-development\/symfony-openapi\" rel=\"noopener noreferrer nofollow\"><code>sunrise-studio\/symfony-openapi<\/code><\/a> \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442 OpenAPI-\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442 \u0438\u0437 \u0442\u043e\u0433\u043e, \u0447\u0442\u043e \u0443\u0436\u0435 \u0435\u0441\u0442\u044c \u0432 Symfony-\u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0438:<\/p>\n<ul>\n<li>\n<p>Symfony routes;<\/p>\n<\/li>\n<li>\n<p>\u0441\u0438\u0433\u043d\u0430\u0442\u0443\u0440 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u043e\u0432;<\/p>\n<\/li>\n<li>\n<p>Symfony HttpKernel attributes;<\/p>\n<\/li>\n<li>\n<p>\u0442\u0438\u043f\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0445 DTO\/View classes;<\/p>\n<\/li>\n<li>\n<p>route options;<\/p>\n<\/li>\n<li>\n<p>\u043d\u0435\u0431\u043e\u043b\u044c\u0448\u0438\u0445 OpenAPI attributes \u0442\u043e\u043b\u044c\u043a\u043e \u0434\u043b\u044f \u0442\u0435\u0445 \u0441\u043b\u0443\u0447\u0430\u0435\u0432, \u0433\u0434\u0435 PHP-\u0442\u0438\u043f\u043e\u0432 \u0438 \u043c\u0430\u0440\u0448\u0440\u0443\u0442\u043e\u0432 \u0443\u0436\u0435 \u043d\u0435\u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e.<\/p>\n<\/li>\n<\/ul>\n<p>\u0413\u043b\u0430\u0432\u043d\u0430\u044f \u0446\u0435\u043b\u044c \u043f\u0440\u043e\u0441\u0442\u0430\u044f: \u043e\u0431\u044b\u0447\u043d\u044b\u0435 endpoints \u043d\u0435 \u0434\u043e\u043b\u0436\u043d\u044b \u0442\u0440\u0435\u0431\u043e\u0432\u0430\u0442\u044c \u0431\u043e\u043b\u044c\u0448\u0438\u0445 \u0431\u043b\u043e\u043a\u043e\u0432 <code>#[OA\\...]<\/code>.<\/p>\n<p>\u0415\u0441\u043b\u0438 endpoint \u043f\u0440\u043e\u0441\u0442\u043e\u0439, \u043e\u043d \u0434\u043e\u043b\u0436\u0435\u043d \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0438\u0440\u043e\u0432\u0430\u0442\u044c\u0441\u044f \u043f\u043e\u0447\u0442\u0438 \u0441\u0430\u043c. \u0415\u0441\u043b\u0438 endpoint \u043e\u0441\u043e\u0431\u0435\u043d\u043d\u044b\u0439, \u043c\u043e\u0436\u043d\u043e \u0432\u043c\u0435\u0448\u0430\u0442\u044c\u0441\u044f \u0432\u0440\u0443\u0447\u043d\u0443\u044e, \u043d\u043e \u0442\u043e\u0447\u0435\u0447\u043d\u043e.<\/p>\n<p>\u041f\u043e\u0434\u0440\u043e\u0431\u043d\u043e\u0441\u0442\u0438 \u044f \u043f\u043e\u0441\u0442\u0430\u0440\u0430\u043b\u0441\u044f \u043e\u043f\u0438\u0441\u0430\u0442\u044c \u0432 <a href=\"https:\/\/github.com\/sunrise-studio-development\/symfony-openapi\/blob\/master\/README-ru.md\" rel=\"noopener noreferrer nofollow\">README<\/a>. \u0422\u0430\u043c \u0435\u0441\u0442\u044c \u0443\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430, \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u044f, route options, request mapping, responses, errors, \u0440\u0443\u0447\u043d\u044b\u0435 OpenAPI-\u0444\u0440\u0430\u0433\u043c\u0435\u043d\u0442\u044b, schema resolvers \u0438 extension points.<\/p>\n<p>\u041a\u0430\u043a \u043c\u0438\u043d\u0438\u043c\u0443\u043c, \u0435\u0441\u043b\u0438 \u043d\u0435 \u0434\u043b\u044f \u0432\u0430\u0441 \u043b\u0438\u0447\u043d\u043e, \u0442\u043e \u0434\u043b\u044f \u0418\u0418, \u043a\u043e\u0442\u043e\u0440\u043e\u043c\u0443 \u0432\u044b \u043f\u043e\u0442\u043e\u043c \u0441\u043a\u043e\u0440\u043c\u0438\u0442\u0435 README \u0438 \u043f\u043e\u043f\u0440\u043e\u0441\u0438\u0442\u0435 \u043f\u043e\u0434\u043a\u043b\u044e\u0447\u0438\u0442\u044c \u043f\u0430\u043a\u0435\u0442 \u0432 \u043f\u0440\u043e\u0435\u043a\u0442\u0435.<\/p>\n<h3>\u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430 \u0438 \u043f\u0435\u0440\u0432\u044b\u0439 \u0437\u0430\u043f\u0443\u0441\u043a<\/h3>\n<p>\u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430:<\/p>\n<pre><code class=\"bash\">composer require sunrise-studio\/symfony-openapi<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u041f\u043e\u0434\u043a\u043b\u044e\u0447\u0438\u0442\u0435 bundle:<\/p>\n<pre><code class=\"php\">\/\/ config\/bundles.phpreturn [    Symfony\\Bundle\\FrameworkBundle\\FrameworkBundle::class =&gt; ['all' =&gt; true],    Sunrise\\Symfony\\OpenApi\\OpenApiBundle::class =&gt; ['all' =&gt; true],];<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0418\u043c\u043f\u043e\u0440\u0442\u0438\u0440\u0443\u0439\u0442\u0435 \u043c\u0430\u0440\u0448\u0440\u0443\u0442\u044b \u043f\u0430\u043a\u0435\u0442\u0430:<\/p>\n<pre><code class=\"yaml\"># config\/routes.yamlopenapi:    resource: '@OpenApiBundle\/config\/routes.php'<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u041f\u043e\u0441\u043b\u0435 \u044d\u0442\u043e\u0433\u043e \u0431\u0443\u0434\u0443\u0442 \u0434\u043e\u0441\u0442\u0443\u043f\u043d\u044b \u0434\u0432\u0430 \u043c\u0430\u0440\u0448\u0440\u0443\u0442\u0430:<\/p>\n<pre><code>GET \/docsGET \/docs\/openapi.json<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p><code>\/docs<\/code> \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442 Swagger UI.<br \/><code>\/docs\/openapi.json<\/code> \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 OpenAPI JSON document.<\/p>\n<p>\u0411\u0430\u0437\u043e\u0432\u0430\u044f \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u044f \u043c\u043e\u0436\u0435\u0442 \u0432\u044b\u0433\u043b\u044f\u0434\u0435\u0442\u044c \u0442\u0430\u043a:<\/p>\n<pre><code class=\"yaml\"># config\/packages\/openapi.yamlparameters:    openapi.initial_document:        openapi: 3.1.1        info:            title: API            version: 1.0.0<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0421\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442 \u0432 \u0444\u0430\u0439\u043b \u043c\u043e\u0436\u043d\u043e \u043a\u043e\u043c\u0430\u043d\u0434\u043e\u0439:<\/p>\n<pre><code class=\"bash\">php bin\/console openapi:build-document<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u041f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e \u043a\u043e\u043c\u0430\u043d\u0434\u0430 \u0437\u0430\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442 \u0432 \u0444\u0430\u0439\u043b, \u0443\u043a\u0430\u0437\u0430\u043d\u043d\u044b\u0439 \u0432 <code>openapi.document_filename<\/code>.<\/p>\n<p>\u0415\u0441\u043b\u0438 \u043d\u0443\u0436\u0435\u043d \u0434\u0440\u0443\u0433\u043e\u0439 \u043f\u0443\u0442\u044c \u0434\u043b\u044f Swagger UI, \u043c\u043e\u0436\u043d\u043e \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0438\u0442\u044c \u043c\u0430\u0440\u0448\u0440\u0443\u0442 \u0441\u0430\u043c\u043e\u043c\u0443:<\/p>\n<pre><code class=\"yaml\"># config\/routes.yamlswagger_ui:    path: \/swagger.html    controller: Sunrise\\Symfony\\OpenApi\\Controller\\SwaggerController    methods: [GET]    options:        api: false<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0415\u0441\u043b\u0438 \u043c\u0435\u043d\u044f\u0435\u0442\u0441\u044f \u043f\u0443\u0442\u044c \u0441\u0430\u043c\u043e\u0433\u043e OpenAPI-\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430, \u043d\u0443\u0436\u043d\u043e \u043e\u0431\u043d\u043e\u0432\u0438\u0442\u044c \u0438 \u043c\u0430\u0440\u0448\u0440\u0443\u0442, \u0438 <code>openapi.document_uri<\/code>, \u0447\u0442\u043e\u0431\u044b Swagger UI \u0437\u0430\u0433\u0440\u0443\u0436\u0430\u043b \u043f\u0440\u0430\u0432\u0438\u043b\u044c\u043d\u044b\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442:<\/p>\n<pre><code class=\"yaml\"># config\/routes.yamlopenapi_document:    path: \/openapi.json    controller: Sunrise\\Symfony\\OpenApi\\Controller\\DocumentController    methods: [GET]    options:        api: false<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<pre><code class=\"yaml\"># config\/packages\/openapi.yamlparameters:    openapi.document_uri: \/openapi.json<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<h3>\u041c\u0438\u043d\u0438\u043c\u0430\u043b\u044c\u043d\u044b\u0439 endpoint<\/h3>\n<p>\u0412\u0435\u0440\u043d\u0451\u043c\u0441\u044f \u043a \u043f\u0440\u0438\u043c\u0435\u0440\u0443 \u0441 completions.<\/p>\n<pre><code class=\"php\">declare(strict_types=1);namespace App\\Http\\Controller;use App\\Http\\Request\\CreateCompletionRequest;use App\\Http\\View\\CompletionView;use App\\Service\\CompletionService;use Symfony\\Component\\HttpKernel\\Attribute\\MapRequestPayload;use Symfony\\Component\\Routing\\Attribute\\Route;#[Route('\/v1\/completions', methods: ['POST'])]final readonly class CreateCompletionController{    public function __construct(        private CompletionService $completionService,    ) {    }    public function __invoke(        #[MapRequestPayload] CreateCompletionRequest $request,    ): CompletionView {        return new CompletionView(            text: $this-&gt;completionService-&gt;complete($request-&gt;prompt),        );    }}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0417\u0434\u0435\u0441\u044c \u043d\u0435\u0442:<\/p>\n<pre><code class=\"php\">#[OA\\Post(...)]#[OA\\RequestBody(...)]#[OA\\Response(...)]#[OA\\JsonContent(...)]<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0418\u0434\u0435\u044f \u0432 \u0442\u043e\u043c, \u0447\u0442\u043e \u043c\u043d\u0435 \u043d\u0435 \u043d\u0443\u0436\u043d\u043e \u0432\u0442\u043e\u0440\u043e\u0439 \u0440\u0430\u0437 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0442\u044c \u0442\u043e, \u0447\u0442\u043e \u0443\u0436\u0435 \u0435\u0441\u0442\u044c \u0432 \u043a\u043e\u0434\u0435.<\/p>\n<p>Route \u0443\u0436\u0435 \u0437\u043d\u0430\u0435\u0442 path \u0438 method.<br \/><code>CreateCompletionRequest<\/code> \u0443\u0436\u0435 \u0437\u043d\u0430\u0435\u0442 request body.<br \/><code>CompletionView<\/code> \u0443\u0436\u0435 \u0437\u043d\u0430\u0435\u0442 response body.<br \/>Return type \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u0430 \u0443\u0436\u0435 \u0433\u043e\u0432\u043e\u0440\u0438\u0442, \u0447\u0442\u043e endpoint \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 <code>CompletionView<\/code>.<\/p>\n<h3>\u0415\u0441\u043b\u0438 \u0432\u0441\u0451-\u0442\u0430\u043a\u0438 \u0445\u043e\u0447\u0435\u0442\u0441\u044f \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c metadata<\/h3>\n<p>\u0418\u043d\u043e\u0433\u0434\u0430 \u043d\u0443\u0436\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c tags, summary, description \u0438\u043b\u0438 status code.<\/p>\n<p>\u042f \u043d\u0435 \u0445\u043e\u0442\u0435\u043b \u043f\u0440\u0435\u0432\u0440\u0430\u0449\u0430\u0442\u044c \u044d\u0442\u043e \u043e\u0431\u0440\u0430\u0442\u043d\u043e \u0432 \u0431\u043e\u043b\u044c\u0448\u043e\u0439 OpenAPI-\u0431\u043b\u043e\u043a, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 metadata \u043c\u043e\u0436\u043d\u043e \u0434\u0435\u0440\u0436\u0430\u0442\u044c \u0431\u043b\u0438\u0436\u0435 \u043a \u043c\u0430\u0440\u0448\u0440\u0443\u0442\u0443:<\/p>\n<pre><code class=\"php\">declare(strict_types=1);namespace App\\Http\\Controller;use App\\Http\\Request\\CreateCompletionRequest;use App\\Http\\View\\CompletionView;use Symfony\\Component\\HttpKernel\\Attribute\\MapRequestPayload;use Symfony\\Component\\Routing\\Attribute\\Route;#[Route(    '\/v1\/completions',    methods: ['POST'],    options: [        'tags' =&gt; ['Completions'],        'summary' =&gt; 'Creates completion',        'description' =&gt; 'Creates text completion for the given prompt.',        'response_code' =&gt; 201,    ],)]final readonly class CreateCompletionController{    public function __invoke(        #[MapRequestPayload] CreateCompletionRequest $request,    ): CompletionView {        \/\/ ...    }}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u042d\u0442\u043e \u0432\u0441\u0451 \u0435\u0449\u0451 \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u043a\u0430\u043a \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0435 \u043c\u0430\u0440\u0448\u0440\u0443\u0442\u0430 \u0438 \u043f\u043e\u0432\u0435\u0434\u0435\u043d\u0438\u044f endpoint-\u0430, \u0430 \u043d\u0435 \u043a\u0430\u043a \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0439 OpenAPI-\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442 \u0432\u043d\u0443\u0442\u0440\u0438 PHP-\u0430\u0442\u0440\u0438\u0431\u0443\u0442\u0430.<\/p>\n<p>\u041f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u044e\u0442\u0441\u044f, \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440:<\/p>\n<ul>\n<li>\n<p><code>tag<\/code>, <code>tags<\/code>;<\/p>\n<\/li>\n<li>\n<p><code>summary<\/code>;<\/p>\n<\/li>\n<li>\n<p><code>description<\/code>;<\/p>\n<\/li>\n<li>\n<p><code>deprecated<\/code>;<\/p>\n<\/li>\n<li>\n<p><code>api<\/code>;<\/p>\n<\/li>\n<li>\n<p><code>response_code<\/code>;<\/p>\n<\/li>\n<li>\n<p><code>response_format<\/code>, <code>response_formats<\/code>.<\/p>\n<\/li>\n<\/ul>\n<p>\u0415\u0441\u043b\u0438 \u0432\u0430\u0448\u0435\u043c\u0443 \u043f\u0440\u043e\u0435\u043a\u0442\u0443 \u043d\u0435 \u043d\u0440\u0430\u0432\u0438\u0442\u0441\u044f \u0445\u0440\u0430\u043d\u0438\u0442\u044c \u044d\u0442\u043e \u0432 route options, \u043c\u043e\u0436\u043d\u043e \u0437\u0430\u043c\u0435\u043d\u0438\u0442\u044c <code>RouteMetadataResolverInterface<\/code>.<\/p>\n<h3>Request body, query, path variables<\/h3>\n<p>\u041f\u0430\u043a\u0435\u0442 \u043f\u043e\u043d\u0438\u043c\u0430\u0435\u0442 Symfony attributes, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u044e\u0442 request data.<\/p>\n<p>Request body \u0447\u0435\u0440\u0435\u0437 <code>#[MapRequestPayload]<\/code>:<\/p>\n<pre><code class=\"php\">use Symfony\\Component\\HttpKernel\\Attribute\\MapRequestPayload;use Symfony\\Component\\Routing\\Attribute\\Route;#[Route('\/v1\/completions', methods: ['POST'])]public function __invoke(    #[MapRequestPayload] CreateCompletionRequest $request,): CompletionView {    \/\/ ...}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>Path variables \u0447\u0438\u0442\u0430\u044e\u0442\u0441\u044f \u0438\u0437 \u043c\u0430\u0440\u0448\u0440\u0443\u0442\u0430 \u0438 \u0441\u0438\u0433\u043d\u0430\u0442\u0443\u0440\u044b \u043c\u0435\u0442\u043e\u0434\u0430:<\/p>\n<pre><code class=\"php\">use Symfony\\Component\\Routing\\Attribute\\Route;#[Route('\/v1\/completions\/{id}', methods: ['GET'])]public function __invoke(string $id): CompletionView{    \/\/ ...}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>Query object \u043c\u043e\u0436\u043d\u043e \u043e\u043f\u0438\u0441\u0430\u0442\u044c \u0447\u0435\u0440\u0435\u0437 <code>#[MapQueryString]<\/code>:<\/p>\n<pre><code class=\"php\">use Symfony\\Component\\HttpKernel\\Attribute\\MapQueryString;use Symfony\\Component\\Routing\\Attribute\\Route;#[Route('\/v1\/completions', methods: ['GET'])]public function __invoke(    #[MapQueryString] CompletionListQuery $query,): CompletionListView {    \/\/ ...}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u041e\u0431\u044b\u0447\u043d\u044b\u0435 scalar query parameters \u043c\u043e\u0436\u043d\u043e \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0442\u044c \u0447\u0435\u0440\u0435\u0437 <code>#[MapQueryParameter]<\/code>.<\/p>\n<h3>\u041f\u043e\u0447\u0435\u043c\u0443 \u044f \u043f\u0440\u0435\u0434\u043f\u043e\u0447\u0438\u0442\u0430\u044e View objects \u0432\u043c\u0435\u0441\u0442\u043e JsonResponse<\/h3>\n<p>\u042f \u043d\u0435 \u043c\u043e\u0433\u0443 \u0438 \u043d\u0435 \u0445\u043e\u0447\u0443 \u043d\u0430\u0432\u044f\u0437\u044b\u0432\u0430\u0442\u044c \u0432\u0441\u0435\u043c \u0430\u0440\u0445\u0438\u0442\u0435\u043a\u0442\u0443\u0440\u0443. \u0423 \u043f\u0440\u043e\u0435\u043a\u0442\u043e\u0432 \u0431\u044b\u0432\u0430\u044e\u0442 \u0440\u0430\u0437\u043d\u044b\u0435 \u0442\u0440\u0435\u0431\u043e\u0432\u0430\u043d\u0438\u044f, legacy, \u0441\u043e\u0433\u043b\u0430\u0448\u0435\u043d\u0438\u044f, \u0441\u0442\u0440\u0430\u043d\u043d\u044b\u0435 \u0438\u043d\u0442\u0435\u0433\u0440\u0430\u0446\u0438\u0438 \u0438 \u0435\u0449\u0451 \u043c\u043d\u043e\u0436\u0435\u0441\u0442\u0432\u043e \u0432\u0435\u0449\u0435\u0439, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u043e\u0431\u044b\u0447\u043d\u043e \u043f\u043e\u044f\u0432\u043b\u044f\u044e\u0442\u0441\u044f \u0432 \u0441\u0438\u0441\u0442\u0435\u043c\u0435 \u043f\u043e\u0441\u043b\u0435 \u0441\u043b\u043e\u0432 \u00ab\u044d\u0442\u043e \u0432\u0440\u0435\u043c\u0435\u043d\u043d\u043e\u00bb.<\/p>\n<p>\u041d\u043e \u043b\u0438\u0447\u043d\u043e \u044f \u0443\u0436\u0435 \u043d\u0435 \u0432 \u043e\u0434\u043d\u043e\u043c \u043f\u0440\u043e\u0435\u043a\u0442\u0435 \u043e\u0442\u043a\u0430\u0437\u0430\u043b\u0441\u044f \u043e\u0442 \u0440\u0443\u0447\u043d\u043e\u0433\u043e \u0432\u043e\u0437\u0432\u0440\u0430\u0442\u0430 <code>JsonResponse<\/code>\/<code>Response<\/code> \u0438\u0437 \u0431\u043e\u043b\u044c\u0448\u0438\u043d\u0441\u0442\u0432\u0430 API-\u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u043e\u0432.<\/p>\n<p>\u041d\u0430 \u043c\u043e\u0439 \u0432\u0437\u0433\u043b\u044f\u0434, \u0434\u043b\u044f API \u044d\u0442\u043e \u0447\u0438\u0449\u0435:<\/p>\n<pre><code class=\"php\">public function __invoke(    #[MapRequestPayload] CreateCompletionRequest $request,): CompletionView {    return new CompletionView(        text: $this-&gt;completionService-&gt;complete($request-&gt;prompt),    );}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u041a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442 \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0438.<br \/>HTTP-\u0441\u043b\u043e\u0439 \u0437\u0430\u043d\u0438\u043c\u0430\u0435\u0442\u0441\u044f \u0441\u0435\u0440\u0438\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u0435\u0439.<br \/>OpenAPI-\u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440 \u0432\u0438\u0434\u0438\u0442 return type \u0438 \u043c\u043e\u0436\u0435\u0442 \u043f\u043e\u0441\u0442\u0440\u043e\u0438\u0442\u044c schema.<\/p>\n<p>\u042f \u043d\u0435 \u043d\u0430\u0437\u044b\u0432\u0430\u044e \u044d\u0442\u043e DDD \u0432 \u0441\u0442\u0440\u043e\u0433\u043e\u043c \u0441\u043c\u044b\u0441\u043b\u0435. \u0421\u043a\u043e\u0440\u0435\u0435 \u044d\u0442\u043e \u043d\u043e\u0440\u043c\u0430\u043b\u044c\u043d\u0430\u044f \u0433\u0440\u0430\u043d\u0438\u0446\u0430 \u043c\u0435\u0436\u0434\u0443 application code \u0438 HTTP-\u043f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u0435\u043d\u0438\u0435\u043c. DTO \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 \u0432\u0445\u043e\u0434, View object \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 \u0432\u044b\u0445\u043e\u0434, \u0430 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440 \u043f\u0435\u0440\u0435\u0441\u0442\u0430\u0451\u0442 \u0431\u044b\u0442\u044c \u043c\u0435\u0441\u0442\u043e\u043c, \u0433\u0434\u0435 \u0440\u0443\u043a\u0430\u043c\u0438 \u0441\u043e\u0431\u0438\u0440\u0430\u044e\u0442\u0441\u044f JSON-\u043c\u0430\u0441\u0441\u0438\u0432\u044b, status codes \u0438 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f.<\/p>\n<p>\u0423 \u043c\u0435\u043d\u044f \u0435\u0441\u0442\u044c \u043f\u0440\u043e\u0435\u043a\u0442 \u0441\u043e 100+ API \u043c\u0435\u0442\u043e\u0434\u0430\u043c\u0438, \u0438 \u0431\u0443\u043a\u0432\u0430\u043b\u044c\u043d\u043e \u0432 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u0438\u0445 \u043c\u0435\u0441\u0442\u0430\u0445 \u043f\u0440\u0438\u0448\u043b\u043e\u0441\u044c \u0432\u0435\u0440\u043d\u0443\u0442\u044c <code>Response<\/code> \u043d\u0430\u043f\u0440\u044f\u043c\u0443\u044e. \u0422\u0430\u043a\u0438\u0435 corner cases \u0431\u044b\u0432\u0430\u044e\u0442. \u042d\u0442\u043e \u043d\u043e\u0440\u043c\u0430\u043b\u044c\u043d\u043e.<\/p>\n<p>\u0414\u043b\u044f \u043d\u0438\u0445 \u0435\u0441\u0442\u044c \u0440\u0443\u0447\u043d\u043e\u0435 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0435 \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0438 \u0447\u0435\u0440\u0435\u0437 <code>#[Operation]<\/code>.<\/p>\n<h3>\u0420\u0443\u0447\u043d\u043e\u0435 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0435 \u0447\u0435\u0440\u0435\u0437 #[Operation] \u0438 Type<\/h3>\n<p>\u0415\u0441\u043b\u0438 endpoint \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 <code>Response<\/code>, \u043f\u0430\u043a\u0435\u0442 \u043d\u0435 \u043c\u043e\u0436\u0435\u0442 \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438 \u043f\u043e\u043d\u044f\u0442\u044c response body. \u0418 \u044d\u0442\u043e \u043f\u0440\u0430\u0432\u0438\u043b\u044c\u043d\u043e: \u0435\u0441\u043b\u0438 \u0432\u044b \u0432\u0435\u0440\u043d\u0443\u043b\u0438 \u043d\u0438\u0437\u043a\u043e\u0443\u0440\u043e\u0432\u043d\u0435\u0432\u044b\u0439 <code>Response<\/code>, \u0437\u043d\u0430\u0447\u0438\u0442 \u0432\u044b \u0441\u0430\u043c\u0438 \u0432\u0437\u044f\u043b\u0438 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u044c \u043d\u0430\u0434 \u043e\u0442\u0432\u0435\u0442\u043e\u043c.<\/p>\n<p>\u041d\u043e \u0434\u0430\u0436\u0435 \u0432 \u0442\u0430\u043a\u043e\u043c \u0441\u043b\u0443\u0447\u0430\u0435 \u043d\u0435 \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u043e \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0442\u044c\u0441\u044f \u043a \u043e\u0433\u0440\u043e\u043c\u043d\u044b\u043c <code>#[OA\\...]<\/code>.<\/p>\n<p>\u041c\u043e\u0436\u043d\u043e \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c <code>#[Operation]<\/code> \u0438 <code>Type<\/code>:<\/p>\n<pre><code class=\"php\">declare(strict_types=1);namespace App\\Http\\Controller;use App\\Http\\Request\\CreateCompletionRequest;use App\\Http\\View\\CompletionView;use Sunrise\\Symfony\\OpenApi\\Annotation\\Operation;use Sunrise\\Symfony\\OpenApi\\Type;use Symfony\\Component\\HttpFoundation\\Response;use Symfony\\Component\\HttpKernel\\Attribute\\MapRequestPayload;use Symfony\\Component\\Routing\\Attribute\\Route;#[Route('\/v1\/completions\/stream', methods: ['POST'])]final readonly class StreamCompletionController{    #[Operation([        'responses' =&gt; [            200 =&gt; [                'description' =&gt; 'Completion stream.',                'content' =&gt; [                    'application\/json' =&gt; [                        'schema' =&gt; new Type(CompletionView::class),                    ],                ],            ],        ],    ])]    public function __invoke(        #[MapRequestPayload] CreateCompletionRequest $request,    ): Response {        \/\/ corner case    }}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p><code>Type<\/code> \u0443\u0434\u043e\u0431\u0435\u043d \u0442\u0435\u043c, \u0447\u0442\u043e \u043c\u043e\u0436\u043d\u043e \u0441\u043e\u0441\u043b\u0430\u0442\u044c\u0441\u044f \u043d\u0430 PHP-\u043a\u043b\u0430\u0441\u0441, \u0430 \u043f\u0430\u043a\u0435\u0442 \u0441\u0430\u043c \u043f\u0440\u0435\u0432\u0440\u0430\u0442\u0438\u0442 \u0435\u0433\u043e \u0432 OpenAPI schema.<\/p>\n<p>\u0420\u0443\u0447\u043d\u043e\u0439 \u0440\u0435\u0436\u0438\u043c \u0435\u0441\u0442\u044c, \u043d\u043e \u043e\u043d, \u043a\u0430\u043a \u0432\u0438\u0434\u043d\u043e \u043d\u0430 \u043f\u0440\u0438\u043c\u0435\u0440\u0435 \u0432\u044b\u0448\u0435, \u0442\u043e\u0447\u0435\u0447\u043d\u044b\u0439.<\/p>\n<h3>Symfony 8.1 \u0438 \u0441\u0435\u0440\u0438\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044f \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u0430 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u0430<\/h3>\n<p>\u0412 Symfony 8.1 \u043f\u043e\u044f\u0432\u0438\u043b\u0441\u044f \u043d\u0430\u0442\u0438\u0432\u043d\u044b\u0439 <code>#[Serialize]<\/code>, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u0432\u0435\u0440\u043d\u0443\u0442\u044c \u0438\u0437 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u0430 \u043e\u0431\u044a\u0435\u043a\u0442 \u0438\u043b\u0438 \u043c\u0430\u0441\u0441\u0438\u0432, \u0430 Symfony \u0441\u0430\u043c \u0441\u0435\u0440\u0438\u0430\u043b\u0438\u0437\u0443\u0435\u0442 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442 \u0432 <code>Response<\/code>.<\/p>\n<p>\u042d\u0442\u043e \u043e\u0447\u0435\u043d\u044c \u043f\u0440\u0438\u044f\u0442\u043d\u044b\u0439 \u0431\u043e\u043d\u0443\u0441.<\/p>\n<pre><code class=\"php\">use Symfony\\Component\\HttpKernel\\Attribute\\MapRequestPayload;use Symfony\\Component\\HttpKernel\\Attribute\\Serialize;use Symfony\\Component\\Routing\\Attribute\\Route;#[Route('\/v1\/completions', methods: ['POST'])]#[Serialize(code: 201)]public function __invoke(    #[MapRequestPayload] CreateCompletionRequest $request,): CompletionView {    \/\/ ...}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0415\u0441\u043b\u0438 <code>#[Serialize]<\/code> \u0435\u0441\u0442\u044c, \u043f\u0430\u043a\u0435\u0442 \u043c\u043e\u0436\u0435\u0442 \u0443\u0447\u0438\u0442\u044b\u0432\u0430\u0442\u044c \u0435\u0433\u043e <code>code<\/code>, \u0430 schema \u0432\u0441\u0451 \u0440\u0430\u0432\u043d\u043e \u0431\u0435\u0440\u0451\u0442\u0441\u044f \u0438\u0437 PHP return type.<\/p>\n<p>\u041d\u043e \u044f \u0431\u044b \u043d\u0435 \u0441\u0442\u0430\u043b \u043e\u0431\u043d\u043e\u0432\u043b\u044f\u0442\u044c Symfony \u0442\u043e\u043b\u044c\u043a\u043e \u0440\u0430\u0434\u0438 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438. \u0415\u0441\u043b\u0438 \u043f\u0440\u043e\u0435\u043a\u0442 \u043d\u0438\u0436\u0435 8.1, runtime-\u0441\u0435\u0440\u0438\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044f \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u0430 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u0430 \u0434\u0435\u043b\u0430\u0435\u0442\u0441\u044f \u043d\u0435\u0431\u043e\u043b\u044c\u0448\u0438\u043c listener-\u043e\u043c.<\/p>\n<p>\u041d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, JSON-only \u0432\u0430\u0440\u0438\u0430\u043d\u0442 \u043c\u043e\u0436\u0435\u0442 \u0432\u044b\u0433\u043b\u044f\u0434\u0435\u0442\u044c \u0442\u0430\u043a:<\/p>\n<pre><code class=\"php\">declare(strict_types=1);namespace App\\Http\\EventListener;use Symfony\\Component\\EventDispatcher\\Attribute\\AsEventListener;use Symfony\\Component\\HttpFoundation\\JsonResponse;use Symfony\\Component\\HttpFoundation\\Response;use Symfony\\Component\\HttpKernel\\Event\\ViewEvent;use Symfony\\Component\\HttpKernel\\KernelEvents;use Symfony\\Component\\Routing\\Route;use Symfony\\Component\\Routing\\RouterInterface;use Symfony\\Component\\Serializer\\SerializerInterface;#[AsEventListener(event: KernelEvents::VIEW)]final readonly class JsonControllerResultListener{    public function __construct(        private SerializerInterface $serializer,        private RouterInterface $router,    ) {    }    public function __invoke(ViewEvent $event): void    {        $result = $event-&gt;getControllerResult();        if ($result === null) {            $event-&gt;setResponse(new Response(status: Response::HTTP_NO_CONTENT));            return;        }        $event-&gt;setResponse(new JsonResponse(            data: $this-&gt;serializer-&gt;serialize($result, 'json'),            status: $this-&gt;resolveResponseCode($event),            json: true,        ));    }    private function resolveResponseCode(ViewEvent $event): int    {        $routeName = $event-&gt;getRequest()-&gt;attributes-&gt;get('_route');        if (!is_string($routeName)) {            return Response::HTTP_OK;        }        $route = $this-&gt;router-&gt;getRouteCollection()-&gt;get($routeName);        if (!$route instanceof Route) {            return Response::HTTP_OK;        }        return $route-&gt;getOption('response_code') ?? Response::HTTP_OK;    }}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0422\u0430\u043a\u043e\u0439 listener \u043d\u0435 \u0434\u043e\u043b\u0436\u0435\u043d \u043f\u043e\u0441\u0442\u0430\u0432\u043b\u044f\u0442\u044c\u0441\u044f \u0441 \u043f\u0430\u043a\u0435\u0442\u043e\u043c.<\/p>\n<p>\u042d\u0442\u043e \u0432\u044b\u0445\u043e\u0434\u0438\u0442 \u0437\u0430 \u0440\u0430\u043c\u043a\u0438 \u0435\u0433\u043e \u043e\u0442\u0432\u0435\u0442\u0441\u0442\u0432\u0435\u043d\u043d\u043e\u0441\u0442\u0438. \u0423 \u043a\u0430\u0436\u0434\u043e\u0433\u043e \u043f\u0440\u043e\u0435\u043a\u0442\u0430 \u043c\u043e\u0433\u0443\u0442 \u0431\u044b\u0442\u044c \u0441\u0432\u043e\u0438 \u043f\u0440\u0430\u0432\u0438\u043b\u0430: \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0430 \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043a\u0430 <code>Accept<\/code>, \u0440\u0430\u0437\u043d\u044b\u0435 \u0444\u043e\u0440\u043c\u0430\u0442\u044b \u043e\u0442\u0432\u0435\u0442\u0430, serializer groups, \u043b\u043e\u0433\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435, \u043d\u0435\u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u043d\u044b\u0435 headers, \u0434\u0438\u043d\u0430\u043c\u0438\u0447\u0435\u0441\u043a\u0430\u044f \u0441\u0435\u0440\u0438\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044f \u0438 \u0442\u0430\u043a \u0434\u0430\u043b\u0435\u0435.<\/p>\n<p>\u041f\u0430\u043a\u0435\u0442 \u043e\u0442\u0432\u0435\u0447\u0430\u0435\u0442 \u0437\u0430 \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044e OpenAPI-\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430. Runtime-\u043f\u043e\u0432\u0435\u0434\u0435\u043d\u0438\u0435 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f \u0434\u043e\u043b\u0436\u043d\u043e \u043e\u0441\u0442\u0430\u0432\u0430\u0442\u044c\u0441\u044f \u043f\u043e\u0434 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u0435\u043c \u0441\u0430\u043c\u043e\u0433\u043e \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f.<\/p>\n<h3>\u0427\u0442\u043e, \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e, \u043f\u0440\u0438\u0434\u0451\u0442\u0441\u044f \u0438\u0437\u043c\u0435\u043d\u0438\u0442\u044c \u0432 \u043f\u0440\u043e\u0435\u043a\u0442\u0435<\/h3>\n<p>\u041f\u0430\u043a\u0435\u0442 \u043c\u043e\u0436\u043d\u043e \u043f\u043e\u0441\u0442\u0430\u0432\u0438\u0442\u044c \u0438 \u043f\u043e\u043f\u0440\u043e\u0431\u043e\u0432\u0430\u0442\u044c \u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e \u0431\u044b\u0441\u0442\u0440\u043e.<\/p>\n<p>\u041d\u043e \u0435\u0441\u043b\u0438 \u0445\u043e\u0447\u0435\u0442\u0441\u044f \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u044c \u043e\u0442 \u043d\u0435\u0433\u043e \u043c\u0430\u043a\u0441\u0438\u043c\u0443\u043c \u043f\u043e\u043b\u044c\u0437\u044b, \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e, \u043f\u0440\u0438\u0434\u0451\u0442\u0441\u044f \u043f\u0440\u0438\u0432\u0435\u0441\u0442\u0438 \u0432 \u043f\u043e\u0440\u044f\u0434\u043e\u043a \u0441\u0430\u043c API-\u0441\u043b\u043e\u0439.<\/p>\n<h4>1. \u041c\u0435\u043d\u044c\u0448\u0435 HttpFoundation Request\/Response \u0432 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u0430\u0445<\/h4>\n<p>\u0415\u0441\u043b\u0438 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u044b \u0432\u0435\u0437\u0434\u0435 \u043f\u0440\u0438\u043d\u0438\u043c\u0430\u044e\u0442 <code>Request<\/code> \u0438 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u044e\u0442 <code>JsonResponse<\/code>, \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440\u0443 \u0441\u043b\u043e\u0436\u043d\u0435\u0435 \u043f\u043e\u043d\u044f\u0442\u044c \u043f\u0443\u0431\u043b\u0438\u0447\u043d\u044b\u0439 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442.<\/p>\n<p>\u042f \u0431\u044b \u0440\u0435\u043a\u043e\u043c\u0435\u043d\u0434\u043e\u0432\u0430\u043b \u0434\u043b\u044f \u043e\u0431\u044b\u0447\u043d\u044b\u0445 API methods \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c:<\/p>\n<ul>\n<li>\n<p>request DTO \u0434\u043b\u044f \u0432\u0445\u043e\u0434\u0430;<\/p>\n<\/li>\n<li>\n<p>View objects \u0434\u043b\u044f \u0432\u044b\u0445\u043e\u0434\u0430;<\/p>\n<\/li>\n<li>\n<p>typed properties;<\/p>\n<\/li>\n<li>\n<p>\u044f\u0432\u043d\u044b\u0435 return types;<\/p>\n<\/li>\n<li>\n<p>\u043c\u0438\u043d\u0438\u043c\u0430\u043b\u044c\u043d\u043e\u0435 \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u0440\u0443\u0447\u043d\u044b\u0445 OpenAPI-\u0444\u0440\u0430\u0433\u043c\u0435\u043d\u0442\u043e\u0432.<\/p>\n<\/li>\n<\/ul>\n<p>\u041d\u0435 \u043f\u043e\u0442\u043e\u043c\u0443 \u0447\u0442\u043e \u00ab\u0442\u0430\u043a \u043d\u0430\u0434\u043e \u043f\u043e \u043a\u043d\u0438\u0436\u043a\u0435\u00bb, \u0430 \u043f\u043e\u0442\u043e\u043c\u0443 \u0447\u0442\u043e \u0442\u0430\u043a \u043f\u0440\u043e\u0449\u0435 \u0447\u0438\u0442\u0430\u0442\u044c \u043a\u043e\u0434, \u043f\u0440\u043e\u0449\u0435 \u0440\u0435\u0444\u0430\u043a\u0442\u043e\u0440\u0438\u0442\u044c \u0438 \u043f\u0440\u043e\u0449\u0435 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e.<\/p>\n<h4>2. \u0415\u0434\u0438\u043d\u044b\u0439 \u0444\u043e\u0440\u043c\u0430\u0442 \u043e\u0448\u0438\u0431\u043e\u043a<\/h4>\n<p>\u041e\u0442\u0434\u0435\u043b\u044c\u043d\u043e \u0441\u0442\u043e\u0438\u0442 \u043f\u0435\u0440\u0435\u0441\u043c\u043e\u0442\u0440\u0435\u0442\u044c \u043e\u0431\u0440\u0430\u0431\u043e\u0442\u043a\u0443 \u043e\u0448\u0438\u0431\u043e\u043a.<\/p>\n<p>\u041e\u0447\u0435\u043d\u044c \u043d\u0435\u0443\u0434\u043e\u0431\u043d\u043e, \u043a\u043e\u0433\u0434\u0430 \u043e\u0434\u0438\u043d endpoint \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442:<\/p>\n<pre><code class=\"json\">{\"message\": \"Validation failed\"}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0434\u0440\u0443\u0433\u043e\u0439:<\/p>\n<pre><code class=\"json\">{\"error\": \"Bad request\"}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0430 \u0442\u0440\u0435\u0442\u0438\u0439:<\/p>\n<pre><code class=\"json\">{\"success\": false, \"data\": null, \"exception\": \"...\"}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0422\u0443\u0442 \u043d\u0438\u043a\u0430\u043a\u043e\u0439 \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440 \u043d\u0435 \u0441\u043f\u0430\u0441\u0451\u0442. \u041e\u043d \u043c\u043e\u0436\u0435\u0442 \u043e\u043f\u0438\u0441\u0430\u0442\u044c \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442, \u043d\u043e \u0435\u0441\u043b\u0438 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u0440\u0430\u0437\u043c\u0430\u0437\u0430\u043d \u043f\u043e \u043f\u0440\u043e\u0435\u043a\u0442\u0443 \u0432 \u0432\u0438\u0434\u0435 \u0440\u0430\u0437\u043d\u044b\u0445 \u0441\u043b\u0443\u0447\u0430\u0439\u043d\u044b\u0445 \u0444\u043e\u0440\u043c\u0430\u0442\u043e\u0432, \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043e\u0441\u043e\u0431\u043e \u043d\u0435\u0447\u0435\u0433\u043e.<\/p>\n<p>\u0412 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u0435\u0441\u0442\u044c \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0439 \u0440\u0430\u0437\u0434\u0435\u043b \u043f\u0440\u043e <a href=\"https:\/\/github.com\/sunrise-studio-development\/symfony-openapi\/blob\/master\/README-ru.md#%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D0%BE%D1%88%D0%B8%D0%B1%D0%BE%D0%BA\" rel=\"noopener noreferrer nofollow\">\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435 \u043e\u0448\u0438\u0431\u043e\u043a<\/a>. \u042f \u0431\u044b \u0440\u0435\u043a\u043e\u043c\u0435\u043d\u0434\u043e\u0432\u0430\u043b \u043f\u0440\u0438\u0432\u0435\u0441\u0442\u0438 \u043e\u0448\u0438\u0431\u043a\u0438 \u043a \u0435\u0434\u0438\u043d\u043e\u043c\u0443 \u0432\u0438\u0434\u0443 \u0438 \u0443\u0436\u0435 \u0435\u0433\u043e \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0438\u0440\u043e\u0432\u0430\u0442\u044c.<\/p>\n<p>\u041d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, view \u0434\u043b\u044f \u043e\u0448\u0438\u0431\u043a\u0438 \u043c\u043e\u0436\u0435\u0442 \u0432\u044b\u0433\u043b\u044f\u0434\u0435\u0442\u044c \u0442\u0430\u043a:<\/p>\n<pre><code class=\"php\">declare(strict_types=1);namespace App\\Http\\View;use Symfony\\Component\\Validator\\ConstraintViolationListInterface;final readonly class ErrorResponseView{    public function __construct(        public string $message,        \/** @var array&lt;array-key, ErrorView&gt; *\/        public array $errors = [],    ) {    }    public static function fromViolationList(        ConstraintViolationListInterface $violations,        ?string $message = null,    ): self {        return new self(            message: $message ?: 'Validation failed',            errors: array_map(ErrorView::fromViolation(...), [...$violations]),        );    }}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<pre><code class=\"php\">declare(strict_types=1);namespace App\\Http\\View;use Symfony\\Component\\Validator\\ConstraintViolationInterface;final readonly class ErrorView{    public function __construct(        public string $key,        public string $message,    ) {    }    public static function fromViolation(ConstraintViolationInterface $violation): self    {        return new self(            key: $violation-&gt;getPropertyPath(),            message: (string) $violation-&gt;getMessage(),        );    }}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0410 <code>ExceptionSubscriber<\/code> \u043c\u043e\u0436\u0435\u0442 \u043f\u0440\u0438\u0432\u043e\u0434\u0438\u0442\u044c \u0438\u0441\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u044f \u043a \u044d\u0442\u043e\u0439 \u0444\u043e\u0440\u043c\u0435:<\/p>\n<pre><code class=\"php\">declare(strict_types=1);namespace App\\Http\\Subscriber;use App\\Http\\View\\ErrorResponseView;use Psr\\Log\\LoggerInterface;use Symfony\\Component\\EventDispatcher\\EventSubscriberInterface;use Symfony\\Component\\HttpFoundation\\JsonResponse;use Symfony\\Component\\HttpFoundation\\Response;use Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent;use Symfony\\Component\\HttpKernel\\Exception\\HttpExceptionInterface;use Symfony\\Component\\HttpKernel\\KernelEvents;use Symfony\\Component\\HttpKernel\\KernelInterface;use Symfony\\Component\\Validator\\ConstraintViolationListInterface;use Symfony\\Component\\Validator\\Exception\\ValidationFailedException;final readonly class ExceptionSubscriber implements EventSubscriberInterface{    public function __construct(        private LoggerInterface $logger,        private KernelInterface $kernel,    ) {    }    \/**     * @return array&lt;string, string&gt;     *\/    public static function getSubscribedEvents(): array    {        return [KernelEvents::EXCEPTION =&gt; 'onKernelException'];    }    public function onKernelException(ExceptionEvent $event): void    {        $exception = $event-&gt;getThrowable();        if ($exception instanceof HttpExceptionInterface) {            $event-&gt;setResponse($this-&gt;buildHttpErrorResponse($exception));            return;        }        $this-&gt;logger-&gt;error($exception-&gt;getMessage(), [            'exception' =&gt; $exception,        ]);        $event-&gt;setResponse($this-&gt;buildFatalErrorResponse($exception));    }    private function buildErrorResponse(string $message, int $status): JsonResponse    {        $message = $message ?: Response::$statusTexts[$status] ?? (string) $status;        return new JsonResponse(new ErrorResponseView($message), $status);    }    private function buildHttpErrorResponse(HttpExceptionInterface $exception): Response    {        $previous = $exception-&gt;getPrevious();        $response = null;        if ($previous instanceof ValidationFailedException) {            $response = $this-&gt;buildValidationErrorResponse(                $previous-&gt;getViolations(),                $exception-&gt;getMessage(),                $exception-&gt;getStatusCode(),            );        }        $response ??= $this-&gt;buildErrorResponse(            $exception-&gt;getMessage(),            $exception-&gt;getStatusCode(),        );        $response-&gt;headers-&gt;add($exception-&gt;getHeaders());        return $response;    }    private function buildValidationErrorResponse(        ConstraintViolationListInterface $violations,        ?string $message = null,        ?int $status = null,    ): JsonResponse {        return new JsonResponse(            ErrorResponseView::fromViolationList($violations, $message),            $status ?? Response::HTTP_BAD_REQUEST,        );    }    private function buildFatalErrorResponse(\\Throwable $exception): Response    {        $message = $this-&gt;kernel-&gt;isDebug()            ? (string) $exception            : 'Something went wrong';        return $this-&gt;buildErrorResponse(            $message,            Response::HTTP_INTERNAL_SERVER_ERROR,        );    }}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u041f\u043e\u0441\u043b\u0435 \u044d\u0442\u043e\u0433\u043e \u043e\u0431\u0449\u0438\u0439 error response \u043c\u043e\u0436\u043d\u043e \u043e\u043f\u0438\u0441\u0430\u0442\u044c \u0447\u0435\u0440\u0435\u0437 <code>openapi.initial_operation<\/code>:<\/p>\n<pre><code class=\"yaml\"># config\/packages\/openapi.yamlparameters:    openapi.initial_operation:        responses:            default:                description: The operation was unsuccessful.                content:                    application\/json:                        schema: 'App\\Http\\View\\ErrorResponseView'<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0418\u043b\u0438 \u0442\u043e\u0447\u0435\u0447\u043d\u043e \u0447\u0435\u0440\u0435\u0437 <code>#[Operation]<\/code>.<\/p>\n<h4>3. \u0415\u0434\u0438\u043d\u044b\u0439 \u0444\u043e\u0440\u043c\u0430\u0442 \u0434\u0430\u0442<\/h4>\n<p>\u042f \u0431\u044b \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e \u043d\u0430\u0432\u0451\u043b \u043f\u043e\u0440\u044f\u0434\u043e\u043a \u0441 \u0434\u0430\u0442\u0430\u043c\u0438.<\/p>\n<p>\u041d\u0430\u043f\u0440\u0438\u043c\u0435\u0440:<\/p>\n<pre><code class=\"yaml\"># config\/services.yamlparameters:    app_output_timestamp_format: 'Y-m-d\\TH:i:s.up'<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<pre><code class=\"yaml\"># config\/packages\/serializer.yamlframework:    serializer:        enabled: true        default_context:            datetime_format: '%app_output_timestamp_format%'<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<pre><code class=\"yaml\"># config\/packages\/openapi.yamlparameters:    openapi.default_timestamp_format: '%app_output_timestamp_format%'<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0422\u0430\u043a runtime-\u0441\u0435\u0440\u0438\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044f \u0438 OpenAPI examples \u0445\u043e\u0442\u044f \u0431\u044b \u0441\u043c\u043e\u0442\u0440\u044f\u0442 \u0432 \u043e\u0434\u043d\u0443 \u0441\u0442\u043e\u0440\u043e\u043d\u0443.<\/p>\n<h3>\u041c\u0430\u0441\u0441\u0438\u0432\u044b \u0438 item types<\/h3>\n<p>\u041e\u0442\u0434\u0435\u043b\u044c\u043d\u0430\u044f \u0431\u043e\u043b\u044c PHP \u2014 \u043c\u0430\u0441\u0441\u0438\u0432\u044b.<\/p>\n<p>\u0421\u0430\u043c \u0442\u0438\u043f <code>array<\/code> \u043f\u043e\u0447\u0442\u0438 \u043d\u0438\u0447\u0435\u0433\u043e \u043d\u0435 \u0433\u043e\u0432\u043e\u0440\u0438\u0442 \u043e \u043f\u0443\u0431\u043b\u0438\u0447\u043d\u043e\u043c \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0435. \u042d\u0442\u043e \u043c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c \u0441\u043f\u0438\u0441\u043e\u043a \u0441\u0442\u0440\u043e\u043a, \u0441\u043f\u0438\u0441\u043e\u043a \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u0432, \u0430\u0441\u0441\u043e\u0446\u0438\u0430\u0442\u0438\u0432\u043d\u044b\u0439 \u043c\u0430\u0441\u0441\u0438\u0432, \u043a\u0430\u0440\u0442\u0430 \u043e\u0448\u0438\u0431\u043e\u043a, \u0447\u0442\u043e \u0443\u0433\u043e\u0434\u043d\u043e.<\/p>\n<p>\u0414\u043b\u044f \u0442\u0430\u043a\u0438\u0445 \u0441\u043b\u0443\u0447\u0430\u0435\u0432 \u043f\u0430\u043a\u0435\u0442 \u0443\u043c\u0435\u0435\u0442 \u0447\u0438\u0442\u0430\u0442\u044c item type \u0438\u0437 PHPDoc:<\/p>\n<pre><code class=\"php\">declare(strict_types=1);namespace App\\Http\\View;final readonly class CompletionListView{    public function __construct(        \/** @var CompletionView[] *\/        public array $items,    ) {    }}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u041f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u044e\u0442\u0441\u044f \u0440\u0430\u0437\u043d\u044b\u0435 \u0444\u043e\u0440\u043c\u044b \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u044f item type, \u0430 \u0435\u0441\u043b\u0438 \u043d\u0443\u0436\u043d\u043e \u044f\u0432\u043d\u043e\u0435 \u043f\u0435\u0440\u0435\u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0435\u043d\u0438\u0435, \u0435\u0441\u0442\u044c <code>#[ItemType]<\/code>.<\/p>\n<p>\u042f \u043d\u0435 \u0445\u043e\u0447\u0443 \u043f\u0440\u0435\u0432\u0440\u0430\u0449\u0430\u0442\u044c \u0441\u0442\u0430\u0442\u044c\u044e \u0432 \u043f\u0435\u0440\u0435\u0441\u043a\u0430\u0437 README, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 \u043f\u043e\u0434\u0440\u043e\u0431\u043d\u043e\u0441\u0442\u0438 \u043b\u0443\u0447\u0448\u0435 \u0441\u043c\u043e\u0442\u0440\u0435\u0442\u044c \u0432 <a href=\"https:\/\/github.com\/sunrise-studio-development\/symfony-openapi\/blob\/master\/README-ru.md\" rel=\"noopener noreferrer nofollow\">\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438<\/a>.<\/p>\n<h3>\u041e\u0433\u0440\u0430\u043d\u0438\u0447\u0435\u043d\u0438\u044f<\/h3>\n<p>\u0412\u0430\u0436\u043d\u043e \u0447\u0435\u0441\u0442\u043d\u043e \u0441\u043a\u0430\u0437\u0430\u0442\u044c: \u043f\u0430\u043a\u0435\u0442 \u043d\u0435 \u043f\u044b\u0442\u0430\u0435\u0442\u0441\u044f \u0443\u0433\u0430\u0434\u0430\u0442\u044c \u0432\u043e\u043e\u0431\u0449\u0435 \u0432\u0441\u0451.<\/p>\n<p>DTO \u0438 View \u043e\u0431\u044a\u0435\u043a\u0430\u0442\u044b \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u044e\u0442\u0441\u044f \u043f\u043e \u0442\u0438\u043f\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u043c \u0441\u0432\u043e\u0439\u0441\u0442\u0432\u0430\u043c. \u041f\u0430\u043a\u0435\u0442 \u043d\u0435 \u043e\u0431\u044f\u0437\u0430\u043d \u0447\u0438\u0442\u0430\u0442\u044c \u0432\u0441\u044e runtime-\u043c\u0430\u0433\u0438\u044e Symfony Serializer: groups, getters, setters, <code>SerializedName<\/code>, name converters \u0438\u043b\u0438 camelCase\/snake_case conversion rules.<\/p>\n<p>\u042f \u0441\u0447\u0438\u0442\u0430\u044e \u044d\u0442\u043e \u043d\u043e\u0440\u043c\u0430\u043b\u044c\u043d\u044b\u043c \u043a\u043e\u043c\u043f\u0440\u043e\u043c\u0438\u0441\u0441\u043e\u043c.<\/p>\n<p>\u0414\u043b\u044f \u043f\u0443\u0431\u043b\u0438\u0447\u043d\u043e\u0433\u043e API \u044f\u0432\u043d\u044b\u0435 DTO \u0438 View \u043e\u0431\u044a\u0435\u043a\u0442\u044b \u0447\u0430\u0441\u0442\u043e \u043f\u0440\u043e\u0449\u0435, \u043d\u0430\u0434\u0451\u0436\u043d\u0435\u0435 \u0438 \u043b\u0443\u0447\u0448\u0435 \u043f\u0435\u0440\u0435\u0436\u0438\u0432\u0430\u044e\u0442 \u0440\u0435\u0444\u0430\u043a\u0442\u043e\u0440\u0438\u043d\u0433. \u0415\u0441\u043b\u0438 \u043d\u0443\u0436\u043d\u0430 \u0434\u0440\u0443\u0433\u0430\u044f \u0432\u043d\u0435\u0448\u043d\u044f\u044f \u0444\u043e\u0440\u043c\u0430, \u043c\u043e\u0436\u043d\u043e \u0441\u0434\u0435\u043b\u0430\u0442\u044c \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0439 View \u043e\u0431\u044a\u0435\u043a\u0442 \u0438 \u0437\u0430\u043c\u0430\u043f\u0438\u0442\u044c \u0432 \u043d\u0435\u0433\u043e \u0441\u0443\u0449\u043d\u043e\u0441\u0442\u044c.<\/p>\n<p>\u0415\u0441\u043b\u0438 \u0432\u0430\u0448\u0435\u0439 \u043a\u043e\u043c\u0430\u043d\u0434\u0435 \u043d\u0443\u0436\u043d\u0430 first-class \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0430 Symfony Serializer metadata, \u044d\u0442\u043e \u0443\u0436\u0435 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u0430\u044f \u0437\u0430\u0434\u0430\u0447\u0430 \u0438 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u0430\u044f \u0441\u0442\u0440\u0430\u0442\u0435\u0433\u0438\u044f, \u0430 \u043d\u0435 \u0442\u043e, \u0447\u0442\u043e \u0441\u0442\u043e\u0438\u0442 \u043d\u0435\u044f\u0432\u043d\u043e \u0441\u043c\u0435\u0448\u0438\u0432\u0430\u0442\u044c \u0441 \u0431\u0430\u0437\u043e\u0432\u043e\u0439 \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0435\u0439 \u0441\u0445\u0435\u043c.<\/p>\n<h3>\u0422\u043e\u0447\u043a\u0438 \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043d\u0438\u044f<\/h3>\n<p>\u041f\u0430\u043a\u0435\u0442 \u0441\u043e\u0431\u0440\u0430\u043d \u0438\u0437 \u0437\u0430\u043c\u0435\u043d\u044f\u0435\u043c\u044b\u0445 \u0441\u0435\u0440\u0432\u0438\u0441\u043e\u0432 \u0434\u043b\u044f \u043f\u0440\u043e\u0435\u043a\u0442\u043e\u0432 \u0441\u043e \u0441\u0432\u043e\u0438\u043c\u0438 \u0441\u043e\u0433\u043b\u0430\u0448\u0435\u043d\u0438\u044f\u043c\u0438.<\/p>\n<p>\u041c\u043e\u0436\u043d\u043e \u0437\u0430\u043c\u0435\u043d\u0438\u0442\u044c \u0438\u043b\u0438 \u0440\u0430\u0441\u0448\u0438\u0440\u0438\u0442\u044c:<\/p>\n<ul>\n<li>\n<p><code>RouteMetadataResolverInterface<\/code>;<\/p>\n<\/li>\n<li>\n<p><code>ResponseMetadataResolverInterface<\/code>;<\/p>\n<\/li>\n<li>\n<p><code>OpenApiOperationEnricherInterface<\/code>;<\/p>\n<\/li>\n<li>\n<p><code>OpenApiPhpTypeSchemaResolverInterface<\/code>;<\/p>\n<\/li>\n<li>\n<p><code>OpenApiPathBuilderInterface<\/code>.<\/p>\n<\/li>\n<\/ul>\n<p>\u041d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u0435\u0441\u043b\u0438 \u0443 \u043f\u0440\u043e\u0435\u043a\u0442\u0430 \u0441\u0432\u043e\u0438 \u043f\u0440\u0430\u0432\u0438\u043b\u0430 \u0434\u043b\u044f status codes \u0438\u043b\u0438 response formats, \u043c\u043e\u0436\u043d\u043e \u0437\u0430\u043c\u0435\u043d\u0438\u0442\u044c <code>ResponseMetadataResolverInterface<\/code>.<\/p>\n<p>\u0415\u0441\u043b\u0438 \u043d\u0443\u0436\u0435\u043d \u043e\u0441\u043e\u0431\u044b\u0439 PHP type, \u043c\u043e\u0436\u043d\u043e \u0440\u0435\u0430\u043b\u0438\u0437\u043e\u0432\u0430\u0442\u044c <code>OpenApiPhpTypeSchemaResolverInterface<\/code> \u0438 \u0437\u0430\u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c resolver.<\/p>\n<p>\u0418\u0434\u0435\u044f \u0432 \u0442\u043e\u043c, \u0447\u0442\u043e\u0431\u044b \u043d\u0435 \u0444\u043e\u0440\u043a\u0430\u0442\u044c \u043f\u0430\u043a\u0435\u0442 \u0440\u0430\u0434\u0438 \u043a\u0430\u0436\u0434\u043e\u0433\u043e \u043f\u0440\u043e\u0435\u043a\u0442\u043d\u043e\u0433\u043e \u043f\u0440\u0430\u0432\u0438\u043b\u0430.<\/p>\n<h3>\u0427\u0442\u043e \u043f\u043e\u043b\u0443\u0447\u0438\u043b\u043e\u0441\u044c<\/h3>\n<p>\u042f \u0445\u043e\u0442\u0435\u043b \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u044c \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0432 \u043e\u0431\u044b\u0447\u043d\u043e\u043c \u0441\u043b\u0443\u0447\u0430\u0435 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u043f\u043e \u043f\u0440\u0438\u043d\u0446\u0438\u043f\u0443:<\/p>\n<blockquote>\n<p>\u0443\u0441\u0442\u0430\u043d\u043e\u0432\u0438\u043b, \u043f\u043e\u0434\u043a\u043b\u044e\u0447\u0438\u043b, \u043e\u043f\u0438\u0441\u0430\u043b \u043d\u043e\u0440\u043c\u0430\u043b\u044c\u043d\u044b\u0435 DTO\/View objects, \u043f\u043e\u043b\u0443\u0447\u0438\u043b OpenAPI.<\/p>\n<\/blockquote>\n<p>\u041f\u043e\u0447\u0442\u0438 \u00ab\u0443\u0441\u0442\u0430\u043d\u043e\u0432\u0438\u043b \u0438 \u0437\u0430\u0431\u044b\u043b\u00bb.<\/p>\n<p>\u0420\u0430\u0437\u0443\u043c\u0435\u0435\u0442\u0441\u044f, \u0432 \u0440\u0435\u0430\u043b\u044c\u043d\u043e\u043c \u043f\u0440\u043e\u0435\u043a\u0442\u0435 \u0432\u0441\u0451 \u0440\u0430\u0432\u043d\u043e \u0435\u0441\u0442\u044c \u043d\u044e\u0430\u043d\u0441\u044b: \u043e\u0448\u0438\u0431\u043a\u0438, \u0434\u0430\u0442\u044b, runtime-\u0441\u0435\u0440\u0438\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044f, \u043d\u0435\u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u043d\u044b\u0435 \u043e\u0442\u0432\u0435\u0442\u044b, \u0432\u043d\u0443\u0442\u0440\u0435\u043d\u043d\u0438\u0435 \u0441\u043e\u0433\u043b\u0430\u0448\u0435\u043d\u0438\u044f. \u041d\u043e \u044d\u0442\u043e \u0443\u0436\u0435 \u043d\u043e\u0440\u043c\u0430\u043b\u044c\u043d\u0430\u044f \u0438\u043d\u0436\u0435\u043d\u0435\u0440\u043d\u0430\u044f \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430, \u0430 \u043d\u0435 \u0440\u0443\u0447\u043d\u043e\u0435 \u043f\u0435\u0440\u0435\u043f\u0438\u0441\u044b\u0432\u0430\u043d\u0438\u0435 \u043e\u0434\u043d\u043e\u0433\u043e \u0438 \u0442\u043e\u0433\u043e \u0436\u0435 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0430 \u0432 \u0434\u0432\u0443\u0445 \u043c\u0435\u0441\u0442\u0430\u0445.<\/p>\n<p>\u0418, \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e, \u0433\u043b\u0430\u0432\u043d\u044b\u0439 \u044d\u0444\u0444\u0435\u043a\u0442 \u0434\u0430\u0436\u0435 \u043d\u0435 \u0432 Swagger UI.<\/p>\n<p>\u041f\u0430\u043a\u0435\u0442 \u043c\u043e\u0436\u0435\u0442 \u043f\u043e\u0434\u0442\u043e\u043b\u043a\u043d\u0443\u0442\u044c \u0447\u0435\u0439-\u0442\u043e, \u0430 \u043c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c \u0438 \u0432\u0430\u0448, \u043f\u0440\u043e\u0435\u043a\u0442 \u043a \u0431\u043e\u043b\u0435\u0435 \u0447\u0438\u0441\u0442\u043e\u043c\u0443 API:<\/p>\n<ul>\n<li>\n<p>\u043c\u0435\u043d\u044c\u0448\u0435 \u0440\u0443\u0447\u043d\u043e\u0439 \u0441\u0431\u043e\u0440\u043a\u0438 <code>JsonResponse<\/code>;<\/p>\n<\/li>\n<li>\n<p>\u043c\u0435\u043d\u044c\u0448\u0435 \u0434\u0443\u0431\u043b\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f;<\/p>\n<\/li>\n<li>\n<p>\u0431\u043e\u043b\u044c\u0448\u0435 typed DTO;<\/p>\n<\/li>\n<li>\n<p>\u0431\u043e\u043b\u044c\u0448\u0435 \u044f\u0432\u043d\u044b\u0445 View objects;<\/p>\n<\/li>\n<li>\n<p>\u043f\u043e\u043d\u044f\u0442\u043d\u0435\u0435 \u043e\u0448\u0438\u0431\u043a\u0438;<\/p>\n<\/li>\n<li>\n<p>\u043f\u0440\u043e\u0437\u0440\u0430\u0447\u043d\u0435\u0435 \u0434\u0430\u0442\u044b;<\/p>\n<\/li>\n<li>\n<p>\u043f\u0440\u043e\u0449\u0435 \u0440\u0435\u0444\u0430\u043a\u0442\u043e\u0440\u0438\u043d\u0433.<\/p>\n<\/li>\n<\/ul>\n<p>\u042f \u043d\u0435 \u0433\u043e\u0432\u043e\u0440\u044e, \u0447\u0442\u043e \u0443 \u0432\u0441\u0435\u0445 \u0432 \u043f\u0440\u043e\u0435\u043a\u0442\u0430\u0445 \u0431\u0430\u0440\u0434\u0430\u043a. \u042f \u043f\u043e\u043d\u044f\u0442\u0438\u044f \u043d\u0435 \u0438\u043c\u0435\u044e, \u0447\u0442\u043e \u0443 \u0432\u0430\u0441 \u0432 \u043f\u0440\u043e\u0435\u043a\u0442\u0430\u0445. \u041d\u043e \u043d\u0430 \u043c\u043e\u0451\u043c \u043e\u043f\u044b\u0442\u0435 \u043f\u043e\u0441\u043b\u0435\u0434\u043d\u0438\u0445 \u043b\u0435\u0442 \u0432\u043e\u043a\u0440\u0443\u0433 API \u0447\u0430\u0441\u0442\u043e \u043d\u0435 \u043e\u0447\u0435\u043d\u044c \u0430\u043a\u043a\u0443\u0440\u0430\u0442\u043d\u043e, \u0438 \u044f \u0440\u0430\u0434, \u0447\u0442\u043e \u043c\u043e\u0433\u0443 \u0445\u043e\u0442\u044f \u0431\u044b \u043d\u0435\u043c\u043d\u043e\u0433\u043e \u043f\u043e\u0432\u043b\u0438\u044f\u0442\u044c \u043d\u0430 \u044d\u0442\u043e.<\/p>\n<h3>\u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f<\/h3>\n<p>\u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u043f\u0430\u043a\u0435\u0442\u0430 \u043b\u0435\u0436\u0438\u0442 \u0437\u0434\u0435\u0441\u044c:<br \/><a href=\"http:\/\/README-ru.md\" rel=\"noopener noreferrer nofollow\"><code>README-ru.md<\/code><\/a><\/p>\n<p>\u042f \u043f\u043e\u0441\u0442\u0430\u0440\u0430\u043b\u0441\u044f \u043e\u043f\u0438\u0441\u0430\u0442\u044c \u043d\u0435 \u0442\u043e\u043b\u044c\u043a\u043e \u00abhappy path\u00bb, \u043d\u043e \u0438 \u0440\u0435\u0430\u043b\u044c\u043d\u044b\u0435 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044c\u0441\u043a\u0438\u0435 \u0441\u0446\u0435\u043d\u0430\u0440\u0438\u0438:<\/p>\n<ul>\n<li>\n<p>\u0443\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430;<\/p>\n<\/li>\n<li>\n<p>\u043c\u0430\u0440\u0448\u0440\u0443\u0442\u044b \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438;<\/p>\n<\/li>\n<li>\n<p>\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430;<\/p>\n<\/li>\n<li>\n<p>route options;<\/p>\n<\/li>\n<li>\n<p>Symfony attributes;<\/p>\n<\/li>\n<li>\n<p>responses;<\/p>\n<\/li>\n<li>\n<p>\u0440\u0443\u0447\u043d\u044b\u0435 OpenAPI-\u0444\u0440\u0430\u0433\u043c\u0435\u043d\u0442\u044b;<\/p>\n<\/li>\n<li>\n<p>\u043e\u0448\u0438\u0431\u043a\u0438;<\/p>\n<\/li>\n<li>\n<p>type schema resolvers;<\/p>\n<\/li>\n<li>\n<p>object schemas;<\/p>\n<\/li>\n<li>\n<p>extension points.<\/p>\n<\/li>\n<\/ul>\n<p>\u0412\u043e\u0437\u043c\u043e\u0436\u043d\u043e, \u0432\u044b \u043f\u0440\u043e\u0447\u0438\u0442\u0430\u0435\u0442\u0435 \u0435\u0451 \u0441\u0430\u043c\u0438.<\/p>\n<p>\u0412\u043e\u0437\u043c\u043e\u0436\u043d\u043e, \u0441\u043a\u043e\u0440\u043c\u0438\u0442\u0435 \u0435\u0451 \u0418\u0418 \u0438 \u043f\u043e\u043f\u0440\u043e\u0441\u0438\u0442\u0435 \u043f\u043e\u043c\u043e\u0447\u044c \u043f\u043e\u0434\u043a\u043b\u044e\u0447\u0438\u0442\u044c \u043f\u0430\u043a\u0435\u0442.<\/p>\n<p>\u0412 \u043b\u044e\u0431\u043e\u043c \u0441\u043b\u0443\u0447\u0430\u0435 \u0438\u0434\u0435\u044f \u0442\u0430 \u0436\u0435: \u043c\u0435\u043d\u044c\u0448\u0435 \u0440\u0443\u0447\u043d\u043e\u0433\u043e \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u044f OpenAPI, \u0431\u043e\u043b\u044c\u0448\u0435 \u043d\u043e\u0440\u043c\u0430\u043b\u044c\u043d\u043e\u0433\u043e \u043a\u043e\u0434\u0430, \u0438\u0437 \u043a\u043e\u0442\u043e\u0440\u043e\u0433\u043e \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u043c\u043e\u0436\u043d\u043e \u0432\u044b\u0432\u0435\u0441\u0442\u0438 \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438.<\/p>\n<p>\u0413\u043b\u0430\u0432\u043d\u043e\u0435, \u0447\u0442\u043e\u0431\u044b \u0418\u0418 \u043d\u0435 \u043d\u0430\u0447\u0430\u043b \u0441\u0430\u043c \u043f\u0440\u0438\u0434\u0443\u043c\u044b\u0432\u0430\u0442\u044c OpenAPI \u0432\u043c\u0435\u0441\u0442\u043e \u0442\u043e\u0433\u043e, \u0447\u0442\u043e\u0431\u044b \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u0443\u0436\u0435 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0443\u044e \u0430\u0440\u0445\u0438\u0442\u0435\u043a\u0442\u0443\u0440\u0443.<\/p>\n<h3>\u0410 \u0435\u0441\u043b\u0438 \u0445\u043e\u0447\u0435\u0442\u0441\u044f \u043f\u043e\u0439\u0442\u0438 \u0434\u0430\u043b\u044c\u0448\u0435<\/h3>\n<p>\u0415\u0441\u043b\u0438 \u0432\u0430\u043c \u0431\u043b\u0438\u0437\u043a\u0430 \u0441\u0430\u043c\u0430 \u0438\u0434\u0435\u044f API, \u0433\u0434\u0435 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0435\u0441\u0442\u0435\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u043c \u043f\u0440\u043e\u0434\u043e\u043b\u0436\u0435\u043d\u0438\u0435\u043c \u043a\u043e\u0434\u0430, \u0430 \u043d\u0435 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u043c \u044d\u0442\u0430\u043f\u043e\u043c \u0440\u0430\u0431\u043e\u0442\u044b, \u043c\u043e\u0436\u043d\u043e \u043f\u043e\u0441\u043c\u043e\u0442\u0440\u0435\u0442\u044c \u0438 \u043d\u0430 <a href=\"https:\/\/github.com\/sunrise-php\/http-router\" rel=\"noopener noreferrer nofollow\"><code>sunrise\/http-router<\/code><\/a>.<\/p>\n<p>\u041f\u0440\u043e \u043d\u0435\u0433\u043e \u044f \u0443\u0436\u0435 \u043f\u0438\u0441\u0430\u043b \u0432 <a href=\"https:\/\/habr.com\/ru\/articles\/891048\/\" rel=\"noopener noreferrer nofollow\">\u043f\u0440\u043e\u0448\u043b\u043e\u0439 \u0441\u0442\u0430\u0442\u044c\u0435<\/a>.<\/p>\n<p>Symfony bundle \u043f\u043e\u044f\u0432\u0438\u043b\u0441\u044f \u043d\u0435 \u0432\u043c\u0435\u0441\u0442\u043e \u044d\u0442\u043e\u0433\u043e \u043c\u0430\u0440\u0448\u0440\u0443\u0442\u0438\u0437\u0430\u0442\u043e\u0440\u0430, \u0430 \u043a\u0430\u043a \u043f\u0440\u043e\u0434\u043e\u043b\u0436\u0435\u043d\u0438\u0435 \u0442\u043e\u0439 \u0436\u0435 \u0438\u0434\u0435\u0438 \u0434\u043b\u044f Symfony-\u043f\u0440\u043e\u0435\u043a\u0442\u043e\u0432. \u0415\u0441\u043b\u0438 \u0443 \u0432\u0430\u0441 Symfony \u2014 \u043c\u043e\u0436\u043d\u043e \u043f\u043e\u043f\u0440\u043e\u0431\u043e\u0432\u0430\u0442\u044c <a href=\"https:\/\/github.com\/sunrise-studio-development\/symfony-openapi\" rel=\"noopener noreferrer nofollow\"><code>sunrise-studio\/symfony-openapi<\/code><\/a>. \u0415\u0441\u043b\u0438 \u0445\u043e\u0447\u0435\u0442\u0441\u044f \u043f\u043e\u043f\u0440\u043e\u0431\u043e\u0432\u0430\u0442\u044c \u0434\u0440\u0443\u0433\u043e\u0439 \u043c\u0430\u0440\u0448\u0440\u0443\u0442\u0438\u0437\u0430\u0442\u043e\u0440 \u0438 \u0447\u0443\u0442\u044c \u0434\u0440\u0443\u0433\u0443\u044e \u0430\u0440\u0445\u0438\u0442\u0435\u043a\u0442\u0443\u0440\u0443 API \u2014 \u043c\u043e\u0436\u043d\u043e \u043f\u043e\u0441\u043c\u043e\u0442\u0440\u0435\u0442\u044c \u0432 \u0441\u0442\u043e\u0440\u043e\u043d\u0443 Sunrise Router.<\/p>\n<h3>\u0424\u0438\u043d\u0430\u043b<\/h3>\n<p>OpenAPI \u043f\u043e\u043b\u0435\u0437\u0435\u043d. Swagger UI \u043f\u043e\u043b\u0435\u0437\u0435\u043d. \u041a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 API \u043f\u043e\u043b\u0435\u0437\u0435\u043d.<\/p>\n<p>\u041d\u043e \u0435\u0441\u043b\u0438 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u043f\u0440\u0438\u0445\u043e\u0434\u0438\u0442\u0441\u044f \u043f\u043e\u0441\u0442\u043e\u044f\u043d\u043d\u043e \u0441\u0438\u043d\u0445\u0440\u043e\u043d\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0440\u0443\u043a\u0430\u043c\u0438 \u0441 \u043a\u043e\u0434\u043e\u043c, \u0440\u0430\u043d\u043e \u0438\u043b\u0438 \u043f\u043e\u0437\u0434\u043d\u043e \u043e\u043d \u043d\u0430\u0447\u043d\u0451\u0442 \u0440\u0430\u0441\u0445\u043e\u0434\u0438\u0442\u044c\u0441\u044f \u0441 \u0440\u0435\u0430\u043b\u044c\u043d\u043e\u0441\u0442\u044c\u044e. \u042d\u0442\u043e \u043d\u0435\u0438\u0437\u0431\u0435\u0436\u043d\u043e.<\/p>\n<p>\u042f \u0441\u0447\u0438\u0442\u0430\u044e, \u0447\u0442\u043e \u0432 Symfony \u0443\u0436\u0435 \u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u0438, \u0447\u0442\u043e\u0431\u044b \u0431\u043e\u043b\u044c\u0448\u0443\u044e \u0447\u0430\u0441\u0442\u044c OpenAPI-\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438.<\/p>\n<p>\u041c\u0430\u0440\u0448\u0440\u0443\u0442\u044b, \u0441\u0438\u0433\u043d\u0430\u0442\u0443\u0440\u044b, DTO, View objects \u0438 \u043d\u0435\u0431\u043e\u043b\u044c\u0448\u043e\u0435 \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e metadata \u2014 \u044d\u0442\u043e\u0433\u043e \u043e\u0431\u044b\u0447\u043d\u043e \u0445\u0432\u0430\u0442\u0430\u0435\u0442.<\/p>\n<p>\u0418\u043c\u0435\u043d\u043d\u043e \u0442\u0430\u043a \u044f \u0438 \u0445\u043e\u0442\u0435\u043b \u0441\u0434\u0435\u043b\u0430\u0442\u044c.<\/p>\n<\/div>\n<p>\u0441\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u0438 <a href=\"https:\/\/habr.com\/ru\/articles\/1047686\/\">https:\/\/habr.com\/ru\/articles\/1047686\/<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u0412 \u043f\u0440\u043e\u0448\u043b\u043e\u0439 \u0441\u0442\u0430\u0442\u044c\u0435 \u044f \u0443\u0436\u0435 \u0440\u0430\u0441\u0441\u043a\u0430\u0437\u044b\u0432\u0430\u043b, \u043a\u0430\u043a \u043e\u0434\u043d\u0430\u0436\u0434\u044b \u0443\u0441\u0442\u0440\u043e\u0438\u043b\u0441\u044f \u043d\u0430 \u0440\u0430\u0431\u043e\u0442\u0443 \u0438 \u043f\u043e\u043b\u0443\u0447\u0438\u043b \u043f\u0430\u0447\u043a\u0443 \u00ab\u0438\u043d\u0442\u0435\u0440\u0435\u0441\u043d\u044b\u0445\u00bb \u0437\u0430\u0434\u0430\u0447: \u0432\u0440\u0443\u0447\u043d\u0443\u044e \u0441\u0438\u043d\u0445\u0440\u043e\u043d\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u0442\u044c OpenAPI, \u043e\u0444\u043e\u0440\u043c\u043b\u0435\u043d\u043d\u044b\u0439 \u0432 \u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u044f\u0445 \u043a \u043a\u043e\u0434\u0443, \u0441 \u0441\u0430\u043c\u0438\u043c \u043a\u043e\u0434\u043e\u043c \u0432 \u0434\u0435\u0441\u044f\u0442\u043a\u0435 \u0441\u0435\u0440\u0432\u0438\u0441\u043e\u0432.\u0422\u043e\u0433\u0434\u0430 \u044d\u0442\u043e \u0437\u0432\u0443\u0447\u0430\u043b\u043e \u043a\u0430\u043a \u043d\u0430\u0447\u0430\u043b\u043e \u0430\u043d\u0435\u043a\u0434\u043e\u0442\u0430, \u043d\u043e \u043c\u043d\u0435 \u0431\u044b\u043b\u043e \u043d\u0435 \u0434\u043e \u0441\u043c\u0435\u0445\u0430.\u0421 \u0442\u0435\u0445 \u043f\u043e\u0440 \u044f \u0441\u043c\u0435\u043d\u0438\u043b \u0440\u0430\u0431\u043e\u0442\u0443. \u0418, \u043a\u0430\u043a \u0431\u0443\u0434\u0442\u043e \u0432\u0441\u0435\u043b\u0435\u043d\u043d\u0430\u044f \u0440\u0435\u0448\u0438\u043b\u0430 \u043f\u0440\u043e\u0432\u0435\u0440\u0438\u0442\u044c \u043c\u043e\u0451 \u0447\u0443\u0432\u0441\u0442\u0432\u043e \u044e\u043c\u043e\u0440\u0430, \u044f \u0441\u043d\u043e\u0432\u0430 \u0432\u0438\u0436\u0443 API, \u0433\u0434\u0435 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u0436\u0438\u0432\u0451\u0442 \u0440\u044f\u0434\u043e\u043c \u0441 \u043a\u043e\u0434\u043e\u043c \u0432 \u0440\u0443\u0447\u043d\u044b\u0445 #[OA\\&#8230;] \u0430\u0442\u0440\u0438\u0431\u0443\u0442\u0430\u0445.\u0418 \u044d\u0442\u043e \u0432\u0430\u0436\u043d\u044b\u0439 \u043c\u043e\u043c\u0435\u043d\u0442. \u042d\u0442\u043e \u043d\u0435 \u0438\u0441\u0442\u043e\u0440\u0438\u044f \u043f\u0440\u043e \u043e\u0434\u043d\u0443 \u043a\u043e\u043d\u043a\u0440\u0435\u0442\u043d\u0443\u044e \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u044e, \u043e\u0434\u0438\u043d \u043d\u0435\u0443\u0434\u0430\u0447\u043d\u044b\u0439 \u043f\u0440\u043e\u0435\u043a\u0442 \u0438\u043b\u0438 \u043e\u0434\u0438\u043d \u0441\u0442\u0430\u0440\u044b\u0439 \u0441\u0435\u0440\u0432\u0438\u0441, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0432\u0441\u0435 \u0431\u043e\u044f\u0442\u0441\u044f \u0442\u0440\u043e\u0433\u0430\u0442\u044c. \u042f \u0432\u0438\u0436\u0443 \u044d\u0442\u043e\u0442 \u043f\u043e\u0434\u0445\u043e\u0434 \u0432 \u0440\u0430\u0437\u043d\u044b\u0445 \u043c\u0435\u0441\u0442\u0430\u0445.Symfony \u0443\u0436\u0435 \u0437\u043d\u0430\u0435\u0442 \u043c\u0430\u0440\u0448\u0440\u0443\u0442\u044b. \u041a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440 \u0443\u0436\u0435 \u0437\u043d\u0430\u0435\u0442 \u0432\u0445\u043e\u0434\u043d\u044b\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b. DTO \u0443\u0436\u0435 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 request. View object \u0443\u0436\u0435 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 response. \u041d\u043e \u043f\u043e\u0432\u0435\u0440\u0445 \u044d\u0442\u043e\u0433\u043e \u0432\u0441\u0451 \u0440\u0430\u0432\u043d\u043e \u0447\u0430\u0441\u0442\u043e \u043f\u0438\u0448\u0435\u0442\u0441\u044f \u0435\u0449\u0451 \u043e\u0434\u0438\u043d \u0441\u043b\u043e\u0439:#[OA\\Post(    path: &#8216;\/v1\/completions&#8217;,    requestBody: new OA\\RequestBody(&#8230;),    responses: [        new OA\\Response(            response: 200,            description: &#8216;Completion result&#8217;,            content: new OA\\JsonContent(&#8230;),        ),    ],)]#[Route(&#8216;\/v1\/completions&#8217;, methods: [&#8216;POST&#8217;])]public function __invoke(CreateCompletionRequest $request): JsonResponse{    \/\/ &#8230;}\u042f \u043d\u0435 \u0441\u0447\u0438\u0442\u0430\u044e OpenAPI \u043f\u0440\u043e\u0431\u043b\u0435\u043c\u043e\u0439. OpenAPI \u043f\u043e\u043b\u0435\u0437\u0435\u043d. Swagger UI \u043f\u043e\u043b\u0435\u0437\u0435\u043d. \u041a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 API \u043f\u043e\u043b\u0435\u0437\u0435\u043d.\u041f\u0440\u043e\u0431\u043b\u0435\u043c\u0430 \u0432 \u0434\u0440\u0443\u0433\u043e\u043c: \u043c\u044b \u0447\u0430\u0441\u0442\u043e \u0432\u0440\u0443\u0447\u043d\u0443\u044e \u0434\u0443\u0431\u043b\u0438\u0440\u0443\u0435\u043c \u0442\u043e, \u0447\u0442\u043e \u0443\u0436\u0435 \u0435\u0441\u0442\u044c \u0432 \u043a\u043e\u0434\u0435.\u041f\u043e\u043c\u0435\u043d\u044f\u043b DTO \u2014 \u043d\u0435 \u0437\u0430\u0431\u0443\u0434\u044c \u043f\u043e\u043c\u0435\u043d\u044f\u0442\u044c OpenAPI. \u041f\u043e\u043c\u0435\u043d\u044f\u043b response \u2014 \u043d\u0435 \u0437\u0430\u0431\u0443\u0434\u044c \u043f\u043e\u043c\u0435\u043d\u044f\u0442\u044c OpenAPI. \u041f\u043e\u043c\u0435\u043d\u044f\u043b status code \u2014 \u043d\u0435 \u0437\u0430\u0431\u0443\u0434\u044c \u043f\u043e\u043c\u0435\u043d\u044f\u0442\u044c OpenAPI. \u041d\u0435 \u043f\u043e\u043c\u0435\u043d\u044f\u043b \u2014 \u0432 \u043b\u0443\u0447\u0448\u0435\u043c \u0441\u043b\u0443\u0447\u0430\u0435 \u2013 \u0431\u0430\u0433.\u042f \u0443\u0436\u0435 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u043b\u0435\u0442 \u0437\u0430\u043d\u0438\u043c\u0430\u044e\u0441\u044c \u044d\u0442\u0438\u043c \u0432\u043e\u043f\u0440\u043e\u0441\u043e\u043c \u0438 \u0441\u0447\u0438\u0442\u0430\u044e, \u0447\u0442\u043e \u0432 \u0431\u043e\u043b\u044c\u0448\u0438\u043d\u0441\u0442\u0432\u0435 \u0441\u043b\u0443\u0447\u0430\u0435\u0432 API-\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u0434\u043e\u043b\u0436\u043d\u0430 \u0432\u044b\u0442\u0435\u043a\u0430\u0442\u044c \u0438\u0437 \u043a\u043e\u0434\u0430, \u0430 \u043d\u0435 \u0436\u0438\u0442\u044c \u0440\u044f\u0434\u043e\u043c \u0441 \u043d\u0438\u043c \u043a\u0430\u043a \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0439 \u0440\u0443\u0447\u043d\u043e\u0439 \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442.\u0418\u043c\u0435\u043d\u043d\u043e \u043f\u043e\u044d\u0442\u043e\u043c\u0443 \u044f \u0441\u0434\u0435\u043b\u0430\u043b sunrise-studio\/symfony-openapi.\u0427\u0442\u043e \u044f \u0445\u043e\u0442\u0435\u043b \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u044c\u042f \u0445\u043e\u0442\u0435\u043b, \u0447\u0442\u043e\u0431\u044b \u043e\u0431\u044b\u0447\u043d\u044b\u0439 Symfony \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440 \u0432\u044b\u0433\u043b\u044f\u0434\u0435\u043b \u043f\u0440\u0438\u043c\u0435\u0440\u043d\u043e \u0442\u0430\u043a:declare(strict_types=1);namespace App\\Http\\Controller;use App\\Http\\Request\\CreateCompletionRequest;use App\\Http\\View\\CompletionView;use App\\Service\\CompletionService;use Symfony\\Component\\HttpKernel\\Attribute\\MapRequestPayload;use Symfony\\Component\\Routing\\Attribute\\Route;#[Route(&#8216;\/v1\/completions&#8217;, methods: [&#8216;POST&#8217;])]final readonly class CreateCompletionController{    public function __construct(        private CompletionService $completionService,    ) {    }    public function __invoke(        #[MapRequestPayload] CreateCompletionRequest $request,    ): CompletionView {        return new CompletionView(            text: $this-&gt;completionService-&gt;complete($request-&gt;prompt),        );    }}Request DTO:declare(strict_types=1);namespace App\\Http\\Request;final readonly class CreateCompletionRequest{    public function __construct(        public string $prompt,    ) {    }}View object:declare(strict_types=1);namespace App\\Http\\View;final readonly class CompletionView{    public function __construct(        public string $text,    ) {    }}\u041c\u0430\u0440\u0448\u0440\u0443\u0442 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 path \u0438 method.#[MapRequestPayload] \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442, \u043e\u0442\u043a\u0443\u0434\u0430 \u0432\u0437\u044f\u0442\u044c \u0432\u0445\u043e\u0434\u043d\u044b\u0435 \u0434\u0430\u043d\u043d\u044b\u0435.Request DTO \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 request body.Return type \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 response.View object \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 \u0444\u043e\u0440\u043c\u0443 \u043e\u0442\u0432\u0435\u0442\u0430.\u041f\u043e \u043c\u043e\u0435\u0439 \u0437\u0430\u0434\u0443\u043c\u043a\u0435, \u044d\u0442\u043e\u0433\u043e \u0443\u0436\u0435 \u0434\u043e\u043b\u0436\u043d\u043e \u0431\u044b\u0442\u044c \u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e, \u0447\u0442\u043e\u0431\u044b \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u044c OpenAPI-\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442.\u041d\u0435 \u0432\u0441\u0435\u0433\u0434\u0430. \u0415\u0441\u0442\u044c corner cases. \u041d\u043e \u0434\u043b\u044f \u0431\u043e\u043b\u044c\u0448\u0438\u043d\u0441\u0442\u0432\u0430 API methods, \u043f\u043e \u043c\u043e\u0435\u043c\u0443 \u043e\u043f\u044b\u0442\u0443, \u044d\u0442\u043e\u0433\u043e \u0434\u0435\u0439\u0441\u0442\u0432\u0438\u0442\u0435\u043b\u044c\u043d\u043e \u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e.\u0410 \u0447\u0442\u043e \u0435\u0441\u043b\u0438&#8230;\u0412\u043e \u0432\u0440\u0435\u043c\u0435\u043d\u0430 \u0418\u0418-\u0430\u0436\u0438\u043e\u0442\u0430\u0436\u0430 \u043c\u043e\u0436\u043d\u043e, \u043a\u043e\u043d\u0435\u0447\u043d\u043e, \u0440\u0435\u0448\u0438\u0442\u044c \u043f\u0440\u043e\u0431\u043b\u0435\u043c\u0443 \u043f\u0440\u0438\u043c\u0435\u0440\u043d\u043e \u0442\u0430\u043a:declare(strict_types=1);namespace App\\Command;use App\\Ai\\ArtificialIntelligenceInterface;use Symfony\\Component\\Console\\Attribute\\AsCommand;use Symfony\\Component\\Console\\Command\\Command;use Symfony\\Component\\Console\\Input\\InputInterface;use Symfony\\Component\\Console\\Output\\OutputInterface;#[AsCommand(&#8216;app:generate-openapi&#8217;)]final readonly class GenerateOpenApiCommand extends Command{    public function __construct(        private ArtificialIntelligenceInterface $ai,    ) {        parent::__construct();    }    protected function execute(InputInterface $input, OutputInterface $output): int    {        $document = $this-&gt;ai-&gt;complete(            &lt;&lt;&lt;&#8216;PROMPT&#8217;            Analyze all Symfony controllers in src\/Http\/Controller.            Generate a valid OpenAPI 3.1 JSON document based on routes,            request DTOs and response types.            Return only raw JSON without Markdown, comments or explanations.            PROMPT,        );        file_put_contents(__DIR__ . &#8216;\/..\/..\/var\/openapi.json&#8217;, $document);        return Command::SUCCESS;    }}\u042f \u043d\u0435 \u0441\u0435\u0440\u044c\u0451\u0437\u043d\u043e.\u041e\u0447\u0435\u043d\u044c \u043d\u0430\u0434\u0435\u044e\u0441\u044c, \u0447\u0442\u043e \u0442\u0430\u043a \u043d\u0438\u043a\u0442\u043e \u043d\u0435 \u0434\u0435\u043b\u0430\u0435\u0442.\u042f \u043d\u0435 \u043c\u043e\u0433 \u043d\u0435 \u043f\u043e\u0434\u0435\u043b\u0438\u0442\u044c\u0441\u044f \u044d\u0442\u043e\u0439 \u0448\u0443\u0442\u043a\u043e\u0439, \u043c\u0435\u043d\u044f \u043e\u043d\u0430 \u043f\u043e\u0437\u0430\u0431\u0430\u0432\u0438\u043b\u0430, \u043d\u0430\u0434\u0435\u044e\u0441\u044c \u0438 \u0432\u0430\u0441!\u0418 \u0434\u0435\u043b\u043e \u0434\u0430\u0436\u0435 \u043d\u0435 \u0432 \u0442\u043e\u043c, \u0447\u0442\u043e \u0418\u0418 \u043c\u043e\u0436\u0435\u0442 \u043e\u0448\u0438\u0431\u0438\u0442\u044c\u0441\u044f. \u041e\u043d \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u043e \u043e\u0448\u0438\u0431\u0451\u0442\u0441\u044f. \u0412\u043e\u043f\u0440\u043e\u0441 \u0442\u043e\u043b\u044c\u043a\u043e \u0432 \u0442\u043e\u043c, \u043d\u0430\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0443\u0432\u0435\u0440\u0435\u043d\u043d\u043e \u0438 \u043d\u0430\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u043f\u043e\u0437\u0434\u043d\u043e \u0432\u044b \u044d\u0442\u043e \u0437\u0430\u043c\u0435\u0442\u0438\u0442\u0435.\u042f, \u0437\u0430\u0441\u0442\u0430\u0432\u043b\u044f\u044e \u0441\u0432\u043e\u0439 \u043c\u043e\u0437\u0433 \u0440\u0430\u0431\u043e\u0442\u0430\u0442\u044c \u0431\u0435\u0437 \u0418\u0418\u0427\u0442\u043e \u0434\u0435\u043b\u0430\u0435\u0442 \u043f\u0430\u043a\u0435\u0442sunrise-studio\/symfony-openapi \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442 OpenAPI-\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442 \u0438\u0437 \u0442\u043e\u0433\u043e, \u0447\u0442\u043e \u0443\u0436\u0435 \u0435\u0441\u0442\u044c \u0432 Symfony-\u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0438:Symfony routes;\u0441\u0438\u0433\u043d\u0430\u0442\u0443\u0440 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u043e\u0432;Symfony HttpKernel attributes;\u0442\u0438\u043f\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0445 DTO\/View classes;route options;\u043d\u0435\u0431\u043e\u043b\u044c\u0448\u0438\u0445 OpenAPI attributes \u0442\u043e\u043b\u044c\u043a\u043e \u0434\u043b\u044f \u0442\u0435\u0445 \u0441\u043b\u0443\u0447\u0430\u0435\u0432, \u0433\u0434\u0435 PHP-\u0442\u0438\u043f\u043e\u0432 \u0438 \u043c\u0430\u0440\u0448\u0440\u0443\u0442\u043e\u0432 \u0443\u0436\u0435 \u043d\u0435\u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e.\u0413\u043b\u0430\u0432\u043d\u0430\u044f \u0446\u0435\u043b\u044c \u043f\u0440\u043e\u0441\u0442\u0430\u044f: \u043e\u0431\u044b\u0447\u043d\u044b\u0435 endpoints \u043d\u0435 \u0434\u043e\u043b\u0436\u043d\u044b \u0442\u0440\u0435\u0431\u043e\u0432\u0430\u0442\u044c \u0431\u043e\u043b\u044c\u0448\u0438\u0445 \u0431\u043b\u043e\u043a\u043e\u0432 #[OA\\&#8230;].\u0415\u0441\u043b\u0438 endpoint \u043f\u0440\u043e\u0441\u0442\u043e\u0439, \u043e\u043d \u0434\u043e\u043b\u0436\u0435\u043d \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0438\u0440\u043e\u0432\u0430\u0442\u044c\u0441\u044f \u043f\u043e\u0447\u0442\u0438 \u0441\u0430\u043c. \u0415\u0441\u043b\u0438 endpoint \u043e\u0441\u043e\u0431\u0435\u043d\u043d\u044b\u0439, \u043c\u043e\u0436\u043d\u043e \u0432\u043c\u0435\u0448\u0430\u0442\u044c\u0441\u044f \u0432\u0440\u0443\u0447\u043d\u0443\u044e, \u043d\u043e \u0442\u043e\u0447\u0435\u0447\u043d\u043e.\u041f\u043e\u0434\u0440\u043e\u0431\u043d\u043e\u0441\u0442\u0438 \u044f \u043f\u043e\u0441\u0442\u0430\u0440\u0430\u043b\u0441\u044f \u043e\u043f\u0438\u0441\u0430\u0442\u044c \u0432 README. \u0422\u0430\u043c \u0435\u0441\u0442\u044c \u0443\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430, \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u044f, route options, request mapping, responses, errors, \u0440\u0443\u0447\u043d\u044b\u0435 OpenAPI-\u0444\u0440\u0430\u0433\u043c\u0435\u043d\u0442\u044b, schema resolvers \u0438 extension points.\u041a\u0430\u043a \u043c\u0438\u043d\u0438\u043c\u0443\u043c, \u0435\u0441\u043b\u0438 \u043d\u0435 \u0434\u043b\u044f \u0432\u0430\u0441 \u043b\u0438\u0447\u043d\u043e, \u0442\u043e \u0434\u043b\u044f \u0418\u0418, \u043a\u043e\u0442\u043e\u0440\u043e\u043c\u0443 \u0432\u044b \u043f\u043e\u0442\u043e\u043c \u0441\u043a\u043e\u0440\u043c\u0438\u0442\u0435 README \u0438 \u043f\u043e\u043f\u0440\u043e\u0441\u0438\u0442\u0435 \u043f\u043e\u0434\u043a\u043b\u044e\u0447\u0438\u0442\u044c \u043f\u0430\u043a\u0435\u0442 \u0432 \u043f\u0440\u043e\u0435\u043a\u0442\u0435.\u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430 \u0438 \u043f\u0435\u0440\u0432\u044b\u0439 \u0437\u0430\u043f\u0443\u0441\u043a\u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430:composer require sunrise-studio\/symfony-openapi\u041f\u043e\u0434\u043a\u043b\u044e\u0447\u0438\u0442\u0435 bundle:\/\/ config\/bundles.phpreturn [    Symfony\\Bundle\\FrameworkBundle\\FrameworkBundle::class =&gt; [&#8216;all&#8217; =&gt; true],    Sunrise\\Symfony\\OpenApi\\OpenApiBundle::class =&gt; [&#8216;all&#8217; =&gt; true],];\u0418\u043c\u043f\u043e\u0440\u0442\u0438\u0440\u0443\u0439\u0442\u0435 \u043c\u0430\u0440\u0448\u0440\u0443\u0442\u044b \u043f\u0430\u043a\u0435\u0442\u0430:# config\/routes.yamlopenapi:    resource: &#8216;@OpenApiBundle\/config\/routes.php&#8217;\u041f\u043e\u0441\u043b\u0435 \u044d\u0442\u043e\u0433\u043e \u0431\u0443\u0434\u0443\u0442 \u0434\u043e\u0441\u0442\u0443\u043f\u043d\u044b \u0434\u0432\u0430 \u043c\u0430\u0440\u0448\u0440\u0443\u0442\u0430:GET \/docsGET \/docs\/openapi.json\/docs \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442 Swagger UI.\/docs\/openapi.json \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 OpenAPI JSON document.\u0411\u0430\u0437\u043e\u0432\u0430\u044f \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u044f \u043c\u043e\u0436\u0435\u0442 \u0432\u044b\u0433\u043b\u044f\u0434\u0435\u0442\u044c \u0442\u0430\u043a:# config\/packages\/openapi.yamlparameters:    openapi.initial_document:        openapi: 3.1.1        info:            title: API            version: 1.0.0\u0421\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442 \u0432 \u0444\u0430\u0439\u043b \u043c\u043e\u0436\u043d\u043e \u043a\u043e\u043c\u0430\u043d\u0434\u043e\u0439:php bin\/console openapi:build-document\u041f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e \u043a\u043e\u043c\u0430\u043d\u0434\u0430 \u0437\u0430\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442 \u0432 \u0444\u0430\u0439\u043b, \u0443\u043a\u0430\u0437\u0430\u043d\u043d\u044b\u0439 \u0432 openapi.document_filename.\u0415\u0441\u043b\u0438 \u043d\u0443\u0436\u0435\u043d \u0434\u0440\u0443\u0433\u043e\u0439 \u043f\u0443\u0442\u044c \u0434\u043b\u044f Swagger UI, \u043c\u043e\u0436\u043d\u043e \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0438\u0442\u044c \u043c\u0430\u0440\u0448\u0440\u0443\u0442 \u0441\u0430\u043c\u043e\u043c\u0443:# config\/routes.yamlswagger_ui:    path: \/swagger.html    controller: Sunrise\\Symfony\\OpenApi\\Controller\\SwaggerController    methods: [GET]    options:        api: false\u0415\u0441\u043b\u0438 \u043c\u0435\u043d\u044f\u0435\u0442\u0441\u044f \u043f\u0443\u0442\u044c \u0441\u0430\u043c\u043e\u0433\u043e OpenAPI-\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430, \u043d\u0443\u0436\u043d\u043e \u043e\u0431\u043d\u043e\u0432\u0438\u0442\u044c \u0438 \u043c\u0430\u0440\u0448\u0440\u0443\u0442, \u0438 openapi.document_uri, \u0447\u0442\u043e\u0431\u044b Swagger UI \u0437\u0430\u0433\u0440\u0443\u0436\u0430\u043b \u043f\u0440\u0430\u0432\u0438\u043b\u044c\u043d\u044b\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442:# config\/routes.yamlopenapi_document:    path: \/openapi.json    controller: Sunrise\\Symfony\\OpenApi\\Controller\\DocumentController    methods: [GET]    options:        api: false# config\/packages\/openapi.yamlparameters:    openapi.document_uri: \/openapi.json\u041c\u0438\u043d\u0438\u043c\u0430\u043b\u044c\u043d\u044b\u0439 endpoint\u0412\u0435\u0440\u043d\u0451\u043c\u0441\u044f \u043a \u043f\u0440\u0438\u043c\u0435\u0440\u0443 \u0441 completions.declare(strict_types=1);namespace App\\Http\\Controller;use App\\Http\\Request\\CreateCompletionRequest;use App\\Http\\View\\CompletionView;use App\\Service\\CompletionService;use Symfony\\Component\\HttpKernel\\Attribute\\MapRequestPayload;use Symfony\\Component\\Routing\\Attribute\\Route;#[Route(&#8216;\/v1\/completions&#8217;, methods: [&#8216;POST&#8217;])]final readonly class CreateCompletionController{    public function __construct(        private CompletionService $completionService,    ) {    }    public function __invoke(        #[MapRequestPayload] CreateCompletionRequest $request,    ): CompletionView {        return new CompletionView(            text: $this-&gt;completionService-&gt;complete($request-&gt;prompt),        );    }}\u0417\u0434\u0435\u0441\u044c \u043d\u0435\u0442:#[OA\\Post(&#8230;)]#[OA\\RequestBody(&#8230;)]#[OA\\Response(&#8230;)]#[OA\\JsonContent(&#8230;)]\u0418\u0434\u0435\u044f \u0432 \u0442\u043e\u043c, \u0447\u0442\u043e \u043c\u043d\u0435 \u043d\u0435 \u043d\u0443\u0436\u043d\u043e \u0432\u0442\u043e\u0440\u043e\u0439 \u0440\u0430\u0437 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0442\u044c \u0442\u043e, \u0447\u0442\u043e \u0443\u0436\u0435 \u0435\u0441\u0442\u044c \u0432 \u043a\u043e\u0434\u0435.Route \u0443\u0436\u0435 \u0437\u043d\u0430\u0435\u0442 path \u0438 method.CreateCompletionRequest \u0443\u0436\u0435 \u0437\u043d\u0430\u0435\u0442 request body.CompletionView \u0443\u0436\u0435 \u0437\u043d\u0430\u0435\u0442 response body.Return type \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u0430 \u0443\u0436\u0435 \u0433\u043e\u0432\u043e\u0440\u0438\u0442, \u0447\u0442\u043e endpoint \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 CompletionView.\u0415\u0441\u043b\u0438 \u0432\u0441\u0451-\u0442\u0430\u043a\u0438 \u0445\u043e\u0447\u0435\u0442\u0441\u044f \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c metadata\u0418\u043d\u043e\u0433\u0434\u0430 \u043d\u0443\u0436\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c tags, summary, description \u0438\u043b\u0438 status code.\u042f \u043d\u0435 \u0445\u043e\u0442\u0435\u043b \u043f\u0440\u0435\u0432\u0440\u0430\u0449\u0430\u0442\u044c \u044d\u0442\u043e \u043e\u0431\u0440\u0430\u0442\u043d\u043e \u0432 \u0431\u043e\u043b\u044c\u0448\u043e\u0439 OpenAPI-\u0431\u043b\u043e\u043a, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 metadata \u043c\u043e\u0436\u043d\u043e \u0434\u0435\u0440\u0436\u0430\u0442\u044c \u0431\u043b\u0438\u0436\u0435 \u043a \u043c\u0430\u0440\u0448\u0440\u0443\u0442\u0443:declare(strict_types=1);namespace App\\Http\\Controller;use App\\Http\\Request\\CreateCompletionRequest;use App\\Http\\View\\CompletionView;use Symfony\\Component\\HttpKernel\\Attribute\\MapRequestPayload;use Symfony\\Component\\Routing\\Attribute\\Route;#[Route(    &#8216;\/v1\/completions&#8217;,    methods: [&#8216;POST&#8217;],    options: [        &#8216;tags&#8217; =&gt; [&#8216;Completions&#8217;],        &#8216;summary&#8217; =&gt; &#8216;Creates completion&#8217;,        &#8216;description&#8217; =&gt; &#8216;Creates text completion for the given prompt.&#8217;,        &#8216;response_code&#8217; =&gt; 201,    ],)]final readonly class CreateCompletionController{    public function __invoke(        #[MapRequestPayload] CreateCompletionRequest $request,    ): CompletionView {        \/\/ &#8230;    }}\u042d\u0442\u043e \u0432\u0441\u0451 \u0435\u0449\u0451 \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u043a\u0430\u043a \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0435 \u043c\u0430\u0440\u0448\u0440\u0443\u0442\u0430 \u0438 \u043f\u043e\u0432\u0435\u0434\u0435\u043d\u0438\u044f endpoint-\u0430, \u0430 \u043d\u0435 \u043a\u0430\u043a \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0439 OpenAPI-\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442 \u0432\u043d\u0443\u0442\u0440\u0438 PHP-\u0430\u0442\u0440\u0438\u0431\u0443\u0442\u0430.\u041f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u044e\u0442\u0441\u044f, \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440:tag, tags;summary;description;deprecated;api;response_code;response_format, response_formats.\u0415\u0441\u043b\u0438 \u0432\u0430\u0448\u0435\u043c\u0443 \u043f\u0440\u043e\u0435\u043a\u0442\u0443 \u043d\u0435 \u043d\u0440\u0430\u0432\u0438\u0442\u0441\u044f \u0445\u0440\u0430\u043d\u0438\u0442\u044c \u044d\u0442\u043e \u0432 route options, \u043c\u043e\u0436\u043d\u043e \u0437\u0430\u043c\u0435\u043d\u0438\u0442\u044c RouteMetadataResolverInterface.Request body, query, path variables\u041f\u0430\u043a\u0435\u0442 \u043f\u043e\u043d\u0438\u043c\u0430\u0435\u0442 Symfony attributes, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u044e\u0442 request data.Request body \u0447\u0435\u0440\u0435\u0437 #[MapRequestPayload]:use Symfony\\Component\\HttpKernel\\Attribute\\MapRequestPayload;use Symfony\\Component\\Routing\\Attribute\\Route;#[Route(&#8216;\/v1\/completions&#8217;, methods: [&#8216;POST&#8217;])]public function __invoke(    #[MapRequestPayload] CreateCompletionRequest $request,): CompletionView {    \/\/ &#8230;}Path variables \u0447\u0438\u0442\u0430\u044e\u0442\u0441\u044f \u0438\u0437 \u043c\u0430\u0440\u0448\u0440\u0443\u0442\u0430 \u0438 \u0441\u0438\u0433\u043d\u0430\u0442\u0443\u0440\u044b \u043c\u0435\u0442\u043e\u0434\u0430:use&#8230;<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[],"tags":[],"class_list":["post-483681","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/483681","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=483681"}],"version-history":[{"count":0,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/483681\/revisions"}],"wp:attachment":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=483681"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=483681"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=483681"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}