Po rokoch spoliehania sa na balíky tretích strán, bojujúcich s ukladaním relácií a písaním komplikovanej logiky ovládača na zaobchádzanie s "príručkami", Symfony 7.4 priniesla jednu z najžiadanejších funkcií v histórii rámca: . Native Multi-Step Forms Ak ste pracovali s Symfony po dobu desiatich rokov, ako ja, poznáte boj. Potrebujete sprievodcu registráciou, komplexný proces vyúčtovania alebo viacstupňový prieskum. Mali ste dve možnosti: hacknutú logiku ovládača s manuálnymi skupinami validácie alebo legendárnu Zatiaľ čo Craue nám dobre slúžil, vždy to bola vonkajšia závislosť, ktorá sa cítila mierne odpojená od filozofie základnej zložky Form. CraueFormFlowBundle S vydaním Symfony 7.4 v novembri 2025 Core Team predstavil Form Flows. Toto nie je len pomocná trieda; ide o úplnú zmenu paradigmy, ktorá zaobchádza s viacstupňovým tokom ako s prvotriednym občanom, plne integrovaným s komponentmi Validator a Form. V tomto článku budeme budovať produktovo pripravenú Sprievodcu pripojením používateľa pomocou Symfony 7.4. budeme pokrývať všetko od inštalácie až po pokročilú správu stavu, pomocou iba natívnych knižníc poskytnutých rámcom. Evolúcia foriem v symfónii 7.4 Predtým, ako napíšeme kód, poďme pochopiť, prečo je táto aktualizácia dôležitá. V predchádzajúcich verziách bol formulár jedinou jednotkou práce. Predložili ste ho, overili ste ho a vyplachovali ste ho. Aby ste to rozbili, vývojári museli umelo rezať dátový model a manuálne spravovať stav medzi požiadavkami. , , a manuálne uložiť priebeh relácie. step 1 step 2, step 3 Symfónia 7.4 predstavuje Premýšľajte o tom ako o " Spravuje životný cyklus celého procesu, automaticky sa zaoberá navigáciou (Next, Previous, Skip), skupinami validácie a pretrvávajúcimi údajmi. AbstractFlowType Form of Forms Podnikový užívateľ Onboarding Vytvárame sprievodcu onboardingom pre platformu SaaS. Skladá sa z troch samostatných krokov: 
 
 
 
 Identifikácia: Základné údaje používateľa (e-mail, heslo). Profil: Profesionálne podrobnosti (názov zamestnania, spoločnosť). Plán: Výber predplatného (Free, Pro, Enterprise) Budeme používať a To je najlepšia prax v modernom vývoji Symfony, vyhýbanie sa problému „Anemic Domain Model“, kde sú entity zmätené s dočasnými údajmi formulára. Data Transfer Object (DTO) Objekt prenosu údajov (DTO) DTO pôsobí ako chrbtica nášho toku. Všimnite si použitie atribútov na overenie. V Symfónii 7.4 komponent Form Flow automaticky používa Toto je hra-zmena; už nepotrebujeme komplexy a uzamknutia. current step name as the validation group validation_groups //src/Form/Dto/UserOnboarding.php
namespace App\Form\Dto;

use Symfony\Component\Validator\Constraints as Assert;

class UserOnboarding
{
    // We need a property to track the current step.
    // The flow component will read/write to this.
    public string $currentStep = 'identity';

    // -- Step 1: Identity --
    
    #[Assert\NotBlank(groups: ['identity'])]
    #[Assert\Email(groups: ['identity'])]
    public ?string $email = null;

    #[Assert\NotBlank(groups: ['identity'])]
    #[Assert\PasswordStrength(minScore: 2, groups: ['identity'])]
    public ?string $password = null;

    // -- Step 2: Profile --

    #[Assert\NotBlank(groups: ['profile'])]
    #[Assert\Length(min: 2, groups: ['profile'])]
    public ?string $fullName = null;

    #[Assert\NotBlank(groups: ['profile'])]
    public ?string $jobTitle = null;

    #[Assert\IsTrue(message: "You must agree to terms.", groups: ['profile'])]
    public bool $termsAccepted = false;

    // -- Step 3: Plan --

    #[Assert\NotBlank(groups: ['plan'])]
    #[Assert\Choice(choices: ['free', 'pro', 'enterprise'], groups: ['plan'])]
    public string $plan = 'free';
}
 poznámka , , Tieto presne zodpovedajú názvom krokov, ktoré definujeme neskôr. groups: [‘identity’] groups: [‘profile’] Vytvorenie krokových foriem Potrebujeme štandard Toto sú štandardné symfonické formuláre; o nich nie je nič „špeciálne“, čo ich robí opakovane použiteľnými. AbstractType Identity Step //src/Form/Step/IdentityStepType.php
namespace App\Form\Step;

use App\Form\Dto\UserOnboarding;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\Extension\Core\Type\EmailType;
use Symfony\Component\Form\Extension\Core\Type\PasswordType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;

class IdentityStepType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options): void
    {
        $builder
            ->add('email', EmailType::class, [
                'label' => 'Work Email',
                'attr' => ['placeholder' => 'you@company.com']
            ])
            ->add('password', PasswordType::class, [
                'label' => 'Choose a Password',
                'always_empty' => false,
            ]);
    }

    public function configureOptions(OptionsResolver $resolver): void
    {
        $resolver->setDefaults([
            'data_class' => UserOnboarding::class,
            // We do NOT set validation_groups here. The Flow handles it.
        ]);
    }
}
 Profile Step //src/Form/Step/ProfileStepType.php

namespace App\Form\Step;

use App\Form\Dto\UserOnboarding;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\Extension\Core\Type\CheckboxType;
use Symfony\Component\Form\Extension\Core\Type\TextType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;

class ProfileStepType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options): void
    {
        $builder
            ->add('fullName', TextType::class, ['label' => 'Full Name'])
            ->add('jobTitle', TextType::class, ['label' => 'Job Title'])
            ->add('termsAccepted', CheckboxType::class, [
                'label' => 'I agree to the Terms of Service',
                'required' => false, // Handled by validator
            ]);
    }

    public function configureOptions(OptionsResolver $resolver): void
    {
        $resolver->setDefaults([
            'data_class' => UserOnboarding::class,
        ]);
    }
}
 Plan Step //src/Form/Step/PlanStepType.php

namespace App\Form\Step;

use App\Form\Dto\UserOnboarding;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\Extension\Core\Type\ChoiceType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;

class PlanStepType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options): void
    {
        $builder
            ->add('plan', ChoiceType::class, [
                'choices' => [
                    'Free Tier' => 'free',
                    'Pro ($29/mo)' => 'pro',
                    'Enterprise' => 'enterprise',
                ],
                'expanded' => true, // Radio buttons
                'label' => 'Select your plan'
            ]);
    }

    public function configureOptions(OptionsResolver $resolver): void
    {
        $resolver->setDefaults([
            'data_class' => UserOnboarding::class,
        ]);
    }
}
 Typ prúdu (The Magic Type) To je miesto, kde Symfony 7.4 žiari. namiesto Rozšírime sa Používame aj nové . AbstractType AbstractFlowType FormFlowBuilderInterface //src/Form/Flow/UserOnboardingFlowType.php
namespace App\Form\Flow;

use App\Form\Dto\UserOnboarding;
use App\Form\Step\IdentityStepType;
use App\Form\Step\PlanStepType;
use App\Form\Step\ProfileStepType;
use Symfony\Component\Form\Flow\AbstractFlowType;
use Symfony\Component\Form\Flow\FormFlowBuilderInterface;
use Symfony\Component\Form\Flow\Type\NavigatorFlowType;
use Symfony\Component\OptionsResolver\OptionsResolver;

class UserOnboardingFlowType extends AbstractFlowType
{
    public function buildFormFlow(FormFlowBuilderInterface $builder, array $options): void
    {
        // 1. Add Steps
        // The first argument is the step name (used for validation groups)
        $builder->addStep('identity', IdentityStepType::class);
        $builder->addStep('profile', ProfileStepType::class);
        $builder->addStep('plan', PlanStepType::class);

        // 2. Add Navigation
        // The NavigatorFlowType automatically adds Next, Previous and Finish buttons
        $builder->add('navigator', NavigatorFlowType::class);
    }

    public function configureOptions(OptionsResolver $resolver): void
    {
        $resolver->setDefaults([
            'data_class' => UserOnboarding::class,
            // Crucial: Tell Symfony which property holds the current step name
            'step_property_path' => 'currentStep',
        ]);
    }
}
 na je nový kompozitný typ v Symfony 7.4. odstraňuje tlačidlá. NavigatorFlowType 
 
 
 
 Ďalšie (na všetkých krokoch okrem posledného) Predchádzajúci (na všetkých krokoch okrem prvého) Finish (na poslednom kroku) Môžete to prispôsobiť! Napríklad, ak chcete povoliť vynechanie kroku: $builder->add('navigator', NavigatorFlowType::class, [
    'buttons' => [
        'next' => ['label' => 'Continue'],
        'finish' => ['label' => 'Complete Setup'],
    ]
]);
 - kontrolér Preč sú dni manuálnej kontroly parametrov $step dotazu alebo klávesov relácie. ovládač vyzerá šokujúco podobný štandardnému ovládaču CRUD. //src/Controller/OnboardingController.php
namespace App\Controller;

use App\Form\Dto\UserOnboarding;
use App\Form\Flow\UserOnboardingFlowType;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;

class OnboardingController extends AbstractController
{
    #[Route('/onboarding', name: 'app_onboarding')]
    public function __invoke(Request $request): Response
    {
        // 1. Initialize your DTO
        $dto = new UserOnboarding();
        
        // 2. Create the Flow Form
        // This inspects the Request and automatically determines the current step
        $flow = $this->createForm(UserOnboardingFlowType::class, $dto);
        
        $flow->handleRequest($request);

        // 3. Check for completion
        // isFinished() checks if the 'finish' button was clicked AND the final step is valid
        if ($flow->isSubmitted() && $flow->isValid() && $flow->isFinished()) {
            
            // At this point, $dto is fully populated and validated across ALL steps
            $this->saveUser($dto);

            return $this->redirectToRoute('app_dashboard');
        }

        // 4. Render the specific step
        // do NOT use createView(). Use getStepForm() to get the view for the current step.
        return $this->render('onboarding/flow.html.twig', [
            'form' => $flow->getStepForm(),
        ]);
    }

    private function saveUser(UserOnboarding $dto): void
    {
        // Logic to persist User entity, create Stripe customer, etc.
        // dd($dto);
    }
}
 V predvolenom nastavení, na je bez štátnosti v tom zmysle, že sa spolieha na údaje, ktoré sú Avšak pre lepšiu náladu, . Wait, where is the Session? AbstractFlowType POSTed back and forth Symfony 7.4 automatically integrates with the standard HTTP Session if your DTO is serializable Ak máte čo do činenia s entitami, ktoré nie sú ľahko serializovateľné, možno budete chcieť použiť transformátor údajov alebo sa spoľahnúť na aby bol ukazovateľ platný. step_property_path - chrámy To je miesto, kde sa guma stretne s cestou. Musíme zobraziť formulár. Premenlivý formulár, ktorý bol predložený šablóne, je zobrazenie formulára aktuálneho kroku. {% extends 'base.html.twig' %}

{% block title %}Onboarding Step: {{ form.vars.name|capitalize }}{% endblock %}

{% block body %}
<div class="container mx-auto max-w-lg mt-10">
    <h1 class="text-2xl font-bold mb-5">Welcome Aboard</h1>
    
    {# Progress Indicator (Optional) #}
    <div class="mb-6 flex justify-between text-sm text-gray-500">
        <span class="{{ form.vars.name == 'identity' ? 'font-bold text-blue-600' : '' }}">Identity</span>
        <span>&rarr;</span>
        <span class="{{ form.vars.name == 'profile' ? 'font-bold text-blue-600' : '' }}">Profile</span>
        <span>&rarr;</span>
        <span class="{{ form.vars.name == 'plan' ? 'font-bold text-blue-600' : '' }}">Plan</span>
    </div>

    {{ form_start(form) }}
        
        {# Render errors for the whole form #}
        {{ form_errors(form) }}

        {# Render the fields for the CURRENT step #}
        {# The 'navigator' field is technically a nested form containing buttons #}
        
        <div class="bg-white shadow-md rounded px-8 pt-6 pb-8 mb-4">
            {% for child in form %}
                {% if child.vars.name != 'navigator' %}
                    {{ form_row(child, {'attr': {'class': 'mb-4'}}) }}
                {% endif %}
            {% endfor %}
        </div>

        {# Render Navigation Buttons #}
        <div class="flex justify-between items-center">
            {# The navigator contains 'previous', 'next', 'finish' depending on the step #}
            {{ form_widget(form.navigator) }}
        </div>

    {{ form_end(form) }}
</div>
{% endblock %}
 na pole sa zvyčajne zobrazuje ako skupina tlačidiel. Možno budete chcieť prispôsobiť vytvorením vlastnej témy formulára, ak chcete konkrétne triedy (napríklad triedy utility Tailwind) na tlačidlách Predchádzajúce vs. Ďalšie. navigator NavigatorFlowType Ak chcete štýl tlačidiel špecificky bez témy, môžete k nim pristupovať priamo, ak viete, že existujú: <div class="flex justify-between">
    {% if form.navigator.previous is defined %}
        {{ form_widget(form.navigator.previous, {'attr': {'class': 'btn-secondary'}}) }}
    {% endif %}
    
    {% if form.navigator.next is defined %}
        {{ form_widget(form.navigator.next, {'attr': {'class': 'btn-primary'}}) }}
    {% endif %}
    
    {% if form.navigator.finish is defined %}
        {{ form_widget(form.navigator.finish, {'attr': {'class': 'btn-success'}}) }}
    {% endif %}
</div>
 Pokročilé: Podmienené kroky Čo ak chceme krok, ak používateľ zadá firemnú e-mailovú adresu? skip the “Profile” v Môžeme použiť na Možnosť nastavenia definície kroku, ale Symfónia 7.4 je veľmi silná. UserOnboardingFlowType include_if addStep Spoločný vzorec kontroluje údaje v Nie, buildFormFlow je postavený raz. Namiesto toho môžeme použiť   , alebo jednoducho logika v ovládači. Ale najčistejším spôsobom v 7.4 je použitie v metóde addStep, ktorá akceptuje uzavretie. buildFormFlow EventListeners inside the Flow skip option Od počiatočného vydania 7.4 je logika dynamického skoku často najlepšie zvládnutá logicky alebo počúvaním v predchádzajúcom kroku manuálne upraviť vlastnosť currentStep v prípade potreby. Metóda podporuje a v niektorých implementáciách. NavigatorFlowType FormEvents::POST_SUBMIT addStep condition Štandardná implementácia Symfony 7.4 odporúča použitie prechodnej logiky. Ak potrebujete vysoko dynamické toky (napríklad „Vyberte si svoje vlastné dobrodružstvo“), môžete prevrátiť logiku, ale pre jednoduché preskočenie, môžeme jednoducho predvolené polia zrušiť a skryť ich. getStepForm Robustnejším spôsobom, ktorý nový komponent poskytuje, je však použitie . Transition System na vypočíta ďalší krok na základe poradia mriežky. Ak potrebujete preskočiť, môžete zmeniť dátový objekt v A poslucháčom z . NavigatorFlowType currentStep POST_SUBMIT IdentityStepType // In IdentityStepType
$builder->addEventListener(FormEvents::POST_SUBMIT, function (FormEvent $event) {
    $data = $event->getData();
    $form = $event->getForm();
    
    if (str_ends_with($data->email, '@corp.com')) {
        // This requires the parent flow to recognize the jump, 
        // usually handled by the navigator looking at the set step.
        // For simple implementations, just ensure your validation groups 
        // don't block empty fields in the skipped step.
    }
});
 Najjednoduchším spôsobom v 7.4 je jednoducho umožniť používateľovi kliknúť na "Ďalšie" a zabezpečiť, aby sa nevytvorili skupiny overenia pozadia pre vynechaný krok. Prečo je to lepšie ako CraueFormFlowBundle. 
 
 
 
 
 Native Integration: Už žiadne boje s ovládačom ukladacieho priestoru relácie balíka. Používa štandardné mapovače údajov formulára. Atribúty validácie: mapovanie názvu kroku -> skupiny validácie znižuje konfiguráciu kotla o 50%. Bezpečnosť typu: Všetko je silne napísané. AbstractFlowType zaisťuje, že dodržiavate zmluvu. Twig Simplicity: Žiadna ďalšia flow.currentStepNumber logika v Twig. Bude to fungovať? Ak chcete zabezpečiť robustnú implementáciu, postupujte podľa týchto krokov overenia: 
 
 
 
 
 Test izolácie kroku: Vyplňte krok 1, kliknite na položku Ďalej. Prečítajte si stránku. Stále by ste mali byť na kroku 2 (ak je aktívna vytrvalosť relácie) alebo by ste mali byť schopní zvládnuť bezštátnu povahu. Validačná brána: Skúste kliknúť na "Ďalej" na kroku 1 s prázdnym e-mailom. Skupinová izolácia: Pridajte požiadavku do kroku 2.Pokúste sa odoslať krok 1. Dokončenie: Dokončenie toku. skontrolujte svoju databázu alebo odložte DTO do ovládača. Uistite sa, že údaje z kroku 1 (Email) pretrvávajú až do konečného odoslania. závery Funkcia Multi-Step Forms v systéme Symfony 7.4 predstavuje obrovský skok vpred pre vývojársku skúsenosť (DX). Využíva komplexný, opakujúci sa problém a rieši ho s eleganciou, ktorú sme očakávali od tímu Symfony Core. Využitím Prirodzená synergia s Môžete odstrániť stovky riadkov špagetového kódu z ovládačov. AbstractFlowType Validator Budovanie komplexných sprievodcov už nie je úlohou - je to štandardná, príjemná časť ekosystému Symfony. Plánujete zrekonštruovať svoje dedičné sprievodcov Symfony 7.4? rád by som počul o vašich skúsenostiach s migráciou. Kontaktujte nás na LinkedIne: . https://www.linkedin.com/in/matthew-mochalkin/ https://www.linkedin.com/in/matthew-mochalkin/

This story contains AI-generated text. The author has used AI either for research, to generate outlines, or write the text itself. 

Read My Stories

Tento zvuk je vyrobený v pôvodnom jazyku príbehu!

Symfónia 7.4: Ako zvládnuť viacstupňové formuláre

About Author

KOMENTÁRE

ZAVISTE ŠTÍTKY

TENTO ČLÁNOK BOL PREDSTAVENÝ V

Related Stories

When Blood Told

Behavior of a shapely Spider

Code Smell 298 - How to Fix Microsoft Windows Time Waste

THE CRAB-SPIDER

When Blood Told

Behavior of a shapely Spider

Code Smell 298 - How to Fix Microsoft Windows Time Waste

THE CRAB-SPIDER

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps