This PR allows a route to be defined as "static generated".

A static generated route is dumped on a storage thanks to a Symfony command: static-site-generation:generate.
With a simple NGINX / Caddy configuration, the generated files could be served directly.
Example with Caddy :

{$SERVER_NAME:localhost} {
	root * /app/public
	encode zstd gzip

	{$CADDY_SERVER_EXTRA_DIRECTIVES}

	try_files {path} /static-pages{path}.html
	try_files {path} /static-pages{path}

	php_server
}

A good use case for this feature is a blog, where pages almost never change.
In that case, if the route is configured as static generated, Symfony won't even load, as the server serves the generate page directly (which implies a huge performance boost).

Similar implementations can be found in Tempest, Astro, and many other frameworks.

Here is an overview of the feature architecture:

StaticPageUrisProvider lists all Route marked as static, those can be defined as follows :

#[Route(name: 'app_sitemap', path: 'sitemap.xml', methods: ['GET'], format: 'xml', staticGeneration: true)]
public function __invoke(): Response
// ...

staticGeneration configuration can be :

• a boolean

#[Route(name: 'home', path: '/', staticGeneration: true)]

• a static array

#[Route(name: 'restaurant_detail', path: '/restaurant/{city}', staticGeneration: [['city' => 'lyon'], ['city' => 'hanoi']])]

• a service ID (tagged with routing.static_site.params_provider)

#[Route(name: 'product_detail', path: '/product/{slug}', staticGeneration: ProductSlugProvider::class)]

There are some extension points :

• StaticPageUrisProviderInterface to provide static page by another mean than symfony/routing. A third party CMS system for example.
• ParamsProviderInterface to resolve params of dynamic routes. For example, with a route /blog/{slug}. We can create a param providers to list all slugs from a database, or all Markdown files in a directory.
• StaticPageDumperInterface to dump the pages content on another storage. Can be useful if we need to dump it to an S3 storage, to GitHub pages, ...