Çlirimi i Lidhur me Për më shumë se një dekadë, ne kemi gjeneruar getters dhe setters fetare, duke fryrë entitetet tona dhe DTO me boilerplate që shton zhurmë vizuale por zero vlerë biznesi. PHP 8.4, Symfony 7.4 (LTS), Përdorimi i PHP 8.4 dhe Ne mund të shkruajmë modele të shkurtra, ekspresive të domain që kapsulojnë sjelljen pa verbositetin. Property Hooks Asymmetric Visibility Në këtë artikull, unë do të eksploroj se si të modernizoj një aplikacion Symfony 7.4 duke përdorur këto karakteristika. unë do të rifaktorizoj një entitet të trashëguar të Doktrinës në një komponent modern PHP 8.4, duke siguruar pajtueshmëri të plotë me Serializer, Validator dhe Forms të Symfony. Mjedisi Para se të zhytemi në kodin, le të sigurohemi që po ekzekutoni grumbullimin e saktë. Symfony 7.4 është versioni i Mbështetjes afatgjatë i lëshuar në nëntor 2025. Sigurohuni që mjedisi juaj lokal është i gatshëm. php -v
# Output must indicate PHP 8.4.0 or higher

composer version
# Ensure you are on Composer 2.8+
 Ne do të përdorim komponentët standarde të Symfony 7.4.Nëse po filloni një projekt të ri: 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
 Nëse po përmirësoni një projekt ekzistues, sigurohuni që Kufizimet dy dhe Paketa të . composer.json php ^8.4 symfony/* ^7.4 Vizibiliteti asimetrik: Fundi i Getter / Setter Boilerplate Për vite me radhë, ne i kemi bërë pronat private dhe i kemi shtuar hapësirat publike për të parandaluar modifikimin e jashtëm, ndërsa lejojmë qasje të brendshme. 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.
}
 Vizibiliteti asimetrik na lejon të përcaktojmë lejen "set" pavarësisht nga leja "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;
    }
}
 Integrimi me doktrinën Kjo punon pa probleme me Doctrine ORM në Symfony 7.4.Doktrina përdor reflektim për të hidratuar pronat, duke shmangur rojet e dukshmërisë, kështu që është plotësisht i sigurt për entitetet e hartuara. public private(set) Një entitet modern i doktrinës 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(). Secure Encapsulation: $product->stock = 100 shkakton një gabim fatal nga jashtë klasës. ju duhet të përdorni addToStock(), zbatimin e rregullave të biznesit tuaj. DX (Përvoja e Zhvilluesit): Autocompletion punon drejtpërdrejt në pronat ($product->name), e cila ndihet më "native" se thirrjet e metodës. Property Hooks: Pronë inteligjente Ndërsa kontrollet e vizibilitetit asimetrik të Ato zëvendësojnë metodat magjike (__get, __set) dhe getters / setters të qarta me logjikën e lidhur drejtpërdrejt me pronën. access Property Hooks Normalizimi i të dhënave (set hook) Imagjinoni një entitet të përdoruesit ku email-i duhet të ruhet gjithmonë në shportën e poshtme. 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
 Pronë virtuale (The Get Hook) Pronat virtuale nuk ruajnë të dhëna; ato e llogarisin atë në fluturim.Kjo është e përkryer për aksesorët e përshtatshëm në DTO-të Symfony ose entitetet që nuk kanë nevojë të qëndrojnë në bazën e të dhënave. 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;
    }
}
 Integrimi me Symfony Serializer Një nga tiparet më të fuqishme të Property Hooks në Symfony 7.4 është mënyra se si komponentët Serializer i trajtojnë ato. 
 
 
 Pronat e mbështetura: Serializuar normalisht. Prona virtuale: Nëse ato janë publike, Serializeri i trajton ato si pronat reale. Ju nuk keni më nevojë për #[SerializedName] në një metodë getFullName(). Shembull i kontrollit: 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);
    }
}
 Të dalë: {
  "firstName": "Jane",
  "lastName": "Doe",
  "fullName": "Jane Doe"
}
 Modeli i avancuar: Objekte të Vlerës & DTOs Le të shohim një skenar më të ndërlikuar që përfshin një Objekt të Transferimit të të Dhënave (DTO) për një Formular Symfony ose ngarkesë API. drejtpërdrejt në pronat e mbuluara. 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();
    }
}
 : Kini kujdes me get hook në $registeredNëse pronësia është uninitialized, duke hyrë në të nëpërmjet $this->registeredNë brendësi të hook shkakton recursion pafund. Warning Refactoring një shërbim trashëgimi Tradicionalisht, ne mund të injektojmë varësi dhe të përdorim metoda standarde.Me PHP 8.4, ne mund të bëjmë konfigurimet tona të shërbimit më të pastra. • Një që ka nevojë për një adresë default “shërbëtori”, por ne duam të lejojmë ndryshimin e saj përkohësisht me vërtetim të rreptë. 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)%'
 Nëse mjedisi ndryshon nëse përmban një email të pavlefshëm, instantimi i shërbimit do të dështojë menjëherë me një përjashtim të qartë, në vend që të dështojë në heshtje më vonë kur dërgohet email-i. . DEFAULT_EMAIL_SENDER This “Fail Fast” approach is enhanced by property hooks Kompatibiliteti i komponentëve të Symfony 7.4 Form Formulat simfonike mbështeten shumë në Komponent për të lexuar dhe shkruar të dhënat në objektet tuaja. PropertyAccessor • The në simfoninë 7.4 PHP 8.4 në dispozicion. Good News PropertyAccessor fully supports 
 
 
 Kur forma lexon të dhënat për të populluar fushat, ajo shkakton get hook. Kur forma dërgon të dhënat përsëri në objekt, ajo shkakton hook set. Transformimet në entitet Shpesh mund të hiqni Transformatorët e të dhënave të formularit duke lëvizur logjikën në lidhësen Entity / 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ë formën tuaj: $builder->add('tagString', TextType::class, [
    'label' => 'Tags (comma separated)',
]);
 Kjo thjeshtëson në mënyrë të konsiderueshme, duke mbajtur logjikën e transformimit të të dhënave brenda objektit të domenit ku i përket. FormType Vlerësimet e performancës & Pitfalls Ndërsa këto karakteristika janë të shkëlqyera, zhvilluesit “Senior” e dinë kur nuk duhet t’i përdorin ato. Rrëzimi i klonimit Kur ju Nëse përdorni vizibilitet asimetrik, objekti i klonuar ruan të njëjtat rregulla të vizibilitetit. clone Megjithatë, të jenë të kujdesshëm me Nëse një pronë virtuale varet nga një objekt tjetër (p.sh., ) dhe ju klononi objektin prind, por jo objektin e brendshëm , pronësia virtuale ende mund të tregojë referencën e vjetër të përdoruesit.Kjo është sjellja standarde e objektit PHP, por hooks mund të fshehin këtë kompleksitet. Virtual Properties $this->user->name $user Doktrina e afërt Doktrina përdor Proxies (subclasses) për ngarkim të butë. 
 
 
 Vizibiliteti asimetrik: Punon mirë sepse Doktrina përdor Reflektim për të vendosur pronat private. Hooks: Nëse përcaktoni një hook në një pronë të hartuar, Doktrina do ta shkaktojë atë kur hidroni entitetin, përveç nëse përdor reflektim (që e bën). Megjithatë, jini shumë të kujdesshëm në lidhje me shtimin e efekteve anësore (si logging ose thirrjet e bazës së të dhënave) brenda një hook të vendosur të një entiteti të Doktrinës. Kur Doktrina hidron objektin nga DB, ju nuk dëshironi që ato efekte anësore të drejtohen. Shmangni efektet anësore (logging, thirrjet API) në hooks Entity. . Best Practice Keep hooks strictly for data validation and transformation Kompleksiteti i fshehur Mos vendosni 50 linja të logjikës së biznesit brenda një kuti të caktuar.Nëse logjika është komplekse, delegojeni atë në një metodë private ose, më mirë akoma, në një Shërbim. 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;
    }
}
 Udhëzues i Migracionit: Nga 7.3/8.3 në 7.4/8.4 Nëse jeni duke përmirësuar një bazë masive të kodit, mos u mundoni të rishkruani gjithçka në të njëjtën kohë. 
 
 
 
 Asymmetric Visibility. Run a regex search or use Rector (njëherë përditësuar për 8.4) to replace private properties + simple getters with public private(set).Search: private type $prop; ... getProp() { return $this->prop; }Replace: public private(set) type $prop; Prona virtuale për burimet e API. Kërkoni klasa me #[SerializedName(‘virtual_field’)] dhe merrni metodatVirtualField(). Konvertimi i tyre në pronat virtuale. Vendosni logjikën e thjeshtë Assert që transformon të dhënat (si trim() ose strtolower()) nga kontrolluesit / dëgjuesit në Property Hooks. Konkludimi dhe Le të shkruajmë kodin që është ndoshta më i pastri në historinë e gjuhës.Ne jemi duke u larguar nga strukturat e të dhënave verbose, “budallaqe” të së kaluarës drejt objekteve inteligjente, të vetë-menaxhimit. PHP 8.4 Symfony 7.4 Kryesisht Takeaways 
 
 
 
 
 Përdorni Asymmetric Visibility (Public private(set)) për të ekspozuar të dhënat në mënyrë të sigurtë pa getters. Përdorni Property Hooks për validim të lehtë, transformim dhe pronat virtuale. Symfony Serializer dhe Forms mbështesin këto karakteristika jashtë kutisë në 7.4. Mbani kapakët të pastër dhe të shpejtë; shmangni efektet anësore të rënda. Ditët e gjenerimit të getters dhe setters kanë mbaruar. Mirë se vini në epokën e PHP moderne. A është ekipi juaj i gatshëm të kalojë në Symfony 7.4? Unë ndihmoj organizatat të modernizojnë aplikacionet e vjetra PHP dhe të miratojnë arkitekturat me performancë të lartë. Bëhuni në kontakt me LinkedIn [ ] ] Let’s connect https://www.linkedin.com/in/matthew-mochalkin/ https://www.linkedin.com/in/matthew-mochalkin/

Read My Stories

Kjo audio është prodhuar në gjuhën origjinale të tregimit!

Property Hooks në veprim: Këtu janë disa shembuj të botës reale që duhet të shikoni

About Author

KOMENTE

VARUR TAGS

KY ARTIKU U PARAQIT NË

Related Stories

Rrjeti SQD sapo vrau emetimet e tokenëve.Ja çfarë paguan 16 miliardë dollarë në DeFi TVL

Rrjeti SQD sapo vrau emetimet e tokenëve.Ja çfarë paguan 16 miliardë dollarë në DeFi TVL

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps