User Documentation
Herunterladen
Starten

Apache, PHP und MySQL manuell einrichten

Übersicht

Hier folgt ein kurzer Überblick über die Schritte zur Einrichtung von Apache, PHP und MySQL in einer Windows-Umgebung sowie Verweise auf verschiedene zugehörige Werkzeuge zur Wartung und Bearbeitung der meisten mit Joomla! verbundenen Aufgaben.

Um die Anleitung klar und präzise zu halten, gehen wir davon aus, dass überall dort, wo keine ausdrückliche Anweisung gegeben wird, die Standardpfade der Einrichtung unverändert übernommen werden.

Warnung

Falls bereits eines der vorgefertigten AMP-Pakete auf dem Rechner installiert ist:

  • Eine Rückkehr zum bisherigen AMP-Paket wird schwierig sein. Die verschiedenen im Folgenden durchgeführten Installationen überschreiben Registrierungswerte und nehmen allgemeine Änderungen an der Umgebung vor. (Dies betrifft zumindest die PC-/Windows-Umgebung.)
  • Falls bestehende Konfigurationen (Apache, MySQL oder PHP) oder Daten (vorhandene Websites und zugehörige Datenbanken) erhalten bleiben sollen, sind vor dem Befolgen dieser Anleitung entsprechende Sicherungen anzulegen.

(muss noch um konkrete Hinweise erweitert werden, wie das oben Genannte umzusetzen ist...)

MySQL-Einrichtung

  1. Den passenden MySQL-Installer für die jeweilige Plattform herunterladen.
  2. Die Installation starten und den benutzerdefinierten Installationspfad auswählen.
  3. Den gesamten Installationsvorgang durchklicken und auf Fertigstellen klicken.
  4. Anschließend erscheint der MySQL Server Instance Configuration Wizard.
    1. Sicherstellen, dass die Standard Configuration ausgewählt ist, und auf Weiter klicken.
    2. Falls MySQL bereits installiert ist, kann die Meldung A Windows service with the name MySQL already exists. Please uninstall this service correctly or choose a different name for the new service. erscheinen. In diesem Fall einen alternativen Dienstnamen wählen.
    3. Im nächsten Fenster Include Bin Directory in Windows PATH aktivieren. Dadurch wird der Zugriff auf die verschiedenen MySQL-Werkzeuge über die Kommandozeile ermöglicht.
    4. Im nächsten Fenster kann ein Passwort für den root-MySQL-Benutzer festgelegt werden, den Benutzer mit den höchsten Zugriffsrechten auf dem Server.
    5. Im letzten Fenster werden alle bisher vorgenommenen Einstellungen gespeichert, sobald die Schaltfläche Execute gedrückt wird, und der Windows-Dienst für diese Instanz wird gestartet.

Notizen

  1. Um die Anleitung möglichst zugänglich zu halten, wurden einige Konfigurationsszenarien der MySQL-Instanz übersprungen, etwa die Möglichkeit, die Datenbankdateien an einen anderen Ort zu verschieben.
  2. MySQL wird standardmäßig mit einem STRICT-Modus installiert, der bei Erweiterungen oder Anwendungen, die dies nicht berücksichtigen, zu Fehlern führen kann.

MySQL-Ressourcen

  • HeidiSQL Ein benutzerfreundlicher und erweiterbarer Vollclient-Ersatz für phpMyAdmin, der sich in ständiger Weiterentwicklung befindet.
  • MySQL Workbench Verschiedene Werkzeuge, darunter der Administrator, der bei der Konfiguration der MySQL-Instanz hilft. Erfordert das .Net-Framework.
  • phpMyAdmin Ein leistungsstarker webbasierter MySQL-Client zur Verwaltung aller mit MySQL zusammenhängenden Aufgaben.
  • MySQL-Dokumentation

Apache-Einrichtung

  1. Installationsprogramm Ihrer Wahl herunterladen.
  2. Installationsassistenten ausführen und sich durch die einzelnen Schritte klicken, bis das Fenster „Server Information“ erreicht ist. Sofern keine besonderen Anforderungen an die Konfiguration des Webservers bestehen, die folgenden Optionen jeweils in der angegebenen Reihenfolge in die Felder eintragen:
    1. localhost,
    2. localhost und
    3. admin@localhost
  3. Durch den Assistenten klicken, der den Apache-Webserver installiert und als Windows-Dienst startet.
  4. In der Windows-Statusleiste erscheint nun eine rosafarbene Feder mit einem grünen Play-Symbol, das anzeigt, dass Apache läuft. Den Browser auf http://localhost/ richten – es sollte eine Seite erscheinen, die bestätigt, dass alles funktioniert.
  5. Nun zum Installationsort von Apache navigieren, der sich üblicherweise unter C:\Program Files\Apache Software Foundation\Apache2.2 befindet, und die verschiedenen Verzeichnisse durchgehen
    1. bin – enthält die verschiedenen Binärdateien, von denen einige unten aufgelistet sind. Um auf diese Anwendungen zuzugreifen, von denen die meisten befehlszeilenbasiert sind, muss der Pfad zum bin-Verzeichnis zur globalen PATH-Variable hinzugefügt werden. Dazu mit der rechten Maustaste auf „Arbeitsplatz“ klicken > Eigenschaften > Erweitert > Umgebungsvariablen und in der Liste der Systemvariablen die Variable PATH suchen und auswählen, auf Bearbeiten klicken und, falls noch nicht vorhanden, ein Semikolon am Ende sowie den absoluten Pfad zum bin-Verzeichnis hinzufügen. Den Dialog „Systemeigenschaften“ durch Bestätigen schließen.
      1. httpd.exe ist der Apache-Webserver selbst, der mehrere Kindprozesse erzeugt, um so viele gleichzeitige eingehende Client-Anfragen zu bedienen, wie es die Direktive MaxClients erlaubt;
      2. ab.exe ist ein mit Apache mitgeliefertes Benchmarking-Tool, mit dem sich die Leistungsfähigkeit der Anwendung pro Zeiteinheit messen lässt
    2. conf – Verzeichnis, in dem sich verschiedene Konfigurationsdateien befinden, von denen die folgenden für unsere Zwecke am wichtigsten sind
      1. httpd.conf – die meisten Serverdirektiven befinden sich in dieser Datei; für einen bequemeren Zugriff sollte der Dateityp .conf mit einem benutzerfreundlichen Editor verknüpft werden, also mit etwas anderem als dem Standard-Editor „Notepad“.
      2. extra\httpd-vhosts.conf – enthält Direktiven, mit denen der lokale Server als virtueller Host genutzt werden kann, d. h. es können mehrere Server auf demselben PC betrieben werden. Ein Anwendungsfall ist zum Beispiel, während der Entwicklungsphase die tatsächliche Domain, an der man arbeitet, auf die lokale Kopie abzubilden, was durch kleine Anpassungen in dieser Datei möglich ist. Dies wird weiter unten ausführlicher behandelt.
    3. htdocs – das Standard-Stammverzeichnis des Webservers; hierauf wird http://localhost/ abgebildet, sofern dies nicht in der oben genannten httpd.conf geändert wurde.
    4. logs – Zugriffs- und Fehlerprotokolle, hilfreich bei der Fehlersuche im Zusammenhang mit dem Server oder der Anwendung

Apache-Ressourcen

PHP-Einrichtung

  1. PHP herunterladen und üblicherweise VC6 x86 Thread Safe im Zip-Format wählen. Die verschiedenen Optionen betreffen die Art und Weise, wie die PHP-Codebasis zu Binärcode kompiliert wurde, und sind vorerst nicht weiter von Bedeutung.
  2. Unter C:\Program Files\ (oder wo sich das Programmverzeichnis befindet) ein Verzeichnis mit dem Namen PHP anlegen.
  3. Die heruntergeladene Zip-Datei suchen, in das neu erstellte Verzeichnis verschieben und dort direkt entpacken.
  4. Nun den PHP-Pfad entsprechend der obigen Anleitung zur globalen PATH-Variable hinzufügen.

Konfigurieren von PHP

Die Konfiguration erfolgt durch Bearbeiten der Datei php.ini. Eine Beispieldatei für verschiedene Szenarien befindet sich bereits im PHP-Verzeichnis. Nun php.ini-development in php.ini umbenennen und in einem bevorzugten Texteditor öffnen. Die üblicherweise anzupassenden Werte sind im Folgenden aufgeführt, und all diese Variablen sind in der Datei php.ini gut dokumentiert. (Zu beachten ist, dass dies eine serverweite Einstellung ist, die für alle Projekte gilt.):

  • max_execution_time – relevant, wenn Skripte zu lange laufen und der Server verschiedene unerwartete Ergebnisse zurückgibt, die vermutlich darauf zurückzuführen sind, dass der gesamte Prozess nicht durchlaufen werden konnte

  • memory_limit

  • error_reporting

  • display_errors

  • log_errors – eine Variable, die in Produktivumgebungen beachtet werden sollte

  • upload_tmp_dir

  • upload_max_filesize

  • extension_dir' – um Komplikationen zu vermeiden, wird das Verzeichnis, in dem sich die folgenden Erweiterungen befinden, angegeben, indem diese Variable einkommentiert und der absolute Pfad des Verzeichnisses zugewiesen wird. Die vollständige Zeile sollte wie folgt lauten extension_dir = "C:\Program Files\PHP\ext"

  • Der Abschnitt der dynamischen Erweiterungen enthält verschiedene zusätzliche Module, die geladen werden sollen; die auskommentierten sind diejenigen, die bereits mit PHP mitgeliefert werden und sich im Verzeichnis ext im PHP-Verzeichnis befinden. Um eine davon zu aktivieren, einfach die Kommentierung entfernen, wie bei den folgenden Erweiterungen:

    • php_curl.dll
    • php_gd2.dll
    • php_mbstring.dll
    • php_mysql.dll
    • php_mysqli.dll
    • php_pdo.dll
    • php_pdo_mysql.dll
    • php_xsl.dll

  • session.save_path

Konfigurieren von Apache für die Zusammenarbeit mit PHP

Nachdem PHP nun wie gewünscht konfiguriert wurde, wird nun Apache entsprechend eingerichtet.

  • httpd.conf öffnen und im Abschnitt „Dynamic Shared Object (DSO) Support“ folgende Direktiven hinzufügen. (Falls das PHP-Verzeichnis an anderer Stelle liegt, die folgende Zeile für php5apache2_2.dll entsprechend anpassen.): LoadModule php5_module "C:/Program Files/PHP/php5apache2_2.dll" AddType application/x-httpd-php .php

  • In der DirectoryIndex-Zeile index.php und index.htm als mögliche Dateien hinzufügen, die beim Aufruf eines Verzeichnisses ausgeliefert werden sollen, wie folgt: DirectoryIndex index.html index.htm index.php

  • Am Ende der Datei folgende Zeile hinzufügen, die angibt, wo sich die Datei php.ini befindet: PHPIniDir "C:/Program Files/PHP"

Neustart und Test von PHP

Sobald Änderungen an php.ini, httpd.conf oder anderen Konfigurationsdateien vorgenommen werden, muss Apache neu gestartet werden, damit die Änderungen wirksam werden. Apache wird nun mit dem Apache-Monitor-Tool neu gestartet, das in der Windows-Statusleiste zu finden ist. Im Idealfall erscheinen keine Dialogfenster, und der Apache-Monitor bleibt grün.

Nun wird geprüft, ob PHP korrekt funktioniert. Zum Dokumenten-Stammverzeichnis des Webservers wechseln (im Standardfall C:\Program Files\Apache Software Foundation\Apache2.2\htdocs) und eine Datei namens phpinfo.php mit folgendem Inhalt hinzufügen:

Dies erzeugt eine Seite mit Informationen über die PHP-Einrichtung und über die verschiedenen, aktuell geladenen Module/Erweiterungen. Browser auf <a href="http://localhost/phpinfo.php"

rel="nofollow noreferrer noopener">http://localhost/phpinfo.php richten.

Installieren und Konfigurieren von xdebug

  1. Browser auf Xdebug Installation Wizard richten. Diese Seite hilft dabei, eine passende Xdebug-Version zu finden.
  2. Die gesamte oben erzeugte phpinfo-Seite kopieren, in das Textfeld einfügen und den angegebenen Anweisungen zur Installation folgen.

XDebug-Ressourcen

  • Das PHP-Handbuch – Ausgezeichnete und aktuelle Dokumentation mit wertvollen zusätzlichen Kommentaren von Nutzern. Herunterladbare Versionen sind verfügbar.
  • Die Xdebug-3-Dokumentation