20ecf91d52
This PR was merged into the 3.4 branch.
Discussion
----------
[Routing] Add PHP fluent DSL for configuring routes
| Q | A
| ------------- | ---
| Branch? | 3.4
| Bug fix? | no
| New feature? | yes
| BC breaks? | no
| Deprecations? | no
| Tests pass? | yes
| Fixed tickets | -
| License | MIT
| Doc PR | -
If we add a PHP DSL for DI config (#23834), we must have a similar one for routing. Here it is. See fixtures.
So, you always start with a `RoutingConfigurator $routes`, which allows you to:
```php
$routes->add($name, $path); // adds a route
$routes->import($resource, $type = null, $ignoreErrors = false); // imports routes
$routes->collection($name = ''); // starts a collection, all *names* might be prefixed
```
then
- for "import" and "collection", you can `->prefix($path)`;
- for "add" and "collection", you can fluently "add" several times;
- for "collection" you add sub"`->collection()`";
- and on all, you can configure the route(s) with:
```php
->defaults(array $defaults)
->requirements(array $requirements)
->options(array $options)
->condition($condition)
->host($pattern)
->schemes(array $schemes)
->methods(array $methods)
->controller($controller)
```
Commits
-------
|
||
|---|---|---|
| .. | ||
| Annotation | ||
| DependencyInjection | ||
| Exception | ||
| Generator | ||
| Loader | ||
| Matcher | ||
| Tests | ||
| .gitignore | ||
| CHANGELOG.md | ||
| CompiledRoute.php | ||
| composer.json | ||
| LICENSE | ||
| phpunit.xml.dist | ||
| README.md | ||
| RequestContext.php | ||
| RequestContextAwareInterface.php | ||
| Route.php | ||
| RouteCollection.php | ||
| RouteCollectionBuilder.php | ||
| RouteCompiler.php | ||
| RouteCompilerInterface.php | ||
| Router.php | ||
| RouterInterface.php | ||
Routing Component
The Routing component maps an HTTP request to a set of configuration variables.