Skip to content
PHP Ecosystem
Explore

ProfilingCollector

API reference › Debug › collectors › ProfilingCollector

classyii\debug\collectors\ProfilingCollector
ExtendsCollector
ImplementsCollectorInterface
Sourcesrc/collectors/ProfilingCollector.php

Captures profile-level log messages emitted by Yii::beginProfile() for the Profiling panel.

PropertyTypeDescriptionDefined by
$moduleyii\debug\Module|nullDebug module supplying the log target and sibling collectors, assigned by the module on registration. Default: null.Collector
MethodDescriptionDefined by
capture() finalEncodes the typed snapshot built by the subclass into the payload persisted for the panel.Collector
id()Returns the stable ID pairing this collector with the Profiling panel.ProfilingCollector
instrument()Installs low-level instrumentation as soon as the module registers the collector, before the panels are built.Collector
shutdown() finalDeactivates the collector once, releasing any subscription created by start().Collector
startup() finalActivates the collector once at the start of the request lifecycle.Collector
getLogMessages() protectedReturns the accumulated log messages, optionally filtered by level, category, and exclusion lists.Collector
getLogTarget() protectedReturns the initialized log target of the owning debug module.Collector
isStarted() protectedReturns whether the collector is active for the current request.Collector
snapshot() protectedSnapshots the captured profile messages, the peak memory usage, and the total request time.ProfilingCollector
start() protectedHook invoked once when the collector activates; subclasses subscribe to framework events here.Collector
stop() protectedHook invoked once when the collector deactivates; subclasses detach subscriptions and clear state here.Collector
public function id(): string

Returns the stable ID pairing this collector with the Profiling panel.

Returns

string: Stable collector ID.

protected function snapshot(): PHPForge\Debug\Panel\Profile\ProfilingSnapshot|null

Snapshots the captured profile messages, the peak memory usage, and the total request time.

Returns

PHPForge\Debug\Panel\Profile\ProfilingSnapshot|null: Captured profiling payload; null when the collector never started.