你好 ？

您是否經(jīng)常希望獲得一個(gè)集合或字符串助手中不存在的方法？你開始鏈接方法，結(jié)果發(fā)現(xiàn)其中一個(gè)方法丟失了，結(jié)果卻碰壁了。老實(shí)說，這是可以理解的；你知道，框架是一刀切的東西。我多次發(fā)現(xiàn)自己處于這種情況。每次，在深入研究如何擴(kuò)展框架之前，我都會(huì)檢查我想要擴(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)然，人們可以簡(jiǎn)單地這樣做：

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

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

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

如果您檢查 IlluminateSupportStringable 類，您會(huì)看到它使用 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;
}

這非常簡(jiǎn)單，它只是將回調(diào)保存到靜態(tài)宏數(shù)組中?，F(xiàn)在，如果我們進(jìn)一步檢查該特征，我們會(huì)發(fā)現(xiàn) __call 方法，每次調(diào)用不存在的方法時(shí)都會(huì)觸發(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);
}

首先，它檢查宏是否已注冊(cè)，fromJson() 就是這種情況，然后從宏數(shù)組中獲取回調(diào)（或?qū)ο螅，F(xiàn)在我們來看看魔術(shù)，如果宏是一個(gè)閉包（如我們的例子），它會(huì)調(diào)用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ù)提供者可能很快就會(huì)變得混亂。我們可以將所有自定義宏提取到一個(gè)名為 Mixin 的類中。

讓我們創(chuàng)建一個(gè) StringableMixin：

$jwt = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c';

現(xiàn)在，在 AppServiceProvider 中，我們可以注冊(cè)這個(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());

基本上是一樣的，只是更干凈一點(diǎn)。

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

糟糕的 IDE？

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

您可以安裝該軟件包并生成 _ide_helper.php 文件，然后就可以開始了。

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

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

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

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