[8.x] Adds class handling for Blade echo statements

src/Illuminate/Support/Facades/Blade.php

@@ -26,6 +26,7 @@
  * @method static void withDoubleEncoding()
  * @method static void withoutComponentTags()
  * @method static void withoutDoubleEncoding()
+ * @method static void handle(string $className, callable $handler)
  *
  * @see \Illuminate\View\Compilers\BladeCompiler
  */

src/Illuminate/View/Compilers/BladeCompiler.php

@@ -127,6 +127,13 @@ class BladeCompiler extends Compiler implements CompilerInterface
      */
     protected $classComponentNamespaces = [];
 
+    /**
+     * The array of handlers objects should be passed through.
+     *
+     * @var array
+     */
+    public $echoHandlers = [];
+
     /**
      * Indicates if component tags should be compiled.
      *
@@ -752,4 +759,14 @@ public function withoutComponentTags()
     {
         $this->compilesComponentTags = false;
     }
+
+    /**
+     * Add a handler to be executed before echoing a given class.
+     *
+     * @return void
+     */
+    public function handle(string $className, callable $handler)
+    {
+        $this->echoHandlers[$className] = $handler;
+    }
 }

src/Illuminate/View/Compilers/Concerns/CompilesEchos.php

@@ -46,7 +46,9 @@ protected function compileRawEchos($value)
         $callback = function ($matches) {
             $whitespace = empty($matches[3]) ? '' : $matches[3].$matches[3];
 
-            return $matches[1] ? substr($matches[0], 1) : "<?php echo {$matches[2]}; ?>{$whitespace}";
+            return $matches[1]
+                ? substr($matches[0], 1)
+                : "<?php echo {$this->applyEchoHandlerFor($matches[2])}; ?>{$whitespace}";
         };
 
         return preg_replace_callback($pattern, $callback, $value);
@@ -65,7 +67,7 @@ protected function compileRegularEchos($value)
         $callback = function ($matches) {
             $whitespace = empty($matches[3]) ? '' : $matches[3].$matches[3];
 
-            $wrapped = sprintf($this->echoFormat, $matches[2]);
+            $wrapped = sprintf($this->echoFormat, $this->applyEchoHandlerFor($matches[2]));
 
             return $matches[1] ? substr($matches[0], 1) : "<?php echo {$wrapped}; ?>{$whitespace}";
         };
@@ -86,9 +88,24 @@ protected function compileEscapedEchos($value)
         $callback = function ($matches) {
             $whitespace = empty($matches[3]) ? '' : $matches[3].$matches[3];
 
-            return $matches[1] ? $matches[0] : "<?php echo e({$matches[2]}); ?>{$whitespace}";
+            return $matches[1]
+                ? $matches[0]
+                : "<?php echo e({$this->applyEchoHandlerFor($matches[2])}); ?>{$whitespace}";
         };
 
         return preg_replace_callback($pattern, $callback, $value);
     }
+
+    /**
+     * Wrap the value in a handler if applicable.
+     *
+     * @param  string $value
+     * @return string
+     */
+    protected function applyEchoHandlerFor($value)
+    {
+        return empty($this->echoHandlers)
+            ? $value
+            : "is_object($value) && isset(app('blade.compiler')->echoHandlers[get_class($value)]) ? call_user_func_array(app('blade.compiler')->echoHandlers[get_class($value)], [$value]) : $value";
+    }
 }

tests/View/Blade/BladeEchoHandlerTest.php

@@ -0,0 +1,77 @@
+<?php
+
+namespace Illuminate\Tests\View\Blade;
+
+use Exception;
+use Illuminate\Support\Fluent;
+use Illuminate\Support\Str;
+
+class BladeEchoHandlerTest extends AbstractBladeTestCase
+{
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->compiler->handle(Fluent::class, function ($object) {
+            return 'Hello World';
+        });
+    }
+
+    public function testBladeHandlersCanBeAddedForAGivenClass()
+    {
+        $this->assertSame('Hello World', $this->compiler->echoHandlers[Fluent::class](new Fluent()));
+    }
+
+    public function testBladeHandlerCanInterceptRegularEchos()
+    {
+        $this->assertSame(
+            "<?php echo e(is_object(\$exampleObject) && isset(app('blade.compiler')->echoHandlers[get_class(\$exampleObject)]) ? call_user_func_array(app('blade.compiler')->echoHandlers[get_class(\$exampleObject)], [\$exampleObject]) : \$exampleObject); ?>",
+            $this->compiler->compileString('{{$exampleObject}}')
+        );
+    }
+
+    public function testBladeHandlerCanInterceptRawEchos()
+    {
+        $this->assertSame(
+            "<?php echo is_object(\$exampleObject) && isset(app('blade.compiler')->echoHandlers[get_class(\$exampleObject)]) ? call_user_func_array(app('blade.compiler')->echoHandlers[get_class(\$exampleObject)], [\$exampleObject]) : \$exampleObject; ?>",
+            $this->compiler->compileString('{!!$exampleObject!!}')
+        );
+    }
+
+    public function testBladeHandlerCanInterceptEscapedEchos()
+    {
+        $this->assertSame(
+            "<?php echo e(is_object(\$exampleObject) && isset(app('blade.compiler')->echoHandlers[get_class(\$exampleObject)]) ? call_user_func_array(app('blade.compiler')->echoHandlers[get_class(\$exampleObject)], [\$exampleObject]) : \$exampleObject); ?>",
+            $this->compiler->compileString('{{{$exampleObject}}}')
+        );
+    }
+
+    public function testWhitespaceIsPreservedCorrectly()
+    {
+        $this->assertSame(
+            "<?php echo e(is_object(\$exampleObject) && isset(app('blade.compiler')->echoHandlers[get_class(\$exampleObject)]) ? call_user_func_array(app('blade.compiler')->echoHandlers[get_class(\$exampleObject)], [\$exampleObject]) : \$exampleObject); ?>\n\n",
+            $this->compiler->compileString("{{\$exampleObject}}\n")
+        );
+    }
+
+    public function testHandlerLogicWorksCorrectly()
+    {
+        $this->expectExceptionMessage('The fluent object has been successfully handled!');
+
+        $this->compiler->handle(Fluent::class, function ($object) {
+            throw new Exception('The fluent object has been successfully handled!');
+        });
+
+        app()->singleton('blade.compiler', function () {
+            return $this->compiler;
+        });
+
+        $exampleObject = new Fluent();
+
+        eval(
+            Str::of($this->compiler->compileString('{{$exampleObject}}'))
+            ->after('<?php')
+            ->beforeLast('?>')
+        );
+    }
+}