Installation XAMPP in der Musterlösung mit der Zeichenkodierung UTF-8

Transkript

1 Berufliche Schulen Zentrale Projektgruppe - Computertechnik / Informatik Kaufmännische Schulen Winfried Klein, Eckehard Möbius Installation XAMPP in der Musterlösung mit der Zeichenkodierung UTF-8 Landesinstitut für Schulentwicklung Qualitätsentwicklung und Evaluation best@ls.kv.bwl.de Schulentwicklung und empirische Bildungsforschung Stand: Bildungspläne

2 Inhalt Inhalt Installation XAMPP in der Musterlösung Konfiguration des Apache-Webservers Aufruf des Apache-WebServers mit PHP Beenden des Apache-WebServers Konfiguration des MySQL-Datenbankservers Aufruf des MySQL-Datenbankservers Beenden des MySQL-Datenbankservers Aufruf des MySQL-Datenbankservers mit Benutzerrechten Zugriff mit PHP-Skripten auf MySQL-Datenbanken Installation XAMPP in der digitalen Schultasche Konfiguration des Apache-Webservers Aufruf des Apache-WebServers mit PHP Beenden des Apache-WebServers Konfiguration des MySQL-Datenbankservers Aufruf des MySQL-Datenbankservers Beenden des MySQL-Datenbankservers Aufruf des MySQL-Datenbankservers mit Benutzerrechten Verwendung von Joomla mit dieser XAMPP-Version Downloadmöglichkeiten Kfm. ZPG am Landesinstitut für Schulentwicklung (LS) Stuttgart -2-

3 1. Installation XAMPP in der Musterlösung (kw/me) Die Lehrpläne in den Fächern Informatik bzw. Wirtschaftsinformatik an den beruflichen Gymnasien (AG, EG, SG und WG außer BTG) und den Kaufmännischen Berufskollegs sind so angelegt, dass ihre Inhalte auch mit lizenzkostenfreien Anwendungen (oft als opensource bezeichnet) vermittelt werden können. - Für die Bereiche, in denen ein Webserver benötigt wird bzw. für den Bereich der Datenbankanwendungen bietet sich der Einsatz der aufeinander abgestimmten Programmsammlung XAMPP an. - Der folgende Artikel beschreibt die Installation dieses Programmpaketes in der Musterlösung des Landes Baden-Württemberg mit den für den Unterricht in obigen Fächern benötigten Konfigurationen. Neben dem kostenlosen Einsatz an unseren Schulen bietet XAMPP die Vorteile, dass eine Installation auf allen drei Musterlösungsvarianten serverbasiert möglich ist. Der Aufruf der einzelnen Anwendungen erfolgt über zentrale Batchdateien, die auch die notwendigen Anwendungsdaten in den Homeverzeichnissen der Benutzer anlegen. Die Installation in allen drei Ausprägungen der Musterlösung (Windows, Novell und Linux) ist identisch, unterscheidet sich aber (je nach Version) nur in der Wahl der Laufwerksbuchstaben für das serverbasierte Programmverzeichnis und den Homeverzeichnissen der Benutzer, dem Handling der Rechtevergabe auf das Programmverzeichnis und dem Zur-Verfügung- Stellen der Batchdateien für den Aufruf der einzelnen Anwendungen. In diesem Artikel werden in den beschriebenen Ausschnitten der Konfigurationsdateien die Laufwerksbuchstaben der Novell-Musterlösung benutzt. Die in diesem Artikel beschriebene Installation wurde mit der Version getestet. Bei zukünftigen Versionen von XAMPP kann es Abweichungen von dieser Installationsbeschreibung geben. Die aktuelle Version von XAMPP kann von der Seite heruntergeladen werden. Dabei muss die ZIP-Version (entpackt nur die Dateien in ein gewähltes Verzeichnis) und nicht die Installer-Version gewählt werden. Ältere Versionen, z. B. auch diese Version von XAMPP stehen auf der Seite zur Verfügung. In diesem Paket von XAMPP sind enthalten: Apache-Webserver MySQL-Datenbankserver PHP phpmyadmin FileZilla FTP-Server Mercury Mail-System Die Joomla-Version kann im Unterrichtsnetz mit dieser Version von XAMPP eingesetzt werden. Kfm. ZPG am Landesinstitut für Schulentwicklung (LS) Stuttgart -3-

4 Das fertig konfigurierte Programmpaket mit allen im Folgenden dokumentierten Einstellungen kann herunter geladen werden (siehe Kapitel 3). Zum Entpacken wählt man das Serverprogrammverzeichnis k:\ (ein Ordner k:\xampp wird beim Entpacken erstellt). Die Benutzer erhalten auf k:\xampp die Rechte zum Lesen und Ausführen der Dateien. Alle Verzeichnisse für das FTP-System und das Mail-System sowie fast alle ausführbaren Dateien und Batchdateien zum Aufrufen der einzelnen Paketteile durch die Benutzer unter k:\xampp können (sollten) gelöscht bzw. in ein temporäres Verzeichnis verschoben werden. Die benötigten Batchdateien werden durch auf unser Vorhaben angepasste Batchdateien ersetzt. k:\xampp - vorher k:\xampp - nachher 1.1 Konfiguration des Apache-Webservers Damit alles nach unseren Vorgaben funktioniert, muss die Konfigurationsdatei für den Apache-Webserver und den PHP-Interpreter unter k:\xampp\apache\conf\httpd.conf angepasst werden. Zeilennummer (ca.) geänderter Eintrag 35 ServerRoot "k:/xampp/apache" 188 DocumentRoot "h:/xampp/htdocs" 215 <Directory "h:/xampp/htdocs"> 272 ErrorLog "h:/xampp/logs/error.log" 303 Kommentar entfernen und ändern: CustomLog "h:/xampp/logs/access.log" common 309 Kommentar einfügen: Kfm. ZPG am Landesinstitut für Schulentwicklung (LS) Stuttgart -4-

5 # CustomLog "logs/access.log" combined 339 ScriptAlias /cgi-bin/ "k:/xampp/cgi-bin/" 355 <Directory "k:/xampp/cgi-bin"> 509 # eigene Erweiterung: Pfad zur PID-Datei PidFile "h:/xampp/logs/httpd.pid" Am Ende, 512 Zeile einfügen AddDefaultCharset utf-8 Achtung: Läuft auf der lokalen Arbeitsstation ein weiterer WebServer wie z. B. der IIS von Microsoft auf Port 80, so muss der Port für den Apache-Webserver z.b. auf 81 geändert werden. Zeilennummer (ca.) geänderter Eintrag 47 Listen 81 Da wir den SSL-Support für den Unterricht nicht benötigen, kann in der Konfigurationsdatei k:\xampp\apache\conf\extra\httpd-ssl.conf die Zeile LISTEN 443 auskommentiert werden. Zusätzlich müssen analog zur Datei httpd.conf die entsprechenden Einträge verändert werden, da sonst der Apache-Webserver versucht auf die Log-Dateien im Programmverzeichnis k:\xampp zuzugreifen. Zeilennummer (ca.) geänderter Eintrag 41 Kommentar einfügen: #Listen DocumentRoot "h:/xampp/htdocs" 85 ErrorLog "h:/xampp/logs/error.log" 87 CustomLog "h:/xampp/logs/access.log" common 233 CustomLog "h:/xampp/logs/ssl_request.log"... Die Umstellung von PHP auf die Zeichencodierung UTF-8 erfolgt in der Datei k:\xampp\php\php.ini Zeilennummer (ca.) geänderter Eintrag 777 evtl. Kommentar einfügen: ;default_charset = "iso " 778 Zeile einfügen default_charset = "utf-8" 1772 Zeile einfügen mbstring.language = utf Zeile einfügen mbstring.internal_encoding = utf Zeile einfügen mbstring.http_input = utf Zeile einfügen mbstring.http_output = utf Aufruf des Apache-WebServers mit PHP Gestartet wird der Apache-Webserver durch die Benutzer mit der untenstehenden Batchdatei start_apache.bat im Verzeichnis k:\xampp. Diese überprüft, ob die benötigte Anwendungsdatenstruktur im Homeverzeichnis des Benutzers vorhanden ist. Kfm. ZPG am Landesinstitut für Schulentwicklung (LS) Stuttgart -5-

6 Für html- und php-seiten für log-dateien Wenn nicht, wird diese Anwendungsdatenstruktur mit der Batchdatei angelegt. echo Es wird versucht, den Apache-Webserver zu starten... if exist h:\xampp goto S1 md h:/xampp :S1 if exist h:\xampp\htdocs goto S2 md h:\xampp\htdocs rem optionales Kopieren von 3 Dateien zum Testen des Webservers rem die Dateien liegen dieser Dokumentation bei copy k:\xampp\htdocs\index.html h:\xampp\htdocs copy k:\xampp\htdocs\test.php h:\xampp\htdocs copy k:\xampp\htdocs\format.css h:\xampp\htdocs :S2 if exist h:\xampp\logs goto S3 md h:\xampp\logs :S3 if not exist h:\xampp\logs\httpd.pid goto start del h:\xampp\logs\httpd.pid löscht eventuell vorhandene pid- Datei, da sonst der WebServer nicht startet. :start xampp_cli.exe start apache Die folgende Systemmeldung zeigt, dass der Apache-Webserver erfolgreich gestartet wurde: Die folgende Systemmeldung zeigt, dass der Apache-Webserver NICHT erfolgreich gestartet wurde, weil er z. B. schon gestartet wurde: Kfm. ZPG am Landesinstitut für Schulentwicklung (LS) Stuttgart -6-

7 Mit den Seiten index.htm und format.css im Verzeichnis h:\xampp\htdocs und dem Aufruf in einem Browser kann der Apache-Webserver getestet werden. <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>test Apache im Unterrichtsnetz</title> <link rel="stylesheet" type="text/css" href="format.css" /> </head> <body> <h1>herzlich willkommen!</h1> <h2>sie haben es geschafft. Der Apache-Webserver auf Ihrem lokalen System läuft.</h2> </body> </html> /* DATEI: format.css */ h1 } {font-family: "Times New Roman"; font-size: 36pt; color: red; text-align: center; h2 {font-family: Arial; font-size: 18pt; color: blue; text-align: center; } body {background-color: yellow; } Mit der Seite test.php im Verzeichnis h:\xampp\htdocs und dem Aufruf php in einem Browser kann die PHP-Anbindung an den Apache-Webserver getestet werden. <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>test PHP5 im Unterrichtsnetz</title> <link rel="stylesheet" type="text/css" href="format.css" /> </head> <body> <h1>php5-konfiguration:</h1> <?php Kfm. ZPG am Landesinstitut für Schulentwicklung (LS) Stuttgart -7-

8 phpinfo();?> </body> </html> 1.3 Beenden des Apache-WebServers Beendet werden muss der Apache-Webserver mit Hilfe der Batchdatei stop_apache.bat durch den Benutzer. ECHO Der Apache-Webserver wird beendet xampp_cli.exe stop apache if not exist h:\xampp\logs\httpd.pid goto ende del h:\xampp\logs\httpd.pid :ende Meldet sich der Benutzer von der Arbeitsstation ab, ohne den Apache-Webserver zu beenden, ergeben sich Probleme mit der Datei httpd.pid im Homeverzeichnis h:\xampp\logs des Benutzers. Die Batchdatei start_apache.bat ist deshalb so aufgebaut, dass die pid-datei, falls vorhanden, automatisch gelöscht wird. Nach dem Beenden des Apache-Webservers sind die beiden DOS-Boxen noch geöffnet. Aus 'pädagogischen' Gründen wurde die PAUSE am Ende der bat-dateien eingebaut, damit Lehrer und Schüler jeweils den Zustand des Apache-Webservers erkennen können: Kfm. ZPG am Landesinstitut für Schulentwicklung (LS) Stuttgart -8-

9 1.4 Konfiguration des MySQL-Datenbankservers Damit die Datenbankdateien im Homeverzeichnis der Benutzer liegen und ein mit Schreibrechten versehenes Verzeichnis für die temporären Dateien vorhanden ist, muss die Konfigurationsdatei k:\xampp\mysql\bin\my.ini angepasst werden. Zeilennummer (ca.) geänderter Eintrag 24 Zeile einfügen default-character-set = utf8 29 basedir = "k:/xampp/mysql/" 30 datadir = "h:/xampp/mysql/" 45 log_error = "h:/xampp/mysql/mysql.err" 48 general_log_file = "h:/xampp/mysql/mysql.log" 50 slow_query_log_file = "h:/xampp/mysql/mysql-slow.log" Zeilen einfügen default-character-set = utf8 character-set-server = utf8 collation-server = utf8_general_ci init_connect = "SET collation_connection = utf8_general_ci" init_connect = "SET names 'utf8'" 137 tmpdir = "h:/xampp/tmp/" 142 innodb_data_home_dir = "h:/xampp/mysql/" 144 innodb_log_group_home_dir = "h:/xampp/mysql/" 158 Zeile einfügen default-character-set = utf8 164 Zeile einfügen default-character-set = utf8 180 Zeile einfügen default-character-set = utf8 1.5 Aufruf des MySQL-Datenbankservers Gestartet wird der MySQL-Datenbankserver mit der untenstehende Batchdatei start_mysql.bat im Verzeichnis k:\xampp, welche zunächst überprüft, ob die benötigte Anwendungsdatenstruktur im Homeverzeichnis des Benutzers vorhanden ist. Kfm. ZPG am Landesinstitut für Schulentwicklung (LS) Stuttgart -9-

10 Datenbankverzeichnis temporäre Dateien Wenn nicht, wird diese Anwendungsdatenstruktur mit der Batchdatei angelegt und die für den Betrieb des Datenbankservers benötigten Strukturtabellen aus dem serverbasierten Programmverzeichnis k:\xampp\mysql\data\ kopiert. echo Es wird versucht, den MySQL-Datenbankserver zu starten... if exist h:\xampp goto S1 md h:\xampp :S1 if exist h:\xampp\mysql goto S2 md h:\xampp\mysql :S2 if exist h:\xampp\tmp goto S3 md h:\xampp\tmp :S3 if exist h:\xampp\mysql\mysql\nul goto start xcopy k:\xampp\mysql\data\*.* h:\xampp\mysql\*.* /s :start mysql\bin\mysqld.exe --defaults-file=k:\xampp\mysql\bin\my.ini --standalone --console --skip-grant-tables 2 Hinweise zu den Startparametern: --console Schreibt Fehlerlogmeldungen auch dann in stderr und stdout, wenn --log-error angegeben ist. Wenn diese Option verwendet wird, schließt mysqld das Konsolenfenster nicht. --defaults-file Datei mit den Konfigurationseinstellungen --skip-grant-tables Der Server überprüft/verwendet das Berechtigungssystem überhaupt nicht. --standalone Nur unter Windows NT-basierten Systemen vorhanden. Die Option weist den MySQL-Server an, nicht als Dienst ausgeführt zu werden. Die folgende Systemmeldung zeigt, dass der MySQL-Datenbankserver erfolgreich gestartet wurde: 2 Der komplette Befehl muss in einer Zeile stehen. Kfm. ZPG am Landesinstitut für Schulentwicklung (LS) Stuttgart -10-

11 Die folgende Systemmeldung zeigt, dass der MySQL-Datenbankserver NICHT erfolgreich gestartet wurde: Getestet werden kann der Datenbankserver z.b. mit der MySQL-Konsole - k:\xampp\mysql\bin\mysql.exe in einer weiteren Eingabeaufforderung starten, - den Befehl show databases; ausführen und - die Konsole mit quit; schließen. 1.6 Beenden des MySQL-Datenbankservers Beendet wird der MySQL-Datenbankserver beim Ausloggen des Benutzers oder durch die Batchdatei stop_mysql.bat im Verzeichnis OFF ECHO Der MySQL-Datenbankserver wird beendet xampp_cli.exe stop mysql PAUSE Kfm. ZPG am Landesinstitut für Schulentwicklung (LS) Stuttgart -11-

12 1.7 Aufruf des MySQL-Datenbankservers mit Benutzerrechten Bei der obigen Startdatei start_mysql.bat werden innerhalb des MySQL-Datenbankservers Benutzerrollen mit entsprechenden Rechten nicht berücksichtigt (--skip-grant-tables). Dies ist zunächst so gewollt. Möchte man jedoch mit seinen Schülern z.b. den GRANT-Befehl behandeln, muss der MySQL-Datenbankserver mit der Startdatei start_mysql_grant.bat gestartet werden. Sie unterscheidet sich von der Startdatei start_mysql.bat nur in Zeile 17 durch das Fehlen des Parameters --skip-grant-tables. echo Es wird versucht, den MySQL-Datenbankserver mit Benutzerrollen zu starten :start mysql\bin\mysqld.exe --defaults-file=k:\xampp\mysql\bin\my.ini --standalone --console Zugriff mit PHP-Skripten auf MySQL-Datenbanken Ergänzung des Quellcodes (z. B.): //Datenbankverbindung herstellen $dbverbindung = new mysqli($mserver, $mbenutzer, $mkennwort, $mdatenbank); // Datenbankverbindung hergestellt? if(mysqli_connect_errno() == 0) { // Zeichensatz des Servers mit SQL auf UTF-8 umstellen $dbverbindung->query("set names 'utf8'"); // SQL-Anweisung erstellen } 2. Installation XAMPP in der digitalen Schultasche Das Verzeichnis xampp auf dem Unterrichtsserver kann in das Root-Verzeichnis der digitalen Schultasche kopiert werden. Allerdings sind die folgenden Änderungen notwendig: 2.1 Konfiguration des Apache-Webservers Die Konfigurationsdatei für den Apache-Webserver und den PHP-Interpreter unter \xampp\apache\conf\httpd.conf muss angepasst werden: 3 Der komplette Befehl muss in einer Zeile stehen. Kfm. ZPG am Landesinstitut für Schulentwicklung (LS) Stuttgart -12-

13 Zeilennummer (ca.) geänderter Eintrag 35 ServerRoot "/xampp/apache" 188 DocumentRoot "/xampp/htdocs" 215 <Directory "/xampp/htdocs"> 272 ErrorLog "/xampp/logs/error.log" 303 CustomLog "/xampp/logs/access.log" common 339 ScriptAlias /cgi-bin/ "/xampp/cgi-bin/" 355 <Directory "/xampp/cgi-bin"> 510 PidFile "/xampp/logs/httpd.pid" Die Konfigurationsdatei k:\xampp\apache\conf\extra\httpd-ssl.conf anpassen: Zeilennummer (ca.) geänderter Eintrag 82 DocumentRoot "/xampp/htdocs" 85 ErrorLog "/xampp/logs/error.log" 87 CustomLog "/xampp/logs/access.log" common 233 CustomLog "/xampp/logs/ssl_request.log" Aufruf des Apache-WebServers mit PHP Gestartet wird der Apache-Webserver durch die Benutzer mit der untenstehenden Batchdatei start_apache.bat im Verzeichnis \xampp auf dem USB-Stick echo Es wird versucht, den Apache-Webserver echo auf dem USB-Stick zu starten... echo if not exist \xampp\logs\httpd.pid goto start del \xampp\logs\httpd.pid :start xampp_cli.exe start apache löscht eventuell vorhandene pid-datei, da sonst der WebServer nicht startet. Die Batchdatei wird in der digitalen Schultasche aufgerufen. Kfm. ZPG am Landesinstitut für Schulentwicklung (LS) Stuttgart -13-

14 2.3 Beenden des Apache-WebServers Beendet wird der Apache-Webserver durch die Benutzer mit der untenstehenden Batchdatei stop_apache.bat im Verzeichnis \xampp.. echo Der Apache-Webserver vom USB-Stick wird beendet echo xampp_cli.exe stop apache if not exist \xampp\logs\httpd.pid goto ende del \xampp\logs\httpd.pid :ende Die Batchdatei wird in der digitalen Schultasche aufgerufen. Meldet sich der Benutzer von der Arbeitsstation ab, ohne den Apache-Webserver zu beenden, ergeben sich Probleme mit der Datei httpd.pid im Homeverzeichnis \xampp\logs des Benutzers. Die Batchdatei start_apache.bat ist deshalb so aufgebaut, dass die pid-datei, falls vorhanden, automatisch gelöscht wird. Nach dem Beenden des Apache-Webservers sind die beiden DOS-Boxen noch geöffnet. Aus 'pädagogischen' Gründen wurde die PAUSE am Ende der bat-dateien eingebaut, damit Lehrer und Schüler jeweils den Zustand des Apache-Webservers erkennen können: Kfm. ZPG am Landesinstitut für Schulentwicklung (LS) Stuttgart -14-

15 2.4 Konfiguration des MySQL-Datenbankservers Die Konfigurationsdatei \xampp\mysql\bin\my.ini muss für den USB-Stick angepasst werden: Zeilennummer (ca.) geänderter Eintrag 29 basedir = "/xampp/mysql/" 30 datadir = "/xampp/mysql/data/" 45 log_error = "/xampp/mysql/mysql.err" 48 general_log_file = "/xampp/mysql/mysql.log" 50 slow_query_log_file = "/xampp/mysql/mysql-slow.log" 137 tmpdir = "/xampp/tmp/" 142 innodb_data_home_dir = " /xampp/mysql/" 144 innodb_log_group_home_dir = "/xampp/mysql/" 2.5 Aufruf des MySQL-Datenbankservers Gestartet wird der MySQL-Datenbankserver mit der untenstehende Batchdatei start_mysql.bat im Verzeichnis \xampp: echo Es wird versucht, den MySQL-Datenbankserver echo auf dem USB-Stick zu starten... echo mysql\bin\mysqld.exe --defaults-file=\xampp\mysql\bin\my.ini --standalone --console --skip-grant-tables Die Batchdatei wird in der digitalen Schultasche aufgerufen. Kfm. ZPG am Landesinstitut für Schulentwicklung (LS) Stuttgart -15-

16 2.6 Beenden des MySQL-Datenbankservers Beendet wird der MySQL-Datenbankserver durch die Batchdatei stop_mysql.bat im Verzeichnis \xampp. echo Der MySQL-Datenbankserver vom USB-Stick wird beendet echo xampp_cli.exe stop mysql Die Batchdatei wird in der digitalen Schultasche aufgerufen. 2.7 Aufruf des MySQL-Datenbankservers mit Benutzerrechten Gestartet wird der MySQL-Datenbankserver mit Benutzerverwaltung mit der untenstehende Batchdatei start_mysql_grant.bat im Verzeichnis \xampp: echo Es wird versucht, den MySQL-Datenbankserver echo auf dem USB-Stick mit Benutzerrollen zu starten echo mysql\bin\mysqld.exe --defaults-file=mysql\bin\my.ini --standalone --console 3. Verwendung von Joomla mit dieser XAMPP-Version Die ersten Schritte sind dokumentiert und können von der Seite unter 'Aktuelle Hinweise zu XAMPP ' herunter geladen werden. Kfm. ZPG am Landesinstitut für Schulentwicklung (LS) Stuttgart -16-

17 4. Downloadmöglichkeiten Die beiden Verzeichnisse mit dem Namen xampp liegen als gepackte Dateien in zwei Versionen vor: Xampp_Server.zip enthält das komplette Verzeichnis xampp für das Laufwerk K: auf dem Unterrichtsserver Xampp_Stick.zip enthält das komplette Verzeichnis xampp für das Root-Laufwerk des USB-Stick (der digitalen Schultasche) Beide Dateien können von der Seite unter 'Aktuelle Hinweise zu XAMPP ' herunter geladen werden. Kfm. ZPG am Landesinstitut für Schulentwicklung (LS) Stuttgart -17-