...

...

@@ -2,7 +2,7 @@

2

2

<!-- $Revision$ -->

3

3

4

4

<book xml:id="book.session" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

5

-

<?phpdoc extension-membership="core" ?>

5

+

<?phpdoc extension-membership="bundled" ?>

6

6

<title>Session Handling</title>

7

7

<titleabbrev>Sessions</titleabbrev>

8

8

...

...

@@ -11,8 +11,7 @@

11

11

&reftitle.intro;

12

12

<para>

13

13

Session support in PHP consists of a way to preserve certain data

14

-

across subsequent accesses. This enables you to build more

15

-

customized applications and increase the appeal of your web site.

14

+

across subsequent accesses.

16

15

</para>

17

16

<para>

18

17

A visitor accessing your web site is assigned a unique id, the

...

...

@@ -24,8 +23,7 @@

24

23

<varname>$_SESSION</varname> superglobal array. When a visitor accesses

25

24

your site, PHP will check automatically (if <link linkend="ini.session.auto-start">session.auto_start</link>

26

25

is set to 1) or on your request (explicitly through

27

-

<function>session_start</function> or implicitly through

28

-

<function>session_register</function>) whether a specific session

26

+

<function>session_start</function>) whether a specific session

29

27

id has been sent with the request. If this is the case, the prior

30

28

saved environment is recreated.

31

29

</para>

...

...

@@ -61,28 +59,18 @@

61

59

special characters (<literal>|</literal>

62

60

and <literal>!</literal>) cannot be used. Using these will end up

63

61

with errors at script shutdown. <literal>php_serialize</literal>

64

-

does not have such limitations. <literal>php_serialize</literal>

65

-

is available from PHP 5.5.4.

62

+

does not have such limitations.

66

63

</para>

67

64

</warning>

68

65

<note>

69

66

<para>

70

67

Please note when working with sessions that a record of a session

71

-

is not created until a variable has been registered using the

72

-

<function>session_register</function> function or by adding a new

68

+

is not created until a variable has been registered by adding a new

73

69

key to the <varname>$_SESSION</varname> superglobal array. This

74

70

holds true regardless of if a session has been started using the

75

71

<function>session_start</function> function.

76

72

</para>

77

73

</note>

78

-

<note>

79

-

<para>

80

-

PHP 5.2.2 introduced an undocumented feature to store session files

81

-

in "/tmp" even if <link linkend="ini.open-basedir">open_basedir</link>

82

-

was enabled and "/tmp" is not explicitly added to the allowed paths

83

-

list. This feature has been removed from PHP as of PHP 5.3.0.

84

-

</para>

85

-

</note>

86

74

</preface>

87

75

<!-- }}} -->

88

76

...

...

@@ -94,6 +82,8 @@

94

82

&reference.session.reference;

95

83

&reference.session.sessionhandler;

96

84

&reference.session.sessionhandlerinterface;

85

+

&reference.session.sessionidinterface;

86

+

&reference.session.sessionupdatetimestamphandlerinterface;

97

87

98

88

</book>

99

89

100

90