A Symfony Console komponens evolúciója a következetes finomítás útja volt. Az évek során a fejlesztők hozzászoktak a parancsnoki osztály kiterjesztésének rituáléjához, a módszer az érvek és opciók meghatározására, és logikájuk beépítésére Erős, determinisztikus és verbóz volt. configure() execute() A Symfony 5 és 6 megjelenésével láttuk a hívható parancsok bevezetését – egy paradigmaváltást, amely lehetővé tette számunkra, hogy a parancsokat úgy kezeljük, mint a vezérlőket. a módszer lett az új belépési pont és a kazánlemez a elkezdett elhalványulni, részben helyettesítve PHP attribútumokkal, mint például Azonban egy súrlódási pont maradt: a parancs aláírása és a tényleges bemeneti elemzés közötti szakítás. vagy bonyolult konfigurációkra támaszkodva a bemenetek feltérképezéséhez a beírt változókhoz. __invoke() configure() #[AsCommand] $input->getArgument(‘…’) A Symfony 7.4 mindent megváltoztat A 2025 novemberében kiadott Symfony 7.4 a konzol-összetevő életminőségének javítását tartalmazza, amely hatékonyan áthidalja a konzol-parancsok és a Http-vezérlők közötti szakadékot. ,  útján A deklaratív interaktivitás a és , írás CLI eszközök soha nem volt ilyen típus-biztonságos vagy kifejező. Backed Enums Input DTOs #[MapInput] #[Interact] #[Ask] Ebben az átfogó útmutatóban mélyrehatóan megvizsgáljuk ezeket az új funkciókat, és egy régimódi parancsot modern Symfony 7.4 remekművé alakítunk át, amely a telepítést, a végrehajtást, az ellenőrzést és a tesztelést foglalja magában. Előfeltételek és telepítés Mielőtt a kódba merülne, győződjön meg róla, hogy a környezet készen áll. 
 
 
 PHP 8.2 vagy újabb (a jobb szintaxis támogatás érdekében a PHP 8.4 ajánlott). Composer globálisan telepítve. A példák követéséhez szükség van egy új Symfony 7.4 projekt létrehozására vagy egy meglévő projekt frissítésére. Ha frissen kezdesz: composer create-project symfony/skeleton:^7.4 my_cli_app
cd my_cli_app
composer require symfony/console:^7.4
 Ha egy meglévő projektet frissít, győződjön meg róla, hogy kifejezetten a konzolkomponens 7.4 kiadását célozza meg: composer.json {
    "require": {
        "php": ">=8.2",
        "symfony/console": "^7.4",
        "symfony/framework-bundle": "^7.4",
        "symfony/runtime": "^7.4"
    }
}
 Indítsa el a Update parancsot: composer update symfony/*
 Ellenőrizze a verziót: php bin/console --version
# Output should look like: Symfony 7.4.x (env: dev, debug: true)
 Native Enum támogatás A régi út (Pre-7.4) Korábban a parancsokban felsorolt értékek kezelése kézi folyamat volt. elfogadnánk egy sorargumentumot, manuálisan érvényesítenénk a megengedett értékek listájával szemben, majd talán egy PHP Enum használatra térképeznénk. // 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;
    }
}
 Ez működik, de az érvényesítési logikát szivárog a végrehajtási folyamatba, és hiányzik a típusbiztonság. Szimfónia 7.4 mód A Symfony 7.4-ben a konzol komponens logikát portálták a parancsokra. Most már beírhatja az argumentumokat a A Symfony automatikusan: ArgumentResolver Backed Enums 
 
 
 
 Olvassa el a beviteli szalagot. Próbálja meg feltérképezni az Enum támogatási értékére. Húzza leíró hiba, ha az érték érvénytelen, felsorolja a rendelkezésre álló beállításokat. Elsőként határozzuk meg az Enum-ot. // 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';
}
 Most a parancs hihetetlenül egyszerű: // 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;
    }
}
 Próbálja meg futtatni a parancsot érvénytelen értékkel: php bin/console app:create-server mars
 A kimenet: [ERROR] The value "mars" is not allowed for argument "region".
         Allowed values are: "us-east-1", "eu-central-1", "ap-northeast-1".
 Ez az érvényesítés „ingyenes”, amelyet a keret szigorúan érvényesít, mielőtt a kód végrehajtaná. Írja be a DTO-kat a #[MapInput] Ahogy a parancsolatok növekednek, a A módszer több tucat argumentummal és opcióval is összezavarodhat. Ez a „Long Parameter List” kód szaga. és most a Console követi a . __invoke #[MapRequestPayload] #[MapInput] Ez lehetővé teszi, hogy kivonja a parancs beviteli definícióját egy dedikált adatátviteli objektumba (DTO). A DTO osztály Hozzon létre egy egyszerű PHP-osztályt a bemeneti adatok megtartásához. Használjon szabványos érvényesítési korlátozásokat, ha van telepítve a Validator komponens! // 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;
}
 A megújult parancsnokság Most ezt a DTO-t beadjuk a parancsba a Az attribútum. #[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;
    }
}
 Miért számít ez 
 
 
 
 Újrafelhasználhatóság: A ServerInput DTO-t más szolgáltatásokban vagy akár vezérlőkben is újra felhasználhatja, ha helyesen van feltérképezve. Olvashatóság: A parancslógia elkülönül az argumentumok és a beállítások konfigurációjától. Hitelesítés: Ha szimfóniát/hitelesítőt használ, a DTO-t automatikusan érvényesítik, mielőtt __invoke-t hívnak. Deklaratív kölcsönhatás a #[Interact] és a #[Ask] Az interaktív parancsok létfontosságúak a jó DX-hez, de a A módszer gyakran úgy érezte, mintha egy második parancsot írna csak az első üres helyének kitöltésére. interact() A #[Kérj] attribútum Egyszerű esetekben, amikor egy hiányzó argumentumnak fel kell hívnia a felhasználót, használja . #[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;
    }
}
 Ha a felhasználó fut A parancsnok megáll és megkérdezi Ha futnak Ez pedig a gyorsaságot szorítja. php bin/console app:hello „Milyen a neved?” php bin/console app:hello World A #[Interaktív] tulajdonság Bonyolult interakciók esetén (például a korábbi válaszokon alapuló dinamikus kérdések esetén) mostantól bármilyen módszert interakciókezelőként jelölhet be. és és automatikusan. 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;
    }
}
 Meghívható parancsok tesztelése A Symfony 7.4 biztosítja, hogy A tesztelési parancsok, amelyek DTO-kat vagy Enums-okat használnak, nem igényelnek speciális beállítást. CommandTester A teszt esete Meg fogjuk tesztelni a Mi teremtettünk már korábban. 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', 
        ]);
    }
}
 Végezze el a teszteket: php bin/phpunit tests/Command/DeployServerCommandTest.php
 Valós világ forgatókönyv: A komplex jelentés generátor Összegyűjtjük az összes funkciót - az , és Képzelj el egy parancsot, amely pénzügyi jelentéseket készít. Enums DTOs Attributes Az 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';
}
 Bevezetés 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;
}
 A szolgáltatás Ideális esetben a logika a szolgálatban van, nem a parancs. namespace App\Service;

use App\Dto\ReportInput;

class ReportGenerator
{
    public function generate(ReportInput $input): void
    {
        // ... generation logic
    }
}
 A parancsnokság 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;
    }
}
 Ez a példa bemutatja a Symfony 7.4 erejét: 
 
 
 
 Aggodalmak szétválasztása: A ReportInput DTO kezeli az adatstruktúrát, a szolgáltatás kezeli a logikát, a parancs pedig a CLI interfészt. Context-Aware Interactivity: A #[Interact] módszer lehetővé teszi a dinamikus kérdéseket (csak e-mailt kérve, ha a PDF-t választja), amelyeket a tiszta attribútumok nem tudnak könnyen kezelni. Típusbiztonság: Soha nem ellenőrizzük manuálisan, hogy a $ formátum pdf vagy csv. Az Enum öntés garantálja. következtetés Az attribútumok és DTO-k elfogadásával a keretrendszer elismeri, hogy a konzolparancsok a modern alkalmazások első osztályú polgárai, és ugyanolyan fejlesztői tapasztalatot (DX) érdemelnek, mint a HTTP-vezérlők. Key Takeaways: 
 
 
 
 Hagyja abba a feldolgozást, kezdje el a kijelentést: Használja a #[MapInput] és az Enums funkciókat, hogy a Symfony kezelje az adatok hidratálását és érvényesítését. Tisztítsa meg az aláírásokat: Hosszú érvek listáinak áthelyezése DTO-kba. Fogadja el a deklaratív interakciót: Használja a #[Ask] egyszerű utasításokhoz és a #[Interact] összetett áramlásokhoz anélkül, hogy felülírná a szülői osztály logikáját. Ezek a változások csökkentik a kazánterhelést, növelik a tesztelhetőséget és jelentősen megkönnyítik a kód olvasását.Ha még nem frissített a Symfony 7.4-re, a továbbfejlesztett konzolkomponens önmagában is meggyőző ok arra, hogy elinduljon. Legyünk érintettek Készen áll a CLI-eszközök korszerűsítésére? Kezdje a legbonyolultabb parancs megújításával és ossza meg tapasztalatait. #[MapInput] Ha hasznosnak találod ezt az útmutatót, vagy kérdésed van a speciális edge esetekről, lépj kapcsolatba velem! Regisztráljon a hírlevélre, hogy mélyebbre merüljön a Symfony ökoszisztémájában. https://www.linkedin.com/in/matthew-mochalkin/ https://www.linkedin.com/in/matthew-mochalkin/ Szerencsés kódolás!

Read My Stories

Ez a hanganyag a történet eredeti nyelvén készült!

Írj szimfóniai parancsokat úgy, ahogy vezérlőket írsz – végre

About Author

HOZZÁSZÓLÁSOK

HANG TAGOK

EZT A CIKKET BEMUTATTA

Related Stories

HackerNoon Contributor Denisa Ganea on HackerNoon, Human Existence, and Everything in Between

And now the important day of the election had arrived

Of The First and Last Things: Part 3

INTRODUCTION

HackerNoon Contributor Denisa Ganea on HackerNoon, Human Existence, and Everything in Between

And now the important day of the election had arrived

Of The First and Last Things: Part 3

INTRODUCTION

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps