Allow disable debugbar rendering

Author: natanfelles

src/Debugger.php

@@ -28,6 +28,7 @@ class Debugger
      */
     protected array $options = [];
     protected string $debugbarView = __DIR__ . '/Views/debugbar/debugbar.php';
+    protected bool $debugbarEnabled = true;
 
     public function addCollection(Collection $collection) : static
     {
@@ -141,6 +142,9 @@ public function getDebugbarView() : string
 
     public function renderDebugbar() : string
     {
+        if (!$this->isDebugbarEnabled()) {
+            return '';
+        }
         \ob_start();
         Isolation::require($this->getDebugbarView(), [
             'collections' => $this->getCollections(),
@@ -150,6 +154,44 @@ public function renderDebugbar() : string
         return \ob_get_clean(); // @phpstan-ignore-line
     }
 
+    /**
+     * Tells if debugbar rendering is enabled.
+     *
+     * @since 4.2
+     *
+     * @return bool
+     */
+    public function isDebugbarEnabled() : bool
+    {
+        return $this->debugbarEnabled;
+    }
+
+    /**
+     * Enables debugbar rendering.
+     *
+     * @since 4.2
+     *
+     * @return static
+     */
+    public function enableDebugbar() : static
+    {
+        $this->debugbarEnabled = true;
+        return $this;
+    }
+
+    /**
+     * Disables debugbar rendering.
+     *
+     * @since 4.2
+     *
+     * @return static
+     */
+    public function disableDebugbar() : static
+    {
+        $this->debugbarEnabled = false;
+        return $this;
+    }
+
     public static function makeSafeName(string $name) : string
     {
         return \strtr(\trim(\strip_tags(\strtolower($name))), [

tests/DebuggerTest.php

@@ -82,6 +82,18 @@ public function testRenderDebugbar() : void
         self::assertStringContainsString('<button>Foo</button> xx', $debugbar);
     }
 
+    public function testDebugbarStatus() : void
+    {
+        self::assertTrue($this->debugger->isDebugbarEnabled());
+        self::assertNotSame('', $this->debugger->renderDebugbar());
+        $this->debugger->disableDebugbar();
+        self::assertFalse($this->debugger->isDebugbarEnabled());
+        self::assertSame('', $this->debugger->renderDebugbar());
+        $this->debugger->enableDebugbar();
+        self::assertTrue($this->debugger->isDebugbarEnabled());
+        self::assertNotSame('', $this->debugger->renderDebugbar());
+    }
+
     public function testActivities() : void
     {
         $microtime = \microtime(true);