conni Wed Apr 24 10:21:39 2002 EDT
Modified files:
/phpdoc/de/reference/pgsql reference.xml
Log:
added table for new function names, fixed typo
Index: phpdoc/de/reference/pgsql/reference.xml
diff -u phpdoc/de/reference/pgsql/reference.xml:1.2
phpdoc/de/reference/pgsql/reference.xml:1.3
--- phpdoc/de/reference/pgsql/reference.xml:1.2 Mon Apr 15 20:14:38 2002
+++ phpdoc/de/reference/pgsql/reference.xml Wed Apr 24 10:21:38 2002
@@ -1,66 +1,9 @@
<?xml version='1.0'?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<reference id='ref.pgsql'>
<title>PostgreSQL Funktionen</title>
<titleabbrev>PostgreSQL</titleabbrev>
-
<partintro>
- <warning>
- <para>
- Wegen eines Bugs in der Behandlung von NOTICE-Benachrichtigungen
- sollte das PostgreSQL-Modul der PHP Version 4.0.6 nicht
- benutzt werden.
- </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.
- Die meisten neuen Namen enthalten zusätzliche Unterstriche, z.B.
- 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 noch ein paar Releases danach noch
- verwendet werden, aber sie werden irgendwann gelöscht. Die
- CVS-Version benutzt die neuen Funktionsnamen.
- </para>
- <example>
- <title>Die geänderten Funktionsnamen</title>
- <programlisting role='php'>
-<![CDATA[
-ALTER NAME NEUER NAME
-pg_exec pg_query
-pg_getlastoid pg_last_oid
-pg_cmdtuples pg_affected_rows
-pg_errormessage pg_last_error
-pg_numrows pg_num_rows
-pg_numfields pg_num_fields
-pg_fieldname pg_field_name
-pg_fieldsize pg_field_size
-pg_fieldtype pg_field_type
-pg_fieldnum pg_field_num
-pg_fieldprtlen pg_field_prtlen
-pg_fieldisnull pg_field_is_null
-pg_freeresult pg_free_result
-pg_result pg_fetch_result
-pg_loreadall pg_lo_read_all
-pg_locreate pg_lo_create
-pg_lounlink pg_lo_unlink
-pg_loopen pg_lo_open
-pg_loclose pg_lo_close
-pg_loread pg_lo_read
-pg_lowrite pg_lo_write
-pg_loimport pg_lo_import
-pg_loexport pg_lo_export
-]]>
- </programlisting>
- </example>
- <para>
- Die veraltete Syntax von pg_connect()/pg_pconnect wird ungültig
- werden, um zukünftig asynchrone Verbindungen zu unterstützen.
- Bitte benutzen Sie einen Verbindungsstring mit pg_connect() und
- pg_pconnect().
- </para>
- </warning>
<para>
PostgreSQL, ursprünglich entwickelt im UC Berkeley Computer Science
Department, hat Pionierarbeit bei objektrelationalen
@@ -76,20 +19,142 @@
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,
- einschliessllich multibyte character encoding. Die aktuelle Version
+ 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 "--with-pgsql[=DIR]" kompilieren. Falls das
- shared object module verfügbar ist, kann das PostgreSQL Modul
- mit der <link linkend='ini.extension'>extension</link> Direktive
+ 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
+ <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>
+ <para>
+ Wegen eines Bugs in der Behandlung von NOTICE-Benachrichtigungen
+ sollte das PostgreSQL-Modul der PHP Version 4.0.6 nicht
+ benutzt werden.
+ </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.
+ Die meisten neuen Namen enthalten zusätzliche Unterstriche, z.B.
+ 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.
+ </para>
+ <table>
+ <title>Die geänderten Funktionsnamen</title>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>Alter Name</entry>
+ <entry>Neuer Name</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><function>pg_exec</function></entry>
+ <entry><function>pg_query</function></entry>
+ </row>
+ <row>
+ <entry><function>pg_getlastoid</function></entry>
+ <entry><function>pg_last_oid</function></entry>
+ </row>
+ <row>
+ <entry><function>pg_cmdtuples</function></entry>
+ <entry><function>pg_affected_rows</function></entry>
+ </row>
+ <row>
+ <entry><function>pg_numrows</function></entry>
+ <entry><function>pg_num_rows</function></entry>
+ </row>
+ <row>
+ <entry><function>pg_numfields</function></entry>
+ <entry><function>pg_num_fields</function></entry>
+ </row>
+ <row>
+ <entry><function>pg_fieldname</function></entry>
+ <entry><function>pg_field_name</function></entry>
+ </row>
+ <row>
+ <entry><function>pg_fieldsize</function></entry>
+ <entry><function>pg_field_size</function></entry>
+ </row>
+ <row>
+ <entry><function>pg_fieldnum</function></entry>
+ <entry><function>pg_field_num</function></entry>
+ </row>
+ <row>
+ <entry><function>pg_fieldptrlen</function></entry>
+ <entry><function>pg_field_ptrlen</function></entry>
+ </row>
+ <row>
+ <entry><function>pg_fieldisnull</function></entry>
+ <entry><function>pg_field_is_null</function></entry>
+ </row>
+ <row>
+ <entry><function>pg_freeresult</function></entry>
+ <entry><function>pg_free_result</function></entry>
+ </row>
+ <row>
+ <entry><function>pg_result</function></entry>
+ <entry><function>pg_fetch_result</function></entry>
+ </row>
+ <row>
+ <entry><function>pg_loreadall</function></entry>
+ <entry><function>pg_lo_read_all</function></entry>
+ </row>
+ <row>
+ <entry><function>pg_locreate</function></entry>
+ <entry><function>pg_lo_create</function></entry>
+ </row>
+ <row>
+ <entry><function>pg_lounlink</function></entry>
+ <entry><function>pg_lo_unlink</function></entry>
+ </row>
+ <row>
+ <entry><function>pg_loopen</function></entry>
+ <entry><function>pg_lo_unlink</function></entry>
+ </row>
+ <row>
+ <entry><function>pg_loclose</function></entry>
+ <entry><function>pg_lo_close</function></entry>
+ </row>
+ <row>
+ <entry><function>pg_loread</function></entry>
+ <entry><function>pg_lo_read</function></entry>
+ </row>
+ <row>
+ <entry><function>pg_lowrite</function></entry>
+ <entry><function>pg_lo_write</function></entry>
+ </row>
+ <row>
+ <entry><function>pg_loimport</function></entry>
+ <entry><function>pg_lo_import</function></entry>
+ </row>
+ <row>
+ <entry><function>pg_loexport</function></entry>
+ <entry><function>pg_lo_export</function></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ <para>
+ Die veraltete Syntax von pg_connect()/pg_pconnect wird ungültig
+ werden, um zukünftig asynchrone Verbindungen zu unterstützen.
+ Bitte benutzen Sie einen Verbindungsstring mit pg_connect()
+ und pg_pconnect().
+ </para>
+ </warning>
<para>
Nicht alle Funktionen sind in allen Versionen verfügbar. Es hängt
davon ab, welche libpq Version (das PostgreSQL C Client Interface)
@@ -98,14 +163,14 @@
die nötigen Routinen nicht unterstützt, die die Funktion braucht.
</para>
<para>
- Es ist ausserdem wichtig, dass Ihre libpq neuer ist, als der
- PostgreSQL Server, zu dem Sie eine Verbindung aufbauen. Wenn Sie
- eine libpq benutzen, die älter als vom PostgreSQL Server erwartet,
+ 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.
</para>
<para>
Seit Version 6.3 (03/02/1998) benutzt PostgreSQL per Voreinstellung
- Unix Domain Sockets. Ein TCP/IP Port wird NICHT standardmässig
+ Unix Domain Sockets. Ein TCP/IP Port wird NICHT standardmäßig
geöffnet. In der untenstehenden Tabelle werden diese neuen
Verbindungsmöglichkeiten gezeigt. Der Socket ist in
<filename>/tmp/.s.PGSQL.5432</filename> zu finden. Der Schalter
@@ -113,7 +178,7 @@
weist diesen an, sowohl über TCP/IP als auch über UNIX Domain
Sockets eine Verbindung aufzubauen.
<table>
- <title>Postmaster und PHP</title>
+ <title>Der Postmaster und PHP</title>
<tgroup cols='3'>
<thead>
<row>
@@ -153,7 +218,7 @@
</table>
</para>
<para>
- Eine Verbindung zu einem PostgreSQL Server lässt sich auch mit den
+ Eine Verbindung zu einem PostgreSQL-Server lässt sich auch mit den
folgenden Wertepaaren, die im Verbindungsstring gesetzt werden,
herstellen (wobei mindestens der Name der Datenbank
angegeben sein muss): <command>$conn =
@@ -209,7 +274,7 @@
</para>
<para>
Um die Large Object-Schnittstelle (lo) zu benutzen, ist es nötig,
- die Large-Object-Funktionen in einen Transaktionsblock einzuschliessen.
+ 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>.
@@ -234,8 +299,8 @@
]]>
</programlisting>
</example>
- Schliessen Sie zuerst das Large Object, bevor Sie die Verbindung
- schliessen.
+ Schließen Sie zuerst das Large Object, bevor Sie die Verbindung
+ schließen.
</para>
</partintro>
