Laravel 中的强大的tap你用过么

风格不统一 提交于 2020-03-06 19:19:19

在本文,我们将讨论 Laravel 中的 tap。我们将详细讨论 tap 帮助函数和 collection 中的 tap 方法。

Tap 帮助函数

旧的实现方式

Laravel提出了一个 tap 功能。这是一个非常奇怪的功能,受Ruby的启发。这是 tap 助手功能的基本实现。

function tap($value, $callback)
{
    $callback($value);

    return $value;
}

上面的代码将接受一个参数,它将使用该参数调用一个匿名函数。在调用回调函数后,它将返回参数。 让我们看看我们如何以有意义的方式使用它。例如:

<?php

$photo = App\Photo::find(1);

return tap($photo, function($photo) {
    $photo->validated = true;
    $photo->save();
});

在上面的例子中,我们传递一个参数(照片模型)和一个回调函数,该函数简单地将 validated 设置为 true 并保存模型。这个函数然后将照片模型实例返回给调用者。

新的实现方式

在最新版本的Laravel 5.4和Laravel 5.5中,更高级的 tap 来了。它引入了更短的使用方式。这里是 tap 函数的新实现。

function tap($value, $callback = null)
{
    if (is_null($callback)) {
        return new HigherOrderTapProxy($value);
    }

    $callback($value);

    return $value;
}

回调函数现在是可选的。你还可以链式使用参数中的多个方法,这里其实也就是照片Model中支持的方法。例如

<?php

$photo = App\Photo::find(1);

return tap($photo)->update([
    'validated' => 'true',
])

我们能够将任何模型的方法通过 tap 链式调用。此更新方法通常返回 truefalse,但是这里使用了 tap 函数。在这种情况下,它将返回照片模型。tap 可以帮助你返回作为参数传递的对象。

它是如何工作的

tap 是一个非常有用的功能,但有时它很难理解它是如何工作的。 这里来解释它是如何工作的。

如果没有给出回调函数,因为它是可选的,Laravel将返回 HigherOrderTapProxy 的新实例。 在 HigherOrderTapProxy 类中定义了调用魔术方法。 调用魔术方法是由语言动态调用的(所谓的方法在类中没有定义)。 因为除了调用魔术方法,HigherOrderTapProxy 类中没有定义方法,所以每次使用 tap 函数任何方法调用时都会调用它。 在调用魔术方法中,我们的更新方法或任何我们调用的方法将被参数调用,并且它将返回我们最初传递给 tap 函数的参数。

这里是 HigherOrderTapProxy 类中调用魔术方法的实际内容。

// vendor/laravel/framework/src/Illuminate/Support/HigherOrderTapProxy.php
public function __call($method, $parameters)
{
    $this->target->{$method}(...$parameters);

    return $this->target;
}

在上面的代码中,target 属性是我们在tap中传递的参数。

Laravel collection 中的 tap 方法

Laravel还在 collection 类中有一个 tap 方法,可让你在特定的地方传入参数到 tap中,并对这些结果进行处理。tap 不会影响主要 collection 的结果。 这对调试代码和查找在处理集合时出现错误的地方很有帮助。 我们用一个例子来解释这个方法。 初始化以下数组。

$photos = [
    ['file_name' => 'wallpaper', 'validated' => true, 'extension' => 'jpg'],
    ['file_name' => 'spring', 'validated' => true, 'extension' => 'png'],
    ['file_name' => 'flowers', 'validated' => false, 'extension' => 'jpg'],
    ['file_name' => 'mac', 'validated' => true, 'extension' => 'png'],
    ['file_name' => 'books', 'validated' => false, 'extension' => 'jpg'],
    ['file_name' => 'mobiles', 'validated' => false, 'extension' => 'jpg'],
    ['file_name' => 'glass', 'validated' => false, 'extension' => 'png'],
    ['file_name' => 'fruit', 'validated' => true, 'extension' => 'jpg'],
];

现在让我们尝试在这个数组上使用 tap 方法。首先,我们必须将这个数组转换为一个集合,然后在特定点处 tap 这个集合。

return collect($photos)
    ->where('validated', true)
    ->tap(function ($validated) {
        return var_dump($validated->pluck('file_name'));
    });
});

上面的代码将会输出以下结果:

wallpaper
spring
mac
fruit

tap VS Pipe(管道)

在Laravel中,也有类似的方法叫管道。 它们在某种意义上是相似的,因为它们都在集合管道中使用。 tappipe 之间有一个区别。 tap 允许你使用数据,但不会修改原始返回值。 另一方面,pipe 根据返回值修改数据。 例如:

return collect($photos)
    ->where('validated', true)
    ->pipe(function ($validated) {
        return $validated->where('extension', 'jpg')->pluck('file_name');
    });
});

输出结果为

wallpaper
fruit

另一方面,如果我们像这样使用上面的代码:

return collect($photos)
    ->where('validated', true)
    ->tap(function ($validated) {
        return $validated->where('extension', 'jpg')->pluck('file_name');
    });
});

它将返回验证设置为true的所有照片数组。

结果为

0: {
    file_name: "wallpaper",
    validated: true,
    extension: "jpg"
},
1: {
    file_name: "spring",
    validated: true,
    extension: "png"
},
3: {
    file_name: "mac",
    validated: true,
    extension: "png"
},
7: {
    file_name: "fruit",
    validated: true,
    extension: "jpg"
}

更多PHP知识,请前往PHPCasts

标签
易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!