151 lines
5.0 KiB
PHP
151 lines
5.0 KiB
PHP
|
<?php
|
||
|
|
||
|
/*
|
||
|
* This file is part of the Symfony package.
|
||
|
*
|
||
|
* (c) Fabien Potencier <fabien@symfony.com>
|
||
|
*
|
||
|
* For the full copyright and license information, please view the LICENSE
|
||
|
* file that was distributed with this source code.
|
||
|
*/
|
||
|
|
||
|
namespace Symfony\Bundle\FrameworkBundle\Command;
|
||
|
|
||
|
use Symfony\Bundle\FrameworkBundle\Console\Helper\DescriptorHelper;
|
||
|
use Symfony\Component\Console\Command\Command;
|
||
|
use Symfony\Component\Console\Completion\CompletionInput;
|
||
|
use Symfony\Component\Console\Completion\CompletionSuggestions;
|
||
|
use Symfony\Component\Console\Exception\InvalidArgumentException;
|
||
|
use Symfony\Component\Console\Input\InputArgument;
|
||
|
use Symfony\Component\Console\Input\InputInterface;
|
||
|
use Symfony\Component\Console\Input\InputOption;
|
||
|
use Symfony\Component\Console\Output\OutputInterface;
|
||
|
use Symfony\Component\Console\Style\SymfonyStyle;
|
||
|
use Symfony\Component\HttpKernel\Debug\FileLinkFormatter;
|
||
|
use Symfony\Component\Routing\RouteCollection;
|
||
|
use Symfony\Component\Routing\RouterInterface;
|
||
|
|
||
|
/**
|
||
|
* A console command for retrieving information about routes.
|
||
|
*
|
||
|
* @author Fabien Potencier <fabien@symfony.com>
|
||
|
* @author Tobias Schultze <http://tobion.de>
|
||
|
*
|
||
|
* @final
|
||
|
*/
|
||
|
class RouterDebugCommand extends Command
|
||
|
{
|
||
|
use BuildDebugContainerTrait;
|
||
|
|
||
|
protected static $defaultName = 'debug:router';
|
||
|
protected static $defaultDescription = 'Display current routes for an application';
|
||
|
private $router;
|
||
|
private $fileLinkFormatter;
|
||
|
|
||
|
public function __construct(RouterInterface $router, FileLinkFormatter $fileLinkFormatter = null)
|
||
|
{
|
||
|
parent::__construct();
|
||
|
|
||
|
$this->router = $router;
|
||
|
$this->fileLinkFormatter = $fileLinkFormatter;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* {@inheritdoc}
|
||
|
*/
|
||
|
protected function configure()
|
||
|
{
|
||
|
$this
|
||
|
->setDefinition([
|
||
|
new InputArgument('name', InputArgument::OPTIONAL, 'A route name'),
|
||
|
new InputOption('show-controllers', null, InputOption::VALUE_NONE, 'Show assigned controllers in overview'),
|
||
|
new InputOption('format', null, InputOption::VALUE_REQUIRED, 'The output format (txt, xml, json, or md)', 'txt'),
|
||
|
new InputOption('raw', null, InputOption::VALUE_NONE, 'To output raw route(s)'),
|
||
|
])
|
||
|
->setDescription(self::$defaultDescription)
|
||
|
->setHelp(<<<'EOF'
|
||
|
The <info>%command.name%</info> displays the configured routes:
|
||
|
|
||
|
<info>php %command.full_name%</info>
|
||
|
|
||
|
EOF
|
||
|
)
|
||
|
;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* {@inheritdoc}
|
||
|
*
|
||
|
* @throws InvalidArgumentException When route does not exist
|
||
|
*/
|
||
|
protected function execute(InputInterface $input, OutputInterface $output): int
|
||
|
{
|
||
|
$io = new SymfonyStyle($input, $output);
|
||
|
$name = $input->getArgument('name');
|
||
|
$helper = new DescriptorHelper($this->fileLinkFormatter);
|
||
|
$routes = $this->router->getRouteCollection();
|
||
|
$container = null;
|
||
|
if ($this->fileLinkFormatter) {
|
||
|
$container = function () {
|
||
|
return $this->getContainerBuilder($this->getApplication()->getKernel());
|
||
|
};
|
||
|
}
|
||
|
|
||
|
if ($name) {
|
||
|
if (!($route = $routes->get($name)) && $matchingRoutes = $this->findRouteNameContaining($name, $routes)) {
|
||
|
$default = 1 === \count($matchingRoutes) ? $matchingRoutes[0] : null;
|
||
|
$name = $io->choice('Select one of the matching routes', $matchingRoutes, $default);
|
||
|
$route = $routes->get($name);
|
||
|
}
|
||
|
|
||
|
if (!$route) {
|
||
|
throw new InvalidArgumentException(sprintf('The route "%s" does not exist.', $name));
|
||
|
}
|
||
|
|
||
|
$helper->describe($io, $route, [
|
||
|
'format' => $input->getOption('format'),
|
||
|
'raw_text' => $input->getOption('raw'),
|
||
|
'name' => $name,
|
||
|
'output' => $io,
|
||
|
'container' => $container,
|
||
|
]);
|
||
|
} else {
|
||
|
$helper->describe($io, $routes, [
|
||
|
'format' => $input->getOption('format'),
|
||
|
'raw_text' => $input->getOption('raw'),
|
||
|
'show_controllers' => $input->getOption('show-controllers'),
|
||
|
'output' => $io,
|
||
|
'container' => $container,
|
||
|
]);
|
||
|
}
|
||
|
|
||
|
return 0;
|
||
|
}
|
||
|
|
||
|
private function findRouteNameContaining(string $name, RouteCollection $routes): array
|
||
|
{
|
||
|
$foundRoutesNames = [];
|
||
|
foreach ($routes as $routeName => $route) {
|
||
|
if (false !== stripos($routeName, $name)) {
|
||
|
$foundRoutesNames[] = $routeName;
|
||
|
}
|
||
|
}
|
||
|
|
||
|
return $foundRoutesNames;
|
||
|
}
|
||
|
|
||
|
public function complete(CompletionInput $input, CompletionSuggestions $suggestions): void
|
||
|
{
|
||
|
if ($input->mustSuggestArgumentValuesFor('name')) {
|
||
|
$suggestions->suggestValues(array_keys($this->router->getRouteCollection()->all()));
|
||
|
|
||
|
return;
|
||
|
}
|
||
|
|
||
|
if ($input->mustSuggestOptionValuesFor('format')) {
|
||
|
$helper = new DescriptorHelper();
|
||
|
$suggestions->suggestValues($helper->getFormats());
|
||
|
}
|
||
|
}
|
||
|
}
|