Files
prestashop/vendor/friendsofsymfony/jsrouting-bundle/Command/RouterDebugExposedCommand.php
2026-04-09 18:31:51 +02:00

124 lines
4.4 KiB
PHP

<?php
declare(strict_types=1);
/*
* This file is part of the FOSJsRoutingBundle package.
*
* (c) FriendsOfSymfony <http://friendsofsymfony.github.com/>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace FOS\JsRoutingBundle\Command;
use FOS\JsRoutingBundle\Extractor\ExposedRoutesExtractorInterface;
use Symfony\Bundle\FrameworkBundle\Console\Helper\DescriptorHelper;
use Symfony\Component\Console\Attribute\AsCommand;
use Symfony\Component\Console\Command\Command;
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\Routing\Route;
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\Routing\RouterInterface;
/**
* A console command for retrieving information about exposed routes.
*
* @author William DURAND <william.durand1@gmail.com>
*/
#[AsCommand('fos:js-routing:debug', 'Displays currently exposed routes for an application')]
class RouterDebugExposedCommand extends Command
{
public function __construct(private ExposedRoutesExtractorInterface $extractor, private RouterInterface $router)
{
parent::__construct();
}
/**
* {@inheritdoc}
*/
protected function configure(): void
{
$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)'),
new InputOption('domain', null, InputOption::VALUE_OPTIONAL | InputOption::VALUE_IS_ARRAY, 'Specify expose domain', []),
])
->setName('fos:js-routing:debug')
->setDescription('Displays currently exposed routes for an application')
->setHelp(<<<EOF
The <info>fos:js-routing:debug</info> command displays an application's routes which will be available via JavaScript.
<info>php app/console fos:js-routing:debug</info>
You can alternatively specify a route name as an argument to get more info about that specific route:
<info>php app/console fos:js-routing:debug my_route</info>
EOF
)
;
}
protected function execute(InputInterface $input, OutputInterface $output): int
{
if ($name = $input->getArgument('name')) {
/** @var Route $route */
$route = $this->router->getRouteCollection()->get($name);
if (!$route) {
throw new \InvalidArgumentException(sprintf('The route "%s" does not exist.', $name));
}
if (!$this->extractor->isRouteExposed($route, $name)) {
throw new \InvalidArgumentException(sprintf('The route "%s" was found, but it is not an exposed route.', $name));
}
$helper = new DescriptorHelper();
$helper->describe($output, $route, [
'format' => $input->getOption('format'),
'raw_text' => $input->getOption('raw'),
'show_controllers' => $input->getOption('show-controllers'),
]);
} else {
$helper = new DescriptorHelper();
$helper->describe($output, $this->getRoutes($input->getOption('domain')), [
'format' => $input->getOption('format'),
'raw_text' => $input->getOption('raw'),
'show_controllers' => $input->getOption('show-controllers'),
]);
}
return 0;
}
protected function getRoutes($domain = []): RouteCollection
{
$routes = $this->extractor->getRoutes();
if (empty($domain)) {
return $routes;
}
$targetRoutes = new RouteCollection();
foreach ($routes as $name => $route) {
$expose = $route->getOption('expose');
$expose = is_string($expose) ? ('true' === $expose ? 'default' : $expose) : 'default';
if (in_array($expose, $domain, true)) {
$targetRoutes->add($name, $route);
}
}
return $targetRoutes;
}
}