QueuePanel

API reference › Debug › panels › QueuePanel

class	`yii\debug\panels\QueuePanel`
Extends	`yii\debug\Panel` » `yii\base\Component` » `yii\base\BaseObject`
Implements	`yii\base\ViewContextInterface`, `yii\base\Configurable`
Source	`src/panels/QueuePanel.php`

Renders the queue lifecycle events captured by the Queue collector.

Delegates the detail view to the framework-neutral QueuePanel, feeding it the per-job detail routes; data acquisition lives in QueueCollector.

Properties

Property	Type	Description	Defined by
`$actions`	`array<string, array<string, mixed>\|class-string>`	Standalone actions merged into the debug module’s `Module::$actionMap`, keyed by action ID. Default: `[]`.	`yii\debug\Panel`
`$behaviors` read-only	`array<yii\base\Behavior<static>>`	List of behaviors attached to this component.	`yii\base\Component`
`$detail` read-only	`string`	Rendered panel markup.	`QueuePanel`
`$id`	`string`	Panel unique identifier, assigned by the container module on registration. Default: `''`.	`yii\debug\Panel`
`$module`	`yii\debug\Module\|null`	Debug module owning this panel. Default: `null`.	`yii\debug\Panel`
`$name` read-only	`string`	Panel display name.	`QueuePanel`
`$records` read-only	`list<PHPForge\Debug\Panel\Queue\JobRecord>`	Captured job events in event order.	`QueuePanel`
`$renderContext`	`PHPForge\Debug\Panel\PanelRenderContext\|null`	Prepared render context, or `null` outside a debugger request.	`yii\debug\Panel`
`$tag`	`string`	Tag of the request whose data this panel currently exposes. Default: `''`.	`yii\debug\Panel`
`$toolbarData` read-only	`array<string, mixed>`	Toolbar envelope; `[]` to skip the panel.	`yii\debug\Panel`
`$toolbarIcon` read-only	`string`	Toolbar icon key.	`QueuePanel`
`$url` read-only	`string`	Absolute URL to the panel detail view.	`yii\debug\Panel`
`$viewPath` read-only	`string`	Directory the panel views resolve against.	`yii\debug\Panel`
`$error` protected	`PHPForge\Debug\Storage\ExceptionSnapshot\|null`	Exception captured when the panel failed to produce or hydrate its snapshot. Default: `null`.	`yii\debug\Panel`

Methods

Method	Description	Defined by
`__construct()`	Constructor.	`yii\base\BaseObject`
`__call()`	Calls the named method which is not a class method.	`yii\base\Component`
`__clone()`	This method is called after the object is created by cloning an existing one.	`yii\base\Component`
`__get()`	Returns the value of a component property.	`yii\base\Component`
`__isset()`	Checks if a property is set, i.e. defined and not null.	`yii\base\Component`
`__set()`	Sets the value of a component property.	`yii\base\Component`
`__unset()`	Sets a component property to be null.	`yii\base\Component`
`attachBehavior()`	Attaches a behavior to this component.	`yii\base\Component`
`attachBehaviors()`	Attaches a list of behaviors to the component.	`yii\base\Component`
`behaviors()`	Returns a list of behaviors that this component should behave as.	`yii\base\Component`
`canGetProperty()`	Returns a value indicating whether a property can be read.	`yii\base\Component`
`canSetProperty()`	Returns a value indicating whether a property can be set.	`yii\base\Component`
`capture()`	Captures the panel payload for the current request.	`yii\debug\Panel`
`className()` static	Returns the fully qualified name of this class.	`yii\base\BaseObject`
`detachBehavior()`	Detaches a behavior from the component.	`yii\base\Component`
`detachBehaviors()`	Detaches all behaviors from the component.	`yii\base\Component`
`ensureBehaviors()`	Makes sure that the behaviors declared in `behaviors()` are attached to this component.	`yii\base\Component`
`getBehavior()`	Returns the named behavior object.	`yii\base\Component`
`getBehaviors()`	Returns all behaviors attached to this component.	`yii\base\Component`
`getDetail()`	Renders the detail view through the shared declarative presenter.	`QueuePanel`
`getError()`	Returns the exception captured while collecting the panel payload, if any.	`yii\debug\Panel`
`getName()`	Returns the panel display name from the shared title enum.	`QueuePanel`
`getRecords()`	Returns the queue job records captured during the request.	`QueuePanel`
`getRenderContext()`	Returns the framework-neutral render context for the active debugger request, when one has been prepared.	`yii\debug\Panel`
`getToolbarData()`	Returns the toolbar envelope wrapping the panel’s icon, items, and URL.	`yii\debug\Panel`
`getToolbarIcon()`	Returns the icon key from the shared panel icon enum.	`QueuePanel`
`getTraceLine()`	Builds a trace line for the toolbar through the shared `Trace` renderer, applying `Module::$tracePathMappings` and the configured `Module::$traceLine` template (or callable).	`yii\debug\Panel`
`getUrl()`	Returns the URL pointing to this panel’s detail view for the current request tag.	`yii\debug\Panel`
`getViewPath()`	Returns the directory under which the panel’s relative views resolve.	`yii\debug\Panel`
`hasContent()`	Returns whether the panel captured content for the loaded request.	`yii\debug\Panel`
`hasError()`	Returns `true` when `setError()` captured an exception during panel capture or hydration.	`yii\debug\Panel`
`hasEventHandlers()`	Returns a value indicating whether there is any handler attached to the named event.	`yii\base\Component`
`hasMethod()`	Returns a value indicating whether a method is defined.	`yii\base\Component`
`hasProperty()`	Returns a value indicating whether a property is defined for this component.	`yii\base\Component`
`hydrate()`	Decodes the captured payload into the typed queue snapshot backing this panel.	`QueuePanel`
`init()`	Registers the `queue-job` action.	`QueuePanel`
`isEnabled()`	Indicates whether this panel is enabled and should be registered by the module.	`yii\debug\Panel`
`isVisible()`	Returns whether the panel should appear in the toolbar and sidebar navigation.	`yii\debug\Panel`
`moduleBound()`	Completes module-dependent wiring after the container module binds `$id` and `$module`.	`yii\debug\Panel`
`off()`	Detaches an existing event handler from this component.	`yii\base\Component`
`on()`	Attaches an event handler to an event.	`yii\base\Component`
`setError()`	Records an exception thrown during capture or hydration so `LogTarget` can surface it in the UI.	`yii\debug\Panel`
`setRenderContext()`	Installs the framework-neutral render context prepared for this panel by the debugger action.	`yii\debug\Panel`
`trigger()`	Triggers an event.	`yii\base\Component`
`getToolbarItems()` protected	Builds the toolbar items.	`QueuePanel`

Method details

getDetail()

public function getDetail(): string

Renders the detail view through the shared declarative presenter.

Returns

string: Rendered panel markup.

getName()

public function getName(): string

Returns the panel display name from the shared title enum.

Returns

string: Panel display name.

getRecords()

public function getRecords(): list<PHPForge\Debug\Panel\Queue\JobRecord>

Returns the queue job records captured during the request.

Returns

list<PHPForge\Debug\Panel\Queue\JobRecord>: Captured job events in event order.

getToolbarIcon()

public function getToolbarIcon(): string

Returns the icon key from the shared panel icon enum.

Returns

string: Toolbar icon key.

hydrate()

public function hydrate(array<string, mixed> $payload): void

Decodes the captured payload into the typed queue snapshot backing this panel.

Parameters

Parameter	Type	Description
`$payload`	`array<string, mixed>`	Captured panel payload.

Throws

PHPForge\Debug\Storage\HydrationException: when the payload does not match the snapshot schema.

init()

public function init(): void

Registers the queue-job action.

getToolbarItems()

protected function getToolbarItems(): array<int, array<string, mixed>>

Builds the toolbar items.

Hides the button when no queue events were captured, and surfaces an Errors chip in danger when at least one error event was captured.

Returns

array<int, array<string, mixed>>: Toolbar items, or [] when no events were captured.