Für das Verbinden zur Datenbank stellt Creole die statische Methode
Creole::getConnection() zur Verfügung. Sie erwartet
die Verbindungsdaten in PEAR-DSN-Notation (DSN: "Data Source Name")
als Array oder String. Die Bestandteile der PEAR-DSN-Notation sind:
phptype ist die PHP-Erweiterung (mysql, mysqli, odbc,
...), die für die Verbindung zum Datenbankserver verwendet werden
soll. Aufgrund dieses Wertes wählt Creole den Datenbanktreiber aus.
protocol ist das Kommunikationsprotokoll (TCP/IP,
UNIX, ...), über das die Verbindung zum Datenbankserver aufgebaut
werden soll.
hostspec ist die Host-Spezifikation des
Datenbankservers.
database ist die im Datenbankserver zu verwendende
Datenbank.
username ist der Benutzername für die Anmeldung
am Datenbankserver.
password ist das Kennwort für die Anmeldung am
Datenbankserver.
Beispiel 11.1: Aufruf der Methode Creole::getConnection()
<?php
require_once 'creole/Creole.php';
try {
$connection = Creole::getConnection(
array(
'phptype' => 'mysql',
'hostspec' => 'localhost',
'username' => 'root',
'password' => '',
'database' => 'test'
)
);
}
catch (SQLException $e) {
// Ausnahme $e behandeln.
}
?>
Die in Beispiel 11.1
gezeigte Verbindung würde in String-Notation als
mysql://root@localhost/test geschrieben.
Als zweiten, optionalen Parameter akzeptiert die Methode
Creole::getConnection() einen Bitwert, der sich aus
den Werten Creole::PERSISTENT und
Creole::NO_ASSOC_LOWER zusammensetzen kann. Ersterer
aktiviert die Verwendung einer persistenten Verbindung, falls der
verwendete Datenbanktreiber beziehungsweise die Datenbank dies
unterstützt. Der zweite Wert deaktiviert die automatische Umwandlung
von Feldnamen in Kleinbuchstaben, die Creole standardmäßig zu
Kompatibilitätszwecken durchführt.