Name: Kurs: GK Informatik. Datenbankabfragen mit PHP. Version vom , Kay Steuer, Ratsgymnasium Minden

Transkript

1 Name: Kurs: GK Informatik Datenbankabfragen mit PHP Version vom , Kay Steuer, Ratsgymnasium Minden

2 Inhaltsverzeichnis 1 Daten finden mit phpmyadmin Arbeitsumgebung zum Üben einrichten Eine Vorlagedatei für php php-datei für Abfragen SQL-Beispielstatement erzeugen Ablauf einer PHP-Abfrage PHP-Abfragedatei entwickeln Dynamische Abfragen Vorbereitung des Eingabeformulars Vorbereiten der Verarbeitungsdatei... 15

3 1 Daten finden mit phpmyadmin Abfragen erlauben es, Daten der Tabellen auf die Bedürfnisse des Anwenders vorzubereiten und zur Verfügung zu stellen. Betrachten wir Tabellen als zur inneren Schicht eines Datenbanksystems gehörig, dann stellen Abfragen die äußere Schricht dar. Übver sie findet der Anwender den Zugang zu der inneren Schicht, den Tabellen. Hier nur kurz zur Wiederholung: PHP ist die Abkürzung für Hypertext Preprocessor und setht für eine Skriptsprache. Bei einigen Programmiersprachen wird der Code in eine eigene Maschinensprache übersetzt. Diesen Vorgang nennt man kompilieren. Code von Skriptsprachen wird nicht kompiliert. Sie werden aber von einem Parser auf dem Server interpretiert und ausgeführt. Webseiten, also Dokumente mit HTML-Code, erhalen die Dateikennung *.php, wenn sie PHP Code enthalten. Auf diese Weise erkennt ein Server, dass php.code auf dem Server verarbeitet und in HTML-Code umgewandelt werden muss, bevor die komplette Seite zurück an den Client gesendet wird. 1.1 Arbeitsumgebung zum Üben einrichten Sie haben auf Ihrem Computer das Programmpaket XAMPP installiert und jetzt stellt sich die Frage, wo eine Textdatei mit der Dateiendung *.php gespeichert wird, um sie anschließend im Browser aufrufen zu können. Der Apache Server ist ein Hintergrunddienst, der beim Start eine Konfigurationsdatei abfragt. Ob der Apache Server gestartet ist, sehen Sie im XAMPP Control Panel. Klicken Sie dazu rechts unten in die kleine Symbolleiste oder rufen Sie das Panel über Start/Programme auf. Der Apache Server und MySQLServer sollten im Hintergrund gestartet sein. Auf Ihrem Computer befindet sich der Ordner...\XAMPP\HTDOCS - wahrscheinlich haben Sie ihn unter C:\XAMPP\HTDOCS angelegt. Dieser Ordner ist der Startordner des Apache Servers. Wenn Sie im Browser localhost eingeben, wird in diesem Ordner nach der Datei index.html bzw. index.php gesucht. Mann kann im Browser aber auch den Namen eines Unterordners oder einer bestimmten Datei eingeben, um diese Datei auszuführen. Legen Sie im Ordner XAMPP\HTDOCS einen neuen Ordner mit dem Namen php an. 3

4 Erstellen Sie nun eine Vorlage-Datei mit HTML. Diese sollte den folgenden Inhalt haben: <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" " <html xmlns=" > <head> <meta http-equiv="content-type" content="text/html; charset=utf-8" /> </head> <body> <title>unbekannte Webseite</title> </body> <html> Sie könnten diesen Text jetzt abschreiben, sie können ihn aber auch mit einem Trick schneller und vor allen Dingen fehlerfrei erzeugen. Starten Sie hierzu Ihren Browser und gehen Sie auf eine beliebige Internetseite, z. B. Klicken Sie mit der rechten Maustaste in die Seiten und zeigen Sie den Quellcode an. Markieren Sie die entscheidenden Textteile und kopieren Sie diese in Ihren Editor und passen Sie den Text an. Legen Sie in Ihrer Ordnerstruktur einen Ordner..\HTML an und speichern Sie die Datei dort unter dem Namen vorlage.html. Was haben Sie da eigentlich kopiert? Schauen wir einmal diesen sog. Verwaltungsblock genauer an: W3C Hinter diesem Kürzel verbirgt sich ein Gremium mit dem Namen World Wide Web Consortium. Es macht Vorgaben, an die sich alle halten müssen. Die Vorgaben stehen in einem öffentlich verfügbaren Dokument mit dem Namen XHTML-DTD. DAbei steht DTD für Document Type Definition und bezeichnet Vorgaben für die Dokumentengestaltung. Durch diese Formulierung wird ein Browser in den Standardmodus versetzt, in dem er Seiten korrekt interpretieren kann. 4

5 <meta> Das Element <meta> mit der Einstellung UTF8 legt den zeichensatz für diese Seite fest. Das bedeutet konkret, dass Sie auch landesspezifische Zeichen, wie Umlaute, direkt eingeben können. Eine Maskierung wie z. B. &uuml& ist nicht erforderlich. XHTML Dieses steht für Extensible Hypertext Markup Language, das bedeutet eine Seitenbeschreibungssprache mit erweitertem Sprachschatz. XML XML ist die Abkürzung für Extensible Marktup Language und ist mit HTML vergleichbar. 1.2 Eine Vorlagedatei für php Wir wollen nun eine erste einfache php-datei erzeugen, die als Vorlage für alle weiteren Dokumente dienen kann. 1. Öffnen Sie den Windows-Editor. 2. Speichern Sie die noch leere Datei mit folgenden Einstellungen: Speicherort: \xampp\htdocs\php, Codierung UTF-8 Dateiname index.php 3. Geben Sie nun den Code in den Editor ein: <?php // index.php Echo 'Hallo Welt';?> 4. Speichern Sie die Datei und öffnen Sie parallel den Browser. Lassen Sie den Editor geöffnet. Geben Sie im Browser localhost/php ein. Das Ergebnis sollte so aussehen: 5

6 Öffnen Sie ebenfalls im Editor die Datei vorlage.html, die sich in Ordnerstruktur im Verzeichnis \HTML befindet. Die Datei vorlage.html enthält den Rahmen eines HTML-Dokuments. In dieses Dokument soll der php-code eingebettet werden. Markieren Sie hierzu den Inhalt der Datei index.php und kopieren Sie diesen in den Body-Teil der Datei vorlage.html. Schließen Sie die Datei index.php. Speichern Sie die Datei vorlage.hmtl im Ordner...\XAMPP\HTDOCS\php_abfragen unter dem Namen index.php. Achten Sie nun darauf, dass als Dateityp ANSI eingestellt ist (dies ist die Standardeinstellung) und geben Sie als Dateiendung.php ein. 6

7 Überprüfen Sie das Ergebnis im Browser: 1.3 php-datei für Abfragen Im Folgenden werden Sie lernen, wie man Daten aus einer Datenbank abfragt. Hierzu benötigen Sie die Datenbankdatei import_export (in meiner Freigabe im Ordner 13-Q2). Importieren Sie diese Datenbank in phpmyadmin. Es gibt dort einen Link "importieren". Legen Sie einen Ordner mit dem Namen php_abfragen unter \XAMPP\HTDOCS an. Öffnen Sie im Editor die Datei index.php aus dem Ordner \XAMPP\HTDOCS\php und nehmen Sie folgende Anpassungen vor: Titel und Überschrift lauten Abfrage, überprüfen Sie den Eintrag charset: hier sollte latin1 stehen, entfernen Sie alles, was sich zwischen den Elementen <php? und?> befindet, 7

8 speichern Sie die Datei unter dem Namen index.php im Ordner php_abfragen. Achten Sie darauf, dass die Codierung ANSI eingestellt ist. Schließen Sie den Editor und überprüfen Sie das Ergebnis: Erstellen Sie ebenfalls im Ordner php_abfragen eine leere Textdatei mit dem Namen abfragebeispiele.txt. Hier sollen die SQL-Statements gesammelt und kommentiert werden. 1.4 SQL-Beispielstatement erzeugen Abfragen werden in diesem Beispiel für die Datenbank import_export erstellt. Diese Datenbank enthält eine Anzahl von Datensätzen, die sich nach unterschiedlichen Kriterien auswerten lassen. Abfragen werden zum einen mit dem Programm phpmyadmin erstellt. Ziel ist es aber, Daten mit einer Abfrage zu erhalten und mit PHP auf einer Website darzustellen. Dafür dient das noch leere Gerüst der Datei index.php. In folgenden Beispiel soll eine php-seite entwickelt werden, die aus der Datenbank Firmen nach einem bestimmten Kriterium (hier: Bundesland beginnt mit N) heraussucht und anzeigt. Starten Sie den Browser und gehen Sie zu phpmyadmin. Wählen Sie links die Datenbank import_export und anschließend die Tabelle tblfirmen aus. Klicken Sie auf den Link Suche. Geben Sie im Feld Wert neben dem Feld Bundesland N% ein. 8

9 Sobald Sie auf OK klicken, sehen Sie das Ergebnis: Aber Sie sehen auch noch mehr, nämlich das SQL-Statement, das zu dieser Abfrage gehört. Kopieren Sie das Statement und fügen Sie ein in die Datei abfragebeispiele.txt ein und speichern Sie diese. 9

10 Damit haben Sie nun ein anpassungsfähigres Beispiel gesichert. Auch der Eintrag Limit 0,30 wurde übernommen. Er bedeutet, dass in der Ausgabe nur die ersten dreißig Datensätze angezeigt werden. Diese zeige muss später nicht in die PHP-Umgebung übernommen werden. Mit dem Prozentzeichen (%) kann man nach beliebig vielen unbekannten Zeichen suchen. Das Prozentzeichen kann am Anfang eines Kriteriums, in der Mitte oder am Ende stehen. Ist Ihnen bei den Suchkriterien die Schreibweise eines einzelnen Zeichens unbekannt, verwenden Sie den Unterstrich (_). Öffnen Sie in phpmyadmin für die Tabelle tblfirmen wieder die Suchmaske und geben Sie für das Feld PLZ das Suchkriterium 4047_ ein. Das bedeutet, dass die ersten vier Stellen der Postleitzahl bekannt sind und das letzte Zeichen nicht. Sobald Sie mit OK bestätigen, erscheint das Ergebnis und Sie können das SQL-Statement wieder in die Datei abfragebeispiele.txt kopieren. Wozu sind aber diese Beispiele gut? Sie dienen Ihnen als Vorlage, denn das Ziel ist es, das Ergebnis einer solchen Anfrage auf einer Webseite mithilfe der Sprache PHP auszugeben. 1.5 Ablauf einer PHP-Abfrage Ein SQL-Statement kann für eine Abfrage mit PHP verwendet werden. Dazu sind folgende Arbeitsschritte nötig: Es wird eine Verbindung zum Server hergestellt. Es wird eine Verbindung zur Datenbank hergestellt. Das SQL-Statement wird an den Server geschickt. Der Server sendet das Ergebnis. Es wird in PHP ausgewertet. Die Verbindungen werden geschlossen. Diese Arbeitsschritte sollen nun umgesetzt werden. 1.6 PHP-Abfragedatei entwickeln Herstellen einer Verbindung zum Server MySQL-Server Zunächst muss eine Verbindung zum MySQL-Server hergestellt werden. Dies erreicht man mit der Funktion mysql_connect. Sie benötigt als Parameter den Namen des Servers, des Administrators und das Kennwort (Sicherheitsaspekte bleiben hier einmal außen vor). Diese Parameter wurde im Zusammenhang mit der Datenbank- und Netzwerkumgebung eingerichtet. Das heißt, dass der Server hier localhost heißt und der Administrator root. Angenommen, des gibt eine Variable mit dem Namen $con (für Connect), dann sieht der Code für den funktionierenden Verbindungsaufbau wie folgt aus: $con = mysql_connect('localhost', 'root', 'A2xK5Mm8'); 10

11 Aus dem letzten Parameter sollten Sie das bei uns vergebene Kennwort für den Administrator erkannt haben ;-)) Herstellung einer Verbindung zur Datenbank Die Variable $con stellt die Verbindung zum Server dar. Über diese Verbindung wird im nächsten Schritt ein SQL-Statement an den Server geschickt. Dazu dien die Funktion mysql_select_db. Sie benötigt als Parameter den Namen der Datenbank und den Namen der Verbindung zum MySQL-Server. Um eine Verbindung zur Datenbank import_export herstellen zu können, muss der Code wie folgt aussehen: mysql_select_db('import_export', $con); Senden eines SQL-Statements an den MySQL-Server Im nächsten Schritt wird ein SQL-Statement an den MySQL-Server geschickt. Dafür wird die Funktion mysql_query benötigt. Sie erhält als Parameter das SQL-Statement und den Namen der Verbindung zum Server. Um sich nur die Firmen aus der Tabelle tblfirmen anzeigen zu lassen, die in Bundesländern mit dem Anfangsbuchstaben N liegen, sieht der Code wie folgt aus: $result=mysql_query('select * FROM tblfirmen WHERE `Bundesland` LIKE "N%"', $con); Die Variable $result erhält das Ergebnis der Abfrage und kann später ausgewertet werden. Schreiben Sie nun diese drei Zeilen in Ihre Datei index.pph in den PHP-Block. Das SQL-Statement können Sie direkt aus der Datei abfragebeispiele.txt übernehmen. Anschließend muss noch eine Anpassung vorgenommen werden. Das Kriterium N% muss mit Anführungszeichen eingegrenzt werden und die einfachen Anführungszeichen um tblfirmen (') müssen entfernt werden. Das ganze sieht dann so aus: Datensätze anzeigen Wenn Sie die Datei nach dieser Eingabe speichern und sich das Ergebnis im Browser anschauen, wäre noch nichts zu sehen. Bisher wurden die Ergebnisdatensätze ja auch nur in einer Variablen gesichert - von Ausgabe keine Spur! 11

12 Für die Ausgabe der einzelnen, in der Variable $result gespeicherten Datensätze eignet sich am besten eine Schleife, die die Datensätze in der Tabelle der Reihe nach ausgibt. Hierzu ist die Funktion mysql_fetch_row erforderlich. Mit ihrer Hilfe lässt sich jeder Datensatz einzeln ansprechen und ausgeben. Um festzustellen, ob man fertig ist oder ob nach Felder zum Auslesen vorhanden sind, kann man die Funktion mysql_num_fields verwenden. Das Ergebnis der Funktion gibt an, wie viele Felder (also Reihen) in der Ergebnistabelle vorhanden sind. Sie sollten hier die bekannten while- und for-schleifen aus Java wiedererkennen: while ($row = mysql_fetch_row($result)) { for ($i=0; $i<mysql_num_fields($result); $i++) echo $row[$i]." "; echo '<br /><br />'; } Hier wird der Variablen $row zeilenweise jeder Datensatz zugewiesen, um ihn dann auszugeben. Bei dieser Variablen handelt es sich genau genommen um ein Array für die Inhalt der Tabellenfelder. Nachjedem ausgegebenen Datensatz werden mit dem Element <br /> zwei Zeilenumbrüche in der Anzeige ausgegeben. Verbindung schließen Zum Schluss wird die offene Verbindung zum Server wieder geschlossen. DAs geschieht mit der Funktion mysql_close. Notieren Sie hierfür folgenden Code: mysql_close($con); Geben Sie den Code genauso ein, wie hier beschrieben. Speichern Sie die Datei unter dem Namen index.php im Verzeichnis \php_abfragen. Das Ergebnis sollte dann so aussehen: 12

13 Entsprechend können Sie jetzt im Browser alle Firmen mit Postleitzahlbereich 4047_ anzeigen lassen, indem Sie das SQL-Statement in der Datei ändern. Wenn Sie sich jetzt fragen, ob Sie nun zu jeder Anfrage immer das SQL-Statement ändern müssen... natürlich nicht... das Skript ist ja hier auch noch nicht zu Ende ;-)) 13

14 2 Dynamische Abfragen Im vorigen Kapitel haben Sie Auswahlabfragen kennengelernt, in denen feste Kriterien vorgegeben wurden. Hier kann man nicht unbedingt von einer Dynamik sprechen ;-)) Anders sieht es allerdings aus, wenn Sie dem Anwender eine Eingabemöglichkeit bieten, und er dann ein Ergebnis erhält, welches zu seinen Angaben passt. In einer Parameterabfrage werden die Kriterien nicht vorgegeben, sondern flexibel in ein SQL- Statement eingebaut. Dabei kann ein Eingabefeld ineiner PHP-Datei ein Suchkriterium eines Anwenders entgegennehmen, welches dann das SQL-Statement ergänzt und vervollständigt. Im Folgenden wird diese Aufgabe schrittweise umgesetzt. Dazu ist eine PHP-Datei erforderlich, die als Eingabeformular dient. Die Eingabefelder in dieser Datei sind reiner HTML-Code. Den Umgang mit Eingabefeldern finden Sie daher in Skripten zum Thema "Formulare in HTML". Die Eingaben aus dieser Datei werden dann in einer weiteren PHP-Datei verarbeitet und ausgegeben. In meiner Freigabe finden Sie zwei vorbereitete Dateien formular.php und resultat.php. Kopieren Sie diese Dateien in Ihren Ordner..\XAMPP\HTDOCS\php_abfragen. 2.1 Vorbereitung des Eingabeformulars Öffnen Sie die Datei formular.php im Browser. In der Datei befindet sich ein Formular mit einigen Eingabefeldern. Dieses Dokument nehmen wir als Grundlage und werden es nun anpassen. Öffnen Sie das Dokument im Editor und nehmen Sie die folgenden Änderungen vor: Passen Sie Titel und Überschrift an. Ersetzen Sie Adresseingabe durch Unser Angebot. Passen Sie den Hinweistext ebenfalls an. Schreiben Sie hier  Dann passen Sie den Inhalt der Tabelle an. (Dass es sich um eine Tabelle handelt, erkennen Sie an den Tags <table>, <tr> und <td>. Weiteres darüber finden Sie in den Skripten zu HTML) Es reichen uns zunächst zwei Eingabefelder: Speichern Sie die Datei und rufen Sie sie im Browser auf. 14

15 Im Moment müssen Sie hier noch nichts eingeben, denn die Verarbeitungsdatei result.php ist noch gar nicht vorbereitet. Auf diese Datei wird in der Zeile <form action="resultat.php" method="post"> verwiesen. 2.2 Vorbereiten der Verarbeitungsdatei Öffnen Sie die Datei resultat.php im Browser. Diese Datei ist dazu gedacht, Eingaben aus einem Formular entgegen zu nehmen und die Antworten darzustellen. Diese Datei ist aber nicht dazu vorbereitet, mit der Datenbank zu kommunizieren und von dort Ergebnisse entgegen zu nehmen. Öffnen Sie die Datei im Editor. Passen Sie auch hier zunächst den Formulartitel und die Überschrift an. Nennen sie beides Unser Angebot. Anschließend kopieren Sie alles, was sich unterhalb der Zeile mit der Überschrift <h1>unser Angebot</h1> befindet bis zum Element </body> in eine andere Datei und löschen diese Zeilen aus der Datei resultat.php. Sie werden diese Zeile (sie stellen eine Tabelle dar) später anpassen und wieder einfügen. Schrittweise werden dann folgende Elemente eingefügt: 1. Übernahme der Eingaben der Anwender 2. SQL-Statement zur Verarbeiten der Eingabe 3. Aufbau einer Verbindung zum Server und zur Datenbank, Übertragen des SQL-Statements 4. Ergebnisdarstellung zeilenweise/feldweise in einer Tabellenstruktur 5. Schließen der Verbindung 1. Um die Eingabe der Anwender aus dem Formular entgegen zu nehmen, schreiben Sie die folgenden Zeilen: <?php // Übernahme der Formulareingabe $Kategorie = $_POST['strKategorie']; $Artikel = $_POST['strArtikel']; Damit bauen Sie PHP-Code in das HTML-Dokument ein. Die Inhalte der beiden Eingabefelder werden jeweils einer Variablen zugewiesen. 2. Nun muss das SQL-Statement der Variablen $sql zugewiesen. Dabei soll erreicht werden, dass die Variable mit der Anwendereingabe als dynamisches Element in das SQL-Statement eingebaut wird. Hierzu gehört der folgende Code: // Zuweisung des SQL-Statements $sql = "SELECT tblkategorien.bezeichnung, tblartikel.name, tblartikel.preis, tblartikel.bestand, tblartikel.mindestbestand, tblartikel.letzte_bestellung_datum FROM tblkategorien INNER JOIN tblartikel ON tblkategorien.kategoriennummer = tblartikel.kategorie WHERE tblkategorien.bezeichnung = $'Kategorie' OR tblartiekl.name = '$Artikel' OPRDER BY tblkategorien.bezeichnung ASC, tblartikel.name ASC"; Übernehmen Sie diese Zeilen exakt so, wie beschrieben. Besonders interessant ist die Zeile mit den Kriterien: WHERE tblkategorien.bezeichnung = $'Kategorie' OR tblartiekl.name = '$Artikel' 15

16 Hier sind die beiden Variablen eingebaut. Die Abfrage bezieht sich auf die beiden Tabellen tblkategorien und tblartikel in der Datenbank isys (s. meine Freigabe), die über eine JOIN- Verbindung miteinander verbunden sind. Konkret bedeutet das hier, dass es in der Tabelle tblkategorien ein Feld Kategoriennummer gibt, das sich in der Tabelle tblartikel im Feld Kategorie wiederfindet. 3. Nun wird die Verbindung zu Server und Datenbank hergestellt. Schreiben Sie dazu folgenden Code: //Verbindungsobjekt und Zugangsdaten definieren $con = mysql_connect('localhost', 'root', 'A2xK5Mm8'); mysql_select_db('isys', $con); $result = mysql_query($sql, $con); Die Bedeutung dieser Zeilen sollte Ihnen bekannt sein. Der Zugang zum Server localhost erfolgt über den Administrator root und dem dazugehörenden Kennwort. Die Datenbank isys wird über diese Verbindung aufgerufen und das SQL-Statement an den Server gesendet. Das Ergebnis wird der Variablen $result zugewiesen. 4. Zum Schluss wird nun das Ergebnis ansprechend und ordentlich auf der Webseite ausgegeben. Dies soll in einer Tabellenstruktur geschehen. Auch dieses Code-Schnipsel haben Sie bereits im vorigen Kapitel kennen gelernt: // Ausgabe des Ergebnisses while ($row = mysql_fetch_row($result) {?> Beachten Sie bitte, dass in der letzten Zeile dieses Code-Teils der PHP-Teil der Datei zunächst endet. Sie erkennen dies an?>. In dem bisherigen Block haben Sie sich in PHP bewegt. Die Erstellung einer Tabelle erfolgt wieder in HTML. Aus dem Grund müssen Sie kurzfristig den PHP-Block beenden. Zuvor die die Schleife begonnen, die eine zeilenweise Verarbeitung der Ergebnistabelle erlaubt. Jedes Mal, wenn die Funktion mysql_fetch_row aufgerufen wird, wird eine neue Zeile der Tabelle bearbeitet. Jeder Zeile wird hier dem Array $row zugewiesen. Nach dem vorläufigen Ende des PHP-Blocks kann die HMTL-Tabelle aus der ursprünglichen Datei wieder verwendet werden. Sie haben diesen Code am Anfang dieses Vorgangs in eine andere Datei ausgelagert Innerhalb der Tabelle wird aus dem Array $row jedes Feld einzeln angesprochen. Die Felder sind nummeriert, die Zählung beginnt bei 0. Die Reihenfolge der Felder richtet sich nach dem SQL- Statement. Hieraus ergibt sich folgender Aufbau: $row[0] Bezeichnung der Kategorie $row[1] Artikelname $row[2] Preis des Artikels $row[3] Lagerbestand $row[4] Mindestbestand $row[5] Letzte Bestellung 16

17 Diese Bestandteile können nun in die Tabelle eingebaut werden. Dabei wird für jede Zuweisung der PHP-Code-Block wieder aktiviert und anschließend beendet. Ändern Sie Ihre ausgelagerte Date wie folgt und kopieren Sie sie anschließend in die Datei resultat.php: Damit die Angaben der einzelnen Artikel nicht so eng aneinander hängen, empfiehlt es sich, nach jedem Artikel zwei Zeilenumbrüche in PHP einzufügen. Außerdem muss die WHILE-Schleife noch beendet und die Verbindung zum Server noch geschlossen werden. Das macht der folgende Code: <?php echo '<br /><br />'; } mysql_close($con);?> Nun ist's fertig! Testen Sie die Abfrage, indem Sie z. B. alle Artikel anzeigen lassen, die zur Kategorie "Bad" gehören. 17

18 Hier das Listing der Gesamt-Datei resultat.php 18