キーテイクアウト

• PHP 5.6は、…トークンを使用してタイプ付き配列を作成する機(jī)能を?qū)毪筏蓼筏?。これは、関數(shù)またはメソッドがさまざまな長さの引數(shù)を受け入れることを示します。この機(jī)能をタイプのヒントと組み合わせて、特定の種類のオブジェクトのみが配列で受け入れられるようにすることができます。 この機(jī)能の制限の1つは、メソッドごとに定義できるタイプアレイが1つだけであることです。これを克服するために、入力された配列を「コレクション」クラスに注入することができます。これにより、GETメソッドの「配列」よりも具體的なリターンタイプも可能になります。
値オブジェクトは、カスタム検証に使用できます。たとえば、定格値を制約で作成して、評価が常に0?5であることを確認(rèn)できます。これにより、各注入オブジェクトの上にループすることなく、個々のコレクションメンバーの追加の検証が提供されます。
• 厳密にタイプされた配列とコレクションには、いくつかの利點(diǎn)があります。それらは、1つの場所で簡単なタイプの検証を提供し、構(gòu)造時に値が常に検証されていることを確認(rèn)し、コレクションごとのカスタムロジックの追加を可能にし、メソッドシグネチャの引數(shù)を混合する確率を減らします。
最初の構(gòu)築後にコレクションと値オブジェクトの値の編集を容易にする方法を追加することは可能ですが、変更を行う必要があるときにそれらを不変に保ち、プリミティブタイプに変換する方が効率的です。変更を加えた後、コレクションまたはバリューオブジェクトを更新された値で再構(gòu)築することができます。これは再度検証されます。
• この投稿は最初にMediumに掲載され、著者の許可を得てここに再発行されました。私たちはあなたがメディアでバートをフォローし、彼にそこにいくつかの好きなものを與えることをお勧めします！
• PHP 5.6で発表された言語機(jī)能の1つは、関數(shù)または方法がさまざまな長さの引數(shù)を受け入れることを示すために...トークンの追加でした。
私がめったに述べていないことは、この機(jī)能とタイプのヒントを組み合わせて、本質(zhì)的に型付けられた配列を作成することが可能であるということです。 たとえば、

dateTimeimmutableオブジェクトのみを受け入れる空気日付の配列を設(shè)定する方法を備えた映畫のクラスを持つことができます。

さまざまな數(shù)の個別のdateTimeImmutableオブジェクトをsetairdatesに渡すことができます（）方法：

---

dateTimeImmutable以外の何かを渡す場合、たとえば、致命的なエラーがスローされます。

代わりに、setimedates（）に渡したいデータティメイムミュート可能なオブジェクトの配列がすでにある場合、もう一度...トークンを使用できますが、今回はそれらを解き放つことができます。

配列に予想されるタイプではない値が含まれている場合でも、前述の致命的なエラーが得られます。

さらに、スカラータイプをPHP 7から始めるのと同じ方法で使用できます。たとえば、映畫のクラスにフロートとして評価のリストを設(shè)定する方法を追加できます。

<span><span><?php
</span></span><span>
</span><span><span>class Movie {  
</span></span><span>  <span>private $dates = [];
</span></span><span>
</span><span>  <span>public function setAirDates(\DateTimeImmutable ...$dates) {
</span></span><span>    <span>$this->dates = $dates;
</span></span><span>  <span>}
</span></span><span>
</span><span>  <span>public function getAirDates() {
</span></span><span>    <span>return $this->dates;
</span></span><span>  <span>}
</span></span><span><span>}
</span></span>

繰り返しますが、これにより、評価プロパティには、すべてのコンテンツをループして検証することなく、常にフロートが含まれます。そのため、無効なタイプを心配することなく、getAverAgreating（）で數(shù)學(xué)操作を簡単に実行できます。 この種のタイプアレイの問題

この機(jī)能を型付けされた配列として使用する欠點(diǎn)の1つは、メソッドごとのそのような配列のみを定義できることです。オプションの方法で後で設(shè)定するのではなく、コンストラクターの評価のリストと一緒に空気日付のリストを期待する映畫のクラスを望んでいたとしましょう。これは、上記の方法では不可能です

別の問題は、PHP 7を使用する場合、get（）メソッドのリターンタイプは「配列」である必要があることです。これはしばしば一般的すぎます。

ソリューション：コレクションクラス

両方の問題を修正するために、いわゆる「コレクション」クラス內(nèi)に型付けされた配列を単純に挿入できます。これにより、懸念の分離も改善されます。これは、平均評価の計算方法を関連するコレクションクラスに移動できるようにするためです。

コンストラクターに変數(shù)の長さを持つタイプされた引數(shù)のリストをまだ使用していることに注意してください。

このコレクションクラスをForeachループで使用する機(jī)能が必要な場合は、IteratorAggregateインターフェイスを?qū)g裝する必要があります。

先に進(jìn)むと、空気日付のリストのコレクションを作成することもできます。

<span><span><?php
</span></span><span>
</span><span><span>$movie = new Movie();
</span></span><span>
</span><span><span>$movie->setAirDates(
</span></span><span>  <span><span>\DateTimeImmutable</span>::createFromFormat('Y-m-d', '2017-01-28'),
</span></span><span>  <span><span>\DateTimeImmutable</span>::createFromFormat('Y-m-d', '2017-02-22')
</span></span><span><span>);
</span></span>

映畫のクラスにパズルのすべてのピースをまとめると、コンストラクターに2つの個別に入力されたコレクションを注入できるようになりました。さらに、GETメソッドの「配列」よりも具體的なリターンタイプを定義できます。

カスタム検証に値オブジェクトを使用して

評価に追加の検証を追加したい場合は、さらに一歩進(jìn)んで、いくつかのカスタム制約を備えた評価値オブジェクトを定義することができます。たとえば、評価は0?5の間で制限される可能性があります：

<span><span><?php
</span></span><span>
</span><span><span>$dates = [
</span></span><span>  <span><span>\DateTimeImmutable</span>::createFromFormat('Y-m-d', '2017-01-28'),
</span></span><span>  <span><span>\DateTimeImmutable</span>::createFromFormat('Y-m-d', '2017-02-22'),
</span></span><span><span>];
</span></span><span>
</span><span><span>$movie = new Movie();
</span></span><span><span>$movie->setAirDates(...$dates);
</span></span>

レーティングコレクションクラスに戻って、フロートの代わりにこれらの値オブジェクトを使用するためにいくつかの小さな変更を行う必要があります。

<span><span><?php
</span></span><span>
</span><span><span>declare(strict_types=1);
</span></span><span>
</span><span><span>class Movie {
</span></span><span>  <span>private $dates = [];
</span></span><span>  <span>private $ratings = [];
</span></span><span>
</span><span>  <span>public function setAirDates(\DateTimeImmutable ...$dates) { /* ... */ }
</span></span><span>  <span>public function getAirDates() : array { /* ... */ }
</span></span><span>
</span><span>  <span>public function setRatings(float ...$ratings) {
</span></span><span>    <span>$this->ratings = $ratings;
</span></span><span>  <span>}
</span></span><span>
</span><span>  <span>public function getAverageRating() : float {
</span></span><span>    <span>if (empty($this->ratings)) {
</span></span><span>      <span>return 0;
</span></span><span>    <span>}
</span></span><span>
</span><span>    <span>$total = 0;
</span></span><span>
</span><span>    <span>foreach ($this->ratings as $rating) {
</span></span><span>      <span>$total += $rating;
</span></span><span>    <span>}
</span></span><span>
</span><span>    <span>return $total / count($this->ratings);
</span></span><span>  <span>}
</span></span><span><span>}
</span></span>

この方法で、各コレクションメンバーの追加の検証を取得しますが、まだ注入された各オブジェクトの上にループする必要はありません。

利點(diǎn)

<span><span><?php
</span></span><span>
</span><span><span>declare(strict_types=1);
</span></span><span>
</span><span><span>class Ratings {
</span></span><span>  <span>private $ratings;
</span></span><span>
</span><span>  <span>public function __construct(float ...$ratings) {
</span></span><span>    <span>$this->ratings = $ratings;
</span></span><span>  <span>}
</span></span><span>
</span><span>  <span>public function getAverage() : float {
</span></span><span>    <span>if (empty($this->ratings)) {
</span></span><span>      <span>return 0;
</span></span><span>    <span>}
</span></span><span>
</span><span>    <span>$total = 0;
</span></span><span>
</span><span>    <span>foreach ($this->ratings as $rating) {
</span></span><span>      <span>$total += $rating;
</span></span><span>    <span>}
</span></span><span>
</span><span>    <span>return $total / count($this->ratings);
</span></span><span>  <span>}
</span></span><span><span>}
</span></span>

これらの個別のコレクションクラスとバリューオブジェクトを入力すると、多くの作業(yè)のように思えるかもしれませんが、一般的な配列とスカラー値よりもいくつかの利點(diǎn)があります。

1つの場所での簡単なタイプ検証。コレクションメンバーのタイプを検証するために、アレイを手動でループする必要はありません。

アプリケーションでこれらのコレクションとバリューオブジェクトを使用している場合は、それらの価値が常に建設(shè)時に検証されていることがわかっています。たとえば、格付けは常に0?5;

コレクションごとのカスタムロジックおよび/または値オブジェクトを簡単に追加できます。たとえば、getaverage（）メソッド。アプリケーション全體を通して再利用できます;

単一の関數(shù)またはメソッドに複數(shù)のタイプされたリストを注入する可能性があります。これは、最初にコレクションクラスに値を注入せずに...トークンを使用することはできません。

メソッドシグネチャに引數(shù)を混合するオッズは大幅に減少しています。たとえば、評価のリストと空気日付のリストの両方を注入する場合、ジェネリック配列を使用すると、建設(shè)時に2つは偶然に簡単に混同される可能性があります。

編集はどうですか？

今では、最初の構(gòu)築後にコレクションとバリューオブジェクトの価値をどのように変更できるか疑問に思うかもしれません。 編集を容易にする方法を追加できますが、タイプのヒントの利點(diǎn)を維持するために各コレクションのほとんどの方法を複製する必要があるため、これはすぐに面倒になります。たとえば、定格のADD（）メソッドは評価オブジェクトのみを受け入れる必要がありますが、AID（）メソッドはADR（）メソッドがDateTimeImmutableオブジェクトのみを受け入れる必要があります。これにより、これらの方法のインターフェースや再利用が非常に困難になります。

代わりに、コレクションとバリューオブジェクトを単に不変に保ち、変更を行う必要があるときにそれらをプリミティブタイプに変換することができます。変更が完了した後、更新された値で必要なコレクションまたはバリューオブジェクトを簡単に再構(gòu)築できます。 （再）構(gòu)築すると、すべてのタイプが再び検証され、定義した可能性のある追加の検証とともに たとえば、

コレクションにSimple ToArray（）メソッドを追加して、次のような変更を加えることができます。

この方法では、array_filter（）などの既存の配列機(jī)能を再利用することもできます。

コレクションオブジェクト自體で編集を行う必要がある場合は、必要な方法で必要な方法で必要な方法で必要な方法で追加できます。ただし、それらのほとんどは、指定された引數(shù)のタイプ検証を行う必要があるため、すべての異なるコレクションクラスでそれらを再利用することは困難です。

ジェネリックメソッドの再利用

ご存知かもしれませんが、すべてのtoarray（）とgetiterator（）の両方を?qū)g裝することにより、コレクションクラス全體でコードの複製を取得しています。幸いなことに、これらの方法は一般的な親クラスに移動するのに十分な一般的なものです。

コレクションクラスに殘されるのは、コンストラクターのタイプ検証と、このようなコレクションに固有のオプションの追加ロジックだけです。

<span><span><?php
</span></span><span>
</span><span><span>class Movie {  
</span></span><span>  <span>private $dates = [];
</span></span><span>
</span><span>  <span>public function setAirDates(\DateTimeImmutable ...$dates) {
</span></span><span>    <span>$this->dates = $dates;
</span></span><span>  <span>}
</span></span><span>
</span><span>  <span>public function getAirDates() {
</span></span><span>    <span>return $this->dates;
</span></span><span>  <span>}
</span></span><span><span>}
</span></span>

オプションで、私たちのタイプの検証を元に戻すことができる方法で、子供のクラスがバリュープロパティをいじるのを防ぐために、コレクションを最終的にすることができました。

結(jié)論

まだ完璧ではありませんが、最近のPHPのリリースを含むコレクションとバリューオブジェクトのタイプ検証で著実に作業(yè)しやすくなっています。

理想的には、再利用可能なコレクションクラスの作成をさらに容易にするために、將來のPHPで何らかの形のジェネリックを取得します。

値オブジェクトの使用を大幅に改善する機(jī)能は、文字列に加えて、異なるプリミティブタイプにオブジェクトをキャストする機(jī)能です。これは、__toint（）、__tofloat（）などのように、__toString（）に匹敵する追加の魔法の方法を追加することで簡単に実裝できます。

幸いなことに、後のバージョンで両方の機(jī)能を?qū)g裝する可能性があるため、いくつかのRFCが進(jìn)行中であるため、指が交差しました！ ？

generics：https：//wiki.php.net/rfc/generics

• ジェネリック配列：https：//wiki.php.net/rfc/generic-arrays

• スカラーへのオブジェクトのキャスト：https：//wiki.php.net/rfc/class_casting_to_scalar

• このチュートリアルが役立つと感じた場合は、メディアの元の投稿にアクセスして、??を付けてください。フィードバック、質(zhì)問、またはコメントがある場合は、以下または元の投稿に回答として殘してください。
PHPで厳密にタイプされた配列とコレクションの作成に関するよくある質(zhì)問（FAQ）

phpで厳密に型付けされた配列を使用することの利點(diǎn)は何ですか？

---

??

phpの厳密に型付けされた配列は、配列內(nèi)のすべての要素が特定のタイプであることを確認(rèn)する方法を提供します。これは、データの一貫性が非常に重要なより大きく、より複雑なアプリケーションで特に役立ちます。配列內(nèi)のすべての要素の特定のタイプを?qū)g施することにより、予期しないデータ型のために発生する可能性のある潛在的なバグやエラーを防ぐことができます。また、使用しているデータの種類を常に知っているので、コードをより予測可能でデバッグしやすくします。厳密にタイプされた配列をネイティブにサポートしていません。ただし、配列に追加された要素をタイプチェックするクラスを作成することができます。このクラスには、要素を追加および取得する方法があり、これらの方法は操作を?qū)g行する前に要素のタイプをチェックします。要素のタイプが予想されるタイプと一致しない場合、エラーがスローされます。

PHPの配列でタイプヒントを使用できますか？関數(shù)またはメソッドは、関數(shù)またはメソッド宣言の引數(shù)名の前に「配列」を追加することにより、引數(shù)として配列を期待することを指定できます。ただし、これにより、引數(shù)が配列であることのみが保証され、配列內(nèi)のすべての要素が特定のタイプであるということではありません。

ゆるく型付けされた型と厳密に型付けされた配列の違いは何ですか？

ゆるく入力された配列では、要素は任意のタイプにできます。厳密にタイプした配列では、すべての要素が特定のタイプでなければなりません。別のタイプの要素を厳密に入力した配列に追加しようとすると、エラーがスローされます。 PHPは「declare（strict_types = 1）;」を使用して使用します。 PHPファイルの先頭にある指令。これにより、ファイル內(nèi)のすべての関數(shù)呼び出しと戻りステートメントの厳密なタイプチェックが強(qiáng)制されます。 Arrayに追加されたオブジェクトをタイプチェックするクラスを作成することにより、PHPのオブジェクトのオブジェクト。クラスにはオブジェクトを追加および取得する方法があり、これらの方法は操作を?qū)g行する前にオブジェクトのタイプを確認(rèn)します。 PHPで厳密にタイプされた配列の主な制限は、PHPがネイティブにサポートしていないため、実裝するために追加のコードが必要であることです。これにより、コードがより複雑で維持が難しくなる可能性があります。さらに、Strictlyタイピングされた配列は、異なるタイプの要素を許可しないため、ゆるく型付けされた配列よりも柔軟性が低下する可能性があります。 PHPの多次元配列を使用して、タイプヒントを使用できます。ただし、PHPのタイプは、引數(shù)が配列であることのみを保証し、配列（またはサブアレイ）のすべての要素が特定のタイプであることを保証します。 php？

??

Strictlyと入力された配列をPHPで使用する場合、トライキャッチブロックを使用してエラーを処理できます。アレイに要素を追加するときにエラーが発生した場合（たとえば、要素が間違ったタイプの場合）、例外がスローされます。この例外をキャッチして適切に処理できます。

PHPの組み込み配列関數(shù)を備えたStrictlyタイプの配列を使用できますか？関數(shù)。ただし、これらの関數(shù)はタイプチェックを強(qiáng)制しないため、注意する必要があります。配列を変更して間違ったタイプの要素を追加する関數(shù)を使用すると、これはエラーにつながる可能性があります。

以上がPHPで厳密に型付けされた配列とコレクションを作成しますの詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國語 Web サイトの他の関連記事を參照してください。