cvs: phpdoc-de /reference/pgsql reference.xml

conni Sat Aug 17 17:16:49 2002 EDT Modified files: /phpdoc-de/reference/pgsql reference.xml Log: updated

Index: phpdoc-de/reference/pgsql/reference.xml diff -u phpdoc-de/reference/pgsql/reference.xml:1.4 phpdoc-de/reference/pgsql/reference.xml:1.5 --- phpdoc-de/reference/pgsql/reference.xml:1.4 Thu Apr 25 15:12:50 2002 +++ phpdoc-de/reference/pgsql/reference.xml Sat Aug 17 17:16:49 2002 @@ -1,47 +1,70 @@ <?xml version='1.0'?> -<!-- EN-Revision: 1.3 Maintainer: conni Status: ready --> -<!-- $Revision: 1.4 $ --> -<reference id='ref.pgsql'> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.9 Maintainer: conni Status: ready --> + <reference id='ref.pgsql'> <title>PostgreSQL Funktionen</title> <titleabbrev>PostgreSQL</titleabbrev> + <partintro> - <para> - PostgreSQL, ursprünglich entwickelt im UC Berkeley Computer Science - Department, hat Pionierarbeit bei objektrelationalen - Datenbankkonzepten geleistet, die jetzt Einzug in kommerzielle - Datenbanken halten. PostgreSQL bietet SQL92/SQL99 - Sprachunterstützung, Transaktionen und ein erweiterbares - Typkonzept. PostgreSQL ist eine Public Domain und Open Source - Weiterentwicklung des ursprünglichen Berkeley-Codes. - </para> - <para> - PostgreSQL ist ein Open Source Produkt und kostenlos - erhältlich. Um PostgreSQL benutzen zu können, brauchen Sie - mindestens eine Version 6.5 oder später, um alle Leistungsmerkmale - des PostgreSQL-Moduls nutzen zu können, müssen Sie eine Version ab - 7.0 haben. PostgreSQL unterstützt viele Zeichencodierungen, - einschließlich multibyte character encoding. Die aktuelle Version - sowie weitere Informationen über PostgreSQL sind auf der Seite - <ulink url='&url.pgsql;'>www.postgresql.org</ulink> erhältlich. - </para> - <para> - Um die PostgreSQL-Unterstützung nutzen zu können, müssen Sie - PHP mit &quot;--with-pgsql[=DIR]&quot; kompilieren. Falls das - shared object module verfügbar ist, kann das PostgreSQL-Modul - mit der <link linkend='ini.extension'>extension</link>-Direktive - der Datei &php.ini; geladen werden oder mittels der Funktion - <function>dl</function>. Die unterstützten ini-Direktiven sind in - der Datei <filename>php.ini-dist</filename> beschrieben, die mit - der Distribution ausgeliefert wird. - </para> - <warning> + <section id="pgsql.intro"> + &reftitle.intro; <para> - Wegen eines Bugs in der Behandlung von NOTICE-Benachrichtigungen - sollte das PostgreSQL-Modul der PHP Version 4.0.6 nicht - benutzt werden. + PostgreSQL ist ein kostenloses Open Source Datenbanksystem. Es + wurde ursprünglich im UC Berkeley Computer Science + Department entwickelt und hat Pionierarbeit bei objektrelationalen + Datenbankkonzepten geleistet, die jetzt Einzug in einige + kommerzielle Datenbanken halten. PostgreSQL bietet SQL92/SQL99 + Sprachunterstützung, Transaktionen und ein erweiterbares + Typkonzept. PostgreSQL ist eine Weiterentwicklung des + ursprünglichen Berkeley-Codes. </para> - </warning> - <warning> + </section> + + <section id="pgsql.requirements"> + &reftitle.required; + <para> + Um PostgreSQL benutzen zu können, brauchen Sie mindestens eine + Version 6.5 oder später, um alle Leistungsmerkmale des + PostgreSQL-Moduls nutzen zu können, müssen Sie eine Version ab + 7.0 haben. PostgreSQL unterstützt viele Zeichencodierungen, + einschließlich multibyte character encoding. Die aktuelle Version + sowie weitere Informationen über PostgreSQL sind auf der Seite + <ulink url='&url.pgsql;'>&url.pgsql;</ulink> erhältlich. + </para> + </section> + + <section id="pgsql.installation"> + &reftitle.install; + <para> + Um die PostgreSQL-Unterstützung nutzen zu können, müssen Sie + PHP mit <option role="configure">--with-pgsql[=DIR]</option> + kompilieren. Falls das shared object module verfügbar ist, kann + das PostgreSQL-Modul mit der + <link linkend='ini.extension'>extension</link>-Direktive + der Datei &php.ini; oder mittels der Funktion + <function>dl</function>geladen werden. + </para> + </section> + + <section id="pgsql.configuration"> + &reftitle.runtime; + <para> + Die unterstützten ini-Direktiven sind in + der Datei <filename>php.ini-dist</filename> beschrieben, die mit + der Distribution ausgeliefert wird. + </para> + </section> + + <section id="pgsql.using"> + <title>Hinweise</title> + <warning> + <para> + Wegen eines Bugs in der Behandlung von NOTICE-Benachrichtigungen + sollte das PostgreSQL-Modul der PHP Version 4.0.6 nicht + benutzt werden. Bitte benutzen Sie PHP 4.1.0 oder höher. + </para> + </warning> + <warning> <para> Die Namen der PostgreSQL-Funktionen werden sich ab der PHP Version 4.2.0 ändern, um sie an die gültigen Coding-Standards anzupassen. @@ -49,8 +72,7 @@ pg_lo_open(). Einige Funktionen werden der Einheitlichkeit wegen umbenannt, z.B. pg_exec() zu pg_query(). Die älteren Namen können in der Version 4.2.0 und auch ein paar Releases danach noch - verwendet werden, aber sie werden irgendwann gelöscht. Die - CVS-Version benutzt die neuen Funktionsnamen. + verwendet werden, aber sie werden irgendwann gelöscht. </para> <table> <title>Die geänderten Funktionsnamen</title> @@ -150,10 +172,11 @@ </tgroup> </table> <para> - Die veraltete Syntax von pg_connect()/pg_pconnect wird ungültig + Die veraltete Syntax von <function>pg_connect</function> und + <function>pg_pconnect</function> wird ungültig werden, um zukünftig asynchrone Verbindungen zu unterstützen. - Bitte benutzen Sie einen Verbindungsstring mit pg_connect() - und pg_pconnect(). + Bitte benutzen Sie einen Verbindungsstring mit + <function>pg_connect</function> bzw. <function>pg_pconnect</function>. </para> </warning> <para> @@ -166,8 +189,8 @@ <para> Es ist außerdem wichtig, dass Ihre libpq neuer ist, als der PostgreSQL-Server, zu dem Sie eine Verbindung aufbauen. Wenn Sie - eine libpq benutzen, die älter ist, als vom PostgreSQL-Server erwartet, - werden Sie wahrscheinlich Probleme haben. + eine libpq benutzen, die älter ist, als vom PostgreSQL-Server + erwartet, werden Sie wahrscheinlich Probleme haben. </para> <para> Seit Version 6.3 (03/02/1998) benutzt PostgreSQL per Voreinstellung @@ -183,36 +206,36 @@ <tgroup cols='3'> <thead> <row> - <entry>Postmaster</entry> - <entry>PHP</entry> - <entry>Status</entry> + <entry>Postmaster</entry> + <entry>PHP</entry> + <entry>Status</entry> </row> </thead> <tbody> <row> - <entry>postmaster &amp;</entry> - <entry>pg_connect("dbname=MyDbName");</entry> - <entry>OK</entry> + <entry>postmaster &amp;</entry> + <entry>pg_connect("dbname=MyDbName");</entry> + <entry>OK</entry> </row> <row> - <entry>postmaster -i &amp;</entry> - <entry>pg_connect("dbname=MyDbName");</entry> - <entry>OK</entry> + <entry>postmaster -i &amp;</entry> + <entry>pg_connect("dbname=MyDbName");</entry> + <entry>OK</entry> </row> <row> - <entry>postmaster &amp;</entry> - <entry>pg_connect("host=localhost dbname=MyDbName");</entry> - <entry> - Unable to connect to PostgreSQL server: connectDB() failed: - Is the postmaster running and accepting TCP/IP (with -i) - connection at 'localhost' on port '5432'? in - /pfad/zu/datei.php on line 20. - </entry> + <entry>postmaster &amp;</entry> + <entry>pg_connect("host=localhost dbname=MyDbName");</entry> + <entry> + Unable to connect to PostgreSQL server: connectDB() failed: + Is the postmaster running and accepting TCP/IP (with -i) + connection at 'localhost' on port '5432'? in + /pfad/zu/datei.php on line 20. + </entry> </row> <row> - <entry>postmaster -i &amp;</entry> - <entry>pg_connect("host=localhost dbname=MyDbName");</entry> - <entry>OK</entry> + <entry>postmaster -i &amp;</entry> + <entry>pg_connect("host=localhost dbname=MyDbName");</entry> + <entry>OK</entry> </row> </tbody> </tgroup> @@ -265,26 +288,33 @@ export PGHOST PGPORT PGDATABASE PGUSER PGPASSWORD PGDATESTYLE PGTZ PGCLIENTENCODING ]]> - </programlisting> - </example> - <para> - Ab der PostgreSQL Version 7.1.0 ist die maximale Grösse eines Feldes - mit dem Datentyp text 1GB. Ältere PostgreSQL Versionen begrenzten - Felder vom Typ text auf Blockgrösse (normalerweise 8KB bis maximal - 32 KB, falls dies bei der Kompilation angegeben wurde). - </para> - <para> - Um die Large Object-Schnittstelle (lo) zu benutzen, ist es nötig, - die Large-Object-Funktionen in einen Transaktionsblock einzuschließen. - Ein Transaktionsblock beginnt mit einem SQL-Befehl - <command>begin</command> und endet, falls die Transaktion gültig - war, mit <command>commit</command> oder <command>end</command>. - Wenn die Transaktion fehlschlägt, sollte sie mit - <command>abort</command> oder <command>rollback</command> - geschlossen werden. - <example> - <title>Large Objects benutzen</title> - <programlisting role='php'> + </programlisting> + </example> + </section> + + &reference.pgsql.constants; + + <section id="pgsql.examples"> + &reftitle.examples; + + <para> + Ab der PostgreSQL Version 7.1.0 ist die maximale Grösse eines Feldes + mit dem Datentyp text 1GB. Ältere PostgreSQL Versionen begrenzten + Felder vom Typ text auf Blockgrösse (normalerweise 8 KB bis maximal + 32 KB, falls dies bei der Kompilation angegeben wurde). + </para> + <para> + Um die Large Object-Schnittstelle (lo) zu benutzen, ist es nötig, + die Large-Object-Funktionen in einen Transaktionsblock einzuschließen. + Ein Transaktionsblock beginnt mit einem SQL-Befehl + <command>BEGIN</command> und endet, falls die Transaktion gültig + war, mit <command>COMMIT</command> oder <command>END</command>. + Wenn die Transaktion fehlschlägt, sollte sie mit + <command>ROLLBACK</command> oder <command>ABORT</command> + geschlossen werden. + <example> + <title>Large Objects benutzen</title> + <programlisting role='php'> <![CDATA[ <?php $database = pg_connect ("dbname=jacarta"); @@ -298,11 +328,11 @@ pg_query ($database, "commit"); ?> ]]> - </programlisting> - </example> - Schließen Sie zuerst das Large Object, bevor Sie die Verbindung - schließen. - </para> + </programlisting> + </example> + Schließen Sie zuerst das Large Object, bevor Sie die Verbindung zum PostgreSQL Server schließen. + </para> + </section> </partintro> &reference.pgsql.functions; @@ -327,4 +357,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> \ No newline at end of file +-->