你好 ？

您是否經(jīng)常希望獲得一個(gè)集合或字串助手中不存在的方法？你開始連結(jié)方法，結(jié)果發(fā)現(xiàn)其中一個(gè)方法遺失了，結(jié)果卻碰壁了。老實(shí)說，這是可以理解的；你知道，框架是一刀切的東西。我多次發(fā)現(xiàn)自己處於這種情況。每次，在深入研究如何擴(kuò)展框架之前，我都會檢查我想要擴(kuò)展的內(nèi)容是否可宏。但這意味著什麼？這正是我們將要探索的！

WTF 是宏嗎？ ？

假設(shè)我們有這個(gè) JWT：

$jwt = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c';

我們需要擷取標(biāo)題：

str($jwt)
    ->before('.')
    ->fromBase64()
    ->fromJson(); // does not exist ?

//  BadMethodCallException  Method Illuminate\Support\Stringable::fromJson does not exist.

fromJson() 不存在？當(dāng)然，人們可以簡單地這樣做：

json_decode(str($jwt)->before('.')->fromBase64());

但這有什麼樂趣呢？另外，這是我的文章？

所以，我們需要一個(gè)方法來擴(kuò)充 Stringable 類別。有幾種方法可以做到這一點(diǎn)，但 Laravel 提前思考，它知道開發(fā)人員可能想要添加自訂方法，因此它使類別可宏，或者像我喜歡的那樣，可擴(kuò)展。

如果您檢查 IlluminateSupportStringable 類，您會看到它使用 Macroable 特徵。

讓我們繼續(xù)擴(kuò)展課程。在AppServiceProvider中，加入以下內(nèi)容：

<?php

namespace App\Providers;

use Illuminate\Support\Stringable;
use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider
{
    public function boot(): void
    {
        Stringable::macro('fromJson', function (bool $associative = true) {
            return json_decode($this->value, $associative);
        });
    }
}

現(xiàn)在讓我們重新運(yùn)行程式碼：

str($jwt)
    ->before('.')
    ->fromBase64()
    ->fromJson();

// ["alg" => "HS256", "typ" => "JWT"]

效果完美嗎？但現(xiàn)在，您可能想知道，這是如何運(yùn)作的？ $this->value 到底是什麼？哈利波特裡發(fā)生了什麼事？

揭開魔法的面紗？

我們知道Stringable類別使用Macroable特徵，它提供了macro()方法。讓我們仔細(xì)看看它的作用：

// src/Illuminate/Macroable/Traits/Macroable.php

/**
 * Register a custom macro.
 *
 * @param  string  $name
 * @param  object|callable  $macro
 *
 * @param-closure-this static  $macro
 *
 * @return void
 */
public static function macro($name, $macro)
{
    static::$macros[$name] = $macro;
}

這非常簡單，它只是將回調(diào)保存到靜態(tài)巨集數(shù)組中?，F(xiàn)在，如果我們進(jìn)一步檢查該特徵，我們會發(fā)現(xiàn) __call 方法，每次呼叫不存在的方法時(shí)都會觸發(fā)方法。在我們的例子中，就是 fromJson()。讓我們深入了解：

/**
 * Dynamically handle calls to the class.
 *
 * @param  string  $method
 * @param  array  $parameters
 * @return mixed
 *
 * @throws \BadMethodCallException
 */
public function __call($method, $parameters)
{
    if (! static::hasMacro($method)) {
        throw new BadMethodCallException(sprintf(
            'Method %s::%s does not exist.', static::class, $method
        ));
    }

    $macro = static::$macros[$method];

    if ($macro instanceof Closure) {
        $macro = $macro->bindTo($this, static::class);
    }

    return $macro(...$parameters);
}

首先，它檢查巨集是否已註冊，fromJson() 就是這種情況，然後從巨集數(shù)組中取得回呼（或物件）?，F(xiàn)在讓我們來看看魔術(shù)，如果巨集是閉包（如我們的例子），它會呼叫bindTo()，它本質(zhì)上告訴閉包$this應(yīng)該引用作為第一個(gè)參數(shù)傳遞的任何內(nèi)容。在本例中，它是 Stringable 實(shí)例，它恰好具有 $value 屬性。

// $this here is the stringable
// $this inside the closure is now referencing the stringable class
$macro->bindTo($this, static::class);

這就是為什麼我們可以做 $this->value。

我們可以做得更好：Mixins？

我還想告訴你一件事！當(dāng)我們多次擴(kuò)展同一個(gè)類別時(shí)，服務(wù)提供者可能很快就會變得混亂。我們可以將所有自訂巨集提取到一個(gè)名為 Mixin 的類別中。

讓我們建立一個(gè) StringableMixin：

$jwt = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c';

現(xiàn)在，在 AppServiceProvider 中，我們可以註冊這個(gè) mixin：

str($jwt)
    ->before('.')
    ->fromBase64()
    ->fromJson(); // does not exist ?

//  BadMethodCallException  Method Illuminate\Support\Stringable::fromJson does not exist.

就是這樣！現(xiàn)在我們可以做：

json_decode(str($jwt)->before('.')->fromBase64());

基本上是一樣的，只是比較乾淨(jìng)一點(diǎn)。

如果您對它的工作原理感到好奇，Macroable 特徵上的 mixin() 方法使用反射 API。它從 Mixin 類別中檢索所有公共方法，期望每個(gè)方法傳回一個(gè)閉包，然後將閉包註冊為宏，就像我們之前看到的那樣。

糟糕的 IDE？

嗯，正如您所看到的，有很多神奇的事情發(fā)生，IDE 不知道定義的巨集。如果您在團(tuán)隊(duì)中工作，其他開發(fā)人員也不會知道這些宏，這不好。幸運(yùn)的是，有一些工具可以幫助您做到這一點(diǎn)。 Laravel IDE 幫助程式包是一個(gè)免費(fèi)開源選項(xiàng)。

您可以安裝該軟體包並產(chǎn)生 _ide_helper.php 文件，然後就可以開始了。

就這樣結(jié)束了..

我們的範(fàn)例相當(dāng)簡單，但是您可以將巨集推得更遠(yuǎn)，因?yàn)?Laravel 附帶的大多數(shù)常見類別都是可巨集的。例如，您可以新增一個(gè)新的 apiResponse() 宏，或者您認(rèn)為在應(yīng)用程式邏輯中非常常見且重複次數(shù)過多的任何內(nèi)容。但不要做得太過分。巨集增加了新的複雜性，在團(tuán)隊(duì)中工作時(shí)，它們可能會令人困惑。

Soo，每當(dāng)您感覺應(yīng)用程式缺少某些內(nèi)容，但框架本身沒有缺少某些內(nèi)容時(shí)，請使用巨集？

以上是Laravel 底層 - 一些宏的詳細(xì)內(nèi)容。更多資訊請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！