Laravel tap 用法

本文参照转译:

http://derekmd.com/2017/02/laravel-tap/?ut...

https://murze.be/2017/02/laravels-tap-help...

Laravel 5.3 中增加了一个新的全局帮助函数 tap(),改进了框架的声明能力。这个微妙的语法是从 RubyLodash 借鉴而来,允许你去 tap 成链。

先看看 tap() 帮助函数的代码,只有短短的几行:

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

   return $value;
}

你需要传一个值和一个回调到方法中,值作为回调的参数,回调将执行,最后值被返回。

执行中间操作

从一个简单的例子开始,提取 LaravelAuthenticateSession@handle() 的一些代码,一些 PHP 开发者非常熟悉的解决方案:

$response = $next($request);

$this->storePasswordHashInSession($request);

return $response;

使用 tap() 帮助函数:

return tap($next($request), function () use ($request) {
    $this->storePasswordHashInSession($request);
});

另外的一个简单的例子,让我们看看 Illuminate\Cache\Repository 下的 pull 方法,此函数将从指定键的缓存中获取值,并将其删除。pull 方法的实现:

public function pull($key, $default = null)
{
   $value = $this->get($key, $default);

   $this->forget($key) // returns a boolean;

   return $value;
}

上面的例子中,$this-> forget() 返回一个布尔值,所以要使我们的函数返回原始值,需要将其储存到临时变量 $value 中。以下是 tap() 的实现,不再需要临时变量:

public function pull($key, $default = null)
{
   return tap($this->get($key, $default), function ($value) use ($key) {
      $this->forget($key);
   });
}

恢复状态

Eloquent 的 createupdate 方法支持 ['timestamps' => false] 选项。如果这被实现成链式方法,结果的可读性会更好。

// Method defined in App\Model that App\Message extends.
public function keepingTimestamps(callable $callback)
{
    try {
        $timestamps = $this->timestamps;
        $this->timestamps = false;

        return tap($this, $callback);
    } finally {
        $this->timestamps = $timestamps;
    }
}

现在 Message 模型可以链式使用以上的方法:

request()->user()->latestMessage->keepingTimestamps(function ($message) {
    $message->markRead(); // updates a 'read_at' timestamp instead
}); // returns the latestMessage

如果你写的代码有 DB::transaction() 相同的模式,你可以在 Laravel 5.4 使用 tap() 帮助函数重写。

Collection

Laravel 5.4 中也可以在 Collection 类中使用 tap() 方法。你可以在任何地方使用,而不需要破坏链式。对于 Laravel 5.3 及更早的版本,你只需要复制粘贴五行代码的方法作为 Collection macro 到你项目的 AppServiceProvider@boot() 即可。

这里有一个例子,用于 Laravel 网站支持英语和法语。取代月份的语言翻译文件,使用 Carbon 列出一年每个月份的 <option>。因此这个模型的修饰方法:

public function monthOptions()
{
    return collect(range(1, 12))
        ->keyByValue() // custom Collection macro
        ->tap(function () {
            if (App::getLocale() === 'fr') {
                setlocale(LC_TIME, 'fr_CA');
            }
        })
        ->map(function ($month) {
            return sprintf('%02d - %s', $month,
                Carbon::now()->month($month)->formatLocalized('%B'));
        })
        ->tap(function () {
            if (App::getLocale() === 'fr') {
                setlocale(LC_TIME, '');
            }
        });
}

对于更多的语言支持,设置/恢复状态将提取到其他方法,使其更加可读。

使用 Collection tap() 处理控制台命令进度条

这是在集合中最典型的用例。你甚至可以在 handle() 处理过程中保持其方法链。

public function handle()
{
    Club::findOrFail($this->option('club'))
        ->members()
        ->subscribed()
        ->get()
        ->tap(function ($members) {
            $this->output->progressStart($members->count());
        })
        ->each(function ($member) {
            Mail::to($member)->queue(new Newsletter($member, $this->matchReport());

            $this->output->progressAdvance();
        })
        ->tap(function () {
            $this->output->progressFinish();
        });
}

public function matchReport()
{
     return once(function () {
          return MatchReport::ofRound($this->option('round'))->firstOrFail();
     });
}

Nothing is impossible. —— @Jiajian Chan

本帖由 Summer 于 2年前 加精
《L01 基础入门》
我们将带你从零开发一个项目并部署到线上,本课程教授 Web 开发中专业、实用的技能,如 Git 工作流、Laravel Mix 前端工作流等。
《L03 构架 API 服务器》
你将学到如 RESTFul 设计风格、PostMan 的使用、OAuth 流程,JWT 概念及使用 和 API 开发相关的进阶知识。
讨论数量: 3
leo

文章多处把tap写成tag

2年前 评论

@leo 我的错,已改,哈哈,打 tag 打顺手了:joy:

2年前 评论
Summer

学习了。 @leo :+1: 够细心 :joy:

2年前 评论

请勿发布不友善或者负能量的内容。与人为善,比聪明更重要!