RouteInfoController.php

Same filename in other branches
  1. 4.x src/Controller/RouteInfoController.php

Namespace

Drupal\devel\Controller

File

src/Controller/RouteInfoController.php

View source
<?php

namespace Drupal\devel\Controller;

use Drupal\Component\Serialization\Json;
use Drupal\Core\Controller\ControllerBase;
use Drupal\Core\Routing\RouteMatchInterface;
use Drupal\Core\Routing\RouteProviderInterface;
use Drupal\Core\Url;
use Drupal\devel\DevelDumperManagerInterface;
use Symfony\Component\DependencyInjection\ContainerInterface;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\Routing\RouterInterface;

/**
 * Provides route responses for the route info pages.
 */
class RouteInfoController extends ControllerBase {
    
    /**
     * The route provider.
     */
    protected RouteProviderInterface $routeProvider;
    
    /**
     * The router service.
     */
    protected RouterInterface $router;
    
    /**
     * The dumper service.
     */
    protected DevelDumperManagerInterface $dumper;
    
    /**
     * {@inheritdoc}
     */
    public static function create(ContainerInterface $container) : static {
        $instance = parent::create($container);
        $instance->routeProvider = $container->get('router.route_provider');
        $instance->router = $container->get('router.no_access_checks');
        $instance->dumper = $container->get('devel.dumper');
        $instance->messenger = $container->get('messenger');
        $instance->stringTranslation = $container->get('string_translation');
        return $instance;
    }
    
    /**
     * Builds the routes overview page.
     *
     * @return array
     *   A render array as expected by the renderer.
     */
    public function routeList() : array {
        $headers = [
            $this->t('Route Name'),
            $this->t('Path'),
            $this->t('Allowed Methods'),
            $this->t('Operations'),
        ];
        $rows = [];
        foreach ($this->routeProvider
            ->getAllRoutes() as $route_name => $route) {
            $row['name'] = [
                'data' => $route_name,
                'filter' => TRUE,
            ];
            $row['path'] = [
                'data' => $route->getPath(),
                'filter' => TRUE,
            ];
            $row['methods']['data'] = [
                '#theme' => 'item_list',
                '#items' => $route->getMethods(),
                '#empty' => $this->t('ANY'),
                '#context' => [
                    'list_style' => 'comma-list',
                ],
            ];
            // We cannot resolve routes with dynamic parameters from route path. For
            // these routes we pass the route name.
            // @see ::routeItem()
            if (str_contains($route->getPath(), '{')) {
                $parameters = [
                    'query' => [
                        'route_name' => $route_name,
                    ],
                ];
            }
            else {
                $parameters = [
                    'query' => [
                        'path' => $route->getPath(),
                    ],
                ];
            }
            $row['operations']['data'] = [
                '#type' => 'operations',
                '#links' => [
                    'devel' => [
                        'title' => $this->t('Devel'),
                        'url' => Url::fromRoute('devel.route_info.item', [], $parameters),
                        'attributes' => [
                            'class' => [
                                'use-ajax',
                            ],
                            'data-dialog-type' => 'modal',
                            'data-dialog-options' => Json::encode([
                                'width' => 700,
                                'minHeight' => 500,
                            ]),
                        ],
                    ],
                ],
            ];
            $rows[] = $row;
        }
        $output['routes'] = [
            '#type' => 'devel_table_filter',
            '#filter_label' => $this->t('Search'),
            '#filter_placeholder' => $this->t('Enter route name or path'),
            '#filter_description' => $this->t('Enter a part of the route name or path to filter by.'),
            '#header' => $headers,
            '#rows' => $rows,
            '#empty' => $this->t('No routes found.'),
            '#sticky' => TRUE,
            '#attributes' => [
                'class' => [
                    'devel-route-list',
                ],
            ],
        ];
        return $output;
    }
    
    /**
     * Returns a render array representation of the route object.
     *
     * The method tries to resolve the route from the 'path' or the 'route_name'
     * query string value if available. If no route is retrieved from the query
     * string parameters it fallbacks to the current route.
     *
     * @param \Symfony\Component\HttpFoundation\Request $request
     *   The request object.
     * @param \Drupal\Core\Routing\RouteMatchInterface $route_match
     *   The route match.
     *
     * @return array
     *   A render array as expected by the renderer.
     */
    public function routeDetail(Request $request, RouteMatchInterface $route_match) : array {
        $route = NULL;
        // Get the route object from the path query string if available.
        if ($path = $request->query
            ->get('path')) {
            try {
                $route = $this->router
                    ->match($path);
            } catch (\Exception) {
                $this->messenger
                    ->addWarning($this->t("Unable to load route for url '%url'", [
                    '%url' => $path,
                ]));
            }
        }
        // Get the route object from the route name query string if available and
        // the route is not retrieved by path.
        if ($route === NULL && ($route_name = $request->query
            ->get('route_name'))) {
            try {
                $route = $this->routeProvider
                    ->getRouteByName($route_name);
            } catch (\Exception) {
                $this->messenger
                    ->addWarning($this->t("Unable to load route '%name'", [
                    '%name' => $route_name,
                ]));
            }
        }
        // No route retrieved from path or name specified, get the current route.
        if ($route === NULL) {
            $route = $route_match->getRouteObject();
        }
        return $this->dumper
            ->exportAsRenderable($route);
    }

}

Classes

Title Deprecated Summary
RouteInfoController Provides route responses for the route info pages.