Ακίνητα σε δράση: Εδώ είναι μερικά παραδείγματα πραγματικού κόσμου που πρέπει να ρίξετε μια ματιά

Η απελευθέρωση του Συνδεδεμένη με Για πάνω από μια δεκαετία, έχουμε δημιουργήσει θρησκευτικά getters και setters, φουσκώνοντας τις οντότητες μας και DTOs με λέβητα που προσθέτει οπτικό θόρυβο αλλά μηδενική επιχειρηματική αξία. PHP 8.4, Symfony 7.4 (LTS), Με την εισαγωγή του PHP 8.4 και Μπορούμε να γράψουμε συνοπτικά, εκφραστικά μοντέλα τομέα που ενσωματώνουν τη συμπεριφορά χωρίς τη λεκτικότητα. Property Hooks Asymmetric Visibility Σε αυτό το άρθρο, θα διερευνήσω πώς να εκσυγχρονίσω μια εφαρμογή Symfony 7.4 χρησιμοποιώντας αυτά τα χαρακτηριστικά. θα αναδημιουργήσω μια κληρονομική οντότητα Doctrine σε ένα σύγχρονο, lean PHP 8.4 στοιχείο, εξασφαλίζοντας πλήρη συμβατότητα με το Serializer, τον Validator και τις φόρμες της Symfony. Το περιβάλλον Πριν βουτήξουμε στον κώδικα, ας βεβαιωθούμε ότι εκτελείτε το σωστό στοίβα. το Symfony 7.4 είναι η έκδοση μακροπρόθεσμης υποστήριξης που κυκλοφόρησε τον Νοέμβριο του 2025. Βεβαιωθείτε ότι το τοπικό σας περιβάλλον είναι έτοιμο. Εκτελέστε τις παρακάτω εντολές: php -v # Output must indicate PHP 8.4.0 or higher composer version # Ensure you are on Composer 2.8+ Θα χρησιμοποιήσουμε τα πρότυπα συστατικά του Symfony 7.4.Αν ξεκινάτε ένα νέο έργο: 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 Εάν αναβαθμίζετε ένα υπάρχον έργο, βεβαιωθείτε ότι Περιορισμοί Δύο και Πακέτα 2 . composer.json php ^8.4 symfony/* ^7.4 Ασύμμετρη ορατότητα: Το τέλος του Getter / Setter Boilerplate Για χρόνια, κάναμε τα ακίνητα ιδιωτικά και προσθέσαμε δημόσιους διακόπτες για να αποτρέψουμε εξωτερικές τροποποιήσεις, επιτρέποντας παράλληλα την εσωτερική πρόσβαση. 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. } Η ασύμμετρη ορατότητα μας επιτρέπει να ορίσουμε την άδεια "εγκατάστασης" ανεξάρτητα από την άδεια "αποδοχής". 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; } } Ενσωμάτωση στο δόγμα Αυτό λειτουργεί άψογα με το Δόγμα ORM στη Συμφωνία 7.4.Το Δόγμα χρησιμοποιεί την αντανάκλαση για να ενυδατώσει τις ιδιότητες, παρακάμπτοντας τους φρουρούς της ορατότητας, έτσι Είναι απόλυτα ασφαλές για χαρτογραφημένες οντότητες. public private(set) Μια σύγχρονη δογματική οντότητα 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 stock += $quantity; } } Why this matters: Μηδενική κατασκευή: Κανένα getId(), getName(), getStock(). Ασφαλής ενσωμάτωση: $product->stock = 100 ενεργοποιεί ένα θανατηφόρο σφάλμα από έξω από την κατηγορία. DX (Developer Experience): Η αυτόματη ολοκλήρωση λειτουργεί απευθείας στις ιδιότητες ($product->name), οι οποίες αισθάνονται πιο «πρωτότυπες» από τις κλήσεις μεθόδου. Ετικέτα: έξυπνες ιδιοκτησίες Ο ασύμμετρος έλεγχος της ορατότητας , Αντικαθιστούν τις μαγικές μεθόδους (__get, __set) και τους ρητούς getters/setters με τη λογική που συνδέεται άμεσα με την ιδιότητα. access Property Hooks Κανονικοποίηση δεδομένων (The set hook) Φανταστείτε μια οντότητα χρήστη όπου το μήνυμα ηλεκτρονικού ταχυδρομείου πρέπει πάντα να αποθηκεύεται σε υποκατάστημα. 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 Εικονικές Ιδιότητες (The Get Hook) Οι εικονικές ιδιότητες δεν αποθηκεύουν δεδομένα, αλλά το υπολογίζουν με την πάροδο του χρόνου.Αυτό είναι ιδανικό για αξεσουάρ ευκολίας σε Symfony DTOs ή Οντότητες που δεν χρειάζεται να επιμένουν στη βάση δεδομένων. 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; } } Ενοποίηση με το Symfony Serializer Ένα από τα πιο ισχυρά χαρακτηριστικά των Property Hooks στο Symfony 7.4 είναι ο τρόπος με τον οποίο το στοιχείο Serializer τα χειρίζεται. Υποστηριζόμενες ιδιότητες: Σειριοποιημένες κανονικά. Εικονικές ιδιότητες: Εάν είναι δημόσιες, το Serializer τις αντιμετωπίζει ακριβώς όπως πραγματικές ιδιότητες. Δεν χρειάζεστε πλέον #[SerializedName] σε μια μέθοδο getFullName() . Παράδειγμα του ελεγκτή: 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); } } ΕΞΟΔΟΣ : { "firstName": "Jane", "lastName": "Doe", "fullName": "Jane Doe" } Προηγμένα πρότυπα: αντικείμενα αξίας & DTOs Ας εξετάσουμε ένα πιο σύνθετο σενάριο που περιλαμβάνει ένα αντικείμενο μεταφοράς δεδομένων (DTO) για μια φόρμα Symfony ή ένα φορτίο χρήσης API. απευθείας στις ακίνητες περιουσίες. 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(); } } : Να είστε προσεκτικοί με το get hook στο $registeredAt παραπάνω. Εάν η ιδιότητα είναι μη αρχικοποιημένη, η πρόσβαση σε αυτό μέσω $this->registeredAt μέσα στο hook προκαλεί άπειρη ανατροπή. Warning Αναδιαμόρφωση μιας υπηρεσίας κληρονομιάς Παραδοσιακά, μπορούμε να εισάγουμε εξαρτήσεις και να χρησιμοποιούμε τυποποιημένες μεθόδους. Με την PHP 8.4, μπορούμε να κάνουμε τις διαμορφώσεις των υπηρεσιών μας πιο καθαρές. : ΕΝ ότι χρειάζεται μια προεπιλεγμένη διεύθυνση "αποστολέα", αλλά θέλουμε να επιτρέψουμε την αλλαγή της προσωρινά με αυστηρή επικύρωση. 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); } } στην : services.yaml services: App\Service\EmailService: arguments: $mailer: '@mailer' $defaultSender: '%env(DEFAULT_EMAIL_SENDER)%' Αν το περιβάλλον είναι μεταβλητό περιέχει ένα άκυρο μήνυμα ηλεκτρονικού ταχυδρομείου, η περίπτωση υπηρεσίας θα αποτύχει αμέσως με μια σαφή Εξαίρεση, αντί να αποτύχει σιωπηλά αργότερα όταν το μήνυμα ηλεκτρονικού ταχυδρομείου αποστέλλεται. . DEFAULT_EMAIL_SENDER This “Fail Fast” approach is enhanced by property hooks Συμβατότητα Symfony 7.4 Form Component Οι μορφές της Συμφωνίας βασίζονται σε μεγάλο βαθμό στην Διαβάστε και γράψτε δεδομένα στα αντικείμενα σας. PropertyAccessor : Η Συμφωνία 7.4 Χάκερς PHP 8.4 Good News PropertyAccessor fully supports Όταν η φόρμα διαβάζει δεδομένα για να πληρώσει τα πεδία, ενεργοποιεί το get hook. Όταν η φόρμα υποβάλλει τα δεδομένα πίσω στο αντικείμενο, ενεργοποιεί τη σύζευξη ρυθμίσεων. Μετασχηματισμοί στην Οντότητα Συχνά, μπορείτε να καταργήσετε τους μετασχηματιστές δεδομένων φόρμας μετακινώντας τη λογική στο δεσμό 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; } } Με τη μορφή σας: $builder->add('tagString', TextType::class, [ 'label' => 'Tags (comma separated)', ]); Αυτό απλοποιεί την σημαντικά, διατηρώντας τη λογική μετατροπής δεδομένων εντός του αντικειμένου τομέα στο οποίο ανήκει. FormType Σκέψεις απόδοσης & Pitfalls Ενώ αυτά τα χαρακτηριστικά είναι εξαιρετικά, οι προγραμματιστές “Senior” ξέρουν πότε να μην τα χρησιμοποιούν. Η ΚΛΩΝΙΣΤΙΚΗ ΚΑΤΑΣΤΡΟΦΗ Όταν εσύ Αν χρησιμοποιήσετε ασύμμετρη ορατότητα, το κλωνοποιημένο αντικείμενο διατηρεί τους ίδιους κανόνες ορατότητας. clone Ωστόσο, προσέξτε με Εάν μια εικονική ιδιοκτησία εξαρτάται από άλλο αντικείμενο (π.χ., ) και κλωνοποιείτε το μητρικό αντικείμενο αλλά όχι το εσωτερικό , η εικονική ιδιοκτησία μπορεί ακόμα να δείχνει την παλιά αναφορά χρήστη. Αυτό είναι η τυπική συμπεριφορά αντικειμένου PHP, αλλά οι κλωτσιές μπορούν να κρύψουν αυτή την πολυπλοκότητα. Virtual Properties $this->user->name $user Δοκίμιο Proxies Το Δόγμα χρησιμοποιεί Proxies (υποκατηγορίες) για τεμπέληδες φόρτωση. Ασύμμετρη Ορατότητα: Λειτουργεί καλά επειδή το Δόγμα χρησιμοποιεί την Αντανάκλαση για να ορίσει ιδιωτικές ιδιότητες. Αν ορίσετε ένα hook σε μια χαρτογραφημένη ιδιότητα, το Δόγμα θα το ενεργοποιήσει όταν ενυδατώνει την οντότητα, εκτός αν χρησιμοποιεί την αντανάκλαση (που κάνει). Ωστόσο, να είστε πολύ προσεκτικοί σχετικά με την προσθήκη παρενεργειών (όπως οι κλήσεις καταγραφής ή βάσης δεδομένων) μέσα σε ένα σύνολο hook μιας οντότητας του Δόγματος. Αποφύγετε τις παρενέργειες (ημερολόγηση, κλήσεις API) στα δεσμά Entity. . Best Practice Keep hooks strictly for data validation and transformation Η πολυπλοκότητα της κρυφής Μην τοποθετείτε 50 γραμμές επιχειρηματικής λογικής μέσα σε ένα σύνολο κουνουπιών. Εάν η λογική είναι περίπλοκη, αναθέστε την σε μια ιδιωτική μέθοδο ή, ακόμα καλύτερα, σε μια υπηρεσία. 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; } } Οδηγός μετανάστευσης: Από 7.3/8.3 έως 7.4/8.4 Εάν αναβαθμίζετε μια τεράστια βάση κώδικα, μην προσπαθήσετε να ξαναγράψετε τα πάντα ταυτόχρονα. Ασύμμετρη ορατότητα. Εκτελέστε μια αναζήτηση regex ή χρησιμοποιήστε το Rector (μια φορά ενημερωμένο για 8.4) για να αντικαταστήσετε ιδιωτικές ιδιότητες + απλούς getters με δημόσιο ιδιωτικό(set).Αναζήτηση: ιδιωτικό τύπο $prop. ... getProp() {επιστροφή $this->prop. }Αντικατάσταση: δημόσιο ιδιωτικό(set) τύπο $prop. Εικονικές ιδιότητες για πόρους API. Αναζητήστε τάξεις με #[SerializedName(‘virtual_field’)] και getVirtualField() μεθόδους. Μετατρέψτε τις σε εικονικές ιδιότητες. Επιβεβαίωση Μετακίνηση απλής λογικής επιβεβαίωσης που μετατρέπει δεδομένα (όπως trim() ή strtolower()) από ελεγκτές / ακροατές σε Property Hooks. Συμπέρασμα και Επιτρέψτε μας να γράψουμε κώδικα που είναι αναμφισβήτητα το καθαρότερο στην ιστορία της γλώσσας.Απομακρυνόμαστε από τις λεκτικές, «ηλίθιες» δομές δεδομένων του παρελθόντος προς έξυπνα, αυτοδιαχειριζόμενα αντικείμενα. PHP 8.4 Symfony 7.4 Κλειδιά Takeaways Χρησιμοποιήστε την ασύμμετρη ορατότητα (δημόσιο ιδιωτικό(set)) για να εκθέσετε τα δεδομένα με ασφάλεια, χωρίς τσιμπήματα. Χρησιμοποιήστε Property Hooks για ελαφριά επικύρωση, μετασχηματισμό και εικονικές ιδιότητες. Το Symfony Serializer και οι φόρμες υποστηρίζουν αυτές τις λειτουργίες εκτός κουτιού στο 7.4. Κρατήστε τα μανίκια καθαρά και γρήγορα. αποφύγετε σοβαρές παρενέργειες. Οι μέρες της δημιουργίας getters και setters έχουν τελειώσει.Καλώς ήρθατε στην εποχή της σύγχρονης PHP. Είναι η ομάδα σας έτοιμη να μεταβεί στο Symfony 7.4; Βοηθάω τους οργανισμούς να εκσυγχρονίσουν τις παραδοσιακές εφαρμογές PHP και να υιοθετήσουν αρχιτεκτονικές υψηλών επιδόσεων. Να είστε συνδεδεμένοι στο LinkedIn ] Let’s connect https://www.linkedin.com/in/matthew-mochalkin/ https://www.linkedin.com/in/matthew-mochalkin/