From 357a3e95c51192beb465e899114a1c161a12df22 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 7 Jan 2025 08:56:55 +0100
Subject: [PATCH] [HttpFoundation] Mention issues with generated URL hashes

---
 routing.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/routing.rst b/routing.rst
index 47fcfe8cb8f..a41b9bba6a6 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2805,6 +2805,12 @@ service, which you can inject in your services or controllers::
     ``Symfony\Component\HttpKernel\UriSigner`` to
     ``Symfony\Component\HttpFoundation\UriSigner``.
 
+.. note::
+
+    The generated URI hashes may include the ``/`` and ``+`` characters, which
+    can cause issues with certain clients. If you encounter this problem, replace
+    them using the following: ``strtr($hash, ['/' => '_', '+' => '-'])``.
+
 Troubleshooting
 ---------------