From d5403ae27407c32c6703a7a0b503500315f8117a Mon Sep 17 00:00:00 2001
From: Chi <Chi@556138.no-reply.drupal.org>
Date: Sat, 21 Apr 2018 14:07:19 +0500
Subject: [PATCH] Added drupal_breakpoint() function.

---
 src/TwigExtension.php | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/src/TwigExtension.php b/src/TwigExtension.php
index 9bed05e..8756b80 100644
--- a/src/TwigExtension.php
+++ b/src/TwigExtension.php
@@ -29,6 +29,7 @@ class TwigExtension extends \Twig_Extension {
    * {@inheritdoc}
    */
   public function getFunctions() {
+    $options = ['needs_environment' => TRUE, 'needs_context' => TRUE];
     return [
       new \Twig_SimpleFunction('drupal_view', 'views_embed_view'),
       new \Twig_SimpleFunction('drupal_view_result', 'views_get_view_result'),
@@ -48,6 +49,7 @@ class TwigExtension extends \Twig_Extension {
       new \Twig_SimpleFunction('drupal_link', [$this, 'drupalLink']),
       new \Twig_SimpleFunction('drupal_messages', [$this, 'drupalMessages']),
       new \Twig_SimpleFunction('drupal_breadcrumb', [$this, 'drupalBreadcrumb']),
+      new \Twig_SimpleFunction('drupal_breakpoint', [$this, 'drupalBreakpoint'], $options),
     ];
   }
 
@@ -528,6 +530,23 @@ class TwigExtension extends \Twig_Extension {
       ->toRenderable();
   }
 
+  /**
+   * Emits a breakpoint to the debug client.
+   *
+   * @param \Twig_Environment $environment
+   *   The Twig environment instance.
+   * @param array $context
+   *   Variables from the Twig template.
+   */
+  public function drupalBreakpoint(\Twig_Environment $environment, array $context) {
+    if (function_exists('xdebug_break')) {
+      xdebug_break();
+    }
+    else {
+      trigger_error('Could not make a break because xdebug is not available.', E_USER_WARNING);
+    }
+  }
+
   /**
    * Replaces all tokens in a given string with appropriate values.
    *