L’alliberament de Juntament amb Des de fa més d’una dècada, hem generat gots i seters religiosos, inflorint les nostres entitats i DTO amb boilerplate que afegeix soroll visual però zero valor empresarial. PHP 8.4, Symfony 7.4 (LTS), Introducció a PHP 8.4 i Podem escriure models de domini concisos i expressius que encapsulen el comportament sense la verbositat. Property Hooks Asymmetric Visibility En aquest article, exploraré com modernitzar una aplicació de Symfony 7.4 utilitzant aquestes característiques. refactor una entitat doctrinal d'estil llegat en un component PHP 8.4 modern i lleuger, assegurant la plena compatibilitat amb el Serializer, Validator i Forms de Symfony. El medi ambient Abans de submergir-nos en el codi, assegurem-nos que esteu executant la pila correcta. Symfony 7.4 és la versió de suport a llarg termini llançada al novembre de 2025. Assegureu-vos que el vostre entorn local està llest. Executeu els comandes següents: php -v
# Output must indicate PHP 8.4.0 or higher

composer version
# Ensure you are on Composer 2.8+
 Utilitzarem els components estàndard de Symfony 7.4.Si esteu començant un nou projecte: 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
 Si esteu actualitzant un projecte existent, assegureu-vos de Restriccions Dues i Els paquets . composer.json php ^8.4 symfony/* ^7.4 Visibilitat asimètrica: el final de la placa de boira de Getter / Setter Durant anys, hem fet que les propietats siguin privades i hem afegit fitxers públics per evitar modificacions externes, alhora que permetem l'accés 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.
}
 La visibilitat asimètrica ens permet definir el permís “set” independentment del permís “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;
    }
}
 Integració amb la doctrina Això funciona sense problemes amb Doctrine ORM a la Simfonia 7.4.La Doctrina utilitza la reflexió per hidratar les propietats, evitant els guardians de la visibilitat, de manera que És perfectament segur per a entitats mapejades. public private(set) Una entitat doctrinal moderna 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(). Encapsulació segura: $product->stock = 100 desencadena un error fatal des de fora de la classe. DX (Developer Experience): L'Autocompletion funciona directament en propietats ($product->name), que se senten més "natives" que les trucades de mètode. Propietats intel·ligents: Propietats intel·ligents Control de visibilitat asimètrica , Substitueixen els mètodes màgics (__get, __set) i els getters/setters explícits amb lògica lligada directament a la propietat. access Property Hooks Normalització de dades (The set hook) Imagineu-vos una entitat d'usuari on l'e-mail ha d'emmagatzemar-se sempre en un subcaixer. 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
 Propietats virtuals (The Get Hook) Les propietats virtuals no emmagatzemen dades; ho calculen en el vol. Això és perfecte per a accessoris de conveniència en Symfony DTOs o Entitats que no necessiten ser persistents a la base de dades. 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;
    }
}
 Integració amb Symfony Serializer Una de les característiques més potents de Property Hooks a Symfony 7.4 és com el component Serializer les gestiona. 
 
 
 Propietats recolzades: Serialitzades normalment. Propietats virtuals: Si són públiques, el Serializer les tracta com a propietats reals. Ja no necessiteu #[SerializedName] en un mètode getFullName(). Exemple del controlador: 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);
    }
}
 La sortida: {
  "firstName": "Jane",
  "lastName": "Doe",
  "fullName": "Jane Doe"
}
 Patró avançat: Objectes de valor i DTO Vegem un escenari més complex que implica un objecte de transferència de dades (DTO) per a un formulari de simfonia o una càrrega útil d'API. directament a les propietats de la propietat. 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();
    }
}
 : Tingueu cura de l'adhesió a $registeredA dalt. Si la propietat no està inicialitzada, accedir-hi a través de $this->registeredA l'interior de l'adhesió causa una recursió infinita. La verificació ?? és un patró segur si el camp de suport pot ser nul. Warning Refactorització d'un servei de llegat Tradicionalment, podríem injectar dependències i utilitzar mètodes estàndard. Amb PHP 8.4, podem fer que les nostres configuracions de servei siguin més netes. : Una que necessita una adreça de "enviament" predeterminada, però volem permetre canviar-la temporalment amb una validació estricta. 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);
    }
}
 en : services.yaml services:
    App\Service\EmailService:
        arguments:
            $mailer: '@mailer'
            $defaultSender: '%env(DEFAULT_EMAIL_SENDER)%'
 Si el medi ambient és variable Si conté un correu electrònic vàlid, l'instantiació del servei fallarà immediatament amb una clara Excepció, en comptes de fallar silenciosament més tard quan s'envia el correu electrònic. . DEFAULT_EMAIL_SENDER This “Fail Fast” approach is enhanced by property hooks Symfony 7.4 Form Compatibilitat de components Les formes simfòniques depenen molt de la Component per llegir i escriure dades als objectes. PropertyAccessor : El La simfonia 7.4 PHP 8.4 en línia. Good News PropertyAccessor fully supports 
 
 
 Quan el formulari llegeix les dades per omplir els camps, desencadena el get hook. Quan el formulari envia les dades de nou a l'objecte, s'activa el ganxo de l'establiment. Transformacions en l'entitat Sovint es poden eliminar els transformadors de dades de formulari mitjançant el moviment de la lògica a l'enllaç d'entitat / 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;
    }
}
 En el seu format: $builder->add('tagString', TextType::class, [
    'label' => 'Tags (comma separated)',
]);
 Això simplifica el significativament, mantenint la lògica de transformació de dades dins de l'objecte de domini on pertany. FormType Consideracions de rendiment i pitfalls Tot i que aquestes característiques són excel·lents, els desenvolupadors "Senior" saben quan no utilitzar-les. La caiguda del clonatge Quan tu Si s'utilitza visibilitat asimètrica, l'objecte clonat manté les mateixes regles de visibilitat. clone No obstant això, tingueu cura amb Si una propietat virtual depèn d'un altre objecte (per exemple, ) i cloneu l'objecte parental però no l'interior , la propietat virtual encara pot apuntar a la vella referència d'usuari. Aquest és el comportament d'objecte PHP estàndard, però els ganxos poden amagar aquesta complexitat. Virtual Properties $this->user->name $user Doctrina Proxies Doctrina utilitza proxies (subclasses) per a la càrrega mandra. 
 
 
 Visibilitat asimètrica: funciona bé perquè Doctrina utilitza Reflexió per establir propietats privades. Hooks: Si defineixes un hook en una propietat cartografiada, Doctrine el desencadenarà quan hidrata l'entitat, llevat que utilitzi reflexió (el que fa). No obstant això, tingues molta cura a l'hora d'afegir efectes secundaris (com el logging o les trucades de base de dades) dins d'un conjunt de hook d'una entitat Doctrine. : Eviteu efectes secundaris (logging, trucades d'API) en els ganxos d'entitat. . Best Practice Keep hooks strictly for data validation and transformation La complexitat oculta No poseu 50 línies de lògica de negoci dins d'un ganivet.Si la lògica és complexa, delegueu-la a un mètode privat o, millor encara, a un servei. 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;
    }
}
 Guia de migració: De 7.3/8.3 a 7.4/8.4 Si esteu actualitzant una base de codi massiva, no intenteu reescriure tot alhora. 
 
 
 
 Visibilitat asimètrica. Executeu una cerca de regex o utilitzeu Rector (una vegada actualitzat per a 8.4) per reemplaçar propietats privades + simples getters amb privats públics(set).Cerca: tipus privat $prop; ... getProp() {retornar $això->prop; }Remplaçar: privat públic(set) tipus $prop; Propietats virtuals per a recursos d'API. Cerca classes amb #[SerializedName(‘virtual_field’)] i getVirtualField() mètodes. Converteix-les en propietats virtuals. Moure lògica Assert simple que transforma les dades (com trim() o strtolower()) dels controladors/escoltaris en Hooks de propietat. Conclusió i Ens estem desviant de les estructures de dades verboses i “estúpides” del passat cap a objectes intel·ligents i autogestionables. PHP 8.4 Symfony 7.4 Coneixements clau 
 
 
 
 
 Utilitzeu Visibilitat asimètrica (públic privat(set)) per exposar les dades de forma segura sense enganxadors. Utilitzeu Hooks de propietats per a validació lleugera, transformació i propietats virtuals. Symfony Serializer i Forms donen suport a aquestes característiques fora de la caixa en 7.4. Mantingui els ganxos nets i ràpids; evitar efectes secundaris greus. Els dies de generar getters i setters s'han acabat.Benvinguts a l'era de la PHP moderna. El teu equip està preparat per migrar a Symfony 7.4? ajudo a les organitzacions a modernitzar aplicacions PHP llegades i adoptar arquitectures d'alt rendiment. : Estar en contacte amb Linkedin [ ] Let’s connect https://www.linkedin.com/in/matthew-mochalkin/ https://www.linkedin.com/in/matthew-mochalkin/

Read My Stories

Aquest àudio és produït a l'idioma original de la història!

Hooks de la propietat en acció: Aquí hi ha alguns exemples del món real que haureu de mirar

About Author

COMENTARIS

Etiquetes penjant

AQUEST ARTICLE VA SER PRESENTAT A

Related Stories

Startups of The Year: Meet the Engineering Industry

The Fall of OM by Mantra DAO: Accident or Pattern?

Meet Catchpoint: HackerNoon Company of the Week

Startups of The Year: Meet the Healthcare Industry

Startups of The Year: Meet the Engineering Industry

The Fall of OM by Mantra DAO: Accident or Pattern?

Meet Catchpoint: HackerNoon Company of the Week

Startups of The Year: Meet the Healthcare Industry

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps