cvs: phpdoc-de /reference/pgsql/functions pg-fetch-row.xml pg-last-notice.xml pg-lo-import.xml pg-query.xml pg-result-error.xml pg-result-status.xml
| From: | Cornelia Boenigk | Date: | Mon, 03 Dec 2007 01:42:02 +0000 |
| Subject: | cvs: phpdoc-de /reference/pgsql/functions pg-fetch-row.xml pg-last-notice.xml pg-lo-import.xml pg-query.xml pg-result-error.xml pg-result-status.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2321@lists.php.net to get a copy of this message | ||
conni Mon Dec 3 01:42:02 2007 UTC
Modified files:
/phpdoc-de/reference/pgsql/functions pg-fetch-row.xml
pg-last-notice.xml
pg-lo-import.xml pg-query.xml
pg-result-error.xml
pg-result-status.xml
Log:
syncing to en-versions
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pgsql/functions/pg-fetch-row.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-de/reference/pgsql/functions/pg-fetch-row.xml diff -u phpdoc-de/reference/pgsql/functions/pg-fetch-row.xml:1.11 phpdoc-de/reference/pgsql/functions/pg-fetch-row.xml:1.12 --- phpdoc-de/reference/pgsql/functions/pg-fetch-row.xml:1.11 Sat Jun 23 13:21:45 2007 +++ phpdoc-de/reference/pgsql/functions/pg-fetch-row.xml Mon Dec 3 01:42:01 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.13 Maintainer: conni Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.15 Maintainer: conni Status: ready --> <refentry xml:id="function.pg-fetch-row" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -21,11 +21,6 @@ <parameter>result</parameter> bezeichnet wird. </para> &database.fetch-null; - <note> - <para> - Ab PHP 4.1.0 wurde <parameter>row</parameter> optional. - </para> - </note> </refsect1> <refsect1 role="parameters"> @@ -37,8 +32,8 @@ <listitem> <para> PostgreSQL Verbindungskennung, die (unter anderem) von den - Funktionen <function>pg_query</function>, - <function>pg_query_params</function> oder <function>pg_execute</function> zurückgegeben wurde. + Funktionen <function>pg_query</function>, <function>pg_query_params</function> + oder <function>pg_execute</function> zurückgegeben wurde. </para> </listitem> </varlistentry> @@ -47,7 +42,8 @@ <listitem> <para> Die Nummer der Zeile des Abfrageergebnisses, die geholt werden - soll. Die Nummerierung beginnt bei 0. Fehlt dieser Parameter, so wird jeweils die nächste Zeile geholt. + soll. Die Nummerierung beginnt bei 0. Fehlt dieser Parameter, so wird + jeweils die nächste Zeile geholt. </para> </listitem> </varlistentry> @@ -60,7 +56,7 @@ <para> Die gelesene Zeile des Abfrageergebnisses (Datensatz) wird als numerisches <type>array</type>, beginnend bei Offset 0, zurückgegeben, - das die Feldwerte in den Arraykomponenten enthält. Diese werden als + das die Spaltenwerte in den Arraykomponenten enthält. Diese werden als <type>string</type> repräsentiert, Nullwerte der Datenbank (<literal>NULL</literal>) werden als &null; zurückgegeben. </para> @@ -70,6 +66,30 @@ kein Datensatz mehr gelesen werden kann, wird &false; zurückgegeben. </para> </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.1.0</entry> + <entry> + Der Parameter <parameter>row</parameter> wurde optional. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> <refsect1 role="examples"> &reftitle.examples; http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pgsql/functions/pg-last-notice.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/pgsql/functions/pg-last-notice.xml diff -u phpdoc-de/reference/pgsql/functions/pg-last-notice.xml:1.7 phpdoc-de/reference/pgsql/functions/pg-last-notice.xml:1.8 --- phpdoc-de/reference/pgsql/functions/pg-last-notice.xml:1.7 Sat Jun 23 13:21:45 2007 +++ phpdoc-de/reference/pgsql/functions/pg-last-notice.xml Mon Dec 3 01:42:02 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.6 Maintainer: conni Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.8 Maintainer: conni Status: ready --> <refentry xml:id="function.pg-last-notice" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>pg_last_notice</refname> @@ -27,30 +27,17 @@ Abfragen vermieden werden, indem man prüft, ob eine NOTICE-Meldung sich auf die aktuelle Transaktion bezieht oder nicht. </para> - <warning> - <para> - Diese Funktion ist EXPERIMENTELL und noch nicht vollständig - implementiert. <function>pg_last_notice</function> wurde mit der - Version 4.0.6 eingeführt. Diese Version hat jedoch Probleme mit der - Verarbeitung der NOTICE-Meldungen. Von der Benutzung des - PostgreSQL-Moduls mit PHP 4.0.6 wird abgeraten, auch wenn Sie die - Funktion <function>pg_last_notice</function> nicht nutzen. - </para> - <para> - Diese Funktion ist seit PHP 4.3.0 vollständig implementiert. In PHP-Versionen davor wird der Parameter <parameter>connection</parameter> ignoriert. - </para> - </warning> <para> - Die Verfolgung von Notice-Benachrichtigungen kann ab PHP 4.3.0 auf + Die Verfolgung von NOTICE-Benachrichtigungen kann auf optional gesetzt werden, indem die Direktive <literal>pgsql.ignore_notice</literal> in &php.ini; den Wert 1 erhält. </para> <para> - Die Protokollierung von Notice-Benachrichtigungen kann ab PHP 4.3.0 auf + Die Protokollierung von Notice-Benachrichtigungen kann auf optional gesetzt werden, indem die Direktive - <literal>pgsql.log_notice</literal> in &php.ini; den Wert 1 erhält. Wenn + <literal>pgsql.log_notice</literal> in &php.ini; den Wert 0 erhält. Nur wenn die Direktive <literal>pgsql.ignore_notice</literal> den Wert 0 hat, - können keine Notice-Benachrichtigungen protokolliert werden. + können Notice-Benachrichtigungen protokolliert werden. </para> </refsect1> @@ -79,6 +66,48 @@ </para> </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.3.0</entry> + <entry> + Diese Funktion ist nun vollständig implementiert. In früheren + Versionen wurde die Angabe des Parameters für die Verbindungskennung + zur Datenbank ignoriert. + </entry> + </row> + <row> + <entry>4.3.0</entry> + <entry> + Die Direktiven <literal>pgsql.ignore_notice</literal> und + <literal>pgsql.log_notice</literal> wurden in die &php.ini; eingefügt. + </entry> + </row> + <row> + <entry>4.0.6</entry> + <entry> + In PHP 4.0.6 gibt es ein Problem mit der Verarbeitung der + Notice-Benachrichtigungen. Von der Verwendung des PostgreSQL-Moduls + mit PHP 4.0.6 wird abgeraten, selbst wenn Sie die Funktion + <function>pg_last_notice</function> nicht einsetzen. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pgsql/functions/pg-lo-import.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/pgsql/functions/pg-lo-import.xml diff -u phpdoc-de/reference/pgsql/functions/pg-lo-import.xml:1.8 phpdoc-de/reference/pgsql/functions/pg-lo-import.xml:1.9 --- phpdoc-de/reference/pgsql/functions/pg-lo-import.xml:1.8 Sat Jun 23 13:21:45 2007 +++ phpdoc-de/reference/pgsql/functions/pg-lo-import.xml Mon Dec 3 01:42:02 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.9 Maintainer: conni Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.11 Maintainer: conni Status: ready --> <refentry xml:id="function.pg-lo-import" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>pg_lo_import</refname> @@ -19,16 +19,8 @@ <methodparam><type>string</type><parameter>pathname</parameter></methodparam> </methodsynopsis> <para> - In PHP Versionen vor 4.2.0 hatte diese Funktion eine andere Syntax, siehe die folgende Definition: - </para> - <methodsynopsis> - <type>int</type><methodname>pg_lo_import</methodname> - <methodparam><type>string</type><parameter>pathname</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>connection</parameter></methodparam> - </methodsynopsis> - <para> <function>pg_lo_import</function> erzeugt ein neues Large Object in der - Datenbank, in dem die Daten einer lokalen Datei gespeichert werden. + Datenbank, in dem die Daten einer Datei aus dem Dateisystem gespeichert werden. </para> <para> Um die Large Object (lo) Schnittstelle benutzen zu können, müssen @@ -50,10 +42,9 @@ <term><parameter>connection</parameter></term> <listitem> <para> - PostgreSQL Verbindungskennung, die (unter anderem) von den - Funktionen <function>pg_query</function>, - <function>pg_query_params</function> oder - <function>pg_execute</function> zurückgegeben wurde. + PostgreSQL Verbindungskennung. Wenn <parameter>connection</parameter> nicht + angegeben ist, wird die zuletzt von <function>pg_connect</function> oder + <function>pg_pconnect</function> geöffnete Verbindung benutzt. </para> </listitem> </varlistentry> @@ -61,8 +52,8 @@ <term><parameter>pathname</parameter></term> <listitem> <para> - Der vollständige Pfad und Dateinamen der Datei im lokalen - Dateisystem, aus der die Inhalte des Large Objects gelesen werden. + Der vollständige Pfad- und Dateiname der Datei im lokalen + Dateisystem des Clients, aus der die Daten des Large Objects gelesen werden. </para> </listitem> </varlistentry> @@ -77,7 +68,36 @@ &false;, wenn ein Fehler auftrat. </para> </refsect1> - + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.2.0</entry> + <entry><para> + Die Syntax dieser Funktion wurde wie folgt geändert: + <methodsynopsis> + <type>int</type><methodname>pg_lo_import</methodname> + <methodparam><type>string</type><parameter>pathname</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>connection</parameter></methodparam> + </methodsynopsis> + </para></entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pgsql/functions/pg-query.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/pgsql/functions/pg-query.xml diff -u phpdoc-de/reference/pgsql/functions/pg-query.xml:1.8 phpdoc-de/reference/pgsql/functions/pg-query.xml:1.9 --- phpdoc-de/reference/pgsql/functions/pg-query.xml:1.8 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/pgsql/functions/pg-query.xml Mon Dec 3 01:42:02 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.14 Maintainer: conni Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.15 Maintainer: conni Status: ready --> <refentry xml:id="function.pg-query" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>pg_query</refname> @@ -20,17 +20,17 @@ </methodsynopsis> <para> <function>pg_query</function> führt die <parameter>query</parameter> - auf der angegebenen <parameter>connection</parameter> aus. + auf der angegebenen Datenbank-<parameter>connection</parameter> aus. </para> <para> Falls ein Fehler auftritt und &false; zurückgegeben wird, können Sie - diesen mit <function>pg_last_error</function> anzeigen, + Details zu diesem Fehler mit <function>pg_last_error</function> anzeigen, vorausgesetzt, die Verbindungskennung ist gültig. </para> <para> <note> <simpara> - Obwohl der Parameter <parameter>connection</parameter> weggelassen + Obwohl der Parameter <parameter>connection</parameter> weggelassen werden kann, ist dies nicht empfehlenswert, da es die Fehlersuche in Skripten erschweren kann. </simpara> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pgsql/functions/pg-result-error.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/pgsql/functions/pg-result-error.xml diff -u phpdoc-de/reference/pgsql/functions/pg-result-error.xml:1.7 phpdoc-de/reference/pgsql/functions/pg-result-error.xml:1.8 --- phpdoc-de/reference/pgsql/functions/pg-result-error.xml:1.7 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/pgsql/functions/pg-result-error.xml Mon Dec 3 01:42:02 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.9 Maintainer: conni Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.11 Maintainer: conni Status: ready --> <refentry xml:id='function.pg-result-error' xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>pg_result_error</refname> @@ -23,8 +23,7 @@ </para> <para> Mit <function>pg_result_error_field</function> bekommt man weitaus - genauere Informationen über Fehler, die mit einem Abfrageergebnis - verknüpft sind, als mit <function>pg_result_error</function>. + genauere Informationen über Fehler als mit <function>pg_result_error</function>. </para> <para> Weil <function>pg_query</function> bei einem Fehlschlag nur &false; @@ -41,7 +40,7 @@ <term><parameter>result</parameter></term> <listitem> <para> - PostgreSQL Abfrageergebnis, das (unter anderem) von <function>pg_query</function>, + PostgreSQL Eergebniskennung, die (unter anderem) von <function>pg_query</function>, <function>pg_query_params</function> oder <function>pg_execute</function> zurückgegeben wurde. </para> @@ -54,7 +53,8 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - &return.success; + Gibt einen <type>string</type> zurück, falls ein Fehler mit dem Parameter + <parameter>result</parameter> verknüpft ist, anderenfalls &false;. </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pgsql/functions/pg-result-status.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/pgsql/functions/pg-result-status.xml diff -u phpdoc-de/reference/pgsql/functions/pg-result-status.xml:1.6 phpdoc-de/reference/pgsql/functions/pg-result-status.xml:1.7 --- phpdoc-de/reference/pgsql/functions/pg-result-status.xml:1.6 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/pgsql/functions/pg-result-status.xml Mon Dec 3 01:42:02 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.9 Maintainer: conni Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.11 Maintainer: conni Status: ready --> <refentry xml:id='function.pg-result-status' xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>pg_result_status</refname> @@ -18,8 +18,8 @@ </methodsynopsis> <para> <function>pg_result_status</function> gibt den Status eines - Abfrageergebnisses zurück oder einen <type>string</type>, der eine - PostgreSQL Meldung enthält, die mit dem Abfrageergebnis verknüpft ist. + Abfrageergebnisses zurück oder das mit dem Ergebnis verknüpfte PostgreSQL + Kommando-Tag, wenn die Abfrage erfolgreich war. </para> </refsect1> @@ -31,7 +31,7 @@ <term><parameter>result</parameter></term> <listitem> <para> - PostgreSQL Verbindungskennung, die (unter anderem) von den + PostgreSQL Ergebniskennung, die (unter anderem) von den Funktionen <function>pg_query</function>, <function>pg_query_params</function> oder <function>pg_execute</function> zurückgegeben wurde. @@ -44,9 +44,9 @@ <para> Entweder <constant>PGSQL_STATUS_LONG</constant>, um die Statusnummer von <parameter>result</parameter> zu erhalten, oder - <constant>PGSQL_STATUS_STRING</constant>, um eine PostgreSQL-Meldung für das + <constant>PGSQL_STATUS_STRING</constant>, um das PostgreSQL Kommando-Tag für das <parameter>result</parameter> zu erhalten. Falls nichts angegeben - wurde, wird der Vorgabewert <constant>PGSQL_STATUS_LONG</constant> übergeben. + wurde, wird der Vorgabewert <constant>PGSQL_STATUS_LONG</constant> zurückgegeben. </para> </listitem> </varlistentry> @@ -61,8 +61,32 @@ <constant>PGSQL_COMMAND_OK</constant>, <constant>PGSQL_TUPLES_OK</constant>, <constant>PGSQL_COPY_OUT</constant>, <constant>PGSQL_COPY_IN</constant>, <constant>PGSQL_BAD_RESPONSE</constant>, <constant>PGSQL_NONFATAL_ERROR</constant> und <constant>PGSQL_FATAL_ERROR</constant>, falls <constant>PGSQL_STATUS_LONG</constant> angegeben wurde. - Anderenfalls wird ein <type>string</type> zurückgegeben, der die - PostgreSQL-Meldung enthält. + Anderenfalls wird ein <type>string</type> zurückgegeben, der das + PostgreSQL Kommando-Tag enthält. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.3.0</entry> + <entry> + Der Parameter <parameter>type</parameter> wurde hinzugefügt. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> </para> </refsect1> @@ -88,15 +112,14 @@ if ($status == PGSQL_COPY_IN) echo "Copy begonnen."; else - echo "Copy fehlgeschlagen."; - + echo "Copy fehlgeschlagen."; ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ -Copy began. +Copy begonnen. ]]> </screen> </example>
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pgsql/functions/pg-fetch-row.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-de/reference/pgsql/functions/pg-fetch-row.xml diff -u phpdoc-de/reference/pgsql/functions/pg-fetch-row.xml:1.11 phpdoc-de/reference/pgsql/functions/pg-fetch-row.xml:1.12 --- phpdoc-de/reference/pgsql/functions/pg-fetch-row.xml:1.11 Sat Jun 23 13:21:45 2007 +++ phpdoc-de/reference/pgsql/functions/pg-fetch-row.xml Mon Dec 3 01:42:01 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.13 Maintainer: conni Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.15 Maintainer: conni Status: ready --> <refentry xml:id="function.pg-fetch-row" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -21,11 +21,6 @@ <parameter>result</parameter> bezeichnet wird. </para> &database.fetch-null; - <note> - <para> - Ab PHP 4.1.0 wurde <parameter>row</parameter> optional. - </para> - </note> </refsect1> <refsect1 role="parameters"> @@ -37,8 +32,8 @@ <listitem> <para> PostgreSQL Verbindungskennung, die (unter anderem) von den - Funktionen <function>pg_query</function>, - <function>pg_query_params</function> oder <function>pg_execute</function> zurückgegeben wurde. + Funktionen <function>pg_query</function>, <function>pg_query_params</function> + oder <function>pg_execute</function> zurückgegeben wurde. </para> </listitem> </varlistentry> @@ -47,7 +42,8 @@ <listitem> <para> Die Nummer der Zeile des Abfrageergebnisses, die geholt werden - soll. Die Nummerierung beginnt bei 0. Fehlt dieser Parameter, so wird jeweils die nächste Zeile geholt. + soll. Die Nummerierung beginnt bei 0. Fehlt dieser Parameter, so wird + jeweils die nächste Zeile geholt. </para> </listitem> </varlistentry> @@ -60,7 +56,7 @@ <para> Die gelesene Zeile des Abfrageergebnisses (Datensatz) wird als numerisches <type>array</type>, beginnend bei Offset 0, zurückgegeben, - das die Feldwerte in den Arraykomponenten enthält. Diese werden als + das die Spaltenwerte in den Arraykomponenten enthält. Diese werden als <type>string</type> repräsentiert, Nullwerte der Datenbank (<literal>NULL</literal>) werden als &null; zurückgegeben. </para> @@ -70,6 +66,30 @@ kein Datensatz mehr gelesen werden kann, wird &false; zurückgegeben. </para> </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.1.0</entry> + <entry> + Der Parameter <parameter>row</parameter> wurde optional. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> <refsect1 role="examples"> &reftitle.examples; http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pgsql/functions/pg-last-notice.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/pgsql/functions/pg-last-notice.xml diff -u phpdoc-de/reference/pgsql/functions/pg-last-notice.xml:1.7 phpdoc-de/reference/pgsql/functions/pg-last-notice.xml:1.8 --- phpdoc-de/reference/pgsql/functions/pg-last-notice.xml:1.7 Sat Jun 23 13:21:45 2007 +++ phpdoc-de/reference/pgsql/functions/pg-last-notice.xml Mon Dec 3 01:42:02 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.6 Maintainer: conni Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.8 Maintainer: conni Status: ready --> <refentry xml:id="function.pg-last-notice" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>pg_last_notice</refname> @@ -27,30 +27,17 @@ Abfragen vermieden werden, indem man prüft, ob eine NOTICE-Meldung sich auf die aktuelle Transaktion bezieht oder nicht. </para> - <warning> - <para> - Diese Funktion ist EXPERIMENTELL und noch nicht vollständig - implementiert. <function>pg_last_notice</function> wurde mit der - Version 4.0.6 eingeführt. Diese Version hat jedoch Probleme mit der - Verarbeitung der NOTICE-Meldungen. Von der Benutzung des - PostgreSQL-Moduls mit PHP 4.0.6 wird abgeraten, auch wenn Sie die - Funktion <function>pg_last_notice</function> nicht nutzen. - </para> - <para> - Diese Funktion ist seit PHP 4.3.0 vollständig implementiert. In PHP-Versionen davor wird der Parameter <parameter>connection</parameter> ignoriert. - </para> - </warning> <para> - Die Verfolgung von Notice-Benachrichtigungen kann ab PHP 4.3.0 auf + Die Verfolgung von NOTICE-Benachrichtigungen kann auf optional gesetzt werden, indem die Direktive <literal>pgsql.ignore_notice</literal> in &php.ini; den Wert 1 erhält. </para> <para> - Die Protokollierung von Notice-Benachrichtigungen kann ab PHP 4.3.0 auf + Die Protokollierung von Notice-Benachrichtigungen kann auf optional gesetzt werden, indem die Direktive - <literal>pgsql.log_notice</literal> in &php.ini; den Wert 1 erhält. Wenn + <literal>pgsql.log_notice</literal> in &php.ini; den Wert 0 erhält. Nur wenn die Direktive <literal>pgsql.ignore_notice</literal> den Wert 0 hat, - können keine Notice-Benachrichtigungen protokolliert werden. + können Notice-Benachrichtigungen protokolliert werden. </para> </refsect1> @@ -79,6 +66,48 @@ </para> </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.3.0</entry> + <entry> + Diese Funktion ist nun vollständig implementiert. In früheren + Versionen wurde die Angabe des Parameters für die Verbindungskennung + zur Datenbank ignoriert. + </entry> + </row> + <row> + <entry>4.3.0</entry> + <entry> + Die Direktiven <literal>pgsql.ignore_notice</literal> und + <literal>pgsql.log_notice</literal> wurden in die &php.ini; eingefügt. + </entry> + </row> + <row> + <entry>4.0.6</entry> + <entry> + In PHP 4.0.6 gibt es ein Problem mit der Verarbeitung der + Notice-Benachrichtigungen. Von der Verwendung des PostgreSQL-Moduls + mit PHP 4.0.6 wird abgeraten, selbst wenn Sie die Funktion + <function>pg_last_notice</function> nicht einsetzen. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pgsql/functions/pg-lo-import.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/pgsql/functions/pg-lo-import.xml diff -u phpdoc-de/reference/pgsql/functions/pg-lo-import.xml:1.8 phpdoc-de/reference/pgsql/functions/pg-lo-import.xml:1.9 --- phpdoc-de/reference/pgsql/functions/pg-lo-import.xml:1.8 Sat Jun 23 13:21:45 2007 +++ phpdoc-de/reference/pgsql/functions/pg-lo-import.xml Mon Dec 3 01:42:02 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.9 Maintainer: conni Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.11 Maintainer: conni Status: ready --> <refentry xml:id="function.pg-lo-import" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>pg_lo_import</refname> @@ -19,16 +19,8 @@ <methodparam><type>string</type><parameter>pathname</parameter></methodparam> </methodsynopsis> <para> - In PHP Versionen vor 4.2.0 hatte diese Funktion eine andere Syntax, siehe die folgende Definition: - </para> - <methodsynopsis> - <type>int</type><methodname>pg_lo_import</methodname> - <methodparam><type>string</type><parameter>pathname</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>connection</parameter></methodparam> - </methodsynopsis> - <para> <function>pg_lo_import</function> erzeugt ein neues Large Object in der - Datenbank, in dem die Daten einer lokalen Datei gespeichert werden. + Datenbank, in dem die Daten einer Datei aus dem Dateisystem gespeichert werden. </para> <para> Um die Large Object (lo) Schnittstelle benutzen zu können, müssen @@ -50,10 +42,9 @@ <term><parameter>connection</parameter></term> <listitem> <para> - PostgreSQL Verbindungskennung, die (unter anderem) von den - Funktionen <function>pg_query</function>, - <function>pg_query_params</function> oder - <function>pg_execute</function> zurückgegeben wurde. + PostgreSQL Verbindungskennung. Wenn <parameter>connection</parameter> nicht + angegeben ist, wird die zuletzt von <function>pg_connect</function> oder + <function>pg_pconnect</function> geöffnete Verbindung benutzt. </para> </listitem> </varlistentry> @@ -61,8 +52,8 @@ <term><parameter>pathname</parameter></term> <listitem> <para> - Der vollständige Pfad und Dateinamen der Datei im lokalen - Dateisystem, aus der die Inhalte des Large Objects gelesen werden. + Der vollständige Pfad- und Dateiname der Datei im lokalen + Dateisystem des Clients, aus der die Daten des Large Objects gelesen werden. </para> </listitem> </varlistentry> @@ -77,7 +68,36 @@ &false;, wenn ein Fehler auftrat. </para> </refsect1> - + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.2.0</entry> + <entry><para> + Die Syntax dieser Funktion wurde wie folgt geändert: + <methodsynopsis> + <type>int</type><methodname>pg_lo_import</methodname> + <methodparam><type>string</type><parameter>pathname</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>connection</parameter></methodparam> + </methodsynopsis> + </para></entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pgsql/functions/pg-query.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/pgsql/functions/pg-query.xml diff -u phpdoc-de/reference/pgsql/functions/pg-query.xml:1.8 phpdoc-de/reference/pgsql/functions/pg-query.xml:1.9 --- phpdoc-de/reference/pgsql/functions/pg-query.xml:1.8 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/pgsql/functions/pg-query.xml Mon Dec 3 01:42:02 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.14 Maintainer: conni Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.15 Maintainer: conni Status: ready --> <refentry xml:id="function.pg-query" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>pg_query</refname> @@ -20,17 +20,17 @@ </methodsynopsis> <para> <function>pg_query</function> führt die <parameter>query</parameter> - auf der angegebenen <parameter>connection</parameter> aus. + auf der angegebenen Datenbank-<parameter>connection</parameter> aus. </para> <para> Falls ein Fehler auftritt und &false; zurückgegeben wird, können Sie - diesen mit <function>pg_last_error</function> anzeigen, + Details zu diesem Fehler mit <function>pg_last_error</function> anzeigen, vorausgesetzt, die Verbindungskennung ist gültig. </para> <para> <note> <simpara> - Obwohl der Parameter <parameter>connection</parameter> weggelassen + Obwohl der Parameter <parameter>connection</parameter> weggelassen werden kann, ist dies nicht empfehlenswert, da es die Fehlersuche in Skripten erschweren kann. </simpara> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pgsql/functions/pg-result-error.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/pgsql/functions/pg-result-error.xml diff -u phpdoc-de/reference/pgsql/functions/pg-result-error.xml:1.7 phpdoc-de/reference/pgsql/functions/pg-result-error.xml:1.8 --- phpdoc-de/reference/pgsql/functions/pg-result-error.xml:1.7 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/pgsql/functions/pg-result-error.xml Mon Dec 3 01:42:02 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.9 Maintainer: conni Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.11 Maintainer: conni Status: ready --> <refentry xml:id='function.pg-result-error' xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>pg_result_error</refname> @@ -23,8 +23,7 @@ </para> <para> Mit <function>pg_result_error_field</function> bekommt man weitaus - genauere Informationen über Fehler, die mit einem Abfrageergebnis - verknüpft sind, als mit <function>pg_result_error</function>. + genauere Informationen über Fehler als mit <function>pg_result_error</function>. </para> <para> Weil <function>pg_query</function> bei einem Fehlschlag nur &false; @@ -41,7 +40,7 @@ <term><parameter>result</parameter></term> <listitem> <para> - PostgreSQL Abfrageergebnis, das (unter anderem) von <function>pg_query</function>, + PostgreSQL Eergebniskennung, die (unter anderem) von <function>pg_query</function>, <function>pg_query_params</function> oder <function>pg_execute</function> zurückgegeben wurde. </para> @@ -54,7 +53,8 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - &return.success; + Gibt einen <type>string</type> zurück, falls ein Fehler mit dem Parameter + <parameter>result</parameter> verknüpft ist, anderenfalls &false;. </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pgsql/functions/pg-result-status.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/pgsql/functions/pg-result-status.xml diff -u phpdoc-de/reference/pgsql/functions/pg-result-status.xml:1.6 phpdoc-de/reference/pgsql/functions/pg-result-status.xml:1.7 --- phpdoc-de/reference/pgsql/functions/pg-result-status.xml:1.6 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/pgsql/functions/pg-result-status.xml Mon Dec 3 01:42:02 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.9 Maintainer: conni Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.11 Maintainer: conni Status: ready --> <refentry xml:id='function.pg-result-status' xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>pg_result_status</refname> @@ -18,8 +18,8 @@ </methodsynopsis> <para> <function>pg_result_status</function> gibt den Status eines - Abfrageergebnisses zurück oder einen <type>string</type>, der eine - PostgreSQL Meldung enthält, die mit dem Abfrageergebnis verknüpft ist. + Abfrageergebnisses zurück oder das mit dem Ergebnis verknüpfte PostgreSQL + Kommando-Tag, wenn die Abfrage erfolgreich war. </para> </refsect1> @@ -31,7 +31,7 @@ <term><parameter>result</parameter></term> <listitem> <para> - PostgreSQL Verbindungskennung, die (unter anderem) von den + PostgreSQL Ergebniskennung, die (unter anderem) von den Funktionen <function>pg_query</function>, <function>pg_query_params</function> oder <function>pg_execute</function> zurückgegeben wurde. @@ -44,9 +44,9 @@ <para> Entweder <constant>PGSQL_STATUS_LONG</constant>, um die Statusnummer von <parameter>result</parameter> zu erhalten, oder - <constant>PGSQL_STATUS_STRING</constant>, um eine PostgreSQL-Meldung für das + <constant>PGSQL_STATUS_STRING</constant>, um das PostgreSQL Kommando-Tag für das <parameter>result</parameter> zu erhalten. Falls nichts angegeben - wurde, wird der Vorgabewert <constant>PGSQL_STATUS_LONG</constant> übergeben. + wurde, wird der Vorgabewert <constant>PGSQL_STATUS_LONG</constant> zurückgegeben. </para> </listitem> </varlistentry> @@ -61,8 +61,32 @@ <constant>PGSQL_COMMAND_OK</constant>, <constant>PGSQL_TUPLES_OK</constant>, <constant>PGSQL_COPY_OUT</constant>, <constant>PGSQL_COPY_IN</constant>, <constant>PGSQL_BAD_RESPONSE</constant>, <constant>PGSQL_NONFATAL_ERROR</constant> und <constant>PGSQL_FATAL_ERROR</constant>, falls <constant>PGSQL_STATUS_LONG</constant> angegeben wurde. - Anderenfalls wird ein <type>string</type> zurückgegeben, der die - PostgreSQL-Meldung enthält. + Anderenfalls wird ein <type>string</type> zurückgegeben, der das + PostgreSQL Kommando-Tag enthält. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.3.0</entry> + <entry> + Der Parameter <parameter>type</parameter> wurde hinzugefügt. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> </para> </refsect1> @@ -88,15 +112,14 @@ if ($status == PGSQL_COPY_IN) echo "Copy begonnen."; else - echo "Copy fehlgeschlagen."; - + echo "Copy fehlgeschlagen."; ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ -Copy began. +Copy begonnen. ]]> </screen> </example>