svn: /phpdoc/de/trunk/reference/pdo/ drivers.xml pdoexception.xml prepared-statements.xml transactions.xml

Modified: phpdoc/de/trunk/reference/pdo/drivers.xml
===================================================================
--- phpdoc/de/trunk/reference/pdo/drivers.xml	2011-06-19 22:59:10 UTC (rev 312314)
+++ phpdoc/de/trunk/reference/pdo/drivers.xml	2011-06-19 23:04:29 UTC (rev 312315)
@@ -1,11 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: fa Status: ready -->
+<!-- EN-Revision: 305103 Maintainer: fa Status: ready -->
 <!-- Purpose: database.abstract -->
 <!-- Membership: pecl, bundled -->

-<part xml:id="pdo.drivers" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <title>PDO Treiber</title>
+<part xml:id="pdo.drivers" xmlns="http://docbook.org/ns/docbook"
+ xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title>PDO-Treiber</title>

  <partintro>
   <para>
@@ -20,6 +21,10 @@
      </thead>
      <tbody>
       <row>
+       <entry><link linkend="ref.pdo-cubrid">PDO_CUBRID</link></entry>
+       <entry>Cubrid</entry>
+      </row>
+      <row>
        <entry><link linkend="ref.pdo-dblib">PDO_DBLIB</link></entry>
        <entry>FreeTDS / Microsoft SQL Server / Sybase</entry>
       </row>
@@ -37,7 +42,7 @@
       </row>
       <row>
        <entry><link linkend="ref.pdo-mysql">PDO_MYSQL</link></entry>
-       <entry>MySQL 3.x/4.x</entry>
+       <entry>MySQL 3.x/4.x/5.x</entry>
       </row>
       <row>
        <entry><link linkend="ref.pdo-oci">PDO_OCI</link></entry>
@@ -55,11 +60,17 @@
        <entry><link linkend="ref.pdo-sqlite">PDO_SQLITE</link></entry>
        <entry>SQLite 3 und SQLite 2</entry>
       </row>
+      <row>
+       <entry><link linkend="ref.pdo-4d">PDO_4D</link></entry>
+       <entry>4D</entry>
+      </row>
      </tbody>
     </tgroup>
    </informaltable>
   </para>
  </partintro>
+
+ &reference.pdo-cubrid.reference;
  &reference.pdo-dblib.reference;
  &reference.pdo-firebird.reference;
  &reference.pdo-ibm.reference;
@@ -69,6 +80,7 @@
  &reference.pdo-odbc.reference;
  &reference.pdo-pgsql.reference;
  &reference.pdo-sqlite.reference;
+ &reference.pdo-4d.reference;
 </part>

 <!-- Keep this comment at the end of the file
@@ -82,7 +94,7 @@
 sgml-indent-data:t
 indent-tabs-mode:nil
 sgml-parent-document:nil
-sgml-default-dtd-file:"../../../manual.ced"
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
 sgml-exposed-tags:nil
 sgml-local-catalogs:nil
 sgml-local-ecat-files:nil

Modified: phpdoc/de/trunk/reference/pdo/pdoexception.xml
===================================================================
--- phpdoc/de/trunk/reference/pdo/pdoexception.xml	2011-06-19 22:59:10 UTC (rev 312314)
+++ phpdoc/de/trunk/reference/pdo/pdoexception.xml	2011-06-19 23:04:29 UTC (rev 312315)
@@ -1,12 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: fa Status: ready -->
+<!-- EN-Revision: 292734 Maintainer: fa Status: ready -->

 <phpdoc:exceptionref xml:id="class.pdoexception" xmlns="http://docbook.org/ns/docbook"
  xmlns:xlink="http://www.w3.org/1999/xlink"
  xmlns:xi="http://www.w3.org/2001/XInclude"
  xmlns:phpdoc="http://php.net/ns/phpdoc">
- <title>The PDOException class</title>
+ <title>Die Klasse PDOException</title>
  <titleabbrev>PDOException</titleabbrev>

  <partintro>
@@ -44,10 +44,10 @@
     </classsynopsisinfo>
 <!-- }}} -->

-    <classsynopsisinfo role="comment">Properties</classsynopsisinfo>
+    <classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
     <fieldsynopsis><!-- {{{ errorInfo -->
      <modifier>public</modifier>
-     <type>string</type>
+     <type>array</type>
      <varname linkend="pdoexception.props.errorinfo">errorInfo</varname>
     </fieldsynopsis><!-- }}} -->
     <fieldsynopsis><!-- {{{ message -->
@@ -61,14 +61,15 @@
      <varname linkend="pdoexception.props.code">code</varname>
     </fieldsynopsis><!-- }}} -->

-    <classsynopsisinfo role="comment">Geerbte Methoden</classsynopsisinfo>
+    <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook)
      xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])"
      />

     <!-- FIXME: Enable when RuntimeException gets documented
     <classsynopsisinfo role="comment">Inherited methods</classsynopsisinfo>
-    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.runtimeexception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook)
+    xpointer(id('class.runtimeexception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
     -->
    </classsynopsis>
 <!-- }}} -->
@@ -83,7 +84,7 @@
      <term><varname>errorInfo</varname></term>
      <listitem>
       <para>
-       Corresponds to <function>PDO::errorInfo</function> or
+       Entsprechend <function>PDO::errorInfo</function> oder
        <function>PDOStatement::errorInfo</function>
       </para>
      </listitem>
@@ -92,7 +93,8 @@
      <term><varname>message</varname></term>
      <listitem>
       <para>
-       Textual error message. <function>Exception::getMessage</function> to access it.
+       Fehlermeldung in Textform. Zugriff via
+       <function>Exception::getMessage</function>.
       </para>
      </listitem>
     </varlistentry><!-- }}} -->
@@ -100,8 +102,8 @@
      <term><varname>code</varname></term>
      <listitem>
       <para>
-       <literal>SQLSTATE</literal> error code. Use
-       <function>Exception::getCode</function> to access it.
+       <literal>SQLSTATE</literal>-Fehlercode. Zugriff via
+       <function>Exception::getCode</function>.
       </para>
      </listitem>
     </varlistentry><!-- }}} -->
@@ -124,7 +126,7 @@
 sgml-indent-data:t
 indent-tabs-mode:nil
 sgml-parent-document:nil
-sgml-default-dtd-file:"manual.ced"
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
 sgml-exposed-tags:nil
 sgml-local-catalogs:nil
 sgml-local-ecat-files:nil

Modified: phpdoc/de/trunk/reference/pdo/prepared-statements.xml
===================================================================
--- phpdoc/de/trunk/reference/pdo/prepared-statements.xml	2011-06-19 22:59:10 UTC (rev 312314)
+++ phpdoc/de/trunk/reference/pdo/prepared-statements.xml	2011-06-19 23:04:29 UTC (rev 312315)
@@ -1,13 +1,14 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 283830 Maintainer: fa Status: ready -->
+<!-- EN-Revision: 288721 Maintainer: fa Status: ready -->

 <chapter xml:id="pdo.prepared-statements" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Prepared Statements und Stored Procedures</title>
  <para>
   Viele der ausgereifteren Datenbanken unterstützen das Konzept der Prepared
-  Statements. Was ist das? Sie können sie sich als eine Art von kompiliertem
-  Template für SQL vorstellen, das durch variable Parameter angepasst werden
+  Statements. Was ist das? Man kann sie sich als eine Art von kompiliertem
+  Template für SQL das eine Anwendung ausführen will vorstellen,
+  das durch variable Parameter angepasst werden
   kann. Prepared Statements haben zwei wichtige Vorteile:
  </para>
  <itemizedlist>
@@ -17,30 +18,30 @@
     aber mehrere Male mit denselben oder anderen Parametern ausgeführt werden.
     Wenn die Abfrage vorbereitet wird, kann die Datenbank ihre Vorgehensweise
     zur Ausführung der Abfrage analysieren, kompilieren und optimieren. Für
-    komplexe Abfragen kann dieser Vorgang genug Zeit benötigen, dass es Ihre
-    Anwendung merklich verlangsamt, wenn Sie dieselbe Abfrage oft mit
-    verschiedenen Parametern wiederholen. Mit einem Prepared Statement
-    vermeiden Sie den Zyklus der Analyse/Kompilierung/Optimierung. Kurz gesagt
-    benötigen Prepared Statements weniger Ressourcen und laufen deswegen
-    schneller.
+    komplexe Abfragen kann dieser Vorgang genug Zeit benötigen, dass es eine
+    Anwendung merklich verlangsamt, wenn dieselbe Abfrage oft mit
+    verschiedenen Parametern wiederholt wird. Mit einem Prepared Statement
+    vermeidet die Anwendung den Zyklus der Analyse/Kompilierung/Optimierung.
+    Kurz gesagt benötigen Prepared Statements weniger Ressourcen und laufen
+    deswegen schneller.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     Die Parameter für Prepared Statements müssen nicht maskiert werden. Der
-    Treiber übernimmt das für Sie. Wenn Ihre Anwendung ausschließlich
-    Prepared Statements benutzt, können Sie sicher sein, dass keine
-    SQL-Injection auftreten wird. (Wenn Sie aber trotzdem andere Teile der
-    Abfrage aus nicht zuverlässigen Eingaben generieren, sind Sie immer noch
-    gefährdet.)
+    Treiber übernimmt das automatisch. Wenn eine Anwendung ausschließlich
+    Prepared Statements benutzt, kann sich der Entwickler sicher sein, dass keine
+    SQL-Injection auftreten wird. (Wenn aber trotzdem andere Teile der
+    Abfrage aus nicht zuverlässigen Eingaben generiert werden en, ist dies
+    immer noch möglich.)
    </simpara>
   </listitem>
  </itemizedlist>
  <para>
   Prepared Statements sind so nützlich, dass sie das einzige Feature sind, das
   PDO auch für Treiber emulieren wird, die diese nicht unterstützen. Das
-  garantiert, dass Sie unabhängig von den Möglichkeiten der Datenbank dieselbe
-  Art des Datenzugriffs nutzen können.
+  garantiert, dass eine Anwendung unabhängig von den Möglichkeiten der
+  Datenbank dieselbe Art des Datenzugriffs nutzen können.
  </para>
  <para>
   <example>
@@ -123,13 +124,13 @@
   </example>
  </para>
  <para>
-  Wenn es der Datenbanktreiber unterstützt, können Sie auch Parameter für die
+  Wenn es der Datenbanktreiber unterstützt, kann eine Anwendung auch Parameter für die
   Ausgabe einführen, ähnlich der Eingabe. Ausgabeparameter werden typischerweise
   benutzt, um Werte von Stored Procedures abzurufen. Ausgabeparameter sind
-  etwas komplexer in der Verwendung als Eingabeparameter, weil Sie wissen
-  müssen, wie groß ein gegebener Parameter sein könnte, wenn Sie ihn einführen.
+  etwas komplexer in der Verwendung als Eingabeparameter, weil die Entwickler wissen
+  muss, wie groß ein gegebener Parameter sein könnte, wenn sie ihn einführen.
   Wenn der Wert sich als größer herausstellt als die vorgeschlagene Größe,
-  wird ein Fehler ausgelöst.
+  wird eine Fehlermeldung erzeugt.
  </para>

  <para>
@@ -152,7 +153,7 @@
  </para>

  <para>
-  Sie können auch Parameter angeben, die Werte für Eingabe und Ausgabe
+  Entwickler können auch Parameter angeben, die Werte für Eingabe und Ausgabe
   enthalten. Die Syntax ist ähnlich den Ausgabeparametern. In diesem nächsten
   Beispiel wird die Zeichenkette 'hallo' der Stored Procedure übergeben. Wenn
   diese etwas zurückgibt, wird 'hallo' durch den Rückgabewert der Stored
@@ -209,7 +210,7 @@
 sgml-indent-data:t
 indent-tabs-mode:nil
 sgml-parent-document:nil
-sgml-default-dtd-file:"../../../manual.ced"
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
 sgml-exposed-tags:nil
 sgml-local-catalogs:nil
 sgml-local-ecat-files:nil

Modified: phpdoc/de/trunk/reference/pdo/transactions.xml
===================================================================
--- phpdoc/de/trunk/reference/pdo/transactions.xml	2011-06-19 22:59:10 UTC (rev 312314)
+++ phpdoc/de/trunk/reference/pdo/transactions.xml	2011-06-19 23:04:29 UTC (rev 312315)
@@ -1,13 +1,13 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: fa Status: ready -->
+<!-- EN-Revision: 305216 Maintainer: fa Status: ready -->

 <chapter xml:id="pdo.transactions" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
     <title>Transaktionen und auto-commit</title>
     <para>
      Jetzt, wo Sie via PDO verbunden sind, müssen Sie sich bewusst machen, wie PDO
      Transaktionen verwaltet, bevor Sie anfangen, Abfragen auszuführen. Falls Sie noch
-     niemit Transaktionen zu tun hatten, diese bieten 4 wichtige Features: Atomizität,
+     nie mit Transaktionen zu tun hatten, diese bieten 4 wichtige Features: Atomizität,
      Konsistenz (Consistency), Isolation und Dauerhaftigkeit (Durability) (ACID).
      Einfach gesagt wird alles in einer Transaktion, auch wenn es in Einzelschritten
      ausgeführt wird, garantiert in sicherer Weise in die Datenbank eingetragen, ohne
@@ -37,13 +37,25 @@
      um die Transaktion abzuschließen, abhängig vom Erfolg des Codes, den Sie während der
      Transaktion ausgeführt haben.
     </para>
+    <warning>
+     <para>
+      PDO überprüft nur auf Treiberebene auf Transaktionsfähigkeit. Wenn bestimmte
+      Laufzeitbedingunen ergeben, dass Transaktionen nicht verfügbar sind, wird
+      <methodname>PDO::beginTransaction</methodname> trotzdem ohne Fehler &true;
+      zurückgeben, wenn der Server die Anfrage zum Start einer Transaktion akzeptiert.
+     </para>
+     <para>
+      Ein Beispiel wäre es, Transaktionen auf MyISAM-Tabellen in einer MySQL-Datenbank
+      zu verwenden
+     </para>
+    </warning>
     <para>
      Wenn das Script endet oder die Verbindung im Begriff ist, geschlossen zu werden und
      Sie eine Transaktion ausstehen haben, wird PDO automatisch einen Rollback
-     durchführen. Dies ist eine Sicherheitsmaßnahme, um Inkonsistenzen in dem Fall, wo
+     durchführen. Dies ist eine Sicherheitsmaßnahme, um Inkonsistenzen in dem Fall, dass
      das Script unerwartet beendet wird, zu vermeiden - wenn Sie die Transaktion nicht
      explizit ausgeführt haben, wird angenommen, dass etwas schiefgegangen ist, deswegen
-     wird zur Sicherheit ein Rollback durchgeführt.
+     wird zur Sicherheit Ihrer Daten ein Rollback durchgeführt.
     </para>
     <warning>
      <para>
@@ -73,6 +85,11 @@
   $dbh = new PDO('odbc:SAMPLE', 'db2inst1', 'ibmdb2',
       array(PDO::ATTR_PERSISTENT => true));
   echo "Connected\n";
+} catch (Exception $e) {
+  die("Unable to connect: " . $e->getMessage());
+}
+
+try {
   $dbh->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

   $dbh->beginTransaction();
@@ -111,7 +128,7 @@
 sgml-indent-data:t
 indent-tabs-mode:nil
 sgml-parent-document:nil
-sgml-default-dtd-file:"../../../manual.ced"
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
 sgml-exposed-tags:nil
 sgml-local-catalogs:nil
 sgml-local-ecat-files:nil