Readonlyプロパティを備えたPHPに不変のオブジェクトを構築します

PHP 8.2のReadonlyプロパティは、コンストラクターまたは宣言で1回しか割り当てられず、その後修正できず、言語レベルで不変性を実施します。 2。深い不変性を実現するには、ArrayObjectの配列などの可変タイプをラップするか、直接状態の変更を防ぐタグコレクションなどのカスタム不変のコレクションを使用します。 3.ベストプラクティスには、コンストラクター内のすべてのプロパティの初期化、セッターの回避、with（）メソッドを介して新しいインスタンスの返却、最終クラスの使用、および突然変異を防ぐためにクローニングを無効にすることが含まれます。 4.制限には、動的特性のサポートの欠如、オブジェクトや配列の深い凍結がなく、ネストされた可変性の手動処理の必要性が含まれます。 5.これらのゴッチャにもかかわらず、読み取りプロパティと値オブジェクトと機能パターンを組み合わせることで、ネイティブPHP機能のみを使用して安全で予測可能なスレッドに安全な不変のオブジェクトを使用することで、外部ライブラリなしで堅牢なドメインモデルを簡単に構築できます。

PHP 8.2では、強力な機能が導入されました： Readonlyプロパティ。これにより、不変のオブジェクトを構築するのがはるかに簡単になります。これは、作成後に状態を変更できないオブジェクトです。不変のオブジェクトは、予測可能でスレッドセーフであり、意図しない状態の変化によって引き起こされるバグを減らすため、価値があります。

readonly使用して、PHPで真に不変の価値オブジェクトを作成する方法は次のとおりです。

Readonlyプロパティとは何ですか？

readonlyプロパティは、宣言またはコンストラクター内のいずれかで1回しか割り当てられません。その後、変更することはできません。

クラスユーザー
{
    パブリック関数__construct（
        public readonly string $ id、
        public readonly string $ email
    ）{}
}

設定すると、 $user->email = 'new@example.com'; Cannot modify readonly property 。

これにより、言語レベルでの不変性が強制されます。慣習や魔法の方法に依存する必要はありません。

深い不変性を実施します

readonly使用すると、プロパティが配列やオブジェクトなどの可変タイプを保持している場合、完全な不変性を保証しません。例えば：

クラスブログポスト
{
    パブリック関数__construct（
        public readonly文字列$タイトル、
        public readonly配列$タグ
    ）{}
}

$ post = new blogpost（ 'php 8.2'、['php'、 'inmutable']）;
$ post-> tags [] = 'readonly'; //これは機能します！配列コンテンツは引き続き変更される可能性があります。

これを防ぐには、アレイとオブジェクトの突然変異から防御する必要があります。

✅ソリューション： ArrayObjectに配列をラップするか、不変のコレクションを使用します

クラスブログポスト
{
    /**
     * @var readonly arrayobject <int、string>
     */
    public readonly arrayobject $タグ。

    パブリック関数__construct（
        public readonly文字列$タイトル、
        配列$タグ
    ）{
        $ this-> tags = new ArrayObject（$ tags）;
        $ this-> tags-> setFlags（arrayObject :: array_as_props）;
        $ this-> tags-> getFlags（）＆〜ArrayObject :: STD_PROP_LIST;
    }
}

これで、 $post->tagsを読み取ることができますが、それを変更すること（例： $post->tags[] = 'hack' ）は失敗します。プロパティ自体が読み取られているため、再割り当てすることはできません。また、内部状態を操作するためにメソッドを公開すると、明示的に制御します。

または、コレクションに値オブジェクトを使用することを検討してください。

 /**
 * @implements \ iteratorAggregate <String>
 */
クラスタグコレクションは\ iteratorAggregateを実装します
{
    プライベート配列$タグ。

    public function __construct（array $ tags）{
        $ this-> tags = array_values（array_unique（$ tags））;
    }

    public function getiterator（）：\ traversable
    {
        new \ arrayiterator（$ this-> tags）を返します。
    }

    パブリック機能with with（string $ tag）：self
    {
        新しい自己を返します（[... $ this-> tags、$ tag]）;
    }
}

クラスブログポスト
{
    パブリック関数__construct（
        public readonly文字列$タイトル、
        public Readonly TagCollection $タグ
    ）{}
}

現在、不変性が保存されています。 $post->tags変更することはできません。また、繰り返しても、変更が新しいインスタンスを作成する必要があります。

不変のオブジェクトのベストプラクティス

PHPで堅牢な不変のオブジェクトを構築するには：

• compleすべてのプロパティでreadonly使用します
• constructorconstructuncturtorのすべてを初期化します
• cublic公開セッターまたはミューテーターメソッドを避けてください
• state状態を変更する代わりに、新しいインスタンスを返します
• final最終クラスを使用して、意図しないオーバーライドを防ぎます
• __clone()を使用して、クローニングによる偶発的な突然変異を防ぐことを検討してください

最終クラスユーザー
{
    パブリック関数__construct（
        public readonly string $ id、
        public readonly string $ name、
        public readonly string $ email
    ）{}

    // setEmail（）の代わりに、新しいインスタンスを返します
    パブリック機能withemail（string $ email）：self
    {
        新しいself（$ this-> id、$ this-> name、$ email）;
    }

    //クローニングを防ぐ（オプション）
    パブリック関数__clone（）
    {
        新しい\ badmethodcallexceptionを投げます（ '不変のオブジェクトの場合、'クローニングは無効になります。 '）;
    }
}

使用法：

 $ user = new user（ '123'、 'alice'、 'alice@example.com'）;
$ updated = $ user-> withemail（'alice@new.com '）; //新しいインスタンス
// $ユーザーは変更されていません

制限とゴッチャ

• readonlyはクラスのプロパティでのみ動作します - 動的プロパティではありません
• クラス内からであっても、コンストラクターの外側の外側のReadonlyプロパティに割り当てることはできません
• Readonlyの小道具に割り当てられたオブジェクトと配列は深く凍結していません - あなたはそれを自分で処理する必要があります
• PHPには組み込みの不変のアレイがないため、ラッパーやカスタムロジックが必要です

まとめ

PHP 8.2にreadonlyあるため、不変のオブジェクトの構築は実用的で安全です。 readonlyプロパティを防御的なコピー、値オブジェクト、および機能スタイルのメソッド（setx withX() setX() ）と組み合わせて、クリーンで予測可能なドメインモデルを作成します。

フレームワークやライブラリは必要ありません。優れたデザインとPHPの組み込み機能です。

基本的に：一度宣言し、安全に保ちます。

以上がReadonlyプロパティを備えたPHPに不変のオブジェクトを構築しますの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。