Skip to main content
Drupal API
User account menu
  • Log in

Breadcrumb

  1. Drupal Core 11.1.x
  2. Profiler.php

class Profiler

Profiler.

@author Fabien Potencier <fabien@symfony.com>

Hierarchy

  • class \Symfony\Component\HttpKernel\Profiler\Profiler implements \Symfony\Contracts\Service\ResetInterface

Expanded class hierarchy of Profiler

1 file declares its use of Profiler
ProfilerListener.php in vendor/symfony/http-kernel/EventListener/ProfilerListener.php

File

vendor/symfony/http-kernel/Profiler/Profiler.php, line 27

Namespace

Symfony\Component\HttpKernel\Profiler
View source
class Profiler implements ResetInterface {
    
    /**
     * @var DataCollectorInterface[]
     */
    private array $collectors = [];
    private bool $initiallyEnabled = true;
    public function __construct(ProfilerStorageInterface $storage, ?LoggerInterface $logger = null, bool $enabled = true) {
        $this->initiallyEnabled = $enabled;
    }
    
    /**
     * Disables the profiler.
     */
    public function disable() : void {
        $this->enabled = false;
    }
    
    /**
     * Enables the profiler.
     */
    public function enable() : void {
        $this->enabled = true;
    }
    public function isEnabled() : bool {
        return $this->enabled;
    }
    
    /**
     * Loads the Profile for the given Response.
     */
    public function loadProfileFromResponse(Response $response) : ?Profile {
        if (!($token = $response->headers
            ->get('X-Debug-Token'))) {
            return null;
        }
        return $this->loadProfile($token);
    }
    
    /**
     * Loads the Profile for the given token.
     */
    public function loadProfile(string $token) : ?Profile {
        return $this->storage
            ->read($token);
    }
    
    /**
     * Saves a Profile.
     */
    public function saveProfile(Profile $profile) : bool {
        // late collect
        foreach ($profile->getCollectors() as $collector) {
            if ($collector instanceof LateDataCollectorInterface) {
                $collector->lateCollect();
            }
        }
        if (!($ret = $this->storage
            ->write($profile)) && null !== $this->logger) {
            $this->logger
                ->warning('Unable to store the profiler information.', [
                'configured_storage' => $this->storage::class,
            ]);
        }
        return $ret;
    }
    
    /**
     * Purges all data from the storage.
     */
    public function purge() : void {
        $this->storage
            ->purge();
    }
    
    /**
     * Finds profiler tokens for the given criteria.
     *
     * @param int|null      $limit  The maximum number of tokens to return
     * @param string|null   $start  The start date to search from
     * @param string|null   $end    The end date to search to
     * @param \Closure|null $filter A filter to apply on the list of tokens
     *
     * @see https://php.net/datetime.formats for the supported date/time formats
     */
    public function find(?string $ip, ?string $url, ?int $limit, ?string $method, ?string $start, ?string $end, ?string $statusCode = null, ?\Closure $filter = null) : array {
        return $this->storage
            ->find($ip, $url, $limit, $method, $this->getTimestamp($start), $this->getTimestamp($end), $statusCode, $filter);
    }
    
    /**
     * Collects data for the given Response.
     */
    public function collect(Request $request, Response $response, ?\Throwable $exception = null) : ?Profile {
        if (false === $this->enabled) {
            return null;
        }
        $profile = new Profile(bin2hex(random_bytes(3)));
        $profile->setTime(time());
        $profile->setUrl($request->getUri());
        $profile->setMethod($request->getMethod());
        $profile->setStatusCode($response->getStatusCode());
        try {
            $profile->setIp($request->getClientIp());
        } catch (ConflictingHeadersException) {
            $profile->setIp('Unknown');
        }
        if ($request->attributes
            ->has('_virtual_type')) {
            $profile->setVirtualType($request->attributes
                ->get('_virtual_type'));
        }
        if ($prevToken = $response->headers
            ->get('X-Debug-Token')) {
            $response->headers
                ->set('X-Previous-Debug-Token', $prevToken);
        }
        $response->headers
            ->set('X-Debug-Token', $profile->getToken());
        foreach ($this->collectors as $collector) {
            $collector->collect($request, $response, $exception);
            // we need to clone for sub-requests
            $profile->addCollector(clone $collector);
        }
        return $profile;
    }
    public function reset() : void {
        foreach ($this->collectors as $collector) {
            $collector->reset();
        }
        $this->enabled = $this->initiallyEnabled;
    }
    
    /**
     * Gets the Collectors associated with this profiler.
     */
    public function all() : array {
        return $this->collectors;
    }
    
    /**
     * Sets the Collectors associated with this profiler.
     *
     * @param DataCollectorInterface[] $collectors An array of collectors
     */
    public function set(array $collectors = []) : void {
        $this->collectors = [];
        foreach ($collectors as $collector) {
            $this->add($collector);
        }
    }
    
    /**
     * Adds a Collector.
     */
    public function add(DataCollectorInterface $collector) : void {
        $this->collectors[$collector->getName()] = $collector;
    }
    
    /**
     * Returns true if a Collector for the given name exists.
     *
     * @param string $name A collector name
     */
    public function has(string $name) : bool {
        return isset($this->collectors[$name]);
    }
    
    /**
     * Gets a Collector by name.
     *
     * @param string $name A collector name
     *
     * @throws \InvalidArgumentException if the collector does not exist
     */
    public function get(string $name) : DataCollectorInterface {
        if (!isset($this->collectors[$name])) {
            throw new \InvalidArgumentException(\sprintf('Collector "%s" does not exist.', $name));
        }
        return $this->collectors[$name];
    }
    private function getTimestamp(?string $value) : ?int {
        if (null === $value || '' === $value) {
            return null;
        }
        try {
            $value = new \DateTimeImmutable(is_numeric($value) ? '@' . $value : $value);
        } catch (\Exception) {
            return null;
        }
        return $value->getTimestamp();
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title
Profiler::$collectors private property
Profiler::$initiallyEnabled private property
Profiler::add public function Adds a Collector.
Profiler::all public function Gets the Collectors associated with this profiler.
Profiler::collect public function Collects data for the given Response.
Profiler::disable public function Disables the profiler.
Profiler::enable public function Enables the profiler.
Profiler::find public function Finds profiler tokens for the given criteria.
Profiler::get public function Gets a Collector by name.
Profiler::getTimestamp private function
Profiler::has public function Returns true if a Collector for the given name exists.
Profiler::isEnabled public function
Profiler::loadProfile public function Loads the Profile for the given token.
Profiler::loadProfileFromResponse public function Loads the Profile for the given Response.
Profiler::purge public function Purges all data from the storage.
Profiler::reset public function Overrides ResetInterface::reset
Profiler::saveProfile public function Saves a Profile.
Profiler::set public function Sets the Collectors associated with this profiler.
Profiler::__construct public function
RSS feed
Powered by Drupal