The Release of coupled with 十数年以上にわたり、我々は宗教的に生成されたゲッターとセットターを持ち、我々のエンティティとDTOをボイラープレートで膨らませ、視覚的な騒音を加えるがビジネス価値をゼロにする。 PHP 8.4, Symfony 7.4 (LTS), PHP 8.4 の導入 そして ようやくPHPオブジェクトの「Java-fication」を引退させることができるので、表現的で簡潔なドメインモデルを書くことができ、言語性のない行動を包み込むことができます。 Property Hooks Asymmetric Visibility この記事では、Symfony 7.4 アプリケーションをこれらの機能を使用して近代化する方法について説明します. I will refactor a legacy-style Doctrine entity into a modern, lean PHP 8.4 component, ensuring full compatibility with Symfony's Serializer, Validator, and Forms. 環境 Symfony 7.4 は、2025 年 11 月にリリースされた長期サポート バージョンです。 現地環境が準備できていることを確認します。以下のコマンドを実行します。 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位 そして パッケージ 2 . composer.json php ^8.4 symfony/* ^7.4 「Asymmetric Visibility: The End of 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.
}
 Asymmetric visibility: Asymmetric visibility allows us to define the “set” permission independently of the “get” permission. Asymmetric visibility allows us to define the “set” permission independently of the “get” permission. Asymmetric visibility allows us to define the “set” permission independently of the “get” permission. 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 は反射を用いて属性を水分化し、視覚保護者を回避します。 地図化されたエンティティにとっては完全に安全です。 public private(set) Modern Doctrine Entity(現代の教義) 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: 
 
 
 
 トップ > トップ > トップ > トップ > トップ > トップ > トップ > トップ > トップ > トップ > トップ > Safe Encapsulation: $product->stock = 100 はクラス外から致命的なエラーを引き起こします. You must use addToStock(), enforcing your business rules. DX (Developer Experience): Autocompletion はプロパティ ($product->name) で直接動作し、メソッド呼び出しよりも「ネイティブ」に感じられます。 Property Hooks: インテリジェント・プロパティ Asymmetric Visibility コントロール で、 彼らは魔法の方法(__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
 仮想プロパティ(The Get Hook) Virtual properties do not store data; they calculate it on the fly. This is perfect for convenience accessories in Symfony DTOs or Entities that 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 の最も強力な機能の 1 つは、Serializer コンポーネントがそれらをどのように処理するかです。 
 
 
 特典:普通にシリアル化。 仮想プロパティ:それらが公開されている場合、Serializer はそれらを実際のプロパティと同様に扱います. You no longer need #[SerializedName] on a getFullName() method. コントローラーの例: 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 シンフォニー フォームまたは API パイロード用のデータ転送オブジェクト (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();
    }
}
 : 上記のプロパティが非初期化されている場合、このプロパティの内側に $this->registered を介してアクセスすると、無限のリカバリが起こります。 Warning Legacy Serviceの再構築 従来、我々は依存性を注入し、標準的な方法を使用するかもしれない 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 コンポーネント互換性 Symphony Forms relies heavily on the コンポーネントは、あなたのオブジェクトにデータを読み、書き込むことができます。 PropertyAccessor : THE シンフォニー 7.4 PHP 8.4 ハウス Good News PropertyAccessor fully supports 
 
 
 フォームがデータを読み込むと、フィールドを埋め込むと Get Hook が起動します。 フォームがオブジェクトにデータを送信すると、セットハックが発生します。 エンティティにおける変換 しばしば、Form Data Transformers を 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」の開発者は、いつ使用しないべきかを知っている。 The Cloning Pitfall(クローンピット) あなたが asymmetric visibility を使用すると、クローン化されたオブジェクトは同じ見通しのルールを保持します。 clone しかし、気をつけて、 仮想プロパティが別のオブジェクトに依存している場合(例えば、 ) そして、あなたは親オブジェクトをクローンしますが、内部オブジェクトではありません。 仮想プロパティはまだ古いユーザー参照を指すかもしれないが、これは標準的なPHPオブジェクト行動だが、ハックはこの複雑さを隠すことができる。 Virtual Properties $this->user->name $user ドキュメンタリー Proxies Doctrine uses Proxies (subclasses) for lazy loading. Doctrine uses Proxies (subclasses) for lazy loading. 
 
 
 Asymmetric Visibility: Doctrine uses Reflection to set private properties. Asymmetric Visibility: Doctrine uses Reflection to set private properties. アシメトリック・ビジョン: Doctrine uses Reflection to set private properties. ハック: あなたがマッピングされた属性にハックを定義する場合、ドクトリンは、反射を使用しない限り、そのエンティティをハイドレートするときにそれを起動します(それが行われます)。しかし、ドクトリンがDBからオブジェクトをハイドレートするとき、あなたはその副作用を実行することを望まない。 : Entity ハックの副作用(ログ、API 呼び出し)を避ける。 . Best Practice Keep hooks strictly for data validation and transformation 複雑さ隠し ビジネス論理の50行をセットハックに置かないでください. 論理が複雑な場合は、プライベートメソッドまたはよりよいところ、サービスにそれを委任してください. Hooks should be 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;
    }
}
 移住ガイド: 7.3/8.3 から 7.4/8.4 大規模なコードベースをアップグレードしている場合は、すべてを一度に書き直そうとしないでください。 
 
 
 
 Asymmetric Visibility. Run a regex search or use Rector (once updated for 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; Virtual Properties for API Resources. クラスを #[SerializedName(‘virtual_field’)] で検索し、VirtualField() メソッドを取得します。 Validation. Move simple Assert logic that transforms data (such as trim() or strtolower()) from controllers/listeners into Property Hooks. コントローラ/聴く者からプロパティ・ホックにデータを変換するシンプルなアセートロジック。 結論 そして 言語の歴史の中で最もクリーンなコードを書くことを可能にし、過去の「愚かな」データ構造からスマートで自己管理可能なオブジェクトへと移行している。 PHP 8.4 Symfony 7.4 Key Takeaways 
 
 
 
 
 Asymmetric Visibility (public private(set)) を使用して、ゲッターなしでデータを安全に露出します。 Property Hooks を使用して、軽量の検証、変換、および仮想属性を実行します。 Symfony Serializer および Forms は、7.4 でこれらの機能をサポートします。 ハックを清潔で速く保ち、重い副作用を避ける。 ゲッターとセッターの生成の日々は終わりました. ようこそ現代のPHPの時代へ。 あなたのチームはSymfony 7.4に移行する準備ができていますか? 私は組織が古いPHPアプリケーションを近代化し、高性能アーキテクチャを採用するのを助けます。 【LinkedInでご連絡ください】 ] Let’s connect https://www.linkedin.com/in/matthew-mochalkin/ https://www.linkedin.com/in/matthew-mochalkin/

Read My Stories

このオーディオは、ストーリーの元の言語で制作されています。

不動産ハックアクション:ここにあなたが見るべき現実世界の例があります

About Author

コメント

ラベル

この記事は

Related Stories

暗号通貨の成長: 効果的なユーザーペルソナの作成

ユニークなエコシステムを支えるビットコインUTXOのモデル

HackerNoon ライティングコンテストで優勝したいですか? #crypto-api コンテスト優勝者のおすすめはこちら

目に見えない層: ユーザーインタビューがかけがえのない資産である理由

暗号通貨の成長: 効果的なユーザーペルソナの作成

ユニークなエコシステムを支えるビットコインUTXOのモデル

HackerNoon ライティングコンテストで優勝したいですか? #crypto-api コンテスト優勝者のおすすめはこちら

目に見えない層: ユーザーインタビューがかけがえのない資産である理由

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps