[prev in list] [next in list] [prev in thread] [next in thread]
List: php-doc-cvs
Subject: [DOC-CVS] cvs: phpdoc(REF_STRUCT_DEV) /en/reference/session_pgsql reference.xml
From: "Hannes Magnusson" <bjori () php ! net>
Date: 2007-10-27 22:18:36
Message-ID: cvsbjori1193523516 () cvsserver
[Download RAW message or body]
bjori Sat Oct 27 22:18:36 2007 UTC
Modified files: (Branch: REF_STRUCT_DEV)
/phpdoc/en/reference/session_pgsql reference.xml
Log:
Upgrade markup
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/session_pgsql/reference.xml?r1=1.4.2.1&r2=1.4.2.2&diff_format=u
Index: phpdoc/en/reference/session_pgsql/reference.xml
diff -u phpdoc/en/reference/session_pgsql/reference.xml:1.4.2.1 \
phpdoc/en/reference/session_pgsql/reference.xml:1.4.2.2
--- phpdoc/en/reference/session_pgsql/reference.xml:1.4.2.1 Wed Oct 3 11:41:15 2007
+++ phpdoc/en/reference/session_pgsql/reference.xml Sat Oct 27 22:18:36 2007
@@ -1,61 +1,76 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4.2.1 $ -->
+<!-- $Revision: 1.4.2.2 $ -->
<!-- Purpose: basic.session -->
<!-- Membership: pecl, external -->
<!-- Author: Yasuo Ohgaki <yohgaki@php.net> -->
-<reference xml:id="ref.session-pgsql" xmlns="http://docbook.org/ns/docbook" \
xmlns:xlink="http://www.w3.org/1999/xlink"> +
+<book xml:id="ref.session-pgsql" xmlns="http://docbook.org/ns/docbook" \
xmlns:xlink="http://www.w3.org/1999/xlink"> <title>PostgreSQL Session Save \
Handler</title> <titleabbrev>Session PgSQL</titleabbrev>
- <partintro>
- <section xml: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 <link xlink:href="&url.pgsql;">PostgreSQL</link> 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 xml: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 <link xlink:href="&url.mm;">libmm</link>
- (and header files).
- </para>
- </section>
-
- &reference.session-pgsql.configure;
-
- &reference.session-pgsql.ini;
-
- <section xml:id="session-pgsql.tables">
- <title>Table definitions</title>
- <para>Session table definition
- <programlisting role="sql">
+ <preface xml: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 <link xlink:href="&url.pgsql;">PostgreSQL</link> 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>
+ </preface>
+
+ <chapter xml:id="session-pgsql.setup" xmlns="http://docbook.org/ns/docbook" \
xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>Installing/Configuring</title>
+
+ <section xml: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 <link xlink:href="&url.mm;">libmm</link>
+ (and header files).
+ </para>
+ </section>
+
+ &reference.session-pgsql.configure;
+
+ &reference.session-pgsql.ini;
+
+ <section xml:id="session-pgsql.resources">
+ &reftitle.resources;
+ &no.resource;
+ </section>
+
+ </chapter>
+
+ <appendix xml:id="session-pgsql.constants" xmlns="http://docbook.org/ns/docbook" \
xmlns:xlink="http://www.w3.org/1999/xlink"> + &reftitle.constants;
+ &no.constants;
+ </appendix>
+
+ <chapter xml:id="session-pgsql.tables">
+ <title>Table definitions</title>
+ <para>Session table definition
+ <programlisting role="sql">
<![CDATA[
CREATE TABLE php_session (
sess_id text,
@@ -76,23 +91,23 @@
CREATE INDEX php_session_idx ON php_session USING BTREE (sess_id);
]]>
- </programlisting>
- </para>
- <warning>
- <para>
+ </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>
+ </para>
+ </warning>
+ <para>
You may change the session table as long as all fields are defined.
- </para>
- <para>
+ </para>
+ <para>
Application variables table definition
- <programlisting role="sql">
+ <programlisting role="sql">
<![CDATA[
CREATE TABLE php_app_vars (
app_modified integer,
@@ -100,29 +115,31 @@
app_vars text
);
]]>
- </programlisting>
- </para>
- </section>
-
-
- <section xml: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
- <link xlink:href="mailto:yohgaki@php.net">yohgaki@php.net</link>. Any help is
- very welcome.
- </para>
- </section>
+ </programlisting>
+ </para>
+ </chapter>
+
+ <reference xml:id="functions.session-pgsql" xmlns="http://docbook.org/ns/docbook" \
xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>Session PgSQL \
&Functions;</title> + <partintro xml: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
+ <link xlink:href="mailto:yohgaki@php.net">yohgaki@php.net</link>. Any help is
+ very welcome.
+ </para>
</partintro>
-
-&reference.session-pgsql.functions.entities;
+
+ &reference.session-pgsql.functions.entities;
</reference>
+</book>
+
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
--
PHP Documentation Commits Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic