Path-to-RegExp
Turn an Express-style path string such as /user/:name into a regular expression.
This is a PHP port of the JS library component/path-to-regexp pillarjs/path-to-regexp without the support of JS native regexp (couldn't check the usage of the path).
Usage
require_once "PathToRegexp.php";
PathToRegexp::convert($path, $keys, $options);- path A string in the express format, an array of strings, or a regular expression.
- keys An array to be populated with the keys present in the url.
- options
- options.sensitive When set to
truethe route will be case sensitive. - options.strict When set to
truea slash is allowed to be trailing the path. - options.end When set to
falsethe path will match at the beginning.
- options.sensitive When set to
$keys = [];
$re = PathToRegexp::convert('/foo/:bar', $keys);
// $re = '/^\/foo\/([^\/]+?)\/?$/i'
// $keys = array(array("name" => 'bar', "delimiter" => '/', "repeat" => false, "optional" => false))Parameters
The path has the ability to define parameters and automatically populate the keys array.
Named Parameters
Named parameters are defined by prefixing a colon to the parameter name (:foo). By default, this parameter will match up to the next path segment.
$re = PathToRegexp::convert('/:foo/:bar', $keys);
// $keys = array(array("name" => 'foo', ... ), array("name" => 'bar', ... ))
$matches = PathToRegexp::match($re, '/test/route');
// $matches = array('/test/route', 'test', 'route')Suffixed Parameters
Optional
Parameters can be suffixed with a question mark (?) to make the entire parameter optional. This will also make any prefixed path delimiter optional (/ or .).
$re = PathToRegexp::convert('/:foo/:bar?', $keys);
// $keys = array(array("name" => 'foo', ... ), array("name" => 'bar', "delimiter" => '/', "optional" => true, "repeat" => false ))
$matches = PathToRegexp::match($re, '/test');
// $matches = array('/test', 'test', null)
$matches = PathToRegexp::match($re, '/test/route');
// $matches = array('/test', 'test', 'route')Zero or more
Parameters can be suffixed with an asterisk (*) to denote a zero or more parameter match. The prefixed path delimiter is also taken into account for the match.
$re = PathToRegexp::convert('/:foo*', $keys);
// $keys = array(array("name" => 'foo', "delimiter" => '/', "optional" => true, "repeat" => true))
$matches = PathToRegexp::match($re, '/');
// $matches = array('/', null)
$matches = PathToRegexp::match($re, '/bar/baz');
// $matches = array('/bar/baz', 'bar/baz')One or more
Parameters can be suffixed with a plus sign (+) to denote a one or more parameters match. The prefixed path delimiter is included in the match.
$re = PathToRegexp::convert('/:foo+', $keys);
// $keys = array(array("name" => 'foo', "delimiter" => '/', "optional" => false, "repeat" => true))
$matches = PathToRegexp::match($re, '/');
// $matches = null
$matches = PathToRegexp::match($re, '/bar/baz');
// $matches = array('/bar/baz', 'bar/baz')Custom Match Parameters
All parameters can be provided a custom matching regexp and override the default. Please note: Backslashes need to be escaped in strings.
$re = PathToRegexp::convert('/:foo(\\d+)', $keys);
// $keys = array(array("name" => 'foo', ... ))
$matches = PathToRegexp::match($re, '/123');
// $matches = array('/123', '123')
$matches = PathToRegexp::match($re, '/abc');
// $matches = nullUnnamed Parameters
It is possible to write an unnamed parameter that is only a matching group. It works the same as a named parameter, except it will be numerically indexed.
$re = PathToRegexp::convert('/:foo/(.*)', $keys);
// $keys = array(array("name" => 'foo', ... ), array("name": '0', ... ))
$matches = PathToRegexp::match($re, '/test/route');
// $matches = array('/test/route', 'test', 'route')License
MIT