Symfony Console 구성 요소의 진화는 일관된 정교함의 여정이었습니다.수년 동안 개발자들은 명령 클래스를 확장하고 명령 클래스를 구현하는 의식에 익숙해졌습니다. 논리와 옵션을 정의하고 그 논리를 내부에 배치하는 방법 그것은 견고하고, 결정적이고, 말도 안 되는 것이었다. configure() execute() Symfony 5와 6의 등장과 함께, 우리는 호출 가능한 명령의 도입을 보았습니다.Invokable Commands는 명령을 컨트롤러처럼 취급 할 수있는 패러다임 변화입니다. 이 방법은 새로운 출입점이 되었고, 사라지기 시작했으며, 부분적으로 PHP 속성에 의해 대체되었습니다. 그러나 한 가지 흔들림점이 남아있었다: 명령의 서명과 실제 입력 분석 사이의 끊임없는 연결.We still found ourselves manually picking arguments via 복잡한 구성에 의존하여 입력 변수에 대한 입력을 매핑합니다. or relying on complex configurations to map inputs to typed variables. __invoke() configure() #[AsCommand] $input->getArgument(‘…’) Symfony 7.4 모든 것을 바꾼다 2025년 11월에 출시된 Symfony 7.4는 콘솔 구성 요소에 대한 품질의 개선을 제공하여 콘솔 명령과 Http 컨트롤러 간의 격차를 효과적으로 교차시킵니다. , 길이  and declarative interactivity with  그리고 , CLI 도구를 쓰는 것은 결코 이런 형식이 안전하거나 표현적이지 않았습니다. Backed Enums Input DTOs #[MapInput] #[Interact] #[Ask] 이 포괄적 인 가이드에서는 이러한 새로운 기능을 심층적으로 탐구합니다.We will refactor a legacy command into a modern Symfony 7.4 masterpiece, covering installation, implementation, verification and testing. 전제 조건 및 설치 Before diving into the code, ensure your environment is ready. You will need: 
 
 
 PHP 8.2 이상 (PHP 8.4는 더 나은 구문 지원을 위해 권장). 전 세계적으로 설치된 Composer. 예를 들면 새로운 Symfony 7.4 프로젝트를 만들거나 기존 프로젝트를 업그레이드하는 것이 필요합니다. 당신이 신선하게 시작하는 경우 : composer create-project symfony/skeleton:^7.4 my_cli_app
cd my_cli_app
composer require symfony/console:^7.4
 기존 프로젝트를 업그레이드하는 경우, 귀하의 명시적으로 콘솔 구성 요소에 대한 7.4 릴리스를 대상으로 합니다: composer.json {
    "require": {
        "php": ">=8.2",
        "symfony/console": "^7.4",
        "symfony/framework-bundle": "^7.4",
        "symfony/runtime": "^7.4"
    }
}
 업데이트 명령어를 실행합니다: composer update symfony/*
 당신의 버전을 확인하십시오 : php bin/console --version
# Output should look like: Symfony 7.4.x (env: dev, debug: true)
 Native Enum 지원 오래된 길 (Pre-7.4) 이전에는 명령에서 나열된 값을 처리하는 것이 수동 프로세스였습니다.You would accept a string argument, valid it against a list of allowed values manually and then map it to a PHP Enum usage. // src/Command/LegacyServerCommand.php
namespace App\Command;

use Symfony\Component\Console\Attribute\AsCommand;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputArgument;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;

#[AsCommand(name: 'app:legacy-server')]
class LegacyServerCommand extends Command
{
    protected function configure(): void
    {
        $this->addArgument('region', InputArgument::REQUIRED, 'The server region (us, eu)');
    }

    protected function execute(InputInterface $input, OutputInterface $output): int
    {
        $region = $input->getArgument('region');
        
        if (!in_array($region, ['us', 'eu'])) {
            $output->writeln('<error>Invalid region.</error>');
            return Command::FAILURE;
        }

        // Logic here...
        return Command::SUCCESS;
    }
}
 이것은 작동하지만 실행 흐름에 검증 논리를 유출하고 타입 보안이 부족합니다. Symfony 7.4 Way에 대한 리뷰 보기 Symfony 7.4에서는 Console 구성 요소의 논리가 명령에 포트되었습니다.당신은 이제 힌트를 입력할 수 있습니다 Symfony는 자동으로 : ArgumentResolver Backed Enums 
 
 
 
 입력 문자열을 읽어보세요. 그것을 Enum의 백업 값으로 매핑하십시오. 값이 유효하지 않은 경우 설명 오류를 던져 사용 가능한 옵션을 나열합니다.Throw a descriptive error if the value is invalid, listing available options. 우선 우리의 에너지를 정의해 보자. // src/Enum/ServerRegion.php
namespace App\Enum;

enum ServerRegion: string
{
    case US = 'us-east-1';
    case EU = 'eu-central-1';
    case ASIA = 'ap-northeast-1';
}
 이제 명령은 믿을 수 없을만큼 간단해집니다: // src/Command/CreateServerCommand.php
namespace App\Command;

use App\Enum\ServerRegion;
use Symfony\Component\Console\Attribute\AsCommand;
use Symfony\Component\Console\Attribute\Argument; // Note: In 7.4 attributes are often simplified
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Output\OutputInterface;

#[AsCommand(name: 'app:create-server', description: 'Creates a server in a specific region.')]
class CreateServerCommand extends Command
{
    // The magic happens here: Type-hinting the Enum
    public function __invoke(
        OutputInterface $output, 
        #[Argument] ServerRegion $region
    ): int {
        $output->writeln(sprintf('Creating server in region: %s', $region->value));

        return Command::SUCCESS;
    }
}
 잘못된 값을 가진 명령을 실행하십시오: php bin/console app:create-server mars
 출력 : [ERROR] The value "mars" is not allowed for argument "region".
         Allowed values are: "us-east-1", "eu-central-1", "ap-northeast-1".
 이 인증은 "무료"이며, 코드가 실행되기 전에 프레임워크에 의해 엄격하게 시행됩니다. #[MapInput]을 사용하여 DTO를 입력합니다 당신의 명령이 성장함에 따라, 당신의 이 방법은 수십 개의 논리와 옵션으로 혼란스러워질 수 있습니다.이것은 "Long Parameter List"코드 냄새입니다. 그리고 이제 Console은 다음과 같이 . __invoke #[MapRequestPayload] #[MapInput] 이렇게 하면 명령의 입력 정의를 전용 데이터 전송 객체(DTO)로 추출할 수 있습니다.This allows you to extract your command's input definition into a dedicated Data Transfer Object (DTO). DTO 클래스 입력 데이터를 저장하기 위해 간단한 PHP 클래스를 만듭니다.Validator 구성 요소가 설치되어 있으면 표준 검증 제약을 사용하십시오! // src/Dto/ServerInput.php
namespace App\Dto;

use App\Enum\ServerRegion;
use Symfony\Component\Console\Attribute\Argument;
use Symfony\Component\Console\Attribute\Option;
use Symfony\Component\Validator\Constraints as Assert;

class ServerInput
{
    #[Argument(description: 'The region to deploy to')]
    public ServerRegion $region;

    #[Option(description: 'The size of the instance')]
    #[Assert\Choice(['small', 'medium', 'large'])]
    public string $size = 'small';

    #[AsOption(name: 'dry-run', description: 'Simulate the creation')]
    public bool $dryRun = false;
}
 Refactored 명령어 이제 우리는 이 DTO를 사용하여 명령에 주입합니다.  attribute. #[MapInput] // src/Command/DeployServerCommand.php
namespace App\Command;

use App\Dto\ServerInput;
use Symfony\Component\Console\Attribute\AsCommand;
use Symfony\Component\Console\Attribute\MapInput;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Output\OutputInterface;

#[AsCommand(name: 'app:deploy-server')]
class DeployServerCommand extends Command
{
    public function __invoke(
        OutputInterface $output,
        #[MapInput] ServerInput $input
    ): int {
        if ($input->dryRun) {
            $output->writeln('<info>Dry run enabled. No changes made.</info>');
        }

        $output->writeln(sprintf(
            'Deploying %s instance to %s...',
            $input->size,
            $input->region->value
        ));

        return Command::SUCCESS;
    }
}
 왜 이것이 중요한가 
 
 
 
 재사용 가능: ServerInput DTO를 올바르게 매핑한 경우 다른 서비스 또는 컨트롤러에서도 재사용할 수 있습니다. 읽기: 명령 논리는 논리와 옵션의 구성에서 분리됩니다. 검증: Symfony/validator를 사용하는 경우 __invoke가 호출되기 전에 DTO가 자동으로 검증됩니다. #[Interact] 및 #[Ask]와의 선언적 상호 작용 상호 작용하는 명령은 좋은 DX에 필수적이지만, 이 방법은 종종 첫 번째 명령의 공백을 채우기 위해 두 번째 명령을 쓰는 것처럼 느껴집니다.Symfony 7.4는 이 명령을 선언적으로 처리하는 특성을 소개합니다. interact() The #[Ask] Attribute에 대한 질문 간단한 경우에 실종된 논문이 사용자를 촉구해야 하는 경우, 사용 . #[Ask] // src/Command/HelloCommand.php
namespace App\Command;

use Symfony\Component\Console\Attribute\AsCommand;
use Symfony\Component\Console\Attribute\Argument;
use Symfony\Component\Console\Attribute\Ask; // New in 7.4
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Output\OutputInterface;

#[AsCommand(name: 'app:hello')]
class HelloCommand extends Command
{
    public function __invoke(
        OutputInterface $output,
        #[Argument, Ask(question: "What is your name?")] 
        string $name
    ): int {
        $output->writeln("Hello, $name!");
        return Command::SUCCESS;
    }
}
 사용자가 실행하는 경우 명령어가 멈추고 묻는다. 만약 그들이 달리면 그것은 속도를 니다. php bin/console app:hello “당신의 이름은 무엇입니까?” php bin/console app:hello World #[Interact] 특성 복잡한 상호 작용 (예를 들어, 이전 응답을 기반으로 한 동적 질문)의 경우 이제 상호 작용 처리기로서 모든 방법을 선택할 수 있습니다. 그리고 자동으로 InputInterface StyleInterface // src/Command/WizardCommand.php
namespace App\Command;

use Symfony\Component\Console\Attribute\AsCommand;
use Symfony\Component\Console\Attribute\Interact;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputArgument;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;
use Symfony\Component\Console\Style\SymfonyStyle;

#[AsCommand(name: 'app:wizard')]
class WizardCommand extends Command
{
    protected function configure(): void
    {
        $this->addArgument('password', InputArgument::REQUIRED);
    }

    // This method is called automatically before __invoke if arguments are missing
    #[Interact]
    public function promptForPassword(InputInterface $input, SymfonyStyle $io): void
    {
        if (null === $input->getArgument('password')) {
            $password = $io->askHidden('Please enter your API password');
            $input->setArgument('password', $password);
        }
    }

    public function __invoke(OutputInterface $output, string $password): int
    {
        $output->writeln('Password received (hashed): ' . md5($password));
        return Command::SUCCESS;
    }
}
 시험할 수 있는 명령어 Symfony 7.4는 이것을 보장합니다. DTO 또는 Enums를 사용하는 테스트 명령은 특별한 설정이 필요하지 않습니다.Testing commands that use DTOs or Enums requires no special setup. CommandTester 테스트 케이스 우리는 그것을 테스트 할 것입니다 우리는 이전에 창조되었다. DeployServerCommand // tests/Command/DeployServerCommandTest.php
namespace App\Tests\Command;

use Symfony\Bundle\FrameworkBundle\Console\Application;
use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
use Symfony\Component\Console\Tester\CommandTester;

class DeployServerCommandTest extends KernelTestCase
{
    public function testExecuteWithDto(): void
    {
        $kernel = self::bootKernel();
        $application = new Application($kernel);

        $command = $application->find('app:deploy-server');
        $commandTester = new CommandTester($command);

        $commandTester->execute([
            'region' => 'us-east-1', // Passing string, automatically converted to Enum
            '--size' => 'large',
            '--dry-run' => true,
        ]);

        $commandTester->assertCommandIsSuccessful();

        $output = $commandTester->getDisplay();
        $this->assertStringContainsString('Dry run enabled', $output);
        $this->assertStringContainsString('Deploying large instance to us-east-1', $output);
    }

    public function testInvalidEnumThrowsError(): void
    {
        $kernel = self::bootKernel();
        $application = new Application($kernel);
        $command = $application->find('app:deploy-server');
        $commandTester = new CommandTester($command);

        // We expect a runtime exception or validation error depending on configuration
        // In Console context, this usually results in a status code 1 and error output
        $this->expectException(\Throwable::class); 
        // Or inspect status code:
        // $exitCode = $commandTester->execute(['region' => 'mars']);
        // $this->assertNotSame(0, $exitCode);

        $commandTester->execute([
            'region' => 'mars', 
        ]);
    }
}
 당신의 테스트를 실행하십시오 : php bin/phpunit tests/Command/DeployServerCommandTest.php
 현실 세계 시나리오 : 복잡한 보고서 생성기 모든 특징을 결합하자 - , 그리고 일관된, 전문적 수준의 명령으로, 재무 보고서를 생성하는 명령을 상상해보십시오. Enums DTOs Attributes ENUM의 namespace App\Enum;

enum ReportFormat: string {
    case PDF = 'pdf';
    case CSV = 'csv';
    case JSON = 'json';
}

enum ReportPeriod: string {
    case DAILY = 'daily';
    case WEEKLY = 'weekly';
    case MONTHLY = 'monthly';
}
 INPUT DTO namespace App\Dto;

use App\Enum\ReportFormat;
use App\Enum\ReportPeriod;
use Symfony\Component\Console\Attribute\Argument;
use Symfony\Component\Console\Attribute\Option;
use Symfony\Component\Console\Attribute\Ask;

class ReportInput
{
    #[Argument(description: 'Type of report')]
    #[Ask('What type of report would you like to generate?')]
    public string $reportType;

    #[Option]
    public ReportPeriod $period = ReportPeriod::WEEKLY;

    #[Option]
    public ReportFormat $format = ReportFormat::PDF;

    #[AsOption(name: 'email', description: 'Email to send report to')]
    public ?string $recipientEmail = null;
}
 서비스 이상적으로, 당신의 논리는 명령이 아니라 서비스에 있습니다. namespace App\Service;

use App\Dto\ReportInput;

class ReportGenerator
{
    public function generate(ReportInput $input): void
    {
        // ... generation logic
    }
}
 명령어 namespace App\Command;

use App\Dto\ReportInput;
use App\Service\ReportGenerator;
use Symfony\Component\Console\Attribute\AsCommand;
use Symfony\Component\Console\Attribute\Interact;
use Symfony\Component\Console\Attribute\MapInput;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Output\OutputInterface;
use Symfony\Component\Console\Style\SymfonyStyle;

#[AsCommand(name: 'app:report:generate')]
class GenerateReportCommand extends Command
{
    public function __construct(
        private ReportGenerator $generator
    ) {
        parent::__construct();
    }

    #[Interact]
    public function interactRecipient(InputInterface $input, SymfonyStyle $io): void
    {
        // Only ask for email if not provided and format is PDF (business rule)
        // Accessing raw input here since mapping happens later
        if (null === $input->getOption('email') && 'pdf' === $input->getOption('format')) {
            $email = $io->ask('Enter recipient email for the PDF');
            $input->setOption('email', $email);
        }
    }

    public function __invoke(
        OutputInterface $output,
        #[MapInput] ReportInput $input
    ): int {
        $output->writeln("Starting {$input->period->value} report generation...");
        
        $this->generator->generate($input);
        
        $output->writeln("Report generated in {$input->format->value} format.");
        
        if ($input->recipientEmail) {
            $output->writeln("Sent to: {$input->recipientEmail}");
        }

        return Command::SUCCESS;
    }
}
 이 예제는 Symfony 7.4의 힘을 보여줍니다. 
 
 
 
 문제의 분리: ReportInput DTO는 데이터 구조를 처리합니다.The Service는 논리를 처리합니다.The Command는 CLI 인터페이스를 처리합니다. Context-Aware Interactivity: #[Interact] 방법은 순수한 속성이 쉽게 처리할 수없는 동적 질문 (PDF가 선택된 경우 이메일을 요청하는 것만)을 허용합니다. 종류 보안: 우리는 $ 형식이 pdf 또는 csv 인지 수동으로 검증하지 않습니다. 결론 Symfony 7.4는 콘솔 구성 요소의 상당한 성숙점을 표시합니다.아트리브와 DTO를 채택함으로써 프레임워크는 콘솔 명령이 현대 애플리케이션에서 최상급 시민이며 HTTP 컨트롤러와 동일한 개발자 경험 (DX)을받을 자격이 있다는 것을 인정합니다. Key Takeaways: 
 
 
 
 파싱을 중지하고 선언을 시작하십시오: #[MapInput] 및 Enums를 사용하여 Symfony가 데이터 유압 및 검증을 처리할 수 있습니다. 서명을 정리하십시오: 긴 논쟁 목록을 DTO로 이동합니다. 선언적 상호 작용을 채택하십시오: 간단한 인스턴스에 대해 #[Ask]를 사용하고 복잡한 흐름에 대해 #[Interact]를 사용하여 부모 클래스 논리를 압도하지 마십시오. These changes reduce boilerplate, increase testability and make your code significantly easier to read. If you haven’t upgraded to Symfony 7.4 yet, the improved Console component alone is a compelling reason to make the jump. Let's be in touch에 대하여 CLI 도구를 현대화할 준비가 되셨습니까?CLI 도구를 사용하여 가장 복잡한 명령을 재구성하여 시작하세요. 그리고 당신의 경험을 공유하십시오. #[MapInput] [LinkedIn] [LinkedIn] [LinkedIn] [LinkedIn] [LinkedIn] [LinkedIn] [LinkedIn] [LinkedIn] [LinkedIn] [LinkedIn] [LinkedIn] [LinkedIn] [LinkedIn] [LinkedIn] [LinkedIn] [LinkedIn] 뉴스레터에 가입하여 Symfony의 생태계에 더 깊이 뛰어들 수 있습니다. https://www.linkedin.com/in/matthew-mochalkin/ https://www.linkedin.com/in/matthew-mochalkin/ 행복한 코딩!

Read My Stories

이 오디오는 이야기의 원래 언어로 제작되었습니다!

당신이 컨트롤러를 쓰는 것처럼 심포니 명령을 쓰십시오 - 마침내

About Author

코멘트

태그 걸기

이 기사는 다음에서 발표되었습니다.

Related Stories

AI/ML 데이터레이크용 참조 아키텍처 구축을 위한 설계자 가이드

작업 흐름을 10배 향상하는 방법: 17가지 필수 앱

AI의 힘을 발휘하세요. 최첨단 기술의 체계적 검토: 개요 및 소개

이 18가지 개발자 도구로 생산성을 높이세요 🚀🔥

AI/ML 데이터레이크용 참조 아키텍처 구축을 위한 설계자 가이드

작업 흐름을 10배 향상하는 방법: 17가지 필수 앱

AI의 힘을 발휘하세요. 최첨단 기술의 체계적 검토: 개요 및 소개

이 18가지 개발자 도구로 생산성을 높이세요 🚀🔥

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps