twig.engine 5.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146
  1. <?php
  2. /**
  3. * @file
  4. * Handles integration of Twig templates with the Drupal theme system.
  5. */
  6. use Drupal\Component\Utility\Html;
  7. use Drupal\Core\Render\Markup;
  8. use Drupal\Core\Extension\Extension;
  9. /**
  10. * Implements hook_theme().
  11. */
  12. function twig_theme($existing, $type, $theme, $path) {
  13. $templates = drupal_find_theme_functions($existing, [$theme]);
  14. $templates += drupal_find_theme_templates($existing, '.html.twig', $path);
  15. return $templates;
  16. }
  17. /**
  18. * Implements hook_extension().
  19. */
  20. function twig_extension() {
  21. return '.html.twig';
  22. }
  23. /**
  24. * Includes .theme file from themes.
  25. *
  26. * @param \Drupal\Core\Extension\Extension $theme
  27. * The theme extension object.
  28. */
  29. function twig_init(Extension $theme) {
  30. $theme->load();
  31. }
  32. /**
  33. * Implements hook_render_template().
  34. *
  35. * Renders a Twig template.
  36. *
  37. * If the Twig debug setting is enabled, HTML comments including the theme hook
  38. * and template file name suggestions will surround the template markup.
  39. *
  40. * @param string $template_file
  41. * The file name of the template to render.
  42. * @param array $variables
  43. * A keyed array of variables that will appear in the output.
  44. *
  45. * @return string|\Drupal\Component\Render\MarkupInterface
  46. * The output generated by the template, plus any debug information.
  47. */
  48. function twig_render_template($template_file, array $variables) {
  49. /** @var \Twig_Environment $twig_service */
  50. $twig_service = \Drupal::service('twig');
  51. $output = [
  52. 'debug_prefix' => '',
  53. 'debug_info' => '',
  54. 'rendered_markup' => '',
  55. 'debug_suffix' => '',
  56. ];
  57. try {
  58. $output['rendered_markup'] = $twig_service->loadTemplate($template_file)->render($variables);
  59. }
  60. catch (\Twig_Error_Runtime $e) {
  61. // In case there is a previous exception, re-throw the previous exception,
  62. // so that the original exception is shown, rather than
  63. // \Twig_Template::displayWithErrorHandling()'s exception.
  64. $previous_exception = $e->getPrevious();
  65. if ($previous_exception) {
  66. throw $previous_exception;
  67. }
  68. throw $e;
  69. }
  70. if ($twig_service->isDebug()) {
  71. $output['debug_prefix'] .= "\n\n<!-- THEME DEBUG -->";
  72. $output['debug_prefix'] .= "\n<!-- THEME HOOK: '" . Html::escape($variables['theme_hook_original']) . "' -->";
  73. // If there are theme suggestions, reverse the array so more specific
  74. // suggestions are shown first.
  75. if (!empty($variables['theme_hook_suggestions'])) {
  76. $variables['theme_hook_suggestions'] = array_reverse($variables['theme_hook_suggestions']);
  77. }
  78. // Add debug output for directly called suggestions like
  79. // '#theme' => 'comment__node__article'.
  80. if (strpos($variables['theme_hook_original'], '__') !== FALSE) {
  81. $derived_suggestions[] = $hook = $variables['theme_hook_original'];
  82. while ($pos = strrpos($hook, '__')) {
  83. $hook = substr($hook, 0, $pos);
  84. $derived_suggestions[] = $hook;
  85. }
  86. // Get the value of the base hook (last derived suggestion) and append it
  87. // to the end of all theme suggestions.
  88. $base_hook = array_pop($derived_suggestions);
  89. $variables['theme_hook_suggestions'] = array_merge($derived_suggestions, $variables['theme_hook_suggestions']);
  90. $variables['theme_hook_suggestions'][] = $base_hook;
  91. }
  92. if (!empty($variables['theme_hook_suggestions'])) {
  93. $extension = twig_extension();
  94. $current_template = basename($template_file);
  95. $suggestions = $variables['theme_hook_suggestions'];
  96. // Only add the original theme hook if it wasn't a directly called
  97. // suggestion.
  98. if (strpos($variables['theme_hook_original'], '__') === FALSE) {
  99. $suggestions[] = $variables['theme_hook_original'];
  100. }
  101. foreach ($suggestions as &$suggestion) {
  102. $template = strtr($suggestion, '_', '-') . $extension;
  103. $prefix = ($template == $current_template) ? 'x' : '*';
  104. $suggestion = $prefix . ' ' . $template;
  105. }
  106. $output['debug_info'] .= "\n<!-- FILE NAME SUGGESTIONS:\n " . Html::escape(implode("\n ", $suggestions)) . "\n-->";
  107. }
  108. $output['debug_info'] .= "\n<!-- BEGIN OUTPUT from '" . Html::escape($template_file) . "' -->\n";
  109. $output['debug_suffix'] .= "\n<!-- END OUTPUT from '" . Html::escape($template_file) . "' -->\n\n";
  110. }
  111. // This output has already been rendered and is therefore considered safe.
  112. return Markup::create(implode('', $output));
  113. }
  114. /**
  115. * Removes child elements from a copy of the original array.
  116. *
  117. * Creates a copy of the renderable array and removes child elements by key
  118. * specified through filter's arguments. The copy can be printed without these
  119. * elements. The original renderable array is still available and can be used
  120. * to print child elements in their entirety in the twig template.
  121. *
  122. * @param array|object $element
  123. * The parent renderable array to exclude the child items.
  124. * @param string[] ...
  125. * The string keys of $element to prevent printing.
  126. *
  127. * @return array
  128. * The filtered renderable array.
  129. *
  130. * @deprecated in Drupal 8.7.x and will be removed before 9.0.0. Use
  131. * \Drupal\Core\Template\TwigExtension::withoutFilter() instead.
  132. */
  133. function twig_without($element) {
  134. @trigger_error('twig_without() is deprecated in Drupal 8.7.x and will be removed before Drupal 9.0.0. Use \Drupal\Core\Template\TwigExtension::withoutFilter(). See https://www.drupal.org/node/3011154.', E_USER_DEPRECATED);
  135. /** @var \Drupal\Core\Template\TwigExtension $extension */
  136. $extension = \Drupal::service('twig.extension');
  137. return call_user_func_array([$extension, 'withoutFilter'], func_get_args());
  138. }