摘要：在調(diào)用回調(diào)函數(shù)后，它將返回參數(shù)。例如在上面的例子中，我們傳遞一個參數(shù)照片模型和一個回調(diào)函數(shù)，該函數(shù)簡單地將設(shè)置為并保存模型。如果沒有給出回調(diào)函數(shù)，因為它是可選的，將返回的新實例。允許你使用數(shù)據(jù)，但不會修改原始返回值。

在本文，我們將討論 Laravel 中的 tap。我們將詳細(xì)討論 tap 幫助函數(shù)和 collection 中的 tap 方法。

Laravel提出了一個 tap 功能。這是一個非常奇怪的功能，受Ruby的啟發(fā)。這是 tap 助手功能的基本實現(xiàn)。

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

    return $value;
}

上面的代碼將接受一個參數(shù)，它將使用該參數(shù)調(diào)用一個匿名函數(shù)。在調(diào)用回調(diào)函數(shù)后，它將返回參數(shù)。
讓我們看看我們?nèi)绾我杂幸饬x的方式使用它。例如：

validated = true;
    $photo->save();
});

在上面的例子中，我們傳遞一個參數(shù)（照片模型）和一個回調(diào)函數(shù)，該函數(shù)簡單地將 validated 設(shè)置為 true 并保存模型。這個函數(shù)然后將照片模型實例返回給調(diào)用者。

在最新版本的Laravel 5.4和Laravel 5.5中，更高級的 tap 來了。它引入了更短的使用方式。這里是 tap 函數(shù)的新實現(xiàn)。

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

    $callback($value);

    return $value;
}

回調(diào)函數(shù)現(xiàn)在是可選的。你還可以鏈?zhǔn)绞褂脜?shù)中的多個方法，這里其實也就是照片Model中支持的方法。例如

update([
    "validated" => "true",
])

我們能夠?qū)⑷魏文Ｐ偷姆椒ㄍㄟ^ tap 鏈?zhǔn)秸{(diào)用。此更新方法通常返回 true 或 false，但是這里使用了 tap 函數(shù)。在這種情況下，它將返回照片模型。tap 可以幫助你返回作為參數(shù)傳遞的對象。

tap 是一個非常有用的功能，但有時它很難理解它是如何工作的。 這里來解釋它是如何工作的。

如果沒有給出回調(diào)函數(shù)，因為它是可選的，Laravel將返回 HigherOrderTapProxy 的新實例。 在 HigherOrderTapProxy 類中定義了調(diào)用魔術(shù)方法。 調(diào)用魔術(shù)方法是由語言動態(tài)調(diào)用的(所謂的方法在類中沒有定義)。 因為除了調(diào)用魔術(shù)方法，HigherOrderTapProxy 類中沒有定義方法，所以每次使用 tap 函數(shù)任何方法調(diào)用時都會調(diào)用它。 在調(diào)用魔術(shù)方法中，我們的更新方法或任何我們調(diào)用的方法將被參數(shù)調(diào)用，并且它將返回我們最初傳遞給 tap 函數(shù)的參數(shù)。

這里是 HigherOrderTapProxy 類中調(diào)用魔術(shù)方法的實際內(nèi)容。

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

    return $this->target;
}

在上面的代碼中，target 屬性是我們在tap中傳遞的參數(shù)。

Laravel還在 collection 類中有一個 tap 方法，可讓你在特定的地方傳入?yún)?shù)到 tap中，并對這些結(jié)果進(jìn)行處理。tap 不會影響主要 collection 的結(jié)果。 這對調(diào)試代碼和查找在處理集合時出現(xiàn)錯誤的地方很有幫助。
我們用一個例子來解釋這個方法。 初始化以下數(shù)組。

$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"],
];

現(xiàn)在讓我們嘗試在這個數(shù)組上使用 tap 方法。首先，我們必須將這個數(shù)組轉(zhuǎn)換為一個集合，然后在特定點處 tap 這個集合。

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

上面的代碼將會輸出以下結(jié)果：

wallpaper
spring
mac
fruit

在Laravel中，也有類似的方法叫管道。 它們在某種意義上是相似的，因為它們都在集合管道中使用。 tap 和 pipe 之間有一個區(qū)別。 tap 允許你使用數(shù)據(jù)，但不會修改原始返回值。 另一方面，pipe 根據(jù)返回值修改數(shù)據(jù)。
例如：

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

輸出結(jié)果為

wallpaper
fruit

另一方面，如果我們像這樣使用上面的代碼：

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

它將返回驗證設(shè)置為true的所有照片數(shù)組。

結(jié)果為

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