102 lines
		
	
	
		
			3.3 KiB
		
	
	
	
		
			PHP
		
	
	
		
		
			
		
	
	
			102 lines
		
	
	
		
			3.3 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\Component\VarDumper\Command;
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								use Symfony\Component\Console\Command\Command;
							 | 
						||
| 
								 | 
							
								use Symfony\Component\Console\Exception\InvalidArgumentException;
							 | 
						||
| 
								 | 
							
								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\VarDumper\Cloner\Data;
							 | 
						||
| 
								 | 
							
								use Symfony\Component\VarDumper\Command\Descriptor\CliDescriptor;
							 | 
						||
| 
								 | 
							
								use Symfony\Component\VarDumper\Command\Descriptor\DumpDescriptorInterface;
							 | 
						||
| 
								 | 
							
								use Symfony\Component\VarDumper\Command\Descriptor\HtmlDescriptor;
							 | 
						||
| 
								 | 
							
								use Symfony\Component\VarDumper\Dumper\CliDumper;
							 | 
						||
| 
								 | 
							
								use Symfony\Component\VarDumper\Dumper\HtmlDumper;
							 | 
						||
| 
								 | 
							
								use Symfony\Component\VarDumper\Server\DumpServer;
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								/**
							 | 
						||
| 
								 | 
							
								 * Starts a dump server to collect and output dumps on a single place with multiple formats support.
							 | 
						||
| 
								 | 
							
								 *
							 | 
						||
| 
								 | 
							
								 * @author Maxime Steinhausser <maxime.steinhausser@gmail.com>
							 | 
						||
| 
								 | 
							
								 *
							 | 
						||
| 
								 | 
							
								 * @final
							 | 
						||
| 
								 | 
							
								 */
							 | 
						||
| 
								 | 
							
								class ServerDumpCommand extends Command
							 | 
						||
| 
								 | 
							
								{
							 | 
						||
| 
								 | 
							
								    protected static $defaultName = 'server:dump';
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								    private $server;
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								    /** @var DumpDescriptorInterface[] */
							 | 
						||
| 
								 | 
							
								    private $descriptors;
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								    public function __construct(DumpServer $server, array $descriptors = [])
							 | 
						||
| 
								 | 
							
								    {
							 | 
						||
| 
								 | 
							
								        $this->server = $server;
							 | 
						||
| 
								 | 
							
								        $this->descriptors = $descriptors + [
							 | 
						||
| 
								 | 
							
								            'cli' => new CliDescriptor(new CliDumper()),
							 | 
						||
| 
								 | 
							
								            'html' => new HtmlDescriptor(new HtmlDumper()),
							 | 
						||
| 
								 | 
							
								        ];
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								        parent::__construct();
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								    protected function configure()
							 | 
						||
| 
								 | 
							
								    {
							 | 
						||
| 
								 | 
							
								        $availableFormats = implode(', ', array_keys($this->descriptors));
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								        $this
							 | 
						||
| 
								 | 
							
								            ->addOption('format', null, InputOption::VALUE_REQUIRED, sprintf('The output format (%s)', $availableFormats), 'cli')
							 | 
						||
| 
								 | 
							
								            ->setDescription('Start a dump server that collects and displays dumps in a single place')
							 | 
						||
| 
								 | 
							
								            ->setHelp(<<<'EOF'
							 | 
						||
| 
								 | 
							
								<info>%command.name%</info> starts a dump server that collects and displays
							 | 
						||
| 
								 | 
							
								dumps in a single place for debugging you application:
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  <info>php %command.full_name%</info>
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								You can consult dumped data in HTML format in your browser by providing the <comment>--format=html</comment> option
							 | 
						||
| 
								 | 
							
								and redirecting the output to a file:
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  <info>php %command.full_name% --format="html" > dump.html</info>
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								EOF
							 | 
						||
| 
								 | 
							
								            )
							 | 
						||
| 
								 | 
							
								        ;
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								    protected function execute(InputInterface $input, OutputInterface $output): int
							 | 
						||
| 
								 | 
							
								    {
							 | 
						||
| 
								 | 
							
								        $io = new SymfonyStyle($input, $output);
							 | 
						||
| 
								 | 
							
								        $format = $input->getOption('format');
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								        if (!$descriptor = $this->descriptors[$format] ?? null) {
							 | 
						||
| 
								 | 
							
								            throw new InvalidArgumentException(sprintf('Unsupported format "%s".', $format));
							 | 
						||
| 
								 | 
							
								        }
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								        $errorIo = $io->getErrorStyle();
							 | 
						||
| 
								 | 
							
								        $errorIo->title('Symfony Var Dumper Server');
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								        $this->server->start();
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								        $errorIo->success(sprintf('Server listening on %s', $this->server->getHost()));
							 | 
						||
| 
								 | 
							
								        $errorIo->comment('Quit the server with CONTROL-C.');
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								        $this->server->listen(function (Data $data, array $context, int $clientId) use ($descriptor, $io) {
							 | 
						||
| 
								 | 
							
								            $descriptor->describe($io, $data, $context, $clientId);
							 | 
						||
| 
								 | 
							
								        });
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								        return 0;
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								}
							 |