Eliberarea de asociat cu De mai bine de un deceniu, am generat ghetteri și seteri religioși, umflând entitățile și DTO-urile noastre cu boilerplate care adaugă zgomot vizual, dar valoare de afaceri zero. PHP 8.4, Symfony 7.4 (LTS), Introducerea PHP 8.4 şi Putem scrie modele de domenii concise și expresive care încapsulează comportamentul fără verbositatea. Property Hooks Asymmetric Visibility În acest articol, voi explora cum să modernizez o aplicație Symfony 7.4 folosind aceste caracteristici. voi refactoriza o entitate Doctrine în stil vechi într-o componentă modernă, lean PHP 8.4, asigurând compatibilitatea deplină cu Serializer, Validator și Forms Symfony. Mediul Înainte de a ne scufunda în cod, să ne asigurăm că rulați stack-ul corect. Symfony 7.4 este versiunea de suport pe termen lung lansată în noiembrie 2025. Asigurați-vă că mediul local este gata. Rulați următoarele comenzi: php -v
# Output must indicate PHP 8.4.0 or higher

composer version
# Ensure you are on Composer 2.8+
 Vom folosi componentele standard Symfony 7.4.Dacă începeți un proiect nou: composer create-project symfony/skeleton:7.4.* my_project
cd my_project
composer require symfony/webapp-pack:7.4.*
composer require symfony/orm-pack
composer require symfony/serializer-pack
composer require symfony/validator-pack
 Dacă actualizați un proiect existent, asigurați-vă că Restricții două şi Pachete pentru . composer.json php ^8.4 symfony/* ^7.4 Vizibilitate asimetrică: sfârșitul plăcii de cazan Getter / Setter De-a lungul anilor, am făcut proprietăți private și am adăugat accesorii publice pentru a preveni modificările externe, permițând în același timp accesul intern. The Old Way (PHP 8.3 and below): class User
{
    private string $email;

    public function __construct(string $email)
    {
        $this->email = $email;
    }

    public function getEmail(): string
    {
        return $this->email;
    }
    
    // No setter meant it was effectively "read-only" externally, 
    // but we still needed the getter to read it.
}
 Vizibilitatea asimetrică ne permite să definim permisiunea „set” independent de permisiunea „get”. The PHP 8.4 Way class User
{
    // Publicly readable, but only writeable by the class itself (private)
    public private(set) string $email;

    public function __construct(string $email)
    {
        $this->email = $email;
    }
}
 Integrarea cu doctrina Acest lucru funcționează fără probleme cu doctrina ORM în Symfony 7.4. doctrina folosește reflecția pentru a hidrata proprietățile, ocolind gardienii vizibilității, astfel încât este perfect sigur pentru entitățile cartografiate. public private(set) O entitate doctrinară modernă namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;
use Symfony\Component\Validator\Constraints as Assert;

#[ORM\Entity]
class Product
{
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column]
    public private(set) ?int $id = null;

    #[ORM\Column(length: 255)]
    #[Assert\NotBlank]
    public private(set) string $name;

    #[ORM\Column]
    #[Assert\PositiveOrZero]
    public private(set) int $stock = 0;

    public function __construct(string $name)
    {
        $this->name = $name;
    }

    // Business logic method to mutate state
    public function addToStock(int $quantity): void
    {
        if ($quantity < 1) {
            throw new \InvalidArgumentException('Quantity must be positive');
        }
        $this->stock += $quantity;
    }
}
 Why this matters: 
 
 
 
 Zero Boilerplate: No getId(), getName(), getStock(). Safe Encapsulation: $product->stock = 100 declanșează o eroare fatală din afara clasei. DX (Developer Experience): Autocompletion funcționează direct pe proprietăți ($product->name), care se simte mai "nativ" decât apelurile de metodă. Proprietăți imobiliare: Proprietăți inteligente În timp ce controlul vizibilității asimetrice , Ele înlocuiesc metodele magice (__get, __set) și getter-urile explicite cu logica atașată direct la proprietate. access Property Hooks Normalizarea datelor (The set hook) Imaginați-vă o entitate de utilizator în care e-mail-ul trebuie să fie stocat întotdeauna în subsol. namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity]
class User
{
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column]
    public private(set) ?int $id = null;

    #[ORM\Column(length: 180, unique: true)]
    public string $email {
        // The 'set' hook intercepts assignment
        set(string $value) {
            if (!filter_var($value, FILTER_VALIDATE_EMAIL)) {
                throw new \InvalidArgumentException("Invalid email format");
            }
            // The backing value is updated automatically via this assignment
            $this->email = strtolower($value);
        }
    }

    public function __construct(string $email)
    {
        // This triggers the set hook!
        $this->email = $email;
    }
}
 Verification: $user = new User('ADMIN@Example.com');
echo $user->email; // Outputs: admin@example.com
 Proprietăți virtuale (The Get Hook) Proprietățile virtuale nu stochează date, ci le calculează cu ușurință.Acest lucru este perfect pentru accesoriile convenabile din Symfony DTO-uri sau entități care nu trebuie să fie persistente la baza de date. namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity]
class Customer
{
    #[ORM\Column]
    public string $firstName;

    #[ORM\Column]
    public string $lastName;

    // This is a VIRTUAL property. It has no storage in memory.
    // Notice we do NOT add #[ORM\Column] because it's not in the DB.
    public string $fullName {
        get => $this->firstName . ' ' . $this->lastName;
    }
}
 Integrare cu Symfony Serializer Una dintre cele mai puternice caracteristici ale Property Hooks din Symfony 7.4 este modul în care componenta Serializer le gestionează. 
 
 
 Proprietăți susținute: Serializate în mod normal. Proprietăți virtuale: Dacă sunt publice, Serializer le tratează la fel ca proprietățile reale. Nu mai aveți nevoie de #[SerializedName] pe o metodă getFullName(). Exemplu de control: namespace App\Controller;

use App\Entity\Customer;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\Routing\Attribute\Route;

class CustomerController extends AbstractController
{
    #[Route('/customer/{id}', methods: ['GET'])]
    public function show(Customer $customer): JsonResponse
    {
        // Serialization automatically includes "fullName" in the JSON output
        return $this->json($customer);
    }
}
 producţie : {
  "firstName": "Jane",
  "lastName": "Doe",
  "fullName": "Jane Doe"
}
 Model avansat: Obiecte de valoare și DTO-uri Să ne uităm la un scenariu mai complex care implică un obiect de transfer de date (DTO) pentru o sarcină utilă Symfony Form sau API. direct pe proprietățile hooked. validation attributes namespace App\DTO;

use Symfony\Component\Validator\Constraints as Assert;

class RegistrationRequest
{
    #[Assert\NotBlank]
    public string $firstName;

    #[Assert\NotBlank]
    public string $lastName;

    // A 'write-only' property behavior for passwords using a hook
    // We only want to set it, but reading it might return a masked value or be disallowed
    public string $password {
        set(string $value) {
            $this->password = password_hash($value, PASSWORD_BCRYPT);
        }
        get => '***MASKED***'; 
    }
    
    // Combining hooks with asymmetric visibility
    // Publicly readable, but only settable internally or by hydration
    public private(set) \DateTimeImmutable $registeredAt {
        get => $this->registeredAt ?? new \DateTimeImmutable();
    }
}
 : Fii atent cu hook-ul pe $registeredAt de mai sus. Dacă proprietatea este neinitializată, accesarea acesteia prin $this->registeredAt în interiorul hook-ului cauzează recursie infinită. Warning Refacerea unui serviciu legacy În mod tradițional, putem injecta dependențe și să folosim metode standard. Cu PHP 8.4, putem face configurațiile noastre de servicii mai curate. • An care are nevoie de o adresă "de expediere" implicită, dar vrem să permitem schimbarea temporară a acesteia cu o validare strictă. Scenario EmailService namespace App\Service;

use Symfony\Component\Mailer\MailerInterface;
use Symfony\Component\Mime\Email;

class EmailService
{
    public function __construct(
        private readonly MailerInterface $mailer,
        // Property Hook to validate configuration immediately
        public string $defaultSender {
            set(string $value) {
                if (!filter_var($value, FILTER_VALIDATE_EMAIL)) {
                    throw new \InvalidArgumentException("Invalid sender email");
                }
                $this->defaultSender = $value;
            }
        }
    ) {}

    public function sendWelcomeEmail(string $recipient): void
    {
        $email = (new Email())
            ->from($this->defaultSender)
            ->to($recipient)
            ->subject('Welcome!')
            ->text('Welcome to our platform.');

        $this->mailer->send($email);
    }
}
 în : services.yaml services:
    App\Service\EmailService:
        arguments:
            $mailer: '@mailer'
            $defaultSender: '%env(DEFAULT_EMAIL_SENDER)%'
 Dacă mediul este variabil Dacă conține un e-mail nevalid, instanțierea serviciului va eșua imediat cu o excepție clară, mai degrabă decât să eșueze în tăcere mai târziu atunci când e-mailul este trimis. . DEFAULT_EMAIL_SENDER This “Fail Fast” approach is enhanced by property hooks Compatibilitatea componentelor Symfony 7.4 Simfonia se bazează în mare măsură pe Component pentru a citi și a scrie date obiectelor. PropertyAccessor • The în Simfonia 7.4 PHP 8.4 încorporat. Good News PropertyAccessor fully supports 
 
 
 Atunci când formularul citește date pentru a popula câmpuri, declanșează capotați. Atunci când formularul trimite date înapoi la obiect, acesta declanșează atașamentul set. Transformări în entitate Adesea, puteți elimina Transformatoarele de date ale formularelor prin mutarea logicii în hook-ul Entitate/DTO. // Old way: create a CallbackTransformer to handle string-to-array conversion
// New way:

class TagAwareDTO
{
    /** @var string[] */
    private array $tags = [];

    // The form field can be mapped to 'tagString'
    // The underlying data is stored in $tags array
    public string $tagString {
        get => implode(', ', $this->tags);
        set(string $value) {
            $this->tags = array_map('trim', explode(',', $value));
        }
    }
    
    public function getTags(): array
    {
        return $this->tags;
    }
}
 În forma ta: $builder->add('tagString', TextType::class, [
    'label' => 'Tags (comma separated)',
]);
 Acest lucru simplifică în mod semnificativ, păstrând logica de transformare a datelor în cadrul obiectului de domeniu în care aparține. FormType Considerații de performanță & Pitfalls În timp ce aceste caracteristici sunt excelente, dezvoltatorii "Senior" știu când să nu le folosească. Cazul clonării Când tu Dacă utilizați vizibilitatea asimetrică, obiectul clonat păstrează aceleași reguli de vizibilitate. clone Cu toate acestea, aveți grijă cu Dacă o proprietate virtuală depinde de un alt obiect (de exemplu, ) și clonați obiectul părinte, dar nu și obiectul intern , proprietatea virtuală ar putea indica în continuare vechea referință a utilizatorului. Aceasta este comportamentul obiectului PHP standard, dar hook-urile pot ascunde această complexitate. Virtual Properties $this->user->name $user Doctrină Proxie Doctrina utilizează Proxies (subclasele) pentru încărcarea leneșă. 
 
 
 Vizibilitate asimetrică: Funcționează bine, deoarece Doctrina folosește Reflecția pentru a seta proprietăți private. Hooks: Dacă definiți un hook pe o proprietate cartografiată, Doctrina îl va declanșa atunci când hidratează entitatea, cu excepția cazului în care utilizează reflecție (ceea ce face). Cu toate acestea, fiți foarte atenți la adăugarea efectelor secundare (cum ar fi apelurile de logare sau de bază de date) în interiorul unui set de hook al unei entități Doctrină. Când Doctrina hidratează obiectul din DB, nu doriți ca aceste efecte secundare să funcționeze. Evitați efectele secundare (logging, apeluri API) în hooks-urile Entity. . Best Practice Keep hooks strictly for data validation and transformation Complexitatea ascunsă Nu puneți 50 de linii de logică de afaceri într-un hook set. Dacă logica este complexă, delegați-o la o metodă privată sau, mai bine încă, la un serviciu. Hooks ar trebui să fie concise. Bad: public string $status {
    set {
        // 50 lines of code checking permissions, logging to DB, sending emails...
    }
}
 Good: public string $status {
    set {
        $this->validateStatusTransition($value);
        $this->status = $value;
    }
}
 Ghid de migrație: De la 7.3/8.3 la 7.4/8.4 Dacă actualizați o bază de coduri masivă, nu încercați să rescrieți totul dintr-o dată. 
 
 
 
 Vizibilitate asimetrică. Rulați o căutare regex sau utilizați Rector (actualizat o dată pentru 8.4) pentru a înlocui proprietățile private + getters simple cu public private(set).Căutare: tip privat $prop; ... getProp() { return $this->prop; }Replace: public private(set) type $prop; Proprietăți virtuale pentru resursele API. Căutați clase cu #[SerializedName(‘virtual_field’)] și obțineți metodeleVirtualField() Convertește-le în proprietăți virtuale. Mutați logica Assert simplă care transformă datele (cum ar fi trim() sau strtolower()) de la controleri / ascultători în Hooks Property. Concluzie şi Permiteți-ne să scriem codul care este, probabil, cel mai curat din istoria limbii.Ne îndepărtăm de structurile de date verboase, „nebune” ale trecutului spre obiecte inteligente, auto-managabile. PHP 8.4 Symfony 7.4 Principiul Takeaways 
 
 
 
 
 Utilizați Vizibilitatea asimetrică (public private(set)) pentru a expune datele în condiții de siguranță. Utilizați Hooks Property pentru validare ușoară, transformare și proprietăți virtuale. Symfony Serializer și Forms suportă aceste caracteristici din casetă în 7.4. Păstrați hook-urile curate și rapide; evitați efectele secundare grele. Zilele generării de getter-uri și setere s-au încheiat.Bine ați venit în era PHP-ului modern. Echipa dvs. este gata să migreze la Symfony 7.4? ajut organizațiile să modernizeze aplicațiile PHP vechi și să adopte arhitecturi de înaltă performanță. Fii conectat pe Linkedin [ ] Let’s connect https://www.linkedin.com/in/matthew-mochalkin/ https://www.linkedin.com/in/matthew-mochalkin/

Read My Stories

Acest audio este produs în limba originală a poveștii!

Hooks de proprietate în acțiune: Iată câteva exemple din lumea reală pe care ar trebui să le luați în considerare

About Author

COMENTARII

Etichete suspendate

ACEST ARTICOL A FOST PREZENTAT IN

Related Stories

Holy 🎅 HackerNoon's Web 2.5 Documentary is Out! 😮

Round the year with the stars by Garrett Putman Serviss - Table of Links

The Robots Are Taking Over

The TechBeat: Digital Transformation Success Stories in Mezzanine Lending (2/28/2024)

Holy 🎅 HackerNoon's Web 2.5 Documentary is Out! 😮

Round the year with the stars by Garrett Putman Serviss - Table of Links

The Robots Are Taking Over

The TechBeat: Digital Transformation Success Stories in Mezzanine Lending (2/28/2024)

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps