Merge pull request #28507 from pascalbaljet/5.8

[5.8] Added Tappable trait

src/Illuminate/Support/Traits/Tappable.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace Illuminate\Support\Traits;
+
+trait Tappable
+{
+    /**
+     * Call the given Closure with this instance then return the instance.
+     *
+     * @param  callable|null  $callback
+     * @return mixed
+     */
+    public function tap($callback = null)
+    {
+        return tap($this, $callback);
+    }
+}

tests/Support/SupportTappableTest.php

@@ -0,0 +1,47 @@
+<?php
+
+namespace Illuminate\Tests\Support;
+
+use PHPUnit\Framework\TestCase;
+use Illuminate\Support\Traits\Tappable;
+
+class SupportTappableTest extends TestCase
+{
+    public function testTappableClassWithCallback()
+    {
+        $name = TappableClass::make()->tap(function ($tappable) {
+            $tappable->setName('MyName');
+        })->getName();
+
+        $this->assertEquals('MyName', $name);
+    }
+
+    public function testTappableClassWithoutCallback()
+    {
+        $name = TappableClass::make()->tap()->setName('MyName')->getName();
+
+        $this->assertEquals('MyName', $name);
+    }
+}
+
+class TappableClass
+{
+    use Tappable;
+
+    private $name;
+
+    public static function make()
+    {
+        return new static;
+    }
+
+    public function setName($name)
+    {
+        $this->name = $name;
+    }
+
+    public function getName()
+    {
+        return $this->name;
+    }
+}