[Symfony] Export Apidoc to YAML File

ExportSwaggerCommand.php

<?php
// src/Command/ExportSwaggerCommand.php
namespace App\Command;

use Nelmio\ApiDocBundle\ApiDocGenerator;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\{InputArgument, InputInterface};
use Symfony\Component\Console\Output\OutputInterface;
use Symfony\Component\Console\Style\SymfonyStyle;
use Symfony\Component\Yaml\Yaml;

class ExportSwaggerCommand extends Command
{
    public const NAME = 'api:swagger:export';
    private const YAML_INLINE = 20;
    private const YAML_INDENT = 2;

    public function __construct(private string $kernelProjectDir, private ApiDocGenerator $apiDocGenerator)
    {
        parent::__construct();
    }

    /**
     * {@inheritdoc}
     */
    protected function configure(): void
    {
        $this
            ->setName(self::NAME)
            ->addArgument('output_path', InputArgument::OPTIONAL, 'The output path of the swagger.yml file', './var')
            ->setDescription('Exports a swagger file for the API')
            ->setHelp('This command allows you to export the swagger definition yml file of the API')
        ;
    }

    /**
     * {@inheritdoc}
     */
    protected function execute(InputInterface $input, OutputInterface $output): int
    {
        $io = new SymfonyStyle($input, $output);
        $io->title($this->getDescription());

        $spec = $this->apiDocGenerator->generate()->toArray();
        $swaggerFile = $this->kernelProjectDir .'/'. $input->getArgument('output_path') . '/swagger.yaml';

        $io->writeln(sprintf('Writing file <info>%s</info>...', $swaggerFile));
        $exportFile = file_put_contents(
            $swaggerFile,
            Yaml::dump(
                $spec,
                self::YAML_INLINE,
                self::YAML_INDENT,
                Yaml::DUMP_OBJECT_AS_MAP | Yaml::DUMP_MULTI_LINE_LITERAL_BLOCK | Yaml::DUMP_EMPTY_ARRAY_AS_SEQUENCE
            )
        );

        return (($exportFile) ? Command::SUCCESS : Command::FAILURE);
    }
}

services.yaml

# config/services.yaml
services:
  _defaults:
    # ...
    bind:
      $kernelProjectDir: '%kernel.project_dir%'

  Nelmio\ApiDocBundle\ApiDocGenerator: '@nelmio_api_doc.generator.default'