Verbindung zur Datenbank: Eine Datenbankklasse

Objektorientiertes PHP

Anders als Java erzwingt PHP nicht, dass der Anwender objekorientiert programmiert, PHP stellt dennoch alle Werkzeuge objektorientierter Programmierung zur Verfügung. Auch Dokuwiki selbst ist objektorientiert implementiert, so ist beispielsweise die syntax.php unseres Plugins eine von der Klasse DokuWiki_Syntax_Plugin abgeleitete Klasse:

class syntax_plugin_projekt extends DokuWiki_Syntax_Plugin { [...] }

Datenbank-Klasse

Wir lagern nun den Zugriff auf die mysql-Datenbank in eine eigene Klasse aus.

(A1)

Erstelle eine Datei mysqldb.php in deinem Plugin-Verzeichnis mit folgendem Inhalt:

<?php class mysqldb { /** * Constructor: Connect to db, return handle * * @param string $dbusername DB username * @param string $dbpassword DB password * @param string $dbname Database to connect to * @param string $host Database host to connect to (optional) * * @return object DB-Handle */ function mysqldb($dbusername, $dbpassword, $dbname, $host="localhost" ) { try { $pdo = new PDO("mysql:host=$host;dbname=$dbname", "$dbusername", "$dbpassword"); $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); } catch ( PDOException $e ) { echo 'Verbindung zur Datenbank fehlgeschlagen: ' . $e->getMessage(); return FALSE; } return $pdo; } } ?>

Wenn man ein neues mysqldb Objekt erzeugt, benötigt der Konstruktor als Argumente den Datenbankbenutzer, dessen Passwort, den Namen der Datenbank und optional einen Datenbank-Host.

Damit wir mysqldb-Objekte (und später vielleicht weitere Objekte) nutzen können müssen uns klar machen, wer in unserem Plugin die Rolle der „Steuerklasse“ übernimmt. Am einfachtsen ist es, diese Funktion an die render-Methode in der Datei syntax.php zu delegieren. Zunächst werden dort alle Operationen ausgeführt, die nötig sind, um alle Informationen zu sammeln, dann wird – möglicherweise unter Verwendung weiterer Methoden und/oder Objekten – die HTML Ausgabe erzeugt, die dann im Wiki ausgegeben wird.

(A2)

Binde im Kopf der Datei syntax.php die mysqldb.php-Datei ein. Informiere dich, was die Einbindung mit dem Befehl require bewirkt. Warum sollte man hier nicht include verwenden?

[...] // must be run within Dokuwiki if (!defined('DOKU_INC')) { die(); } // Klassendateien einbinden require("mysqldb.php"); class syntax_plugin_projekt extends DokuWiki_Syntax_Plugin { [...]

Ergänze innerhalb der render-Methode Code, der eine Datenbanlk Verbindung erzeugt.

Mache dir klar, welche Funktion das dabei erzeugte Objekt $dbhandle im weiteren Verlauf des Programms hat.

Teste, was passiert, wenn du eine falsches Benutzer/Passwort-Kombination, eine nicht existente Datenbank oder einen anderen Host als localhost angibst.

$dbhandle = new mysqldb("DBUSER", "dbuserPASS", "DBNAME");

Modellierung - fällt aus

Eigentlich sollte man sich an dieser Stelle überlegen, wie man seine Problemstellung (objektorientiert) modellieren möchte, das fällt uns etwas schwer, weil wir noch keine Problemstellung haben. Ein paar Überlegungen kann man an dieser Stelle dennoch anstellen.

Eine grundlegende Frage könnte z.B. sein, wie man die mysqldb-Klasse weiter entwickelt: Man kann weitere Methoden implementieren, die Abfragen oder Manipulationen an der Datenbank ermöglichen. Man könnte solche Programmfunktionen jedoch auch (wie im Schema oben angedeutet) nach Objektkategorien zusammengefasst auf weitere Klassen verteilen. Das Schema demonstriert ein solches Vorgehen für ein Micro-Blog mit Benutzern, die Posts verfassen können.