Зохиогчийн эрх © 2020 Property Hooks in Action: Here are some real-world examples you should take a look at

Үнэлгээ Холбоо барих Энэ нь манай экосистем дахь чухал момент юм. Зөвхөн нэг долоо хоногийн турш, бид итгэгчдэд үүсгэдэг getters болон setters байна, бидний суурь, DTOs нь боодлын хавхлагатай байдаг бөгөөд энэ нь визуал шугам нэмдэг боловч бизнесийн үнэ цэнэтэй байдаг. PHP 8.4, Symfony 7.4 (LTS), PHP 8.4-ийн идэвхжүүлэх Нөхцөл , бид эцэст нь PHP объектын "Java-fication" -ийг эвдэх болно. Бид хэлбэлзэлгүйгээр үйл явцыг хамарна. Property Hooks Asymmetric Visibility Энэ нийтлэлд, би Symfony 7.4 програмуудыг энэ онцлог ашиглан шинэчлэх талаар суралцаж болно. Би Symfony-ийн Serializer, Validator, Forms-тэй бүрэн нийцэж буй орчин үеийн, lean PHP 8.4-ийн бүрэлдэхүүн хэсэгт хуудаснаар Doctrine суралцаж болно. Байгаль орчны Дараа нь бид кодыг олж авах өмнө, та зөв багц ажиллуулж байгаа эсэхийг хангах. Symfony 7.4 нь 2025-ийн Арванхоёрдугаар сард хувилбарласан Long-Term Support хувилбар юм. Таны орон нутгийн байгаль орчинд тохиромжтой байх. Дараах орчинд ажиллуулах: 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 Хэрэв та одоогийн төслийг шинэчлэх байгаа бол, таны Хязгаарлагч Өнгөрсөн Нөхцөл Бүтээгдэхүүн . composer.json php ^8.4 symfony/* ^7.4 Asymmetric Visibility: 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. } : Асимметрийн харахын тулд бид "set" зөвшөөрөл "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; } } Доктрины интеграци Энэ нь Symfony 7.4-д Doctrine ORM-тэй тохиромжтой ажилладаг. Doctrine нь шинж чанарыг хидратийг ашигладаг. Mapped entities нь бүрэн аюулгүй юм. public private(set) Modern Doctrine Судалгааны суурь 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(). Safe Encapsulation: $product->stock = 100 класс гадна нь хатуу алдааг үүсгэх болно. Та addToStock() ашиглах ёстой, таны бизнесийн эрх хуулиар хамгаалагдсан. DX (Developer Experience): Autocompletion нь өөрсдийн онцлог ($product->name) дээр шууд ажилладаг. Зохиогчийн эрх: Intelligent Property Asymmetric Visibility хяналт Нөхцөл Бид үйл явцыг хянах боломжийг олгодог. Тэд Magic арга зам (__get, __set) болон явцад getters / setters нь логик нь өөрсдийн онцлог дээр холбогдсон байна. access Property Hooks Data Normalization (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 Virtual Properties (The Get Hook) Virtual properties data not stored; they calculate it on the fly. This is perfect for convenience accessories in Symfony DTOs or Entities which do not need to be persisted to the database. 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-ийн интеграци Symfony 7.4 Property Hooks-ийн хамгийн хүчтэй шинж чанарын нэг нь Serializer-ийн бүрэлдэхүүн хэсэг нь тэднийг удирдах арга юм. Баримтлагдсан байшин: Нормално serialized. Virtual Properties: Хэрэв тэд олон нийтийн байгаа бол Serializer тэднийг бодит шинж чанарыг харьцуулах болно. Та getFullName() аргаар #[SerializedName] ямар ч шаардлагагүй байна. Controller Үзүүлэлт: 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" } Өндөр загвар: Value Objects & DTOs Бид Symfony Формулын эсвэл API-ийн ашигтай ачаалал нь Data Transfer Object (DTO) -ийг хэрэглэхэд илүү комплексны үзнэ үү. Бид ашиглах болно шууд хавтан дээр. 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(); } } : $registeredAt дээр get-hook дээр дарна уу. Хэрэв онцлог нь uninitialized байгаа бол $this->registeredAt хоорондын дотор нь хязгааргүй рекурсийг үүсгэдэг. ?? шалгах нь дэмжлэг газар нуль байж болох бол аюулгүй загвар юм. Warning Legacy үйлчилгээг шинэчлэх Өнгөрсөн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлбэрийн хэлб : А Энэ нь стандарт "судалдагч" хаяг хэрэгтэй, гэхдээ бид строгой баталгаажуулалттай цаг хугацаагаар өөрчилж боломжийг олгодог. 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 Compatibility Симфони хэлбэр нь ихэвчлэн Компонент таны объектонд өгөгдлийг унших, хуваалцах. PropertyAccessor : Энэ Симфони 7.4 PHP 8.4 хавтгай. Good News PropertyAccessor fully supports Формулаас өгөгдлийг хуваалцах үед энэ нь Get Hook-ийг үүсгэдэг. Формулаас өгөгдлийг объектонд дамжуулан илгээх үед энэ нь Set Hook-ийг үүсгэдэг. Сургалтын трансформаци Хэрэв та хэлбэрийн өгөгдлийн трансформаторууд хэлбэрийн өгөгдлийн трансформаторууд нь хэлбэрийн өгөгдлийн трансформаторуудтай байх болно.You can often remove Form Data Transformers by moving the logic to the Entity/DTO hook. // 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 (субкласс) ашигладаг. Asymmetric Visibility: Doctrine нь хувийн шинж чанарыг тохируулахын тулд Reflection-ийг ашигладаг. Хавтгай: Хэрэв та хавтгайтай онцлог дээр хавтгай тохируулж байгаа бол Доктрин энэ нь хавтгайлах үед хавтгайлах болно. Гэсэн хэдий ч, хавтгай дөрвөн хавтгай дөрвөн хавтгай дөрвөн хавтгай дөрвөн хавтгай дөрвөн хавтгай дөрвөн хавтгай дөрвөн хавтгай дөрвөн хавтгай дөрвөн хавтгай дөрвөн хавтгай дөрвөн хавтгай дөрвөн хавтгай дөрвөн хавтгай дөрвөн хавтгай дөрвөн хавтгай дөрвөн хавтгай хавтгай дөрвөн хавтгай дөрвөн ха : Entity хавтан дахь бодит үр нөлөө (лагинг, API зочлол) үгүй. . Best Practice Keep hooks strictly for data validation and transformation Комплекс Хэвлэх Бизнесийн логикийн 50 шугам Set Hook-д байрлуулахгүй. Хэрэв логик комплексан бол энэ нь хувийн аргаар, эсвэл илүү сайн, үйлчилгээнд дамжуулах. Hooks нь нарийвчлалтай байх ёстой. 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 Хэрэв та том кодыг суурилуулахыг хүсэж байгаа бол, бүх зүйл нь нэг удаа шинэчлэхыг туршиж чадахгүй. Asymmetric Visibility. Regex хайлтын ажиллуулах эсвэл Rector-ийг ашиглах (8.4-ийн хувьд шинэчлэгдсэн) нь хувийн орон сууц + хялбар getters нь публи Private(set).Search: private type $prop; ... getProp() {return $this->prop; }Replace: public private(set) type $prop; Virtual Properties for API Resources. #[SerializedName(‘virtual_field’)] -ийг хайж, getVirtualField() -ийг аргаар конвертирууд. Validation. Хязгаарлагдмал Assert логик дамжуулан өгөгдөл (жишээ нь trim() эсвэл strtolower()) controllers/listeners нь Property Hooks-д өөрчлөх. Баримтлал Нөхцөл Бид хэлний түүхэн хамгийн чист код бичж чадна. Бид алдартай, "хатуу" өгөгдлийн бүтэцээс зөөлөн, өөрөө удирдлагатай объекторууд руу явах. PHP 8.4 Symfony 7.4 Бүтээгдэхүүн Asymmetric Visibility (Public private(set)) ашиглан өгөгдлийн арилжаагүй байлгахын тулд. Property Hooks нь хялбар баталгаажуулалт, трансформаци, виртуал шинж чанарыг ашиглах. Symfony Serializer болон Формууд нь 7.4-д хайрцагтай эдгээр шинж чанарыг дэмждэг. Хувцаслалт цэвэр, хурдан хадгалах; хүчтэй бодисуурын нөлөө явах. Generating getters and setters days are over. Хамгийн сүүлийн үеийн PHP-д тавтай морилно уу. Яагаад таны баг Symfony 7.4-ийг элсүүлэхэд зориулсан байна уу? Яасан PHP програмуудыг шинэчлэх, өндөр хүчин чадалтай архитекторууд хэрэглэхэд туслах. : LinkedIn дээр холбоо барих [ ] Let’s connect https://www.linkedin.com/in/matthew-mochalkin/ https://www.linkedin.com/in/matthew-mochalkin/