diff --git a/reference/session/functions/session-start.xml b/reference/session/functions/session-start.xml index 788bf4ade4..5bc9d94ede 100644 --- a/reference/session/functions/session-start.xml +++ b/reference/session/functions/session-start.xml @@ -14,28 +14,32 @@ session_start creates a session or resumes the - current one based on the current session id that's being passed via a - request, such as GET, POST, or a cookie. + current one based on a session identifier passed via a GET or POST + request, or passed via a cookie. - If you want to use a named session, you must call + To use a named session, call session_name before calling session_start. - session_start will register internal output handler - for URL rewriting when trans-sid is enabled. If a user - uses ob_gzhandler or like with - ob_start, the order of output handler is important - for proper output. For example, user must register - ob_gzhandler before 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 session was started with success otherwise &false;. + This function returns &true; if a session was successfully started, + otherwise &false;. @@ -54,17 +58,17 @@ 5.3.0 - If session fails to start for some reason, then &false; is returned - where previously &true; always was returned. + If a session fails to start, then &false; is returned. + Previously &true; was returned. 4.3.3 - As of now, calling session_start while the - session has already been started will result in an error of level - E_NOTICE. Also, the second session start will - simply be ignored. + 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. @@ -138,22 +142,21 @@ echo '
page 1'; &reftitle.notes; - If you are using cookie-based sessions, you must call - session_start before anything is outputted to the - browser. + To use cookie-based sessions, session_start + must be called before outputing anything to the browser. Use of zlib.output_compression - is recommended rather than ob_gzhandler + is recommended instead of ob_gzhandler - This function will send out several HTTP headers depending on the - configuration. See session_cache_limiter to customize - these headers. + This function sends out several HTTP headers depending on the + configuration. See session_cache_limiter to + customize these headers.