minor #10785 [Router] Marking variable as important (zavulon)

javiereguiluz · javiereguiluz · commit 06b8e9b457a8 · 2019-01-02T10:34:13.000+01:00
This PR was merged into the master branch. Discussion ---------- [Router] Marking variable as important symfony/symfony#29599 Commits ------- 34f5dfa [Router] Marking variable as important
diff --git a/routing.rst b/routing.rst
@@ -531,6 +531,18 @@ So how can you make ``blog_list`` once again match when the user visits
 Now, when the user visits ``/blog``, the ``blog_list`` route will match and
 ``$page`` will default to a value of ``1``.
 
+If you want to always include some default value in the generated URL (for
+example to force the generation of ``/blog/1`` instead of ``/blog`` in the
+previous example) add the ``!`` character before the placeholder: ``/blog/{!page}``
+
+.. versionadded:: 4.3
+    The feature to force the inclusion of default values in generated URLs was
+    introduced in Symfony 4.3.
+
+When you generate URL for path ``blog_list`` without adding ``page`` parameter Router
+will generate ``/blog/``. Note that it doesn't use default value ``1``. To generate
+``/blog/1`` mark variable as important adding ``!`` before the name: ``/blog/{!page}``.
+
 As it happens with requirements, default values can also be inlined in each
 placeholder using the syntax ``{placeholder_name?default_value}``. This feature
 is compatible with inlined requirements, so you can inline both in a single
