Verbindungen werden durch das Erstellen von Instanzen der PDO-Basisklasse 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).
Beispiel #1 Mit MySQL verbinden
<?php
$dbh = new PDO('mysql:host=localhost;dbname=test', $user, $pass);
?>
Wenn es Fehler bei der Verbindung gibt, wird eine Ausnahme vom Typ
PDOException 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 set_exception_handler() konfigurieren.
Beispiel #2 Verbindungsfehler behandeln
<?php
try {
$dbh = new PDO('mysql:host=localhost;dbname=test', $user, $pass);
} catch (PDOException $e) {
// z.B. nach einem Timeout versuchen, die Verbindung erneut aufzubauen
}
Wie jede andere Exception kann
auch PDOException entweder explizit über eine
catch-Anweisung oder implizit über
set_exception_handler() abgefangen werden. Andernfalls
ist das Standardverhalten, eine nicht abgefangene Exception in einen
E_FATAL_ERROR umzuwandeln. Der fatale Fehler enthält
einen Backtrace, der Verbindungsdetails preisgeben könnte. Deshalb sollte
die php.ini-Option
display_errors
auf einem Produktionsserver auf 0 gesetzt werden.
Bei erfolgreicher Verbindung zur Datenbank wird eine Instanz der
PDO-Klasse an Ihr Skript 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 Skript endet.
Hinweis: Gibt es noch weitere Referenzen auf dieses PDO-Exemplar (wie etwa von einem PDOStatement-Exemplar, oder von anderen Variablen, die dasselbe PDO-Exemplar referenzieren), müssen diese ebenfalls entfernt werden (zum Beispiel durch die Zuweisung von
nullan die Variable, die das PDOStatement referenziert).
Beispiel #3 Eine Verbindung schließen
<?php
$dbh = new PDO('mysql:host=localhost;dbname=test', $user, $pass);
// hier die Verbindung nutzen
$sth = $dbh->query('SELECT * FROM foo');
// und nachdem das erledigt ist, wird sie geschlossen
$sth = null;
$dbh = null;
?>Viele Webanwendungen profitieren von persistenten Verbindungen zum Datenbankserver. Persistente Verbindungen werden nicht am Ende des Skripts geschlossen, sondern werden gecacht und wiederverwendet, wenn ein anderes Skript eine Verbindung mit denselben Daten anfordert. Der Cache an persistenten Verbindungen erlaubt Ihnen, den Overhead zu vermeiden, wenn jedesmal eine neue Verbindung geöffnet wird, sobald ein Skript mit der Datenbank kommunizieren muss, was sich in einer schnelleren Anwendung widerspiegelt.
Beispiel #4 Persistente Verbindungen
<?php
$dbh = new PDO('mysql:host=localhost;dbname=test', $user, $pass, array(
PDO::ATTR_PERSISTENT => true
));
?>
Der Wert der PDO::ATTR_PERSISTENT Option wird nach Boolean
kovertiert (aktiviere/deaktiviere persistente Verbindungen), es sei denn es ist ein
nicht-numerischer String; in diesem Fall ermöglicht es die Verwendung mehrerer
persistenter Verbindungspools. Das ist nützlich, wenn unterschiedliche Verbindungen
inkompatible Einstellungen verwenden, beispielsweise unterschiedliche Werte von
PDO::MYSQL_ATTR_USE_BUFFERED_QUERY.
Hinweis:
Wenn Sie persistente Verbindungen verwenden wollen, müssen Sie
PDO::ATTR_PERSISTENTim Array von Treiberoptionen setzen, das an den PDO-Konstruktor übergeben wird. Wenn Sie dieses Attribut mittels PDO::setAttribute() nach der Instanziierung des Objekts setzen, verwendet der Treiber keine persistenten Verbindungen.
Hinweis:
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.