From 805257e828208c9d42ad5bed728311156f164863 Mon Sep 17 00:00:00 2001 From: Drak Date: Sat, 28 Sep 2013 07:52:55 +0100 Subject: [PATCH 1/2] Add note about PHP 5.3 behaviour and proxies. --- components/http_foundation/session_configuration.rst | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/components/http_foundation/session_configuration.rst b/components/http_foundation/session_configuration.rst index 187f5d52c03..e9b38e638dc 100644 --- a/components/http_foundation/session_configuration.rst +++ b/components/http_foundation/session_configuration.rst @@ -252,12 +252,18 @@ using the `Native*SessionHandler` classes, while :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\SessionHandlerProxy` will be used to wrap any custom save handlers, that implement :phpclass:`SessionHandlerInterface`. -Under PHP 5.4 and above, all session handlers implement :phpclass:`SessionHandlerInterface` +From PHP 5.4 and above, all session handlers implement :phpclass:`SessionHandlerInterface` including `Native*SessionHandler` classes which inherit from :phpclass:`SessionHandler`. The proxy mechanism allows you to get more deeply involved in session save handler classes. A proxy for example could be used to encrypt any session transaction without knowledge of the specific save handler. +.. note:: + + Under PHP 5.3, you cannot proxy the session handler interface for native PHP handlers, + only user handlers so if you write proxies, be aware they will only work for user-land + session save handlers. + .. _`php.net/session.customhandler`: http://php.net/session.customhandler .. _`php.net/session.configuration`: http://php.net/session.configuration From 70db62bc97e81ce59e431637d2dfc3742eae4c0c Mon Sep 17 00:00:00 2001 From: Drak Date: Mon, 30 Sep 2013 13:07:15 +0100 Subject: [PATCH 2/2] Better wording. --- components/http_foundation/session_configuration.rst | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/components/http_foundation/session_configuration.rst b/components/http_foundation/session_configuration.rst index e9b38e638dc..e0a7b4c7ff4 100644 --- a/components/http_foundation/session_configuration.rst +++ b/components/http_foundation/session_configuration.rst @@ -261,9 +261,8 @@ without knowledge of the specific save handler. .. note:: - Under PHP 5.3, you cannot proxy the session handler interface for native PHP handlers, - only user handlers so if you write proxies, be aware they will only work for user-land - session save handlers. + Before PHP 5.4, you can only proxy user-land save handlers but not + native PHP save handlers. .. _`php.net/session.customhandler`: http://php.net/session.customhandler .. _`php.net/session.configuration`: http://php.net/session.configuration