session_startInitialize session data
&reftitle.description;
boolsession_startsession_start creates a session or resumes the
current one based on a session identifier passed via a GET or POST
request, or passed via a cookie.
To use a named session, call
session_name before calling
session_start.
When session.use_trans_sid
is enabled, the session_start function will
register an internal output handler for URL rewriting.
If a user uses ob_gzhandler or similar with
ob_start, the function order is important for
proper output. For example,
ob_gzhandler must be registered before starting the session.
&reftitle.returnvalues;
This function returns &true; if a session was successfully started,
otherwise &false;.
&reftitle.changelog;
&Version;&Description;5.3.0
If a session fails to start, then &false; is returned.
Previously &true; was returned.
4.3.3
As of PHP 4.3.3, calling session_start
after the session was previously started will result in an
error of level E_NOTICE. Also, the
second session start will simply be ignored.
&reftitle.examples;
A session example: page1.phppage 2';
// Or maybe pass along the session id, if needed
echo ' page 2';
?>
]]>
After viewing page1.php, the second page
page2.php will magically contain the session
data. Read the session reference
for information on propagating
session ids as it, for example, explains what the constant
SID is all about.
A session example: page2.php
';
echo $_SESSION['favcolor']; // green
echo $_SESSION['animal']; // cat
echo date('Y m d H:i:s', $_SESSION['time']);
// You may want to use SID here, like we did in page1.php
echo ' page 1';
?>
]]>
&reftitle.notes;
To use cookie-based sessions, session_start
must be called before outputing anything to the browser.
Use of zlib.output_compression
is recommended instead of ob_gzhandler
This function sends out several HTTP headers depending on the
configuration. See session_cache_limiter to
customize these headers.
&reftitle.seealso;
$_SESSION
The session.auto_start
configuration directive
session_id