PathRouter Class Reference

PathRouter class. More...

Public Member Functions
	add ( $path, $params=[], $options=[])
	Add a new path pattern to the path router.
	addStrict ( $path, $params=[], $options=[])
	Add a new path pattern to the path router with the strict option on.
	parse ( $path)
	Parse a path and return the query matches for the path.
	validateRoute ( $path, $varName)

Static Public Member Functions
static	getActionPaths (array $actionPaths, $articlePath)

Protected Member Functions
	doAdd ( $path, $params, $options, $key=null)
	Protected helper to do the actual bulk work of adding a single pattern.
	internalParse ( $path)
	Match a path against each defined pattern.
	sortByWeight ()
	Protected helper to re-sort our patterns so that the most specific (most heavily weighted) patterns are at the start of the array.

Static Protected Member Functions
static	expandParamValue ( $pathMatches, $key, $value)
	Replace $key etc.
static	extractTitle ( $path, $pattern)
static	makeWeight ( $pattern)

Detailed Description

PathRouter class.

This class can take patterns such as /wiki/$1 and use them to parse query parameters out of REQUEST_URI paths.

$router->add( "/wiki/$1" );

• Matches /wiki/Foo style urls and extracts the title $router->add( [ 'edit' => "/edit/$key" ], [ 'action' => '$key' ] );
• Matches /edit/Foo style urls and sets action=edit $router->add( '/$2/$1', [ 'variant' => '$2' ], [ '$2' => [ 'zh-hant', 'zh-hans' ] ] );
• Matches /zh-hant/Foo or /zh-hans/Foo $router->addStrict( "/foo/Bar", [ 'title' => 'Baz' ] );
• Matches /foo/Bar explicitly and uses "Baz" as the title $router->add( '/help/$1', [ 'title' => 'Help:$1' ] );
• Matches /help/Foo with "Help:Foo" as the title $router->add( '/$1', [ 'foo' => [ 'value' => 'bar$2' ] ] );
• Matches /Foo and sets 'foo' to 'bar$2' without $2 being replaced $router->add( '/$1', [ 'data:foo' => 'bar' ], [ 'callback' => 'functionname' ] );
• Matches /Foo, adds the key 'foo' with the value 'bar' to the data array and calls functionname( &$matches, $data );

Path patterns:

• Paths may contain $# patterns such as $1, $2, etc...
• $1 will match 0 or more while the rest will match 1 or more
• Unless you use addStrict "/wiki" and "/wiki/" will be expanded to "/wiki/$1"

Params:

• In a pattern $1, $2, etc... will be replaced with the relevant contents
• If you used a keyed array as a path pattern, $key will be replaced with the relevant contents
• The default behavior is equivalent to ‘[ 'title’ => '$1' ], if you don't want the title parameter you can explicitly use[ 'title' => false ]
• You can specify a value that won't have replacements in it using'foo' => [ 'value' => 'bar' ];`

Options:

• The option keys $1, $2, etc... can be specified to restrict the possible values of that variable. A string can be used for a single value, or an array for multiple.
• When the option key 'strict' is set (Using addStrict is simpler than doing this directly) the path won't have $1 implicitly added to it.
• The option key 'callback' can specify a callback that will be run when a path is matched. The callback will have the arguments ( &$matches, $data ) and the matches array can be modified.

Since

1.19

Author

Daniel Friesen

Definition at line 73 of file PathRouter.php.

Member Function Documentation

add()

PathRouter::add	(		$path,
			$params = [],
			$options = [] )

Add a new path pattern to the path router.

Parameters

string | array	$path	The path pattern to add
array	$params	The params for this path pattern
array	$options	The options for this path pattern

Definition at line 158 of file PathRouter.php.

References $path, and doAdd().

Referenced by addStrict(), and WebRequest\getPathInfo().

addStrict()

PathRouter::addStrict	(		$path,
			$params = [],
			$options = [] )

Add a new path pattern to the path router with the strict option on.

See also

self::add

Parameters

string | array	$path
array	$params
array	$options

Definition at line 194 of file PathRouter.php.

References $path, and add().

doAdd()

PathRouter::doAdd ( $path, $params, $options, $key = null )

protected

Protected helper to do the actual bulk work of adding a single pattern.

This is in a separate method so that add() can handle the difference between a single string $path and an array $path that contains multiple path patterns each with an associated $key to pass on.

Parameters

string	$path
array	$params
array	$options
null | string	$key

Definition at line 90 of file PathRouter.php.

References $path.

Referenced by add().

expandParamValue()

static PathRouter::expandParamValue ( $pathMatches, $key, $value )

staticprotected

Replace $key etc.

in param values with the matched strings from the path.

Parameters

array	$pathMatches	The match results from the path
string | null	$key	The key of the matching pattern
string	$value	The param value to be expanded

Returns

string|false

Definition at line 392 of file PathRouter.php.

extractTitle()

static PathRouter::extractTitle ( $path, $pattern )

staticprotected

Parameters

string	$path
stdClass	$pattern

Returns

array|null

Definition at line 298 of file PathRouter.php.

References $matches, and $path.

getActionPaths()

static PathRouter::getActionPaths ( array $actionPaths, $articlePath )

static

Access: internal

For use by Title and WebRequest only.

Parameters

array	$actionPaths
string	$articlePath

Returns

string[]|false

Definition at line 430 of file PathRouter.php.

internalParse()

PathRouter::internalParse ( $path )

protected

Match a path against each defined pattern.

Parameters

string

$path

Returns

array|null

Definition at line 281 of file PathRouter.php.

References $matches, and $path.

Referenced by parse().

makeWeight()

static PathRouter::makeWeight ( $pattern )

staticprotected

Parameters

stdClass

$pattern

Returns

float|int

Definition at line 215 of file PathRouter.php.

References $path.

parse()

PathRouter::parse

(

$path

)

Parse a path and return the query matches for the path.

Parameters

string

$path

The path to parse

Returns

array The array of matches for the path

Definition at line 255 of file PathRouter.php.

References $matches, $path, internalParse(), sortByWeight(), and wfRemoveDotSegments().

sortByWeight()

PathRouter::sortByWeight ( )

protected

Protected helper to re-sort our patterns so that the most specific (most heavily weighted) patterns are at the start of the array.

Definition at line 203 of file PathRouter.php.

Referenced by parse().

validateRoute()

PathRouter::validateRoute	(		$path,
			$varName )

Access: internal

For use by WebRequest::getPathInfo

Parameters

string	$path	To be given to add()
string	$varName	Full name of configuration variable for use in error message and url to mediawiki.org Manual (e.g. "wgExample").

Exceptions

FatalError

If path is invalid

Definition at line 175 of file PathRouter.php.

References $path.

---

The documentation for this class was generated from the following file:

• includes/PathRouter.php