cvs: phpdoc-de /reference/pdo book.xml configure.xml connections.xml drivers.xml error-handling.xml lobs.xml pdo.xml pdoexception.xml
prepared-statements.xml reference.xml setup.xml transactions.xml
| From: | Hartmut Holzgraefe | Date: | Tue, 11 Mar 2008 13:53:25 +0000 |
| Subject: | cvs: phpdoc-de /reference/pdo book.xml configure.xml connections.xml drivers.xml error-handling.xml lobs.xml pdo.xml pdoexception.xml prepared-statements.xml reference.xml setup.xml transactions.xml |
||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2515@lists.php.net to get a copy of this message | ||
hholzgra Tue Mar 11 13:53:25 2008 UTC
Added files:
/phpdoc-de/reference/pdo book.xml configure.xml connections.xml
drivers.xml error-handling.xml lobs.xml
pdo.xml pdoexception.xml
prepared-statements.xml setup.xml
transactions.xml
Removed files:
/phpdoc-de/reference/pdo reference.xml
Log:
new file structure
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pdo/book.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pdo/book.xml +++ phpdoc-de/reference/pdo/book.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: fa Status: ready --> <!-- Purpose: database.abstract --> <!-- Membership: pecl, bundled --> <book xml:id="book.pdo" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>PHP Data Objects</title> <titleabbrev>PDO</titleabbrev> <!-- {{{ preface --> <preface xml:id="intro.pdo"> &reftitle.intro; <para> Die PHP Data Objects(PDO)-Erweiterung stellt eine leichte, konsistente Schnittstelle bereit, um mit PHP auf Datenbanken zuzugreifen. Jeder Datenbanktreiber, der die PDO-Schnittstelle implementiert, kann spezifische Features als reguläre Funktionen der Erweiterung bereitstellen. Beachten Sie, dass Sie keine Funktionen der Datenbank mit PDO allein benutzen können. Sie müssen einen <link linkend="pdo.drivers">datenbankspezifischen PDO-Treiber</link> benutzen, um auf eine Datenbank zuzugreifen. </para> <para> PDO bietet eine Abstraktionsschicht für den <emphasis>Datenzugriff</emphasis>, das bedeutet, dass Sie, egal welche Datenbank Sie benutzen, dieselben Funktionen verwenden können, um Abfragen zu erstellen und Daten zu lesen. PDO bietet keine Abstraktion für <emphasis>Datenbanken</emphasis>. Es schreibt keine SQL-Abfragen um oder emuliert fehlende Features. Sie sollten eine komplette Abstraktionsschicht verwenden, wenn Sie diese Funktionalität benötigen. </para> <para> PDO wird mit PHP 5.1 ausgeliefert und ist als PECL-Erweiterung für PHP 5.0 verfügbar. PDO benötigt die neuen OO-Features im Kern von PHP 5 und wird deswegen nicht mit früheren Versionen von PHP funktionieren. </para> </preface> <!-- }}} --> &reference.pdo.setup; &reference.pdo.constants; &reference.pdo.connections; &reference.pdo.transactions; &reference.pdo.prepared-statements; &reference.pdo.error-handling; &reference.pdo.lobs; &reference.pdo.pdo; &reference.pdo.pdostatement; <!-- FIXME: Find out how to deal with classess without any methods &reference.pdo.pdoexception; --> &reference.pdo.drivers; </book> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pdo/configure.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pdo/configure.xml +++ phpdoc-de/reference/pdo/configure.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.6 Maintainer: fa Status: ready --> <section xml:id="pdo.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.install; <procedure xml:id='pdo.install.unix51up'> <title>PHP 5.1 und höher auf Unix-Systemen</title> <step> <para> Wenn Sie ein PHP 5.1-Release verwenden, ist PDO bereits enthalten. Es wird automatisch angeschaltet, wenn Sie configure ausführen. Es wird empfohlen, PDO als shared module zu kompilieren, da Sie so die durch PECL bereitgestellen Updates nutzen können. Das empfohlene configure-Kommando, um PHP mit PDO zu kompilieren, sollte auch die zlib-Unterstützung (für den PEAR-Installer) aktivieren. Sie müssen eventuell auch den PDO-Treiber für die Datenbank Ihrer Wahl aktivieren. Ziehen Sie die Dokumentation für <link linkend="pdo.drivers">datenbankspezifische PDO-Treiber</link> zu Rate, um mehr darüber herauszufinden, aber beachten Sie, dass Sie, wenn Sie PDO als Shared Extension bauen, auch die PDO-Treiber als Shared Extensions bauen müssen. <screen> <![CDATA[ ./configure --with-zlib --enable-pdo=shared ]]> </screen> </para> </step> <step> <para> Nach der Installation von PDA als shared module müssen sie Ihre &php.ini;-Datei bearbeiten, damit die PDO-Erweiterung automatisch geladen wird, wenn PHP ausgeführt wird. Sie müssen dort auch alle datenbankspezifischen Treiber aktivieren. Versichern Sie sich, dass diese nach der Zeile mit pdo.so stehen, da PDO initialisiert werden muss, bevor die datenbankspezifischen Erweiterungen geladen werden können. Wenn Sie PDO und die datenbankspezifischen Erweiterungen statisch kompiliert haben, können Sie diesen Schritt überspringen. <screen> <![CDATA[ extension=pdo.so ]]> </screen> </para> </step> <step> <para> PDO als shared module zu benutzen erlaubt Ihnen, <command>pear upgrade pdo</command> auszuführen, wenn neue Versionen von PDO veröffentlicht werden, ohne dass Sie PHP komplett neu kompilieren müssen. Beachten Sie, dass Sie auch die datenbankspezifischen Treiber zur gleichen Zeit aktualisieren müssen. </para> </step> </procedure> <procedure xml:id='pdo.install.pecl'> <title>PHP 5.0 und höher auf Unix-Systemen</title> <step> <para> PDO ist als PECL-Erweiterung verfügbar auf <link xlink:href='&url.pecl.package;pdo'>&url.pecl.package;pdo</link>. Die Installation kann mit Hilfe des <command>pear</command>-Tools durchgeführt werden. Dies ist standardmäÃig aktiviert, wenn sie PHP konfigurieren. Sie sollten sich vergewissern, dass PHP mit <option role="configure">--with-zlib</option> erstellt wurde, damit <command>pear</command> mit der komprimierten Paketdatei umgehen kann. </para> </step> <step> <para> Führen Sie den folgenden Befehl aus, um die neueste stabile Version von PDO herunterzuladen, zu kompilieren und zu installieren: <screen> <![CDATA[ pear install pdo ]]> </screen> </para> </step> <step> <para> Wenn PDO sich noch in der Beta-Phase befindet (und zur Zeit, wenn diese Zeilen geschrieben werden, ist es das noch), werden Sie dem <command>pear</command>-Tool explizit mitteilen müssen, dass es in Ordnung ist, das Beta-Paket zu benutzen. Statt des oben genannten Befehls benutzen Sie einfach: <screen> <![CDATA[ pear install pdo-beta ]]> </screen> </para> </step> <step> <para> Der <command>pear</command>-Befehl installiert das PDO-Modul automatisch in Ihr PHP-<link linkend="ini.extension-dir">extensions</link>-Verzeichnis. Um die PDO-Erweiterung unter Linux oder Unix zu aktivieren, müssen Sie die folgende Zeile zur &php.ini; hinzufügen: <screen> <![CDATA[ extension=pdo.so ]]> </screen> </para> <para> Für weitere Informationen über das Erstellen von PECL-Paketen lesen Sie am besten das Kapitel <link linkend="install.pecl">PECL-Installation</link> im Handbuch. </para> </step> </procedure> <procedure xml:id='pdo.install.win32php51'> <title>PHP 5.1 und höher unter Windows</title> <step> <para> PDO und alle gängigen Treiber werden mit PHP als shared module mitgeliefert und müssen nur durch Bearbeiten der Datei &php.ini; aktiviert werden: <screen> <![CDATA[ extension=php_pdo.dll ]]> </screen> </para> </step> <step> <para> Als nächstes wählen sie die datenbankspezifischen DLL-Dateien und laden sie entweder per <function>dl</function> zur Laufzeit oder aktivieren sie in der Datei &php.ini; unterhalb von <filename>php_pdo.dll</filename>. Zum Beispiel: <screen> <![CDATA[ extension=php_pdo.dll extension=php_pdo_firebird.dll extension=php_pdo_informix.dll extension=php_pdo_mssql.dll extension=php_pdo_mysql.dll extension=php_pdo_oci.dll extension=php_pdo_oci8.dll extension=php_pdo_odbc.dll extension=php_pdo_pgsql.dll extension=php_pdo_sqlite.dll ]]> </screen> </para> <para> Diese DLLs sollten im <link linkend="ini.extension-dir">extension_dir</link> des Systems vorhanden sein. Beachten Sie bitte, dass <link linkend="ref.pdo-informix">PDO_INFORMIX</link> nur als PECL-Erweiterung verfügbar ist. </para> </step> </procedure> </section> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pdo/connections.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pdo/connections.xml +++ phpdoc-de/reference/pdo/connections.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: fa Status: ready --> <chapter xml:id="pdo.connections" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Connections and Connection management</title> <title>Verbindungen und Verwaltung der Verbindungen</title> <para> Verbindungen werden durch das Erstellen von Instanzen der PDO-Basisklase erzeugt. Es ist unerheblich, welchen Treiber Sie benutzen wollen. Sie benutzen immer den PDO-Klassennamen. Der Konstruktor erwartet Parameter zur Angabe der Datenbankquelle (auch bekannt als DSN) und optional für Benutzername und Passwort (falls vorhanden). </para> <para> <example><title>Mit MySQL verbinden</title> <programlisting role='php'> <![CDATA[ <?php $dbh = new PDO('mysql:host=localhost;dbname=test', $user, $pass); ?> ]]> </programlisting> </example> </para> <para> Wenn es Fehler bei der Verbindung gibt, wird eine Ausnahme vom Typ <literal>PDOException</literal> geworfen. Sie können die Ausnahme abfangen, wenn Sie sich selbst um die Fehlerbedingung kümmern wollen, oder Sie können es einer globalen Routine zur Ausnahmebehandlung überlassen, die Sie mit <function>set_exception_handler</function> konfigurieren. </para> <para> <example><title>Verbindungsfehler behandeln</title> <programlisting role='php'> <![CDATA[ <?php try { $dbh = new PDO('mysql:host=localhost;dbname=test', $user, $pass); foreach ($dbh->query('SELECT * from FOO') as $row) { print_r($row); } $dbh = null; } catch (PDOException $e) { print "Error!: " . $e->getMessage() . "<br/>"; die(); } ?> ]]> </programlisting> </example> </para> <warning> <para> Wenn Ihre Anwendung die vom PDO-Konstruktor geworfene Ausnahme nicht auffängt, ist die normale Vorgehnsweise der Zend Engine, das Script zu terminieren und einen Backtrace anzuzeigen. Dieser Backtrace wird wahrscheinlich alle Details der Datenbankverbindung enthüllen, inklusive Benutzername und Passwort. Sie sind also verantwortlich, diese Ausnahme aufzufangen, entweder explizit (mit einem <literal>catch</literal>-Block) oder implizit mit <function>set_exception_handler</function>. </para> </warning> <para> Bei erfolgreicher Verbindung zur Datenbank wird eine Instanz der PDO-Klasse an Ihr Script zurückgegeben. Die Verbindung bleibt während der Lebensdauer des PDO-Objekts aktiv. Um die Verbindung zu beenden, müssen Sie das Objekt löschen, indem Sie sicherstellen, dass alle Referenzen darauf gelöscht werden - das erreichen Sie, indem Sie der Variable, die das Objekt beinhaltet, &null; zuweisen. Wenn Sie das nicht explizit tun, schlieÃt PHP die verbindung automatisch, wenn Ihr Script endet. </para> <para> <example><title>Eine Verbindung schlieÃen</title> <programlisting role='php'> <![CDATA[ <?php $dbh = new PDO('mysql:host=localhost;dbname=test', $user, $pass); // use the connection here // and now we're done; close it $dbh = null; ?> ]]> </programlisting> </example> </para> <para> Viele Webanwendungen profitieren von persistenten Verbindungen zum Datenbankserver. Persistente Verbindungen werden nicht am Ende des Scripts geschlossen, sondern werden gecachet und wieder benutzt, wenn ein anderes Script eine Verbindung mit denselben Daten anfordert. Der Cache an persistenten Verbindungen erlaubt Ihnen, den Overhead zu vermeiden, wenn jedes mal eine neue Verbindung geöffnet wird, sobald ein Script mit der Datenbank kommunizieren muss, was sich in einer schnelleren Anwendung widerspiegelt. </para> <para> <example><title>Persistente Verbindungen</title> <programlisting role='php'> <![CDATA[ <?php $dbh = new PDO('mysql:host=localhost;dbname=test', $user, $pass, array( PDO::ATTR_PERSISTENT => true )); ?> ]]> </programlisting> </example> </para> <note> <para> Wenn Sie den PDO-ODBC-Treiber benutzen und Ihre ODBC-Bibliotheken ODBC Connection Pooling unterstützen (unixODBC und Windows etwa, es könnte auch andere geben), dann wird empfohlen, dass sie keine persistenten PDO-Verbindungen benutzen, sondern das Cachen der Verbindungen der ODBC Connection Pooling-Schicht überlassen. Der ODBC Connection Pool wird mit anderen Modulen im Prozess geteilt. Wenn PDO also angewiesen wird die Verbindung zu cachen, wird diese Verbindung nie dem ODBC Connection Pool zurückgegeben, was darin resultiert, dass zusätzliche Verbindungen aufgebaut werden, um jene anderen Module zu bedienen. </para> </note> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pdo/drivers.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pdo/drivers.xml +++ phpdoc-de/reference/pdo/drivers.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- 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> <partintro> <para> Die folgenden Treiber implementieren momentan die PDO-Schnittstelle: <informaltable> <tgroup cols='2'> <thead> <row> <entry>Treibername</entry> <entry>Unterstützte Datenbanken</entry> </row> </thead> <tbody> <row> <entry><link linkend="ref.pdo-dblib">PDO_DBLIB</link></entry> <entry>FreeTDS / Microsoft SQL Server / Sybase</entry> </row> <row> <entry><link linkend="ref.pdo-firebird">PDO_FIREBIRD</link></entry> <entry>Firebird/Interbase 6</entry> </row> <row> <entry><link linkend="ref.pdo-informix">PDO_INFORMIX</link></entry> <entry>IBM Informix Dynamic Server</entry> </row> <row> <entry><link linkend="ref.pdo-mysql">PDO_MYSQL</link></entry> <entry>MySQL 3.x/4.x</entry> </row> <row> <entry><link linkend="ref.pdo-oci">PDO_OCI</link></entry> <entry>Oracle Call Interface</entry> </row> <row> <entry><link linkend="ref.pdo-odbc">PDO_ODBC</link></entry> <entry>ODBC v3 (IBM DB2, unixODBC und win32 ODBC)</entry> </row> <row> <entry><link linkend="ref.pdo-pgsql">PDO_PGSQL</link></entry> <entry>PostgreSQL</entry> </row> <row> <entry><link linkend="ref.pdo-sqlite">PDO_SQLITE</link></entry> <entry>SQLite 3 und SQLite 2</entry> </row> </tbody> </tgroup> </informaltable> </para> </partintro> &reference.pdo-dblib.reference; &reference.pdo-firebird.reference; &reference.pdo-ibm.reference; &reference.pdo-informix.reference; &reference.pdo-mysql.reference; &reference.pdo-oci.reference; &reference.pdo-odbc.reference; &reference.pdo-pgsql.reference; &reference.pdo-sqlite.reference; </part> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pdo/error-handling.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pdo/error-handling.xml +++ phpdoc-de/reference/pdo/error-handling.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: fa Status: ready --> <chapter xml:id="pdo.error-handling" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Fehler und Fehlerbehandlung</title> <para> PDO bietet Ihnen die Wahl unter 3 verschiedenen Strategien zur Fehlerbehandlung, um Ihrem Stil der Anwendungsentwicklung gerecht zu werden. </para> <itemizedlist> <listitem> <para> <constant>PDO::ERRMODE_SILENT</constant> </para> <para> Das ist die Standardmethode. PDO setzt einfach den Fehler-Code, damit Sie ihn mit den Methoden <function>PDO::errorCode</function> und <function>PDO::errorInfo</function> sowohl im Statement- als auch im Datenbank-Objekt überprüfen können. Wenn der Fehler aus einem Aufruf eines Statement-Objekts hervorging, würden Sie die Methoden <function>PDOStatement::errorCode</function> oder <function>PDOStatement::errorInfo</function> des Objekts aufrufen. Wenn der Fehler aus einem Aufruf des Datenbank-Objekts hervorging, würden Sie diese Methoden des Datenbank-Objekts aufrufen. </para> </listitem> <listitem> <para> <constant>PDO::ERRMODE_WARNING</constant> </para> <para> Zusätzlich zum Setzen des Fehler-Codes wird PDO eine traditionelle E_WARNING-Nachricht ausgeben. Diese Einstellung ist nützlich während des Debuggens/Testens, wenn Sie sehen wollen, welche Probleme aufgetreten sind, ohne den Ablauf der Anwendung zu unterbrechen. </para> </listitem> <listitem> <para> <constant>PDO::ERRMODE_EXCEPTION</constant> </para> <para> Zusätzlich zum Setzen des Fehler-Codes wirft PDO eine <classname>PDOException</classname> und setzt deren Eigenschaften so, dass sie den Fehler-Code und Fehlerinformationen widergeben. Diese Einstellung ist auch nützlich während des Debuggens, da sie das Script am Ort des Fehlers gewissermaÃen "sprengt" und sehr schnell mögliche Problemstellen in Ihrem Code aufzeigt. (Zur Erinnerung: Transaktionen bekommen automatisch einen Rollback, wenn eine Ausnahme das Script beendet.) </para> <para> Diese Einstellung ist auch nützlich, da Sie ihre Fehlerbehandlung klarer als mit traditionellen PHP-Warnungen strukturireren können und mit weniger Code und Verschachtelung als im stillen Modus mit expliziter Ãberprüfung des Rückgabewertes jedes einzelnen Datenbankaufrufes. </para> <para> Unter <link linkend='language.exceptions'>Ausnahmen</link> finden Sie weitere Informationen über Ausnahmen in PHP. </para> </listitem> </itemizedlist> <para> PDO benutzt Fehler-Codes nach SQL-92 SQLSTATE. Individuelle PDO-Treiber sind selbst verantwortlich, ihre nativen Fehler-Codes in die entsprechenden SQLSTATE-Pendants umzuwandeln. Die Methode <function>PDO::errorCode</function> gibt einen einzelnen SQLSTATE-Code zurück. Wenn Sie genauere Informationen über einen Fehler benötigen, bietet PDO auch die Methode <function>PDO::errorInfo</function>, die ein Array zurückgibt, das den SQLSTATE-Code, den treiberspezifischen Fehler-Code und die treiberspezifische Fehlermeldung enthält. </para> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pdo/lobs.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pdo/lobs.xml +++ phpdoc-de/reference/pdo/lobs.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: fa Status: ready --> <chapter xml:id="pdo.lobs" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Large Objects (LOBs)</title> <para> Es könnte an irgendeinem Punkt in Ihrer Anwendung passieren, dass Sie eine "groÃe" Menge an Daten in Ihrer Datenbank ablegen müssen. Groà bedeutet typischerweise "etwa 4kb oder mehr", obwohl manche Datenbanken spielend bis zu 32kb bearbeiten können, bevor das als "groÃ" zählt. Large Objects können aus Text oder Binärdaten bestehen. PDO erlaubt Ihnen, mit diesem groÃen Datentyp zu arbeiten, indem Sie <constant>PDO::PARAM_LOB</constant> als Typ in Ihren Methodenaufrufen von <function>PDOStatement::bindParam</function> oder <function>PDOStatement::bindColumn</function> benutzen. <constant>PDO::PARAM_LOB</constant> veranlasst PDO, die Daten als Stream zu behandeln, so dass Sie diese mit Hilfe der <link linkend='ref.stream'>PHP Streams-API</link> bearbeiten können. </para> <para> </para> <para> <example><title>Ein Bild aus einer Datenbank anzeigen</title> <para> Dieses Beispiel weist das LOB der Variable namens $lob zu und sendet es mittels <function>fpassthru</function> an den Browser. Weil das LOB als Stream dargestellt wird, können Funktionen wie <function>fgets</function>, <function>fread</function> und <function>stream_get_contents</function> damit benutzt werden. </para> <programlisting role='php'> <![CDATA[ <?php $db = new PDO('odbc:SAMPLE', 'db2inst1', 'ibmdb2'); $stmt = $db->prepare("select contenttype, imagedata from images where id=?"); $stmt->execute(array($_GET['id'])); $stmt->bindColumn(1, $type, PDO::PARAM_STR, 256); $stmt->bindColumn(2, $lob, PDO::PARAM_LOB); $stmt->fetch(PDO::FETCH_BOUND); header("Content-Type: $type"); fpassthru($lob); ?> ]]> </programlisting> </example> </para> <para> <example><title>Ein Bild in eine Datenbank einfügen</title> <para> Dieses Beispiel öffnet eine Datei und übergibt das File-Handle an PDO, damit sie als LOB eingefügt wird. PDO wird sein Möglichstes tun, den Inhalt der Datei auf möglichst effiziente Weise in die Datenbank zu bekommen. </para> <programlisting role='php'> <![CDATA[ <?php $db = new PDO('odbc:SAMPLE', 'db2inst1', 'ibmdb2'); $stmt = $db->prepare("insert into images (id, contenttype, imagedata) values (?, ?, ?)"); $id = get_new_id(); // some function to allocate a new ID // assume that we are running as part of a file upload form // You can find more information in the PHP documentation $fp = fopen($_FILES['file']['tmp_name'], 'rb'); $stmt->bindParam(1, $id); $stmt->bindParam(2, $_FILES['file']['type']); $stmt->bindParam(3, $fp, PDO::PARAM_LOB); $stmt->beginTransaction(); $stmt->execute(); $stmt->commit(); ?> ]]> </programlisting> </example> </para> <para> <example><title>Ein Bild in eine Datenbank einfügen: Oracle</title> <para> Oracle erfordert eine leicht unterschiedliche Syntax, um ein LOB aus einer Datei einzufügen. Es ist auch unumgänglich, dass Sie diesen Insert innerhalb einer Transaktion durchführen, andernfalls wird Ihr frisch eingefügtes LOB mit einer Länge von 0 als Teil des impliziten commits, der beim Ausführen der Abfrage passiert, gespeichert. </para> <programlisting role='php'> <![CDATA[ <?php $db = new PDO('oci:', 'scott', 'tiger'); $stmt = $db->prepare("insert into images (id, contenttype, imagedata) " . "VALUES (?, ?, EMPTY_BLOB()) RETURNING imagedata INTO ?"); $id = get_new_id(); // some function to allocate a new ID // assume that we are running as part of a file upload form // You can find more information in the PHP documentation $fp = fopen($_FILES['file']['tmp_name'], 'rb'); $stmt->bindParam(1, $id); $stmt->bindParam(2, $_FILES['file']['type']); $stmt->bindParam(3, $fp, PDO::PARAM_LOB); $stmt->beginTransaction(); $stmt->execute(); $stmt->commit(); ?> ]]> </programlisting> </example> </para> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pdo/pdo.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pdo/pdo.xml +++ phpdoc-de/reference/pdo/pdo.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <reference xml:id="class.pdo" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"> <title>The PDO class</title> <titleabbrev>PDO</titleabbrev> <partintro> <!-- {{{ PDO intro --> <section xml:id="pdo.intro"> &reftitle.intro; <para> Represents a connection between PHP and a database server. </para> </section> <!-- }}} --> <section xml:id="pdo.synopsis"> &reftitle.classsynopsis; <!-- {{{ Synopsis --> <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <!-- {{{ Class synopsis --> <classsynopsisinfo> <ooclass> <classname>PDO</classname> </ooclass> </classsynopsisinfo> <!-- }}} --> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[1])" /> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> <!-- }}} --> </classsynopsis> </section> </partintro> &reference.pdo.entities.pdo; </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pdo/pdoexception.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pdo/pdoexception.xml +++ phpdoc-de/reference/pdo/pdoexception.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: fa Status: ready --> <reference 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"> <title>The PDOException class</title> <titleabbrev>PDOException</titleabbrev> <partintro> <!-- {{{ PDOException intro --> <section xml:id="pdoexception.intro"> &reftitle.intro; <para> Stellt einen Fehler dar, der von PDO ausgelöst wird. Sie sollten selbst keine <classname>PDOException</classname> in Ihrem eigenen Code werfen. Unter <link linkend='language.exceptions'>Ausnahmen</link> finden Sie weitere Informationen über Ausnahmen in PHP. </para> </section> <!-- }}} --> <section xml:id="pdoexception.synopsis"> &reftitle.classsynopsis; <!-- {{{ Synopsis --> <classsynopsis> <ooclass><classname>PDOException</classname></ooclass> <!-- {{{ Class synopsis --> <classsynopsisinfo> <ooclass> <classname>PDOException</classname> </ooclass> <ooclass> <modifier>extends</modifier> <classname>RuntimeException</classname> </ooclass> </classsynopsisinfo> <!-- }}} --> <classsynopsisinfo role="comment">Properties</classsynopsisinfo> <fieldsynopsis><!-- {{{ errorInfo --> <modifier>public</modifier> <type>string</type> <varname linkend="pdoexception.props.errorinfo">errorInfo</varname> </fieldsynopsis><!-- }}} --> <fieldsynopsis><!-- {{{ message --> <modifier>protected</modifier> <type>string</type> <varname linkend="pdoexception.props.message">message</varname> </fieldsynopsis><!-- }}} --> <fieldsynopsis><!-- {{{ code --> <modifier>protected</modifier> <type>string</type> <varname linkend="pdoexception.props.code">code</varname> </fieldsynopsis><!-- }}} --> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdoexception')/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])" /> --> </classsynopsis> <!-- }}} --> </section> <!-- {{{ PDOException properties --> <section xml:id="pdoexception.props"> &reftitle.properties; <variablelist> <varlistentry xml:id="pdoexception.props.errorinfo"><!-- {{{ --> <term><varname>errorInfo</varname></term> <listitem> <para> Corresponds to <function>PDO::errorInfo</function> or <function>PDOStatement::errorInfo</function> </para> </listitem> </varlistentry><!-- }}} --> <varlistentry xml:id="pdoexception.props.message"><!-- {{{ --> <term><varname>message</varname></term> <listitem> <para> Textual error message. <function>Exception::getMessage</function> to access it. </listitem> </varlistentry><!-- }}} --> <varlistentry xml:id="pdoexception.props.code"><!-- {{{ --> <term><varname>code</varname></term> <listitem> <para> <literal>SQLSTATE</literal> error code. Use <function>Exception::getCode</function> to access it. </para> </listitem> </varlistentry><!-- }}} --> </variablelist> </section> <!-- }}} --> </partintro> &reference.pdo.entities.pdoexception; </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pdo/prepared-statements.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pdo/prepared-statements.xml +++ phpdoc-de/reference/pdo/prepared-statements.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 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 kann. Prepared Statements haben zwei wichtige Vorteile: </para> <itemizedlist> <listitem> <simpara> Die Abfrage muss nur einmal geparset (oder vorbereitet) werden, kann dann 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. </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.) </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. </para> <para> <example><title>Wiederholte Inserts mit Prepared Statements</title> <simpara> Dieses Beispiel führt eine INSERT-Abfrage durch, indem ein <literal>name</literal> und ein <literal>value</literal> für die benannten Platzhalter eingesetzt werden. </simpara> <programlisting role='php'> <![CDATA[ <?php $stmt = $dbh->prepare("INSERT INTO REGISTRY (name, value) VALUES (:name, :value)"); $stmt->bindParam(':name', $name); $stmt->bindParam(':value', $value); // insert one row $name = 'one'; $value = 1; $stmt->execute(); // insert another row with different values $name = 'two'; $value = 2; $stmt->execute(); ?> ]]> </programlisting> </example> </para> <para> <example><title>Wiederholte Inserts mit Prepared Statements</title> <simpara> Dieses Beispiel führt eine INSERT-Abfrage durch, indem ein <literal>name</literal> und ein <literal>value</literal> für die positionsabhängigen <literal>?</literal>-Platzhalter eingesetzt werden. </simpara> <programlisting role='php'> <![CDATA[ <?php $stmt = $dbh->prepare("INSERT INTO REGISTRY (name, value) VALUES (?, ?)"); $stmt->bindParam(1, $name); $stmt->bindParam(2, $value); // insert one row $name = 'one'; $value = 1; $stmt->execute(); // insert another row with different values $name = 'two'; $value = 2; $stmt->execute(); ?> ]]> </programlisting> </example> </para> <para> <example><title>Abfragen von Daten mit Prepared Statements</title> <simpara> Dieses Beispiel ruft Daten basierend auf einem Schlüsselwert ab, der von einem Formular geliefert wird. Die Benutzereingabe wird automatisch maskiert, deswegen gibt es kein Risiko eines SQL-Injection-Angriffs. </simpara> <programlisting role='php'> <![CDATA[ <?php $stmt = $dbh->prepare("SELECT * FROM REGISTRY where name = ?"); if ($stmt->execute(array($_GET['name']))) { while ($row = $stmt->fetch()) { print_r($row); } } ?> ]]> </programlisting> </example> </para> <para> Wenn es der Datenbanktreiber unterstützt, können Sie 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. Wenn der Wert sich als gröÃer herausstellt als die vorgeschlagene GröÃe, wird ein Fehler ausgelöst. </para> <para> <example><title>Eine Stored Procedure mit einem Ausgabeparameter aufrufen</title> <programlisting role='php'> <![CDATA[ <?php $stmt = $dbh->prepare("CALL sp_returns_string(?)"); $stmt->bindParam(1, $return_value, PDO::PARAM_STR, 4000); // call the stored procedure $stmt->execute(); print "procedure returned $return_value\n"; ?> ]]> </programlisting> </example> </para> <para> Sie 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 'hello' der Stored Procedure übergeben und wenn diese etwas zurückgibt, wird 'hello' durch den Rückgabewert der Stored procedure ersetzt. </para> <para> <example><title>Eine Stored Procedure mit einem Eingabe-/Ausgabe-Parameter aufrufen</title> <programlisting role='php'> <![CDATA[ <?php $stmt = $dbh->prepare("CALL sp_takes_string_returns_string(?)"); $value = 'hello'; $stmt->bindParam(1, $value, PDO::PARAM_STR|PDO::PARAM_INPUT_OUTPUT, 4000); // call the stored procedure $stmt->execute(); print "procedure returned $value\n"; ?> ]]> </programlisting> </example> </para> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pdo/setup.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pdo/setup.xml +++ phpdoc-de/reference/pdo/setup.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: fa Status: ready --> <chapter xml:id="pdo.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.setup; <!-- {{{ Requirements --> <section xml:id="pdo.requirements"> &reftitle.required; &no.requirement; </section> <!-- }}} --> <!-- {{{ Installation --> &reference.pdo.configure; <!-- }}} --> <!-- {{{ Configuration --> &reference.pdo.ini; <!-- }}} --> <!-- {{{ Resources --> <section xml:id="pdo.resources"> &reftitle.resources; &no.resource; </section> <!-- }}} --> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pdo/transactions.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pdo/transactions.xml +++ phpdoc-de/reference/pdo/transactions.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 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, 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 Beeinträchtigung durch andere Verbindungen, wenn es abgeschickt wird. Aktivitäten in Transaktionen können auch automatisch annulliert werden (wenn Sie es noch nicht abgeschickt haben), was Fehlerbehandlung in Ihren Scripts einfacher macht. </para> <para> Transaktionen werden typischerweise implementiert, indem Ihre Menge an Ãnderungen "aufgespart" wird und dann in einem Rutsch abgearbeitet werden. Das hat den netten Nebeneffekt, dass die Effizienz der Aktualisierungen drastisch erhöht wird. In anderen Worten können Transaktionen Ihre Scripts schneller und möglicherweise auch robuster machen. Aber Sie müssen sie korrekt verwenden, um davon zu profitieren. </para> <para> Unglücklicherweise unterstützt nicht jede Datenbank Transaktionen, deswegen muss PDO in einem "auto-commit" genannten Modus laufen, wenn Sie die Verbindung zum ersten Mal öffnen. "Auto-commit" bedeutet, dass jede Abfrage, die Sie ausführen ihre eigene implizite Transaktion besitzt, wenn die Datenbank das unterstützt, oder keine Transaktion, wenn die Datenbank keine Transaktionen unterstützt. Wenn Sie eine Transaktion benötigen, müssen Sie eine mit der Methode <function>PDO::beginTransaction</function> initiieren. Wenn der zu Grunde liegende Treiber keine Transaktionen unterstützt, wird eine <literal>PDOException</literal> geworfen (unbeachtet Ihrer Einstellungen zur Fehlerbehandlung: dies ist immer eine ernste Fehlerbedingung). Wenn Sie dann in einer Transaktion sind, können Sie <function>PDO::commit</function> oder <function>PDO::rollBack</function> benutzen, um die Transaktion abzuschlieÃen, abhängig vom Erfolg des Codes, den Sie während der Transaktion ausgeführt haben. </para> <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 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. </para> <warning> <para> Der automatische Rollback wird nur durchgeführt, wenn Sie die Transaktion per <function>PDO::beginTransaction</function> starten. Wenn Sie manuell eine Abfrage ausführen, die eine Transaktion startet, kann PDO nichts davon wissen und kann deswegen auch keinen Rollback durchführen, wenn etwas schiefgeht. </para> </warning> <para> <example><title>Mehrere Abfragen in einer Transaktion</title> <para> Im folgenden Beispiel nehmen wir an, dass wir einen Satz von Einträgen für einen neuen Angestellten eintragen wollen, dem die ID-Nummer 23 zugeordnet wurde. Zusätzlich zur Angabe der Basisdaten für diese Person müssen wir auch ihr Gehalt festhalten. Es ist ziemlich einfach, zwei getrennte Aktualisierungen durchzuführen, aber indem wir sie in <function>PDO::beginTransaction</function> und <function>PDO::commit</function> einschlieÃen, garantieren wir, dass niemand anderes diese Ãnderungen sieht, bis sie komplett sind. Wenn etwas schiefgeht, wird der <literal>catch</literal>-Block alle seit Beginn der Transaktion durchgeführten Ãnderungen rückgängig machen und dann eine Fehlermeldung ausgeben. </para> <programlisting role='php'> <![CDATA[ <?php try { $dbh = new PDO('odbc:SAMPLE', 'db2inst1', 'ibmdb2', array(PDO::ATTR_PERSISTENT => true)); echo "Connected\n"; $dbh->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); $dbh->beginTransaction(); $dbh->exec("insert into staff (id, first, last) values (23, 'Joe', 'Bloggs')"); $dbh->exec("insert into salarychange (id, amount, changedate) values (23, 50000, NOW())"); $dbh->commit(); } catch (Exception $e) { $dbh->rollBack(); echo "Failed: " . $e->getMessage(); } ?> ]]> </programlisting> </example> </para> <para> Sie sind nicht darauf beschränkt, Ãnderungen in einer Transaktion durchzuführen. Sie können auch komplexe Abfragen ausführen um Daten zu erhalten, und diese Informationen etwa dazu benutzen, mehr Ãnderungen und Abfragen zu erzeugen. Während die Transaktion aktiv ist, kann garantiert niemand anderes Ãnderungen durchführen, während Sie bei der Arbeit sind. Um ehrlich zu sein, stimmt das nicht 100%, aber es ist für den Anfang ausreichend, falls Sie noch nie von Transaktionen gehört haben. </para> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pdo/book.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pdo/book.xml +++ phpdoc-de/reference/pdo/book.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: fa Status: ready --> <!-- Purpose: database.abstract --> <!-- Membership: pecl, bundled --> <book xml:id="book.pdo" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>PHP Data Objects</title> <titleabbrev>PDO</titleabbrev> <!-- {{{ preface --> <preface xml:id="intro.pdo"> &reftitle.intro; <para> Die PHP Data Objects(PDO)-Erweiterung stellt eine leichte, konsistente Schnittstelle bereit, um mit PHP auf Datenbanken zuzugreifen. Jeder Datenbanktreiber, der die PDO-Schnittstelle implementiert, kann spezifische Features als reguläre Funktionen der Erweiterung bereitstellen. Beachten Sie, dass Sie keine Funktionen der Datenbank mit PDO allein benutzen können. Sie müssen einen <link linkend="pdo.drivers">datenbankspezifischen PDO-Treiber</link> benutzen, um auf eine Datenbank zuzugreifen. </para> <para> PDO bietet eine Abstraktionsschicht für den <emphasis>Datenzugriff</emphasis>, das bedeutet, dass Sie, egal welche Datenbank Sie benutzen, dieselben Funktionen verwenden können, um Abfragen zu erstellen und Daten zu lesen. PDO bietet keine Abstraktion für <emphasis>Datenbanken</emphasis>. Es schreibt keine SQL-Abfragen um oder emuliert fehlende Features. Sie sollten eine komplette Abstraktionsschicht verwenden, wenn Sie diese Funktionalität benötigen. </para> <para> PDO wird mit PHP 5.1 ausgeliefert und ist als PECL-Erweiterung für PHP 5.0 verfügbar. PDO benötigt die neuen OO-Features im Kern von PHP 5 und wird deswegen nicht mit früheren Versionen von PHP funktionieren. </para> </preface> <!-- }}} --> &reference.pdo.setup; &reference.pdo.constants; &reference.pdo.connections; &reference.pdo.transactions; &reference.pdo.prepared-statements; &reference.pdo.error-handling; &reference.pdo.lobs; &reference.pdo.pdo; &reference.pdo.pdostatement; <!-- FIXME: Find out how to deal with classess without any methods &reference.pdo.pdoexception; --> &reference.pdo.drivers; </book> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pdo/configure.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pdo/configure.xml +++ phpdoc-de/reference/pdo/configure.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.6 Maintainer: fa Status: ready --> <section xml:id="pdo.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.install; <procedure xml:id='pdo.install.unix51up'> <title>PHP 5.1 und höher auf Unix-Systemen</title> <step> <para> Wenn Sie ein PHP 5.1-Release verwenden, ist PDO bereits enthalten. Es wird automatisch angeschaltet, wenn Sie configure ausführen. Es wird empfohlen, PDO als shared module zu kompilieren, da Sie so die durch PECL bereitgestellen Updates nutzen können. Das empfohlene configure-Kommando, um PHP mit PDO zu kompilieren, sollte auch die zlib-Unterstützung (für den PEAR-Installer) aktivieren. Sie müssen eventuell auch den PDO-Treiber für die Datenbank Ihrer Wahl aktivieren. Ziehen Sie die Dokumentation für <link linkend="pdo.drivers">datenbankspezifische PDO-Treiber</link> zu Rate, um mehr darüber herauszufinden, aber beachten Sie, dass Sie, wenn Sie PDO als Shared Extension bauen, auch die PDO-Treiber als Shared Extensions bauen müssen. <screen> <![CDATA[ ./configure --with-zlib --enable-pdo=shared ]]> </screen> </para> </step> <step> <para> Nach der Installation von PDA als shared module müssen sie Ihre &php.ini;-Datei bearbeiten, damit die PDO-Erweiterung automatisch geladen wird, wenn PHP ausgeführt wird. Sie müssen dort auch alle datenbankspezifischen Treiber aktivieren. Versichern Sie sich, dass diese nach der Zeile mit pdo.so stehen, da PDO initialisiert werden muss, bevor die datenbankspezifischen Erweiterungen geladen werden können. Wenn Sie PDO und die datenbankspezifischen Erweiterungen statisch kompiliert haben, können Sie diesen Schritt überspringen. <screen> <![CDATA[ extension=pdo.so ]]> </screen> </para> </step> <step> <para> PDO als shared module zu benutzen erlaubt Ihnen, <command>pear upgrade pdo</command> auszuführen, wenn neue Versionen von PDO veröffentlicht werden, ohne dass Sie PHP komplett neu kompilieren müssen. Beachten Sie, dass Sie auch die datenbankspezifischen Treiber zur gleichen Zeit aktualisieren müssen. </para> </step> </procedure> <procedure xml:id='pdo.install.pecl'> <title>PHP 5.0 und höher auf Unix-Systemen</title> <step> <para> PDO ist als PECL-Erweiterung verfügbar auf <link xlink:href='&url.pecl.package;pdo'>&url.pecl.package;pdo</link>. Die Installation kann mit Hilfe des <command>pear</command>-Tools durchgeführt werden. Dies ist standardmäÃig aktiviert, wenn sie PHP konfigurieren. Sie sollten sich vergewissern, dass PHP mit <option role="configure">--with-zlib</option> erstellt wurde, damit <command>pear</command> mit der komprimierten Paketdatei umgehen kann. </para> </step> <step> <para> Führen Sie den folgenden Befehl aus, um die neueste stabile Version von PDO herunterzuladen, zu kompilieren und zu installieren: <screen> <![CDATA[ pear install pdo ]]> </screen> </para> </step> <step> <para> Wenn PDO sich noch in der Beta-Phase befindet (und zur Zeit, wenn diese Zeilen geschrieben werden, ist es das noch), werden Sie dem <command>pear</command>-Tool explizit mitteilen müssen, dass es in Ordnung ist, das Beta-Paket zu benutzen. Statt des oben genannten Befehls benutzen Sie einfach: <screen> <![CDATA[ pear install pdo-beta ]]> </screen> </para> </step> <step> <para> Der <command>pear</command>-Befehl installiert das PDO-Modul automatisch in Ihr PHP-<link linkend="ini.extension-dir">extensions</link>-Verzeichnis. Um die PDO-Erweiterung unter Linux oder Unix zu aktivieren, müssen Sie die folgende Zeile zur &php.ini; hinzufügen: <screen> <![CDATA[ extension=pdo.so ]]> </screen> </para> <para> Für weitere Informationen über das Erstellen von PECL-Paketen lesen Sie am besten das Kapitel <link linkend="install.pecl">PECL-Installation</link> im Handbuch. </para> </step> </procedure> <procedure xml:id='pdo.install.win32php51'> <title>PHP 5.1 und höher unter Windows</title> <step> <para> PDO und alle gängigen Treiber werden mit PHP als shared module mitgeliefert und müssen nur durch Bearbeiten der Datei &php.ini; aktiviert werden: <screen> <![CDATA[ extension=php_pdo.dll ]]> </screen> </para> </step> <step> <para> Als nächstes wählen sie die datenbankspezifischen DLL-Dateien und laden sie entweder per <function>dl</function> zur Laufzeit oder aktivieren sie in der Datei &php.ini; unterhalb von <filename>php_pdo.dll</filename>. Zum Beispiel: <screen> <![CDATA[ extension=php_pdo.dll extension=php_pdo_firebird.dll extension=php_pdo_informix.dll extension=php_pdo_mssql.dll extension=php_pdo_mysql.dll extension=php_pdo_oci.dll extension=php_pdo_oci8.dll extension=php_pdo_odbc.dll extension=php_pdo_pgsql.dll extension=php_pdo_sqlite.dll ]]> </screen> </para> <para> Diese DLLs sollten im <link linkend="ini.extension-dir">extension_dir</link> des Systems vorhanden sein. Beachten Sie bitte, dass <link linkend="ref.pdo-informix">PDO_INFORMIX</link> nur als PECL-Erweiterung verfügbar ist. </para> </step> </procedure> </section> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pdo/connections.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pdo/connections.xml +++ phpdoc-de/reference/pdo/connections.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: fa Status: ready --> <chapter xml:id="pdo.connections" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Connections and Connection management</title> <title>Verbindungen und Verwaltung der Verbindungen</title> <para> Verbindungen werden durch das Erstellen von Instanzen der PDO-Basisklase erzeugt. Es ist unerheblich, welchen Treiber Sie benutzen wollen. Sie benutzen immer den PDO-Klassennamen. Der Konstruktor erwartet Parameter zur Angabe der Datenbankquelle (auch bekannt als DSN) und optional für Benutzername und Passwort (falls vorhanden). </para> <para> <example><title>Mit MySQL verbinden</title> <programlisting role='php'> <![CDATA[ <?php $dbh = new PDO('mysql:host=localhost;dbname=test', $user, $pass); ?> ]]> </programlisting> </example> </para> <para> Wenn es Fehler bei der Verbindung gibt, wird eine Ausnahme vom Typ <literal>PDOException</literal> geworfen. Sie können die Ausnahme abfangen, wenn Sie sich selbst um die Fehlerbedingung kümmern wollen, oder Sie können es einer globalen Routine zur Ausnahmebehandlung überlassen, die Sie mit <function>set_exception_handler</function> konfigurieren. </para> <para> <example><title>Verbindungsfehler behandeln</title> <programlisting role='php'> <![CDATA[ <?php try { $dbh = new PDO('mysql:host=localhost;dbname=test', $user, $pass); foreach ($dbh->query('SELECT * from FOO') as $row) { print_r($row); } $dbh = null; } catch (PDOException $e) { print "Error!: " . $e->getMessage() . "<br/>"; die(); } ?> ]]> </programlisting> </example> </para> <warning> <para> Wenn Ihre Anwendung die vom PDO-Konstruktor geworfene Ausnahme nicht auffängt, ist die normale Vorgehnsweise der Zend Engine, das Script zu terminieren und einen Backtrace anzuzeigen. Dieser Backtrace wird wahrscheinlich alle Details der Datenbankverbindung enthüllen, inklusive Benutzername und Passwort. Sie sind also verantwortlich, diese Ausnahme aufzufangen, entweder explizit (mit einem <literal>catch</literal>-Block) oder implizit mit <function>set_exception_handler</function>. </para> </warning> <para> Bei erfolgreicher Verbindung zur Datenbank wird eine Instanz der PDO-Klasse an Ihr Script zurückgegeben. Die Verbindung bleibt während der Lebensdauer des PDO-Objekts aktiv. Um die Verbindung zu beenden, müssen Sie das Objekt löschen, indem Sie sicherstellen, dass alle Referenzen darauf gelöscht werden - das erreichen Sie, indem Sie der Variable, die das Objekt beinhaltet, &null; zuweisen. Wenn Sie das nicht explizit tun, schlieÃt PHP die verbindung automatisch, wenn Ihr Script endet. </para> <para> <example><title>Eine Verbindung schlieÃen</title> <programlisting role='php'> <![CDATA[ <?php $dbh = new PDO('mysql:host=localhost;dbname=test', $user, $pass); // use the connection here // and now we're done; close it $dbh = null; ?> ]]> </programlisting> </example> </para> <para> Viele Webanwendungen profitieren von persistenten Verbindungen zum Datenbankserver. Persistente Verbindungen werden nicht am Ende des Scripts geschlossen, sondern werden gecachet und wieder benutzt, wenn ein anderes Script eine Verbindung mit denselben Daten anfordert. Der Cache an persistenten Verbindungen erlaubt Ihnen, den Overhead zu vermeiden, wenn jedes mal eine neue Verbindung geöffnet wird, sobald ein Script mit der Datenbank kommunizieren muss, was sich in einer schnelleren Anwendung widerspiegelt. </para> <para> <example><title>Persistente Verbindungen</title> <programlisting role='php'> <![CDATA[ <?php $dbh = new PDO('mysql:host=localhost;dbname=test', $user, $pass, array( PDO::ATTR_PERSISTENT => true )); ?> ]]> </programlisting> </example> </para> <note> <para> Wenn Sie den PDO-ODBC-Treiber benutzen und Ihre ODBC-Bibliotheken ODBC Connection Pooling unterstützen (unixODBC und Windows etwa, es könnte auch andere geben), dann wird empfohlen, dass sie keine persistenten PDO-Verbindungen benutzen, sondern das Cachen der Verbindungen der ODBC Connection Pooling-Schicht überlassen. Der ODBC Connection Pool wird mit anderen Modulen im Prozess geteilt. Wenn PDO also angewiesen wird die Verbindung zu cachen, wird diese Verbindung nie dem ODBC Connection Pool zurückgegeben, was darin resultiert, dass zusätzliche Verbindungen aufgebaut werden, um jene anderen Module zu bedienen. </para> </note> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pdo/drivers.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pdo/drivers.xml +++ phpdoc-de/reference/pdo/drivers.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- 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> <partintro> <para> Die folgenden Treiber implementieren momentan die PDO-Schnittstelle: <informaltable> <tgroup cols='2'> <thead> <row> <entry>Treibername</entry> <entry>Unterstützte Datenbanken</entry> </row> </thead> <tbody> <row> <entry><link linkend="ref.pdo-dblib">PDO_DBLIB</link></entry> <entry>FreeTDS / Microsoft SQL Server / Sybase</entry> </row> <row> <entry><link linkend="ref.pdo-firebird">PDO_FIREBIRD</link></entry> <entry>Firebird/Interbase 6</entry> </row> <row> <entry><link linkend="ref.pdo-informix">PDO_INFORMIX</link></entry> <entry>IBM Informix Dynamic Server</entry> </row> <row> <entry><link linkend="ref.pdo-mysql">PDO_MYSQL</link></entry> <entry>MySQL 3.x/4.x</entry> </row> <row> <entry><link linkend="ref.pdo-oci">PDO_OCI</link></entry> <entry>Oracle Call Interface</entry> </row> <row> <entry><link linkend="ref.pdo-odbc">PDO_ODBC</link></entry> <entry>ODBC v3 (IBM DB2, unixODBC und win32 ODBC)</entry> </row> <row> <entry><link linkend="ref.pdo-pgsql">PDO_PGSQL</link></entry> <entry>PostgreSQL</entry> </row> <row> <entry><link linkend="ref.pdo-sqlite">PDO_SQLITE</link></entry> <entry>SQLite 3 und SQLite 2</entry> </row> </tbody> </tgroup> </informaltable> </para> </partintro> &reference.pdo-dblib.reference; &reference.pdo-firebird.reference; &reference.pdo-ibm.reference; &reference.pdo-informix.reference; &reference.pdo-mysql.reference; &reference.pdo-oci.reference; &reference.pdo-odbc.reference; &reference.pdo-pgsql.reference; &reference.pdo-sqlite.reference; </part> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pdo/error-handling.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pdo/error-handling.xml +++ phpdoc-de/reference/pdo/error-handling.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: fa Status: ready --> <chapter xml:id="pdo.error-handling" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Fehler und Fehlerbehandlung</title> <para> PDO bietet Ihnen die Wahl unter 3 verschiedenen Strategien zur Fehlerbehandlung, um Ihrem Stil der Anwendungsentwicklung gerecht zu werden. </para> <itemizedlist> <listitem> <para> <constant>PDO::ERRMODE_SILENT</constant> </para> <para> Das ist die Standardmethode. PDO setzt einfach den Fehler-Code, damit Sie ihn mit den Methoden <function>PDO::errorCode</function> und <function>PDO::errorInfo</function> sowohl im Statement- als auch im Datenbank-Objekt überprüfen können. Wenn der Fehler aus einem Aufruf eines Statement-Objekts hervorging, würden Sie die Methoden <function>PDOStatement::errorCode</function> oder <function>PDOStatement::errorInfo</function> des Objekts aufrufen. Wenn der Fehler aus einem Aufruf des Datenbank-Objekts hervorging, würden Sie diese Methoden des Datenbank-Objekts aufrufen. </para> </listitem> <listitem> <para> <constant>PDO::ERRMODE_WARNING</constant> </para> <para> Zusätzlich zum Setzen des Fehler-Codes wird PDO eine traditionelle E_WARNING-Nachricht ausgeben. Diese Einstellung ist nützlich während des Debuggens/Testens, wenn Sie sehen wollen, welche Probleme aufgetreten sind, ohne den Ablauf der Anwendung zu unterbrechen. </para> </listitem> <listitem> <para> <constant>PDO::ERRMODE_EXCEPTION</constant> </para> <para> Zusätzlich zum Setzen des Fehler-Codes wirft PDO eine <classname>PDOException</classname> und setzt deren Eigenschaften so, dass sie den Fehler-Code und Fehlerinformationen widergeben. Diese Einstellung ist auch nützlich während des Debuggens, da sie das Script am Ort des Fehlers gewissermaÃen "sprengt" und sehr schnell mögliche Problemstellen in Ihrem Code aufzeigt. (Zur Erinnerung: Transaktionen bekommen automatisch einen Rollback, wenn eine Ausnahme das Script beendet.) </para> <para> Diese Einstellung ist auch nützlich, da Sie ihre Fehlerbehandlung klarer als mit traditionellen PHP-Warnungen strukturireren können und mit weniger Code und Verschachtelung als im stillen Modus mit expliziter Ãberprüfung des Rückgabewertes jedes einzelnen Datenbankaufrufes. </para> <para> Unter <link linkend='language.exceptions'>Ausnahmen</link> finden Sie weitere Informationen über Ausnahmen in PHP. </para> </listitem> </itemizedlist> <para> PDO benutzt Fehler-Codes nach SQL-92 SQLSTATE. Individuelle PDO-Treiber sind selbst verantwortlich, ihre nativen Fehler-Codes in die entsprechenden SQLSTATE-Pendants umzuwandeln. Die Methode <function>PDO::errorCode</function> gibt einen einzelnen SQLSTATE-Code zurück. Wenn Sie genauere Informationen über einen Fehler benötigen, bietet PDO auch die Methode <function>PDO::errorInfo</function>, die ein Array zurückgibt, das den SQLSTATE-Code, den treiberspezifischen Fehler-Code und die treiberspezifische Fehlermeldung enthält. </para> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pdo/lobs.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pdo/lobs.xml +++ phpdoc-de/reference/pdo/lobs.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: fa Status: ready --> <chapter xml:id="pdo.lobs" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Large Objects (LOBs)</title> <para> Es könnte an irgendeinem Punkt in Ihrer Anwendung passieren, dass Sie eine "groÃe" Menge an Daten in Ihrer Datenbank ablegen müssen. Groà bedeutet typischerweise "etwa 4kb oder mehr", obwohl manche Datenbanken spielend bis zu 32kb bearbeiten können, bevor das als "groÃ" zählt. Large Objects können aus Text oder Binärdaten bestehen. PDO erlaubt Ihnen, mit diesem groÃen Datentyp zu arbeiten, indem Sie <constant>PDO::PARAM_LOB</constant> als Typ in Ihren Methodenaufrufen von <function>PDOStatement::bindParam</function> oder <function>PDOStatement::bindColumn</function> benutzen. <constant>PDO::PARAM_LOB</constant> veranlasst PDO, die Daten als Stream zu behandeln, so dass Sie diese mit Hilfe der <link linkend='ref.stream'>PHP Streams-API</link> bearbeiten können. </para> <para> </para> <para> <example><title>Ein Bild aus einer Datenbank anzeigen</title> <para> Dieses Beispiel weist das LOB der Variable namens $lob zu und sendet es mittels <function>fpassthru</function> an den Browser. Weil das LOB als Stream dargestellt wird, können Funktionen wie <function>fgets</function>, <function>fread</function> und <function>stream_get_contents</function> damit benutzt werden. </para> <programlisting role='php'> <![CDATA[ <?php $db = new PDO('odbc:SAMPLE', 'db2inst1', 'ibmdb2'); $stmt = $db->prepare("select contenttype, imagedata from images where id=?"); $stmt->execute(array($_GET['id'])); $stmt->bindColumn(1, $type, PDO::PARAM_STR, 256); $stmt->bindColumn(2, $lob, PDO::PARAM_LOB); $stmt->fetch(PDO::FETCH_BOUND); header("Content-Type: $type"); fpassthru($lob); ?> ]]> </programlisting> </example> </para> <para> <example><title>Ein Bild in eine Datenbank einfügen</title> <para> Dieses Beispiel öffnet eine Datei und übergibt das File-Handle an PDO, damit sie als LOB eingefügt wird. PDO wird sein Möglichstes tun, den Inhalt der Datei auf möglichst effiziente Weise in die Datenbank zu bekommen. </para> <programlisting role='php'> <![CDATA[ <?php $db = new PDO('odbc:SAMPLE', 'db2inst1', 'ibmdb2'); $stmt = $db->prepare("insert into images (id, contenttype, imagedata) values (?, ?, ?)"); $id = get_new_id(); // some function to allocate a new ID // assume that we are running as part of a file upload form // You can find more information in the PHP documentation $fp = fopen($_FILES['file']['tmp_name'], 'rb'); $stmt->bindParam(1, $id); $stmt->bindParam(2, $_FILES['file']['type']); $stmt->bindParam(3, $fp, PDO::PARAM_LOB); $stmt->beginTransaction(); $stmt->execute(); $stmt->commit(); ?> ]]> </programlisting> </example> </para> <para> <example><title>Ein Bild in eine Datenbank einfügen: Oracle</title> <para> Oracle erfordert eine leicht unterschiedliche Syntax, um ein LOB aus einer Datei einzufügen. Es ist auch unumgänglich, dass Sie diesen Insert innerhalb einer Transaktion durchführen, andernfalls wird Ihr frisch eingefügtes LOB mit einer Länge von 0 als Teil des impliziten commits, der beim Ausführen der Abfrage passiert, gespeichert. </para> <programlisting role='php'> <![CDATA[ <?php $db = new PDO('oci:', 'scott', 'tiger'); $stmt = $db->prepare("insert into images (id, contenttype, imagedata) " . "VALUES (?, ?, EMPTY_BLOB()) RETURNING imagedata INTO ?"); $id = get_new_id(); // some function to allocate a new ID // assume that we are running as part of a file upload form // You can find more information in the PHP documentation $fp = fopen($_FILES['file']['tmp_name'], 'rb'); $stmt->bindParam(1, $id); $stmt->bindParam(2, $_FILES['file']['type']); $stmt->bindParam(3, $fp, PDO::PARAM_LOB); $stmt->beginTransaction(); $stmt->execute(); $stmt->commit(); ?> ]]> </programlisting> </example> </para> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pdo/pdo.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pdo/pdo.xml +++ phpdoc-de/reference/pdo/pdo.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <reference xml:id="class.pdo" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"> <title>The PDO class</title> <titleabbrev>PDO</titleabbrev> <partintro> <!-- {{{ PDO intro --> <section xml:id="pdo.intro"> &reftitle.intro; <para> Represents a connection between PHP and a database server. </para> </section> <!-- }}} --> <section xml:id="pdo.synopsis"> &reftitle.classsynopsis; <!-- {{{ Synopsis --> <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <!-- {{{ Class synopsis --> <classsynopsisinfo> <ooclass> <classname>PDO</classname> </ooclass> </classsynopsisinfo> <!-- }}} --> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[1])" /> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> <!-- }}} --> </classsynopsis> </section> </partintro> &reference.pdo.entities.pdo; </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pdo/pdoexception.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pdo/pdoexception.xml +++ phpdoc-de/reference/pdo/pdoexception.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: fa Status: ready --> <reference 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"> <title>The PDOException class</title> <titleabbrev>PDOException</titleabbrev> <partintro> <!-- {{{ PDOException intro --> <section xml:id="pdoexception.intro"> &reftitle.intro; <para> Stellt einen Fehler dar, der von PDO ausgelöst wird. Sie sollten selbst keine <classname>PDOException</classname> in Ihrem eigenen Code werfen. Unter <link linkend='language.exceptions'>Ausnahmen</link> finden Sie weitere Informationen über Ausnahmen in PHP. </para> </section> <!-- }}} --> <section xml:id="pdoexception.synopsis"> &reftitle.classsynopsis; <!-- {{{ Synopsis --> <classsynopsis> <ooclass><classname>PDOException</classname></ooclass> <!-- {{{ Class synopsis --> <classsynopsisinfo> <ooclass> <classname>PDOException</classname> </ooclass> <ooclass> <modifier>extends</modifier> <classname>RuntimeException</classname> </ooclass> </classsynopsisinfo> <!-- }}} --> <classsynopsisinfo role="comment">Properties</classsynopsisinfo> <fieldsynopsis><!-- {{{ errorInfo --> <modifier>public</modifier> <type>string</type> <varname linkend="pdoexception.props.errorinfo">errorInfo</varname> </fieldsynopsis><!-- }}} --> <fieldsynopsis><!-- {{{ message --> <modifier>protected</modifier> <type>string</type> <varname linkend="pdoexception.props.message">message</varname> </fieldsynopsis><!-- }}} --> <fieldsynopsis><!-- {{{ code --> <modifier>protected</modifier> <type>string</type> <varname linkend="pdoexception.props.code">code</varname> </fieldsynopsis><!-- }}} --> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdoexception')/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])" /> --> </classsynopsis> <!-- }}} --> </section> <!-- {{{ PDOException properties --> <section xml:id="pdoexception.props"> &reftitle.properties; <variablelist> <varlistentry xml:id="pdoexception.props.errorinfo"><!-- {{{ --> <term><varname>errorInfo</varname></term> <listitem> <para> Corresponds to <function>PDO::errorInfo</function> or <function>PDOStatement::errorInfo</function> </para> </listitem> </varlistentry><!-- }}} --> <varlistentry xml:id="pdoexception.props.message"><!-- {{{ --> <term><varname>message</varname></term> <listitem> <para> Textual error message. <function>Exception::getMessage</function> to access it. </listitem> </varlistentry><!-- }}} --> <varlistentry xml:id="pdoexception.props.code"><!-- {{{ --> <term><varname>code</varname></term> <listitem> <para> <literal>SQLSTATE</literal> error code. Use <function>Exception::getCode</function> to access it. </para> </listitem> </varlistentry><!-- }}} --> </variablelist> </section> <!-- }}} --> </partintro> &reference.pdo.entities.pdoexception; </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pdo/prepared-statements.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pdo/prepared-statements.xml +++ phpdoc-de/reference/pdo/prepared-statements.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 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 kann. Prepared Statements haben zwei wichtige Vorteile: </para> <itemizedlist> <listitem> <simpara> Die Abfrage muss nur einmal geparset (oder vorbereitet) werden, kann dann 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. </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.) </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. </para> <para> <example><title>Wiederholte Inserts mit Prepared Statements</title> <simpara> Dieses Beispiel führt eine INSERT-Abfrage durch, indem ein <literal>name</literal> und ein <literal>value</literal> für die benannten Platzhalter eingesetzt werden. </simpara> <programlisting role='php'> <![CDATA[ <?php $stmt = $dbh->prepare("INSERT INTO REGISTRY (name, value) VALUES (:name, :value)"); $stmt->bindParam(':name', $name); $stmt->bindParam(':value', $value); // insert one row $name = 'one'; $value = 1; $stmt->execute(); // insert another row with different values $name = 'two'; $value = 2; $stmt->execute(); ?> ]]> </programlisting> </example> </para> <para> <example><title>Wiederholte Inserts mit Prepared Statements</title> <simpara> Dieses Beispiel führt eine INSERT-Abfrage durch, indem ein <literal>name</literal> und ein <literal>value</literal> für die positionsabhängigen <literal>?</literal>-Platzhalter eingesetzt werden. </simpara> <programlisting role='php'> <![CDATA[ <?php $stmt = $dbh->prepare("INSERT INTO REGISTRY (name, value) VALUES (?, ?)"); $stmt->bindParam(1, $name); $stmt->bindParam(2, $value); // insert one row $name = 'one'; $value = 1; $stmt->execute(); // insert another row with different values $name = 'two'; $value = 2; $stmt->execute(); ?> ]]> </programlisting> </example> </para> <para> <example><title>Abfragen von Daten mit Prepared Statements</title> <simpara> Dieses Beispiel ruft Daten basierend auf einem Schlüsselwert ab, der von einem Formular geliefert wird. Die Benutzereingabe wird automatisch maskiert, deswegen gibt es kein Risiko eines SQL-Injection-Angriffs. </simpara> <programlisting role='php'> <![CDATA[ <?php $stmt = $dbh->prepare("SELECT * FROM REGISTRY where name = ?"); if ($stmt->execute(array($_GET['name']))) { while ($row = $stmt->fetch()) { print_r($row); } } ?> ]]> </programlisting> </example> </para> <para> Wenn es der Datenbanktreiber unterstützt, können Sie 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. Wenn der Wert sich als gröÃer herausstellt als die vorgeschlagene GröÃe, wird ein Fehler ausgelöst. </para> <para> <example><title>Eine Stored Procedure mit einem Ausgabeparameter aufrufen</title> <programlisting role='php'> <![CDATA[ <?php $stmt = $dbh->prepare("CALL sp_returns_string(?)"); $stmt->bindParam(1, $return_value, PDO::PARAM_STR, 4000); // call the stored procedure $stmt->execute(); print "procedure returned $return_value\n"; ?> ]]> </programlisting> </example> </para> <para> Sie 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 'hello' der Stored Procedure übergeben und wenn diese etwas zurückgibt, wird 'hello' durch den Rückgabewert der Stored procedure ersetzt. </para> <para> <example><title>Eine Stored Procedure mit einem Eingabe-/Ausgabe-Parameter aufrufen</title> <programlisting role='php'> <![CDATA[ <?php $stmt = $dbh->prepare("CALL sp_takes_string_returns_string(?)"); $value = 'hello'; $stmt->bindParam(1, $value, PDO::PARAM_STR|PDO::PARAM_INPUT_OUTPUT, 4000); // call the stored procedure $stmt->execute(); print "procedure returned $value\n"; ?> ]]> </programlisting> </example> </para> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pdo/setup.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pdo/setup.xml +++ phpdoc-de/reference/pdo/setup.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: fa Status: ready --> <chapter xml:id="pdo.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.setup; <!-- {{{ Requirements --> <section xml:id="pdo.requirements"> &reftitle.required; &no.requirement; </section> <!-- }}} --> <!-- {{{ Installation --> &reference.pdo.configure; <!-- }}} --> <!-- {{{ Configuration --> &reference.pdo.ini; <!-- }}} --> <!-- {{{ Resources --> <section xml:id="pdo.resources"> &reftitle.resources; &no.resource; </section> <!-- }}} --> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pdo/transactions.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pdo/transactions.xml +++ phpdoc-de/reference/pdo/transactions.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 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, 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 Beeinträchtigung durch andere Verbindungen, wenn es abgeschickt wird. Aktivitäten in Transaktionen können auch automatisch annulliert werden (wenn Sie es noch nicht abgeschickt haben), was Fehlerbehandlung in Ihren Scripts einfacher macht. </para> <para> Transaktionen werden typischerweise implementiert, indem Ihre Menge an Ãnderungen "aufgespart" wird und dann in einem Rutsch abgearbeitet werden. Das hat den netten Nebeneffekt, dass die Effizienz der Aktualisierungen drastisch erhöht wird. In anderen Worten können Transaktionen Ihre Scripts schneller und möglicherweise auch robuster machen. Aber Sie müssen sie korrekt verwenden, um davon zu profitieren. </para> <para> Unglücklicherweise unterstützt nicht jede Datenbank Transaktionen, deswegen muss PDO in einem "auto-commit" genannten Modus laufen, wenn Sie die Verbindung zum ersten Mal öffnen. "Auto-commit" bedeutet, dass jede Abfrage, die Sie ausführen ihre eigene implizite Transaktion besitzt, wenn die Datenbank das unterstützt, oder keine Transaktion, wenn die Datenbank keine Transaktionen unterstützt. Wenn Sie eine Transaktion benötigen, müssen Sie eine mit der Methode <function>PDO::beginTransaction</function> initiieren. Wenn der zu Grunde liegende Treiber keine Transaktionen unterstützt, wird eine <literal>PDOException</literal> geworfen (unbeachtet Ihrer Einstellungen zur Fehlerbehandlung: dies ist immer eine ernste Fehlerbedingung). Wenn Sie dann in einer Transaktion sind, können Sie <function>PDO::commit</function> oder <function>PDO::rollBack</function> benutzen, um die Transaktion abzuschlieÃen, abhängig vom Erfolg des Codes, den Sie während der Transaktion ausgeführt haben. </para> <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 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. </para> <warning> <para> Der automatische Rollback wird nur durchgeführt, wenn Sie die Transaktion per <function>PDO::beginTransaction</function> starten. Wenn Sie manuell eine Abfrage ausführen, die eine Transaktion startet, kann PDO nichts davon wissen und kann deswegen auch keinen Rollback durchführen, wenn etwas schiefgeht. </para> </warning> <para> <example><title>Mehrere Abfragen in einer Transaktion</title> <para> Im folgenden Beispiel nehmen wir an, dass wir einen Satz von Einträgen für einen neuen Angestellten eintragen wollen, dem die ID-Nummer 23 zugeordnet wurde. Zusätzlich zur Angabe der Basisdaten für diese Person müssen wir auch ihr Gehalt festhalten. Es ist ziemlich einfach, zwei getrennte Aktualisierungen durchzuführen, aber indem wir sie in <function>PDO::beginTransaction</function> und <function>PDO::commit</function> einschlieÃen, garantieren wir, dass niemand anderes diese Ãnderungen sieht, bis sie komplett sind. Wenn etwas schiefgeht, wird der <literal>catch</literal>-Block alle seit Beginn der Transaktion durchgeführten Ãnderungen rückgängig machen und dann eine Fehlermeldung ausgeben. </para> <programlisting role='php'> <![CDATA[ <?php try { $dbh = new PDO('odbc:SAMPLE', 'db2inst1', 'ibmdb2', array(PDO::ATTR_PERSISTENT => true)); echo "Connected\n"; $dbh->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); $dbh->beginTransaction(); $dbh->exec("insert into staff (id, first, last) values (23, 'Joe', 'Bloggs')"); $dbh->exec("insert into salarychange (id, amount, changedate) values (23, 50000, NOW())"); $dbh->commit(); } catch (Exception $e) { $dbh->rollBack(); echo "Failed: " . $e->getMessage(); } ?> ]]> </programlisting> </example> </para> <para> Sie sind nicht darauf beschränkt, Ãnderungen in einer Transaktion durchzuführen. Sie können auch komplexe Abfragen ausführen um Daten zu erhalten, und diese Informationen etwa dazu benutzen, mehr Ãnderungen und Abfragen zu erzeugen. Während die Transaktion aktiv ist, kann garantiert niemand anderes Ãnderungen durchführen, während Sie bei der Arbeit sind. Um ehrlich zu sein, stimmt das nicht 100%, aber es ist für den Anfang ausreichend, falls Sie noch nie von Transaktionen gehört haben. </para> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->