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

The Little Shop at Fishbourne

How Emoji Credibility Indicators Add Context to HackerNoon Stories

From Desk to HackerNoon: Your Ultimate Guide on How to Publish a Story

THE LAST DAY OF NEW YORK

The Little Shop at Fishbourne

How Emoji Credibility Indicators Add Context to HackerNoon Stories

From Desk to HackerNoon: Your Ultimate Guide on How to Publish a Story

THE LAST DAY OF NEW YORK

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps