The evolution of the Symfony Console component has been a journey of consistent refinement. For years, developers grew accustomed to the ritual of extending the Command class, implementing the   method to define arguments and options and placing their logic inside  . It was robust, deterministic and verbose. configure() execute() With the advent of Symfony 5 and 6, we saw the introduction of Invokable Commands — a paradigm shift that allowed us to treat commands more like controllers. The  方法は新しい入り口となり、ボイラープレートは 薄くなり始め、PHPの属性によって部分的に置き換えられた。 しかし、一つの摩擦点は残っていた:コマンドの署名と実際の入力パッシングの間の切断。 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コントローラーの間のギャップを効率的にブリッジするコンソールコンポーネントのライフ・オブ・ライフのパッケージを導入します。 で、 VIA 「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. 古いコマンドを現代のSymfony 7.4の傑作に再現します。 前提条件と設置 コードに潜入する前に、あなたの環境が準備されていることを確認してください. You will need: 
 
 
 PHP 8.2 またはそれ以上 (PHP 8.4 はより良いシンタクスサポートのために推奨されます)。 グローバルにインストールされたコンポーネント たとえば、新しい 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"
    }
}
 Update コマンドを実行する: composer update symfony/*
 あなたのバージョンをチェック: php bin/console --version
# Output should look like: Symfony 7.4.x (env: dev, debug: true)
 ネイティブサポート The Old Way (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. あなたは、文字列のアルゴリズムを受け入れ、それを許容値のリストに対して手動で検証し、その後、おそらくそれをPHP Enumの使用にマップします。 // 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;
    }
}
 This works, but it leaks validation logic into the execution flow and lacks type safety. シンフォニア 7.4 Way Symfony 7.4 では、コンソールコンポーネントの 論理がコマンドに移行されました. You can now type-hint arguments with Symfony は自動的に: ArgumentResolver Backed Enums 
 
 
 
 入力文字列を読んでください。 Enumのバックアップ値にマッピングしてみてください。 値が無効である場合に記述的なエラーを投げて、利用可能なオプションをリストします。 まず、私たちのエノミーを定義しましょう。 // 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;
    }
}
 Try running the command with an invalid value: 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".
 この検証は「無料」で、あなたのコードが実行される前にフレームワークによって厳格に執行されます。 Input DTOs with #[MapInput] あなたの命令が成長するにつれて、あなたの この方法は、数十の議論やオプションで混乱する可能性があります。これは「Long Parameter List」コードの臭いです。 and now Console follows suit with . __invoke #[MapRequestPayload] #[MapInput] これにより、コマンドの入力定義を専用データ転送オブジェクト(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;
}
 The Refactored コマンド 現在、この DTO をコマンドに注入します。 属性 #[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 を正しくマッピングした場合、他のサービスやコントローラで再利用できます。 可読性:コマンド論理は、議論とオプションの構成から切り離されます。  If you use  , the DTO is validated automatically before   is called. Validation: symfony/validator __invoke Declarative Interaction with #[Interact] and #[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 “What is your name?” php bin/console app:hello World The #[Interact] Attribute は、 複雑な相互作用(例えば、以前の回答に基づくダイナミックな質問)の場合、いずれかの方法を相互作用マネージャーとしてマークし、インジェクションを行うことができます。 そして 自動的に 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 を使用するコマンドをテストするには、特別な設定は必要ありません。 CommandTester テストケース We’ll test the   we created earlier. 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
 リアル・ワールド・シナリオ: A Complex Report Generator すべての特徴を組み合わせる - で、 そして ――一貫したプロレベルのコマンドに、財務報告を生成するコマンドを想像してください。 Enums DTOs Attributes THE ENUMS 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 はデータ構造を処理します。 サービスは論理を処理します。 コマンドは CLI インターフェイスを処理します。 Context-Aware Interactivity: The #[Interact] method allows for dynamic questions (only asking for email if PDF is selected) that pure attributes can't easily handle. Context-Aware Interactivity:#[Interact] method allows for dynamic questions (only asking for email if PDF is selected) that pure attributes can't easily handle. Context-Aware Interactivity: The #[Interact] method allows for dynamic questions (only asking for email if PDF is selected) that pure attributes cannot easily handle. Type Safety: We never manually validate if $format is pdf or csv. The Enum casting guarantees it. タイプのセキュリティ:我々は決して手動で$形式がPDFまたはCSVであるかどうかを検証しません。 結論 Symfony 7.4 は、コンソール コンポーネントの重要な成熟点を意味します. 属性と DTO を採用することにより、フレームワークは、コンソール コマンドが現代のアプリケーションで一流の市民であることを認識し、HTTP コントローラと同じ開発者体験 (DX) に値します。 Key Takeaways: 
 
 
 
  Use   and   to let Symfony handle data hydration and validation. Stop parsing, start declaring: #[MapInput] Enums 署名をクリアする:長い議論リストを DTO に移動します。 Declarative interaction: Use #[Ask] for simple prompts and #[Interact] for complex flows without overriding the parent class logic. Declarative interaction: Use #[Ask] for simple prompts and #[Interact] for complex flows without overriding the parent class logic. Declarative interaction: Use #[Ask] for simple promps and #[Interact] for complex flows without overriding the parent class logic. これらの変更は、ボイラープレートを削減し、テスト可能性を高め、コードの読み取りを大幅に容易にします。Symfony 7.4 にアップグレードしていない場合は、コンソールコンポーネントの改良だけが強力な理由です。 Let's be in touch ♪ あなたのCLIツールを近代化する準備はできていますか? まずは、最も複雑なコマンドを再構成することから始めましょう。 そして、あなたの経験を共有する。 #[MapInput] あなたがこのガイドが役に立つと感じた場合、または特定のエッジケースに関する質問がある場合は、私に連絡してください! あなたは私を見つけることができます [LinkedIn] ( ). Subscribe to the newsletter for more deep dives into Symfony’s ecosystem. https://www.linkedin.com/in/matthew-mochalkin/ https://www.linkedin.com/in/matthew-mochalkin/ ハッピーコード!

Read My Stories

このオーディオは、ストーリーの元の言語で制作されています。

コントローラーを書くようにシンフォニーコマンドを書く(Symfony Commands Like You Write Controllers)

About Author

コメント

ラベル

この記事は

Related Stories

ユニークなエコシステムを支えるビットコインUTXOのモデル

目に見えない層: ユーザーインタビューがかけがえのない資産である理由

AI の力を解き放つ。最先端技術の体系的レビュー: 概要と序論

タップして稼ぐ：テレグラムはソラナより先に次の100億人の暗号通貨ユーザーを獲得する可能性がある

ユニークなエコシステムを支えるビットコインUTXOのモデル

目に見えない層: ユーザーインタビューがかけがえのない資産である理由

AI の力を解き放つ。最先端技術の体系的レビュー: 概要と序論

タップして稼ぐ：テレグラムはソラナより先に次の100億人の暗号通貨ユーザーを獲得する可能性がある

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps