1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
|
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- Purpose: basic.session -->
<!-- Membership: pecl, external -->
<!-- Author: Yasuo Ohgaki <yohgaki@php.net> -->
<reference id="ref.session-pgsql">
<title>PostgreSQL Session Save Handler</title>
<titleabbrev>Session PgSQL</titleabbrev>
<partintro>
<section id="session-pgsql.intro">
&reftitle.intro;
¬e.no-windows.extension;
<para>
This module provides an additional session save handler for the
<link linkend="ref.session">session</link>
module using <ulink url="&url.pgsql;">PostgreSQL</ulink> as a
storage system. A <literal>user-level</literal> session storage function may
also be used - <function>session_set_save_handler</function>, but this module is
written in C and therefore could be twice as fast, compared to
a session save handler written in PHP.
</para>
<para>
Session PgSQL is designed to scale any size of web sites and offers some
advanced features:
<simplelist>
<member>session tables are created automatically</member>
<member>automatic session table vacuum</member>
<member>better garbage collection</member>
<member>multiple PostgreSQL servers support</member>
<member>automatic database server failover (switching)</member>
<member>
automatic database server load balancing if there are multiple
PostgreSQL servers.
</member>
<member>short circuit UPDATE</member>
</simplelist>
</para>
</section>
<section id="session-pgsql.requirements">
&reftitle.required;
<para>
You need at least PHP >= 4.3.0, and PostgreSQL >=7.2.0 as database
server. <literal>libpq</literal> that comes with PostgreSQL 7.2.0 or
later (and header files to build) and <ulink url="&url.mm;">libmm</ulink>
(and header files).
</para>
</section>
&reference.session-pgsql.configure;
&reference.session-pgsql.ini;
<section id="session-pgsql.tables">
<title>Table definitions</title>
<para>Session table definition
<programlisting role="sql">
<![CDATA[
CREATE TABLE php_session (
sess_id text,
sess_name text,
sess_data text,
sess_created integer,
sess_modified integer,
sess_expire integer,
sess_addr_created text,
sess_addr_modified text,
sess_counter integer,
sess_error integer,
sess_warning integer,
sess_notice integer,
sess_err_message text,
sess_custom text
);
CREATE INDEX php_session_idx ON php_session USING BTREE (sess_id);
]]>
</programlisting>
</para>
<warning>
<para>
If you use <literal>HASH</literal> for <literal>INDEX</literal>, you'll
have a deadlock problem when the server load is
<emphasis>very</emphasis> high. Even if it's unlikely to have a deadlock
under normal operation, it can occur. <emphasis>Do not use
<literal>HASH</literal> for <literal>INDEX</literal></emphasis>.
</para>
</warning>
<para>
You may change the session table as long as all fields are defined.
</para>
<para>
Application variables table definition
<programlisting role="sql">
<![CDATA[
CREATE TABLE php_app_vars (
app_modified integer,
app_name text,
app_vars text
);
]]>
</programlisting>
</para>
</section>
<section id="session-pgsql.contact">
<title>Contact Information</title>
<para>
I have at the moment not very much time to further develop this
extension. I will implement more and more features in the near future.
</para>
<para>
If you have comments, bug fixes, enhancements or want to help developing
this, you can drop me a mail at
<ulink url="mailto:yohgaki@php.net">yohgaki@php.net</ulink>. Any help is
very welcome.
</para>
</section>
</partintro>
&reference.session-pgsql.functions;
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
|
