php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #27944 features section has nothing on Sessions
Submitted: 2004-04-10 13:00 UTC Modified: 2004-09-17 15:53 UTC
From: derick@php.net Assigned:
Status: Closed Package: Documentation problem
PHP Version: Irrelevant OS: irrelevant
Private report: No CVE-ID: None
 [2004-04-10 13:00 UTC] derick@php.net
Description:
------------
The features section (http://www.php.net/manual/en/features.php) in the Manual misses a short introduction/tutorial on sessions. It doesn't have to be covering everything, but the basic session_start() and use of $_SESSION[] would be a very good idea. (And of course points to more information in the manual about it).


Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2004-04-11 07:06 UTC] goba@php.net
Kenneth offered to move the session info from ref.session to features.session. The intention so far was to work the other way around (and provide compact and all-in-one reference sections). See the preg section for example. It contains info on preg formatting. Though regular expressions would be a possible feature section cadidate, we decided to keep the documentation for one extension in one place.

This does not mean that pointers might not be added to the features section (short pages on regex extensions or session handling). But I am strongly opposed to the idea to move out stuff from the reference sections to the features section, since we have worked the other way around so far. There used to be an image generation section in the features part which we moved to the gd docs for example...

[Kenneth, it is better to store comments in the bug system for future reference...]
 [2004-04-11 09:12 UTC] betz@php.net
I agree with Goba (infos compact and all-in-one reference 
sections). 
Although a short introduction to sessions as core feature 
of php might be feasible. 
 
Friedhelm 
 
 [2004-04-11 09:21 UTC] derick@php.net
I just wanted a short tutorial like introduction, similar to what we have for file uploads. All other information for this is in the manual too, but not grouped in any way. Moving the session stuff to the features section is not a good idea IMO.
 [2004-04-11 10:36 UTC] irchtml@php.net
Ok, That's fine.  I wanted to check before I did anything.
 [2004-09-17 15:53 UTC] vrana@php.net
This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.

Thank you for the report, and for helping us make our documentation better.

As everything is in ref.session, I add only very short intro to Features with link to Reference.
 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved.
Last updated: Wed Sep 18 21:01:26 2024 UTC