こんにちは ？

コレクションや文字列ヘルパーに存在しないメソッドが欲しいと何度思ったことか?メソッドを連鎖させ始めますが、そのうちの 1 つが不足していることが判明したときに壁にぶつかります。正直に言って、それは理解できます。ご存知のとおり、フレームワークは萬(wàn)能のものです。私もこの狀況に何度も遭遇しました。毎回、フレームワークの拡張方法に入る前に、拡張したいものがマクロ可能であるかどうかを確認(rèn)します。しかし、それは何を意味するのでしょうか？それがまさに私たちが探求するものです!

いったいマクロとは何でしょうか？ ?

次の JWT があるとしましょう:

そしてヘッダーを抽出する必要があります:

fromJson() は存在しませんか?確かに、次のようにすることもできます。

しかし、それのどこが楽しいのでしょうか？しかも、それは私の記事です?

したがって、Stringable クラスを拡張する方法が必要です。これを行う方法はいくつかありますが、Laravel は開(kāi)発者がカスタム メソッドを追加したい可能性があることを事前に考えて、クラスをマクロ可能、つまり私が好んで呼んでいるように拡張可能な

にしました。 >

IlluminateSupportStringable クラスを調(diào)べると、Macroable トレイトを使用していることがわかります。

クラスを拡張してみましょう。 AppServiceProvider に以下を追加します:

次に、コードを再実行してみましょう:

完璧に動(dòng)作しますか?しかし今、あなたはこれがどのように機(jī)能したのか疑問(wèn)に思っているかもしれません。 $this->value とは正確には何でしょうか?ハリー?ポッターの中で何が起こっているのですか?

魔法を解き明かす？

Stringable クラスは、macro() メソッドを提供する Macroable トレイトを使用していることがわかっています。これが何をするのか詳しく見(jiàn)てみましょう:

これは非常に簡(jiǎn)単で、コールバックを靜的マクロ配列に保存するだけです。ここで、特性をさらに詳しく調(diào)べると、存在しないメソッドが呼び出されるたびにトリガーされる __call メソッドが見(jiàn)つかります。私たちの場(chǎng)合、それは fromJson() です。それでは詳しく見(jiàn)てみましょう:

まず、マクロが登録されているかどうかを確認(rèn)し (fromJson() の場(chǎng)合)、次にマクロ配列からコールバック (またはオブジェクト) をフェッチします。ここで魔法のトリックを説明します。マクロがクロージャの場(chǎng)合 (この例のように)、bindTo() を呼び出します。これは本質(zhì)的に、最初の引數(shù)として渡されるものを $this が參照する必要があることをクロージャに伝えます。この場(chǎng)合、それは $value 屬性を持つ Stringable インスタンスです。

これが $this->value を?qū)g行できる理由です。

もっと改善できるはずです: Mixins ?

もう一つお見(jiàn)せしたいものがあるんです！同じクラスを數(shù)回拡張すると、サービス プロバイダーがすぐに混亂してしまう可能性があります。すべてのカスタム マクロを Mixin と呼ばれるクラスに抽出できます。

StringableMixin を作成しましょう:

これで、AppServiceProvider でこのミックスインを登録できます:

それで終わりです!これで、次のことができるようになります:

基本的には同じですが、少しだけすっきりしています。

これがどのように機(jī)能するか知りたい場(chǎng)合は、Macroable トレイトの mixin() メソッドがリフレクション API を使用していることを確認(rèn)してください。これは、Mixin クラスからすべてのパブリック メソッドを取得し、それぞれがクロージャを返すことを期待し、前に見(jiàn)たのと同じようにクロージャをマクロとして登録します。

IDE が貧弱ですか?

これまで見(jiàn)てきたように、多くの魔法が行われており、IDE は定義されたマクロについて知りません。チーム內(nèi)で作業(yè)している場(chǎng)合、他の開(kāi)発者もこれらのマクロについて知りませんが、これは良くありません。幸いなことに、それを支援するツールがあります。無(wú)料のオープンソース オプションは、Laravel IDE ヘルパー パッケージです。

パッケージをインストールして _ide_helper.php ファイルを生成すれば、準(zhǔn)備完了です。

それで終わります..

私たちの例はかなり単純ですが、Laravel に同梱されている一般的なクラスのほとんどはマクロ可能であるため、マクロをこれよりもさらに拡張することができます。たとえば、新しい apiResponse() マクロ、またはアプリのロジックで非常に一般的で必要以上に繰り返されていると思われるマクロを追加できます。しかし、やりすぎないでください。マクロはさらに複雑さを増し、チームで作業(yè)する場(chǎng)合には混亂を招く可能性があります。

それで、フレームワーク自體ではなく、アプリケーションに何かが欠けていると感じたときは、マクロを使用してください?

以上がLaravel の內(nèi)部 - ちょっとしたマクロの詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國(guó)語(yǔ) Web サイトの他の関連記事を參照してください。