ActionRoutes

API reference › Debug › models › router › ActionRoutes

class	`yii\debug\models\router\ActionRoutes`
Extends	`yii\base\Model` » `yii\base\Component` » `yii\base\BaseObject`
Implements	`yii\base\StaticInstanceInterface`, `IteratorAggregate`, `ArrayAccess`, `yii\base\Arrayable`, `yii\base\Configurable`
Uses traits	`yii\base\ArrayableTrait`, `yii\base\StaticInstanceTrait`
Source	`src/models/router/ActionRoutes.php`

Discovers every controller action reachable from the running application and pairs it with its matching URL rule.

Walks the module tree starting from Yii::$app, reflects each controller to enumerate its action methods, and resolves the first creation-time URL rule that matches the resulting route.

Properties

Property	Type	Description	Defined by
`$activeValidators` read-only	`yii\validators\Validator[]`	The validators applicable to the current `$scenario`.	`yii\base\Model`
`$attributes`	`array<string, mixed>`	Attribute values (name => value).	`yii\base\Model`
`$behaviors` read-only	`array<yii\base\Behavior<static>>`	List of behaviors attached to this component.	`yii\base\Component`
`$errors` read-only	`array<string, string[]>`	Errors for all attributes.	`yii\base\Model`
`$firstErrors` read-only	`array<string, string>`	The first errors.	`yii\base\Model`
`$iterator` read-only	`ArrayIterator<string, mixed>`	An iterator for traversing the items in the list.	`yii\base\Model`
`$routes`	`array<string, array{route: string, rule: string\|null, count: int}>`	Discovered actions keyed by display name, each carrying its route, matched URL rule (or `null`), and the number of rules scanned. Default: `[]`.	`ActionRoutes`
`$scenario`	`string`	The scenario that this model is in.	`yii\base\Model`
`$validators` read-only	`ArrayObject<int,` `yii\validators\Validator>\|yii\validators\Validator[]`	All the validators declared in the model.	`yii\base\Model`

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\Model`
`__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`
`activeAttributes()`	Returns the attribute names that are subject to validation in the current scenario.	`yii\base\Model`
`addError()`	Adds a new error to the specified attribute.	`yii\base\Model`
`addErrors()`	Adds a list of errors.	`yii\base\Model`
`afterValidate()`	This method is invoked after validation ends.	`yii\base\Model`
`attachBehavior()`	Attaches a behavior to this component.	`yii\base\Component`
`attachBehaviors()`	Attaches a list of behaviors to the component.	`yii\base\Component`
`attributeHints()`	Returns the attribute hints.	`yii\base\Model`
`attributeLabels()`	Returns the attribute labels.	`yii\base\Model`
`attributes()`	Returns the list of attribute names.	`yii\base\Model`
`beforeValidate()`	This method is invoked before validation starts.	`yii\base\Model`
`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`
`className()` static	Returns the fully qualified name of this class.	`yii\base\BaseObject`
`clearErrors()`	Removes errors for all attributes or a single attribute.	`yii\base\Model`
`createValidators()`	Creates validator objects based on the validation rules specified in `rules()`.	`yii\base\Model`
`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`
`extraFields()`	Returns the list of fields that can be expanded further and returned by `toArray()`.	`yii\base\ArrayableTrait`
`fields()`	Returns the list of fields that should be returned by default by `toArray()` when no specific fields are specified.	`yii\base\Model`
`formName()`	Returns the form name that this model class should use.	`yii\base\Model`
`generateAttributeLabel()`	Generates a user friendly attribute label based on the give attribute name.	`yii\base\Model`
`getActiveValidators()`	Returns the validators applicable to the current `$scenario`.	`yii\base\Model`
`getAttributeHint()`	Returns the text hint for the specified attribute.	`yii\base\Model`
`getAttributeLabel()`	Returns the text label for the specified attribute.	`yii\base\Model`
`getAttributes()`	Returns attribute values.	`yii\base\Model`
`getBehavior()`	Returns the named behavior object.	`yii\base\Component`
`getBehaviors()`	Returns all behaviors attached to this component.	`yii\base\Component`
`getErrors()`	Returns the errors for all attributes or a single attribute.	`yii\base\Model`
`getErrorSummary()`	Returns the errors for all attributes as a one-dimensional array.	`yii\base\Model`
`getFirstError()`	Returns the first error of the specified attribute.	`yii\base\Model`
`getFirstErrors()`	Returns the first error of every attribute in the model.	`yii\base\Model`
`getIterator()`	Returns an iterator for traversing the attributes in the model.	`yii\base\Model`
`getScenario()`	Returns the scenario that this model is used in.	`yii\base\Model`
`getValidators()`	Returns all the validators declared in `rules()`.	`yii\base\Model`
`hasErrors()`	Returns a value indicating whether there is any validation error.	`yii\base\Model`
`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`
`init()`	Scans the application on construction so the view model is ready before the panel renders.	`ActionRoutes`
`instance()` static	Returns static class instance, which can be used to obtain meta information.	`yii\base\StaticInstanceTrait`
`isAttributeActive()`	Returns a value indicating whether the attribute is active in the current scenario.	`yii\base\Model`
`isAttributeRequired()`	Returns a value indicating whether the attribute is required.	`yii\base\Model`
`isAttributeSafe()`	Returns a value indicating whether the attribute is safe for massive assignments.	`yii\base\Model`
`load()`	Populates the model with input data.	`yii\base\Model`
`loadMultiple()` static	Populates a set of models with the data from end user.	`yii\base\Model`
`off()`	Detaches an existing event handler from this component.	`yii\base\Component`
`offsetExists()`	Returns whether there is an element at the specified offset.	`yii\base\Model`
`offsetGet()`	Returns the element at the specified offset.	`yii\base\Model`
`offsetSet()`	Sets the element at the specified offset.	`yii\base\Model`
`offsetUnset()`	Sets the element value at the specified offset to null.	`yii\base\Model`
`on()`	Attaches an event handler to an event.	`yii\base\Component`
`onUnsafeAttribute()`	This method is invoked when an unsafe attribute is being massively assigned.	`yii\base\Model`
`rules()`	Returns the validation rules for attributes.	`yii\base\Model`
`safeAttributes()`	Returns the attribute names that are safe to be massively assigned in the current scenario.	`yii\base\Model`
`scenarios()`	Returns a list of scenarios and the corresponding active attributes.	`yii\base\Model`
`setAttributes()`	Sets the attribute values in a massive way.	`yii\base\Model`
`setScenario()`	Sets the scenario for the model.	`yii\base\Model`
`toArray()`	Converts the model into an array.	`yii\base\ArrayableTrait`
`trigger()`	Triggers an event.	`yii\base\Component`
`validate()`	Performs the data validation.	`yii\base\Model`
`validateMultiple()` static	Validates multiple models.	`yii\base\Model`
`extractFieldsFor()` protected	Extract nested fields from a fields collection for a given root field Nested fields are separated with dots (.). e.g: “item.id” The previous example would extract “id”.	`yii\base\ArrayableTrait`
`extractRootFields()` protected	Extracts the root field names from nested fields.	`yii\base\ArrayableTrait`
`getActions()` protected	Returns the action method names declared on the given controller, plus a sentinel when it overrides `actions()`.	`ActionRoutes`
`getAppRoutes()` protected	Returns every web/REST controller reachable from the application, grouped by controller ID.	`ActionRoutes`
`getMatchedCreationRule()` protected	Returns the first URL rule name that successfully creates a URL for the given route.	`ActionRoutes`
`getModuleControllers()` protected	Returns every controller available in the given module (and recursively its child modules).	`ActionRoutes`
`resolveFields()` protected	Determines which fields can be returned by `toArray()`.	`yii\base\ArrayableTrait`
`validateControllerClass()` protected	Returns whether the given class is a concrete `yii\web\Controller` or `yii\rest\Controller` subclass.	`ActionRoutes`

Events

Event	Type	Description	Defined by
`EVENT_BEFORE_VALIDATE`	`yii\base\ModelEvent`	An event raised at the beginning of `validate()`. Event name: `'beforeValidate'`.	`yii\base\Model`
`EVENT_AFTER_VALIDATE`	`yii\base\Event`	An event raised at the end of `validate()` Event name: `'afterValidate'`.	`yii\base\Model`

Constants

Constant	Value	Description	Defined by
`SCENARIO_DEFAULT`	`'default'`	The name of the default scenario.	`yii\base\Model`

Method details

init()

public function init(): void

Scans the application on construction so the view model is ready before the panel renders.

getActions()

protected function getActions(ReflectionClass<yii\base\Controller> $controller): list<non-empty-string>

Returns the action method names declared on the given controller, plus a sentinel when it overrides actions().

Parameters

Parameter	Type	Description
`$controller`	`ReflectionClass<yii\base\Controller>`	Reflection over the target controller class.

Returns

list<non-empty-string>: Action method names (actionFoo), or __ACTIONS__ for controllers that declare external actions.

getAppRoutes()

protected function getAppRoutes(): array<string, array{class: class-string<yii\base\Controller>, actions: list<non-empty-string>}>

Returns every web/REST controller reachable from the application, grouped by controller ID.

Returns

array<string, array{class: class-string<yii\base\Controller>, actions: list<non-empty-string>}>: Controllers keyed by ID, each carrying its FQCN and the action method names it exposes.

Throws

ReflectionException: when a controller class fails to reflect.

getMatchedCreationRule()

protected function getMatchedCreationRule(string $route): array{0: string|null, 1: int}

Returns the first URL rule name that successfully creates a URL for the given route.

Parameters

Parameter	Type	Description
`$route`	`string`	Route to test against every configured URL rule.

Returns

array{0: string|null, 1: int}: Matching rule name (or null when no rule matches) and the number of rules actually scanned before deciding.

getModuleControllers()

protected function getModuleControllers(yii\base\Module $module): array<string, class-string<yii\base\Controller>>

Returns every controller available in the given module (and recursively its child modules).

Scans the module’s controller path for *Controller.php files and applies controllerMap overrides on top.

Parameters

Parameter	Type	Description
`$module`	`yii\base\Module`	Module to scan, including its child modules.

Returns

array<string, class-string<yii\base\Controller>>: Controller class names indexed by route prefix.

Throws

ReflectionException: when a controller class fails to reflect.

validateControllerClass()

protected function validateControllerClass(string $controllerClass): bool

Returns whether the given class is a concrete yii\web\Controller or yii\rest\Controller subclass.

Parameters

Parameter	Type	Description
`$controllerClass`	`string`	Fully qualified class name to validate.

Returns

bool: true when the class is loadable, non-abstract, and extends a web/REST controller, false otherwise.

Throws

ReflectionException: when reflection over the class fails.