From f95e682b642155bfb4b328b0426670ff0d0ee807 Mon Sep 17 00:00:00 2001
From: Drak <drak@php.net>
Date: Sun, 4 Mar 2012 13:31:04 +0000
Subject: [PATCH] [sessions] Added note about SessionHandler behaviour.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@323861 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/session/sessionhandler.xml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/reference/session/sessionhandler.xml b/reference/session/sessionhandler.xml
index c47d7b310b..613809c036 100644
--- a/reference/session/sessionhandler.xml
+++ b/reference/session/sessionhandler.xml
@@ -133,6 +133,14 @@ session_start();
 ]]>
     </programlisting>
    </example>
+   <note>
+    <para>
+     Since this class' methods are designed to be called internally by PHP as part of the normal session workflow,
+     child class calls to parent methods (i.e. the actual internal native handlers) will return &false; unless
+     the session has actually been started (either automatically, or by explicit <function>session_start</function>.
+     This is important to consider when writing unit tests where the class methods might be invoked manually.
+    </para>
+   </note>
   </section>
 
  </partintro>