Verbindung zur Datenbank

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:

Abbildung 11.2. Die Creole-Schnittstelle Connection

Die Creole-Schnittstelle Connection


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.