sessionhandlerinterface.read(3) [php man page]

SESSIONHANDLERINTERFACE.READ(3) 					 1					   SESSIONHANDLERINTERFACE.READ(3)

SessionHandlerInterface::read - Read session data

SYNOPSIS

       abstractpublic string SessionHandlerInterface::read (string  $session_id)

DESCRIPTION

	Reads  the  session data from the session storage, and returns the results. Called right after the session starts or when session_start(3)
       is called. Please note that before this method is called SessionHandlerInterface.open(3) is invoked.

	This method is called by PHP itself when the session is started. This method should retrieve the session data from storage by the  session
       ID provided. The string returned by this method must be in the same serialized format as when originally passed to the SessionHandlerInter-
       face.write(3) If the record was not found, return an empty string.

	The data returned by this method will be decoded internally by PHP using the unserialization method  specified	in  session.serialize_han-
       dler. The resultig data will be used to populate the $_SESSION superglobal.

	Note that the serialization scheme is not the same as unserialize(3) and can be accessed by session_decode(3).

PARAMETERS

	      o $session_id
		- The session id.

RETURN VALUES

	Returns an encoded string of the read data. If nothing was read, it must return an empty string. Note this value is returned internally to
       PHP for processing.

SEE ALSO

	The session.serialize_handler configuration directive. .

PHP Documentation Group 											   SESSIONHANDLERINTERFACE.READ(3)

SESSION_REGENERATE_ID(3)						 1						  SESSION_REGENERATE_ID(3)

session_regenerate_id - Update the current session id with a newly generated one

SYNOPSIS

       bool session_regenerate_id ([bool  $delete_old_session = false])

DESCRIPTION

       session_regenerate_id(3) will replace the current session id with a new one, and keep the current session information.

PARAMETERS

	      o $delete_old_session
		- Whether to delete the old associated session file or not.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 4.3.3	|						    |
       |	|						    |
       |	|  Since  then, if session cookies are enabled, use |
       |	| of session_regenerate_id(3) will  also  submit  a |
       |	| new session cookie with the new session id.	    |
       |	|						    |
       | 5.1.0	|						    |
       |	|						    |
       |	|      Added the $delete_old_session parameter.     |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      A session_regenerate_id(3) example

	      <?php
	      session_start();

	      $old_sessionid = session_id();

	      session_regenerate_id();

	      $new_sessionid = session_id();

	      echo "Old Session: $old_sessionid<br />";
	      echo "New Session: $new_sessionid<br />";

	      print_r($_SESSION);
	      ?>

SEE ALSO

       session_id(3), session_start(3), session_name(3).

PHP Documentation Group 												  SESSION_REGENERATE_ID(3)