Nakon godina oslanjanja na pakete trećih strana, borbe s pohranjivanjem sesija i pisanja složene kontrolorske logike za rukovanje "čarobnjacima", Symfony 7.4 je isporučio jednu od najtraženijih značajki u povijesti okvira: . Native Multi-Step Forms Ako ste radili s Symfony desetljećima, kao što sam ja, znate borbu. Treba vam čarobnjak za registraciju, složen proces plaćanja ili višestupanjsko istraživanje. Imali ste dva izbora: hakirana logika kontrolera zajedno s ručnim grupama validacije ili legendarni Iako nam je Craue dobro služio, to je uvijek bila vanjska ovisnost koja se osjećala malo odvojena od filozofije osnovne komponente Oblike. CraueFormFlowBundle Sa izdanjem Symfony 7.4 u studenom 2025. godine, Core Team je uveo Form Flows. Ovo nije samo pomoćna klasa; to je potpuna promjena paradigme koja tretira višestupanjski protok kao prvoklasnog građanina, potpuno integriran s komponentama Validator i Form. U ovom članku ćemo izgraditi čarobnjak za upis korisnika koji je spreman za proizvodnju pomoću Symfony 7.4. pokrivat ćemo sve od instalacije do naprednog upravljanja stanjem, koristeći samo natprirodne knjižnice koje pruža okvir. Evolucija oblika u simfoniji 7.4 Prije nego što napišemo kod, razumijemo zašto je ovo ažuriranje važno. U ranijim verzijama, obrazac je bio jedna jedinica rada. Vi ste ga podnijeli, potvrdili i isprali. Da biste to razbili, programeri su morali umjetno rezati model podataka i ručno upravljati stanjem između zahtjeva. , i ručno sačuvati napredak do sesije. step 1 step 2, step 3 Simfonija 7.4 uvodi Razmislite o tome kao o » Upravlja životnim ciklusom cijelog procesa, automatski upravlja navigacijom (Next, Previous, Skip), grupama validacije i upornošću podataka. AbstractFlowType Form of Forms Poduzetnički korisnik Onboarding Izgradili smo čarobnjak za ugradnju za SaaS platformu, koji se sastoji od tri različita koraka: 
 
 
 
 Identitet: Osnovni korisnički podaci (e-mail, lozinka) Profil: profesionalni podaci (naziv posla, tvrtka) Plan: Odabir pretplate (Free, Pro, Enterprise) Upotrijebit ćemo a To je najbolja praksa u suvremenom razvoju Symfony, izbjegavajući problem "Anemic Domain Model" gdje su entiteti zbunjeni s privremenim podacima obrasca. Data Transfer Object (DTO) Objekt prijenosa podataka (DTO) DTO djeluje kao kralježnica našeg protoka. Obratite pažnju na korištenje atributa za validaciju. U Symfony 7.4, komponenta Form Flow automatski koristi Ovo je mijenjač igre; više nam nije potreban kompleks Završetak 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';
}
 Obavijest , Oni točno odgovaraju nazivima koraka koje ćemo definirati kasnije. groups: [‘identity’] groups: [‘profile’] Izgradnja koraka u obliku Potreban je standard To su standardni oblici simfonije; nema ništa "posebno" o njima, što ih čini ponovnim korištenjem. 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,
        ]);
    }
}
 Vrsta toka (The Magic Type) To je mjesto gdje Symfony 7.4 sja. Mi proširujemo Također koristimo nove . 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 novi kompozitni tip u Symfony 7.4. on uklanja gumbe. NavigatorFlowType 
 
 
 
 Sljedeći (na svim koracima osim posljednjeg) Prethodni (na svim koracima osim na prvom) Završetak (na posljednjem koraku) Možete ga prilagoditi! Na primjer, ako želite dopustiti preskakanje koraka: $builder->add('navigator', NavigatorFlowType::class, [
    'buttons' => [
        'next' => ['label' => 'Continue'],
        'finish' => ['label' => 'Complete Setup'],
    ]
]);
 Kontrolor Prošli su dani ručnog provjeravanja $step upita parametara ili ključeva sesije. kontroler izgleda šokantno slično standardnom CRUD kontroleru. //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);
    }
}
 Prema podrazumijevanju, The je bez državnosti u smislu da se oslanja na podatke koji su Međutim, za bolji užitak, . 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 Ako se bavite entitetima koji se ne mogu lako serijalizirati, možda biste željeli koristiti transformator podataka ili se osloniti na kako bi pokazatelj bio valjan. step_property_path Hramovi To je mjesto gdje guma susreće put. Moramo prikazati obrazac. promjenjivi obrazac prenesen na predložak je prikaz obrasca trenutnog koraka. {% 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š Polje se obično prikazuje kao skupina tipki. Možda ćete željeti prilagoditi prikaz stvaranjem teme obrasca po meri ako želite određene klase (kao što su klase korisničkog programa Tailwind) na gumbima Prethodni i Sljedeći. navigator NavigatorFlowType Da biste oblikovali gumbe posebno bez teme, možete im pristupiti izravno ako znate da postoje: <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>
 Napredni: uvjetni koraci Što ako želimo Korak ako korisnik unese korporativnu e-mail adresu? skip the “Profile” U Možemo koristiti i Odluka o odluci o odluci o odluci, međutim, Simfonija 7.4 je snažna. UserOnboardingFlowType include_if addStep Uobičajeni uzorak provjerava podatke u Ne, buildFormFlow se gradi jednom. Umjesto toga, možemo koristiti   , ili jednostavno logiku unutar kontrolera. Ali najčišći način u 7.4 je korištenje u metodi addStep, koja prihvaća zatvaranje. buildFormFlow EventListeners inside the Flow skip option Od početnog izdanja 7.4, dinamička logika preskakanja često se najbolje rukuje Logično ili slušajući na prethodnom koraku kako biste ručno izmijenili svojstvo currentStep ako je potrebno. Metoda podupire a primjenjivo u nekim provedbama. NavigatorFlowType FormEvents::POST_SUBMIT addStep condition Provjerimo standardni pristup uvjetnoj logici.Standardna implementacija Symfony 7.4 preporučuje korištenje tranzicijske logike.Ako trebate vrlo dinamične tokove (kao što je "Izaberi svoju avanturu"), možda ćete prevladati logike, ali za jednostavno preskočenje, možemo jednostavno podesiti polja na nullable i sakriti ih. getStepForm Međutim, robusniji način koji pruža nova komponenta je korištenje . Transition System Naš izračunava sljedeći korak temeljen na redoslijedu niza. Ako morate preskočiti, možete izmijeniti redoslijed objekta podataka U A Slušatelji iz . 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.
    }
});
 Najjednostavniji način u 7.4 je jednostavno dopustiti korisniku da klikne na "Naslijediti" i osigurati da skupine za potvrdu pozadine za preskočeni korak nisu pokrenute. Zašto je to bolje od CraueFormFlowBundle? 
 
 
 
 
 Native integracija: Nema više borbe s vozačem za skladištenje sesije paketa. koristi standardne mape podataka obrasca. Atributi za validaciju: mape imena koraka -> skupina za validaciju smanjuju konfiguraciju boilerplate za 50%. Sigurnost tipa: Sve je snažno tipkovano. AbstractFlowType osigurava da se pridržavate ugovora. Twig Simplicity: Nema više flow.currentStepNumber logike u Twig. Djeluje li to? Da biste osigurali da je provedba robusna, slijedite ove korake provjere: 
 
 
 
 
 Test izolacije koraka: Popunite Korak 1, kliknite Naprijed. Ponovno učitajte stranicu. Trebali biste i dalje biti na Koraku 2 (ako je trajnost sesije aktivna) ili biti u mogućnosti nositi se s bezstatnom prirodom. Validacijska vrata: Pokušajte kliknuti na "Naprijed" na Korak 1 s praznom e-poštom. obrazac bi trebao ponovno prikazati Korak 1 s pogreškama. Izolacija grupe: Dodajte zahtjev u Korak 2. pokušajte podnijeti Korak 1. Završetak: Završetak protoka. Provjerite svoju bazu podataka ili bacite DTO u kontrolor. Pobrinite se da podaci iz koraka 1 (E-mail) traju do konačnog podnošenja. zaključci Symfony 7.4 Multi-Step Forms značajka je ogroman skok naprijed za Developer Experience (DX). On uzima složen, ponavljajući problem i rješava ga s elegancijom smo došli očekivati od Symfony Core Team. Korištenjem Prirodna sinergija s Možete izbrisati stotine redaka špagetnog koda iz kontrolera. AbstractFlowType Validator Izgradnja složenih čarobnjaka više nije posao - to je standardni, ugodan dio Symfony ekosustava. Planirate li preoblikovati svoje nasljedne čarobnjake u Symfony 7.4? Posjetite nas na LinkedInu: . 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

Ovaj zvuk je proizveden na izvornom jeziku priče!

Simfonija 7.4: Kako upravljati višestupanjskim oblicima

About Author

KOMENTARI

VIJESI OZNAKE

OVAJ ČLANAK JE PREDSTAVLJEN U

Related Stories

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps