From ad966a7b82c6ae4303ce3d4b2a1350d1f71faf0e Mon Sep 17 00:00:00 2001
From: Matthias Schmidt <matthias@mttsch.dev>
Date: Sun, 22 Jun 2025 12:38:08 +0200
Subject: [PATCH] [Routing] Document _query parameter for URL generation

Fix #21055
---
 routing.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/routing.rst b/routing.rst
index ffc7d168395..46215fe1881 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1151,6 +1151,17 @@ special parameters created by Symfony:
     This is used for such things as setting the ``Content-Type`` of the response
     (e.g. a ``json`` format translates into a ``Content-Type`` of ``application/json``).
 
+``_query``
+    Used to add query parameters to the generated URL.
+
+    .. versionadded:: 7.4
+
+        The ``_query`` parameter was introduced in Symfony 7.4.
+
+    .. deprecated:: 7.4
+
+        Passing a value other than an array as the ``_query`` parameter was deprecated in Symfony 7.4.
+
 ``_fragment``
     Used to set the fragment identifier, which is the optional last part of a URL that
     starts with a ``#`` character and is used to identify a portion of a document.