SimpleEnhancer extends AbstractEnhancer implements RoutingEnhancerInterface, InflatableEnhancerInterface, ResultingInterface

This is usually used for simple GET arguments that have no namespace (e.g. not plugins).

routeEnhancers Categories: type: Simple routePath: '/cmd/{category_id}/{scope_id}' _arguments: category_id: 'category/id' scope_id: 'scope/id'

Table of Contents

Interfaces

RoutingEnhancerInterface
Interface for enhancers
InflatableEnhancerInterface
Interface asserting that enhancer is capable of inflating parameters.
ResultingInterface
Extend the Resulting Interface to explain that this route builds the page arguments itself, instead of having the PageRouter having to deal with that.

Properties

$aspects  : AspectInterface[]
$configuration  : array
$variableProcessor  : VariableProcessor|null

Methods

__construct()  : mixed
buildResult()  : PageArguments
enhanceForGeneration()  : void
Extends route collection with routes that are relevant for given parameters. Used during URL generation.
enhanceForMatching()  : void
Extends route collection with all routes. Used during URL resolving.
getAspects()  : AspectInterface[]
inflateParameters()  : array
setAspects()  : void
applyRequirements()  : mixed
applyRouteAspects()  : mixed
applyStaticVariables()  : void
Applies variables that are considered static (not having `&cHash=...` applied), without having the demand to define a custom `StaticMappableAspectInterface` to fake the behavior.
defineValuesByAspect()  : array
Define items having an aspect definition in case they are not defined with a given $targetValue in target $targetValue array.
filterValuesByPathVariables()  : array
Only keeps values that actually have been used as variables in route path.
getVariableProcessor()  : VariableProcessor
getVariant()  : Route
Builds a variant of a route based on the given configuration.
modifyRoutePath()  : string
Modify the route path to add the variable names with the aspects, e.g.
overrideValuesByAspect()  : array
Overrides items having an aspect definition with a given $overrideValue in target $targetValue array.
resolveType()  : string
Retrieves type from processed route and modifies remaining query parameters.

Properties

$configuration

protected array $configuration

Methods

__construct()

public __construct(array $configuration) : mixed
Parameters
$configuration : array

buildResult()

public buildResult(Route $route, array $results[, array $remainingQueryParameters = [] ]) : PageArguments
Parameters
$route : Route
$results : array
$remainingQueryParameters : array = []
Return values
PageArguments

enhanceForGeneration()

Extends route collection with routes that are relevant for given parameters. Used during URL generation.

public enhanceForGeneration(RouteCollection $collection, array $parameters) : void
Parameters
$collection : RouteCollection
$parameters : array

enhanceForMatching()

Extends route collection with all routes. Used during URL resolving.

public enhanceForMatching(RouteCollection $collection) : void
Parameters
$collection : RouteCollection

inflateParameters()

public inflateParameters(array $parameters[, array $internals = [] ]) : array
Parameters
$parameters : array
$internals : array = []
Return values
array

setAspects()

public setAspects(array $aspects) : void
Parameters
$aspects : array

applyRequirements()

protected applyRequirements(Route $route, array $requirements[, string|null $namespace = null ]) : mixed
Parameters
$route : Route
$requirements : array
$namespace : string|null = null

applyStaticVariables()

Applies variables that are considered static (not having `&cHash=...` applied), without having the demand to define a custom `StaticMappableAspectInterface` to fake the behavior.

protected applyStaticVariables(Route $route, array<non-empty-string, bool> $staticVariables[, string|null $namespace = null ]) : void

However:

  • in case there's an aspect defined for a variable, it will be skipped (aspects take precedence)
  • in case not requirement is defined for a variable, it will be skipped (avoiding weak definitions)
Parameters
$route : Route
$staticVariables : array<non-empty-string, bool>

option values

$namespace : string|null = null

defineValuesByAspect()

Define items having an aspect definition in case they are not defined with a given $targetValue in target $targetValue array.

protected defineValuesByAspect(Route $route, array $values, string $targetValue) : array
Parameters
$route : Route
$values : array
$targetValue : string
Return values
array

filterValuesByPathVariables()

Only keeps values that actually have been used as variables in route path.

protected filterValuesByPathVariables(Route $route, array $values) : array
  • routePath: '/list/{page}' ('page' used as variable in route path)
  • values: ['entity' => 'entity...', 'page' => 'page...', 'other' => 'other...']
  • result: ['page' => 'page...']
Parameters
$route : Route
$values : array
Return values
array

getVariant()

Builds a variant of a route based on the given configuration.

protected getVariant(Route $defaultPageRoute, array $configuration) : Route
Parameters
$defaultPageRoute : Route
$configuration : array
Return values
Route

modifyRoutePath()

Modify the route path to add the variable names with the aspects, e.g.

protected modifyRoutePath(string $routePath) : string
  • /{locale_modifier}/{product_title} -> /products/{product_title}
  • /{!locale_modifier}/{product_title} -> /products/{product_title}
Parameters
$routePath : string
Return values
string

overrideValuesByAspect()

Overrides items having an aspect definition with a given $overrideValue in target $targetValue array.

protected overrideValuesByAspect(Route $route, array $values, string $targetValue) : array
Parameters
$route : Route
$values : array
$targetValue : string
Return values
array

resolveType()

Retrieves type from processed route and modifies remaining query parameters.

protected resolveType(Route $route, array &$remainingQueryParameters) : string
Parameters
$route : Route
$remainingQueryParameters : array

reference to remaining query parameters

Return values
string
On this page

Search results