cvs: phpdoc(REF_STRUCT_DEV) /en/reference/session_pgsql reference.xml

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; - &note.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 &gt;= 4.3.0, and PostgreSQL &gt;=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; + &note.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 &gt;= 4.3.0, and PostgreSQL &gt;=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