Blame | Letzte Änderung | Log anzeigen | RSS feed
<?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;use Symfony\Component\HttpFoundation\Request;use Symfony\Component\HttpFoundation\RequestStack;use Symfony\Component\HttpKernel\Debug\FileLinkFormatter;use Symfony\Component\VarDumper\Caster\ReflectionCaster;use Symfony\Component\VarDumper\Cloner\VarCloner;use Symfony\Component\VarDumper\Dumper\CliDumper;use Symfony\Component\VarDumper\Dumper\ContextProvider\CliContextProvider;use Symfony\Component\VarDumper\Dumper\ContextProvider\RequestContextProvider;use Symfony\Component\VarDumper\Dumper\ContextProvider\SourceContextProvider;use Symfony\Component\VarDumper\Dumper\ContextualizedDumper;use Symfony\Component\VarDumper\Dumper\HtmlDumper;use Symfony\Component\VarDumper\Dumper\ServerDumper;// Load the global dump() functionrequire_once __DIR__.'/Resources/functions/dump.php';/*** @author Nicolas Grekas <p@tchwork.com>*/class VarDumper{/*** @var callable|null*/private static $handler;public static function dump(mixed $var){if (null === self::$handler) {self::register();}return (self::$handler)($var);}public static function setHandler(callable $callable = null): ?callable{if (1 > \func_num_args()) {trigger_deprecation('symfony/var-dumper', '6.2', 'Calling "%s()" without any arguments is deprecated, pass null explicitly instead.', __METHOD__);}$prevHandler = self::$handler;// Prevent replacing the handler with expected format as soon as the env var was set:if (isset($_SERVER['VAR_DUMPER_FORMAT'])) {return $prevHandler;}self::$handler = $callable;return $prevHandler;}private static function register(): void{$cloner = new VarCloner();$cloner->addCasters(ReflectionCaster::UNSET_CLOSURE_FILE_INFO);$format = $_SERVER['VAR_DUMPER_FORMAT'] ?? null;switch (true) {case 'html' === $format:$dumper = new HtmlDumper();break;case 'cli' === $format:$dumper = new CliDumper();break;case 'server' === $format:case $format && 'tcp' === parse_url($format, \PHP_URL_SCHEME):$host = 'server' === $format ? $_SERVER['VAR_DUMPER_SERVER'] ?? '127.0.0.1:9912' : $format;$dumper = \in_array(\PHP_SAPI, ['cli', 'phpdbg'], true) ? new CliDumper() : new HtmlDumper();$dumper = new ServerDumper($host, $dumper, self::getDefaultContextProviders());break;default:$dumper = \in_array(\PHP_SAPI, ['cli', 'phpdbg'], true) ? new CliDumper() : new HtmlDumper();}if (!$dumper instanceof ServerDumper) {$dumper = new ContextualizedDumper($dumper, [new SourceContextProvider()]);}self::$handler = function ($var) use ($cloner, $dumper) {$dumper->dump($cloner->cloneVar($var));};}private static function getDefaultContextProviders(): array{$contextProviders = [];if (!\in_array(\PHP_SAPI, ['cli', 'phpdbg'], true) && class_exists(Request::class)) {$requestStack = new RequestStack();$requestStack->push(Request::createFromGlobals());$contextProviders['request'] = new RequestContextProvider($requestStack);}$fileLinkFormatter = class_exists(FileLinkFormatter::class) ? new FileLinkFormatter(null, $requestStack ?? null) : null;return $contextProviders + ['cli' => new CliContextProvider(),'source' => new SourceContextProvider(null, null, $fileLinkFormatter),];}}