From 8daccd39555d4db035625b0c4e25f55059efb929 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 9 Apr 2021 16:52:54 +0200
Subject: [PATCH] [HttpFoundation] Document the unix_socket and charset options
 for MySQL PdoSessionHandler

---
 session/database.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/session/database.rst b/session/database.rst
index 01c663911e1..dffed5562e7 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -234,6 +234,16 @@ first register a new handler service with your database credentials:
             ;
         };
 
+.. tip::
+
+    When using MySQL as the database, the DSN defined in ``DATABASE_URL`` can
+    contain the ``charset`` and ``unix_socket`` options as query string parameters.
+
+    .. versionadded:: 5.3
+
+        The support for ``charset`` and ``unix_socket`` options was introduced
+        in Symfony 5.3.
+
 Next, use the :ref:`handler_id <config-framework-session-handler-id>`
 configuration option to tell Symfony to use this service as the session handler: