Test und Hilfe KAPITEL. Wie Sie Fehler in der Programmierung selbst finden, verrät Kapitel 40,»Fehlersuche und Debugging«.

Transkript

1

2 3 Test und Hilfe Den berühmtesten PHP-Test kennen Sie schon: phpinfo(). In diesem Kapitel haben wir Informationen gesammelt, die Ihnen darüber hinaus bei Installation und Betrieb von PHP weiterhelfen. Das Unterkapitel»Häufige Fehler«sammelt einige Probleme, auf die wir in Schulungen, Projekten und in unserer täglichen Arbeit gestoßen sind,»hilfsquellen«verrät Ihnen, wo Sie im Internet Hilfe finden. Der Fokus liegt auf Problemen direkt nach der Installation: Woran kann es gehapert haben, welche Schritte wurden möglicherweise vergessen? Wie Sie Fehler in der Programmierung selbst finden, verrät Kapitel 40,»Fehlersuche und Debugging«. KAPITEL

3 Kapitel 3 Test und Hilfe 3.1 Häufige Fehler Eine Zusammenstellung häufiger Fehler ist natürlich gerade im Rahmen einer Installation nie umfassend. Wenn Ihre Fehlermeldung oder Ihr Problem hier also nicht dabei ist, werfen Sie doch einen Blick in die»hilfsquellen«oder suchen Sie im Netz. Einige häufige Probleme hoffen wir aber hier abfangen zu können Die Seite kann nicht angezeigt werden Abbildung 3.1 zeigt eine der häufigsten Fehlermeldungen zumindest wenn Sie den Micro soft Internet Explorer unter Windows einsetzen. Dieser ist nämlich ganz besonders»schlau«und will seine Anwender nicht durch allzu viele technische Details erschre cken. Bei vielen Fehlertypen gibt der Browser die abgedruckte Meldung aus. Zum Beispiel, wenn der Server nicht gefunden wurde, das Netzwerk- oder Modemkabel nicht steckt, ein Fehler auf der Seite aufgetreten ist, manchmal sogar bei Vollmond. Um es kurz zu machen: Die Fehlermeldung ist alles andere als aussagekräftig. 1 Abbildung 3.1: Die Seite kann nicht angezeigt werden 1 Beherzigen Sie das auch, wenn Sie uns eine Frage schicken: Mit»Die Seite kann nicht angezeigt werden«können wir leider beim besten Willen nichts anfangen. 96

4 Häufige Fehler Der Internet Explorer versteckt in seinem Usability-Bemühen die wahre Fehlermeldung vor dem Benutzer, was diesem möglicherweise etwas bringt, nicht jedoch dem Fehler suchenden Entwickler. Sie sollten also zumindest auf dem Testsystem diese schönen Fehlermeldungen abschalten, indem Sie die Option Extras/Internetoptionen/ Erweitert Kurze HTTP-Fehlermeldungen anzeigen deaktivieren. Oder verwen den Sie am besten gleich einen anderen Webbrowser. 2 Abbildung 3.2: Die»hübschen«Fehlermeldungen können hier ausge schaltet werden Und noch eine hübsche Eigenheit des Internet Explorers: Wenn Sie Ihren Webserver so konfiguriert haben, dass er nicht über Port 80 läuft, hat Ihre Homepage einen URL der Art localhost:8080/. Das klappt natürlich im Internet Explorer, aber nur, wenn Sie explizit angeben. Tippen Sie dagegen ins Adressfeld nur localhost:8080 ein, findet der Internet Explorer den Server nicht. Das klingt lustig, ist es aber leider nicht... HINWEIS Server nicht gefunden Wenn der Webbrowser meldet, der Server wäre nicht gefunden worden, oder die Verbindung scheitert, kommt Ihre Anfrage entweder nicht zum Webserver durch oder dessen Antwort nicht zurück. Liegt der Webserver nicht auf dem lokalen Sys tem, prüfen Sie, ob ein Router, eine Firewall oder ein Virenscanner den Verbin dungsaufbau blockiert. Bei einem lokalen System lohnt sich ein Blick in die Proxy-Einstellungen des Webbrowsers. 2 In der professionellen Webentwicklung ist es sowieso unumgänglich, auf mehreren Webbrowsern zu tes ten. 97

5 Kapitel 3 Test und Hilfe Ein Proxy-Server ist ein Rechner im Internet, über den Ihr kompletter Webverkehr läuft (sofern Sie einen Server eingestellt haben). Ihren lokalen Webserver jedoch müssen (und können) Sie nicht über dieses Zwi schenglied abfragen. Werfen Sie also einen Blick in Ihre Proxy-Einstellungen und schalten Sie gegebenenfalls den Zwischenrechner für lokale Verbindungen aus. Beim Internet Explorer finden Sie die Option unter Extras/ Internetoptionen/Verbin dungen/einstellungen, Netscape-Nutzer greifen zu Bearbeiten/Einstellungen/Erweitert/Proxies, bei Firefox hilft Extras/Einstellungen/Allgemein/Verbin dungs- Einstellungen. Abbildung 3.3: Kein Proxy-Server bei lokalen Adres sen Abbildung 3.4: Das teilweise Deak tivieren funktioniert auch im Firefox 98

6 Häufige Fehler Unable to initialize module Erscheint im Fehler-Log oder gar als Popup auf dem Rechner eine Meldung, ein Modul konnte nicht initialisiert werden, besteht irgendein Problem mit einer der Erweiterungen von PHP. Meist steht die Lösung auch gleich da: In Abbildung 3.5 finden Sie den Hinweis, dass die Moduloptionen nicht zusammenpassen. Das liegt entwe der an unterschiedlichen Kompilierungsoptionen (beispielsweise Debug ja/nein), oft jedoch an unterschiedlichen PHP-Versionen. Eine PHP-Erweiterung ist meist mehrere PHP- Unterversionen lang gültig, da sich am Sprachkern von PHP nichts Entscheidendes ändert. Sobald das jedoch passiert, beschwert sich PHP. Der Fehler tritt häufig auf, wenn Sie eine neuere Version von PHP installieren und dabei einige Erweiterungen nicht neu kompilieren (oder, bei der Verwendung einer Binärdistribu tion, nicht die neue Modulversion über die alte kopieren). Sehen Sie auch in anderen Verzeichnissen nach (bei Windows etwa im Windows- und im System-Verzeichnis), ob dort nicht noch eine ältere Version vorhanden ist. Abbildung 3.5: Falsche API-Version deutet auf ein zu altes Modul hin 99

7 Kapitel 3 Test und Hilfe Modul nicht gefunden Der PHP-Interpreter liefert gleich beim ersten Aufruf eine Fehlermeldung, dass ein Modul nicht geladen werden kann; dieses Modul hatten Sie aber vorher in der php.ini bei extensions auskommentiert oder eingetragen. Hier müssen Sie die fol genden Dinge der Reihe nach durchprüfen: Existiert das Modul oder die Erweiterung im Ordner extensions (PHP 4) bzw. ext (PHP 5)? In PHP 5 kann es beispielsweise sein, dass das Modul nur im sepa rat verfügbaren PECL-Paket enthalten ist. Ist der Pfad zu den Erweiterungen in der php.ini korrekt gesetzt: (Direktive extension_dir)? Abbildung 3.6: Ein Modul kann nicht gefunden (oder geladen?) werden In Bild 3.6 sehen Sie die Meldung, dass eine Erweiterung (übrigens die zur Ansteuerung von Oracle-Datenbanken, die Sie in Kapitel 25 kennen lernen werden) nicht gefunden werden konnte. Sie stellen aber fest, dass die Datei in der Tat existiert. Dann gibt es zwei Möglichkeiten: Der PHP-Interpreter oder der Webserver hat keine Zugriffsrechte auf die Erweiterungsdatei. Die Erweiterung besitzt Abhängigkeiten, beispielsweise weitere Bibliotheken. 100

8 Häufige Fehler Im Beispiel ist der zweite Punkt der Fall: Die Oracle-Bibliothek von PHP benötigt die Clientbibliotheken von Oracle, um funktionieren zu können. Sofern Sie Windows einsetzen, kann ein Programm wie FILE MONITOR oder der mittlerweile etablierte Nachfolger PROCESS MONITOR von (mittlerweile von Microsoft aufgekauft, aber immer noch gratis) bei diesen oder anderen Zugriffsproblemen sehr nützliche Dienste leisten, da es anzeigt, auf welche Dateien gerade von welchen Prozessen zugegriffen wird. In Abbildung 3.7 sehen Sie die Ausgabe des Tools neben jeder Datei steht auch, ob der Zugriff geklappt hat (SUCCESS) oder ob ein Fehler auftrat (z. B. FILE NOT FOUND, PERMISSION DENIED). Abbildung 3.7: PHP sucht eine Datei OCI.dll, findet sie aber nicht Das Tool bietet die Möglichkeit, zu filtern. Geben Sie als Filter php an, werden nur Zugriffe angezeigt, die vom PHP-Prozess kommen, ansonsten wird die Liste schnell sehr unübersichtlich. TIPP Der Browser öffnet ein Download-Fenster Wenn der Webbrowser nicht das gewünschte PHP-Skript ausführt und Ihnen das Ergebnis anzeigt, sondern sich ein Download-Fenster öffnet, hat der Webserver den PHP- Interpreter übergangen und schickt Ihnen den Quellcode des Skripts frei Haus (das sehen Sie, wenn Sie das Ergebnis auf der Festplatte abspeichern und in einem Texteditor öffnen). Hier ist bei der Installation etwas schief gegangen, überprüfen Sie noch einmal alle Schritte. Unter Umständen haben Sie PHP mit der falschen Dateiendung verknüpft (vgl. Kapitel 2: bei Apache in der Datei httpd.conf, beim IIS in der Management-Konsole). 101

9 Kapitel 3 Test und Hilfe Abbildung 3.8: Der Webbrowser will das Skript abspeichern Ein ähnlich gelagerter Fall ist es, wenn Sie im Webbrowser nur Teile des Skripts sehen, der PHP-Code aber offenbar nicht ausgeführt worden ist. Werfen Sie einen Blick auf den HTML-Quellcode, Sie werden mit hoher Wahrscheinlichkeit auch Ihren PHP- Code dort wiederfinden. Die Ursache: Vermutlich haben Sie die Adresse nicht mit dem Testwebserver, sondern lokal aufgerufen. Sie benötigen immer ein (bzw. Rechnername oder IP), da PHP nur interpretiert werden kann, wenn es über den Webserver läuft No input file specified (oder so ähnlich) Sie linken einfach auf eine Datei, die nicht vorhanden ist. Diese Fehlermeldung ist nicht die 404 des Webservers, sondern die Meldung des PHP-Interpreters, die der Webserver stattdessen zurückliefert. Dies macht nicht jeder Webserver in der Standardinstallation. Sie können allerdings auch die Webserver, die es tun, zwingen, zu prüfen, ob die aufgerufene Skriptdatei auch existiert. In diesem Fall wird dann eine 404-Meldung angezeigt. Hier ist der IIS dafür verantwortlich. Sie ändern sein Verhalten in der IIS-Konsole unter Website/Eigenschaften/Basisverzeichnis/Konfiguration und dort bei der Endung.php (oder Ihrer PHP- Dateiendung). Klicken Sie einfach Prüfen, ob Datei existiert an. 102

10 Häufige Fehler Abbildung 3.9: Die PHP-Datei test.php existiert nicht Eine zweite Variante von»datei nicht gefunden«sehen Sie in Abbildung Der Webserver meldet»seite nicht gefunden«, Sie sind sich aber sicher, dass Sie keinen Tippfehler gemacht haben. Etwas weiter unten in der Fehlermeldung sehen Sie die eigentliche Ursache: HTTP 400 ungültige Anforderung. Das ist ein Fehler, der spezifisch beim Microsoft-Server IIS auftaucht, wenn Sie vergessen haben, in der php.ini die folgende Anweisung zu tätigen: cgi.force_redirect = 0 Abbildung 3.10: HTTP-Fehler 400 deutet auf eine falsche Konfiguration hin 103

11 Kapitel 3 Test und Hilfe Call to undefined function Diese Fehlermeldung hat eigentlich bei Hilfen rund um die Installation wenig zu suchen, da sich dahinter meist ein Tippfehler im Funktionsnamen verbirgt. Manch mal kann es aber auch bedeuten, dass Sie das Modul noch nicht installiert haben. In diesem Buch finden Sie immer im Abschnitt»Vorbereitungen«eine Beschreibung der Installation der Module. Was ebenfalls passieren kann, ist, dass sich die API, das heißt die Funktionsnamen des Moduls, geändert haben. Prüfen Sie also auf jeden Fall, mit welcher PHP-Ver sion Sie gerade arbeiten. Die Online-Hilfe gibt bei vielen Funktionen Auskunft darü ber, in welcher Version sie aktuell waren. Abbildung 3.11: php_info() gibt es nicht (phpinfo() schon) Internal Server Error Die gemeinste Fehlermeldung ist der»internal Server Error«oder der HTTP-Fehlercode 500. Das bedeutet, dass bei der Skriptausführung ein Fehler aufgetreten ist, dessen Fehlertext aber nicht an den Webbrowser übermittelt worden ist. Hier hilft nur ein Blick in das Fehler-Log des Systems, beispielsweise die Datei error.log bei Apache PEAR-Paket noch nicht stabil Manche PEAR-Pakete können Sie nicht nur mit dem Namen installieren, weil sie noch nicht als stabil eingetragen sind. Sie erhalten die Fehlermeldung»No release with state equal to:,stable found for,packagename «. In diesem Fall müssen Sie bei der Installation den gesamten Namen des Pakets inklusive Versionsnummer angeben oder Sie schreiben hinter das Paket den Status, z. B. -alpha oder -beta. pear install UDDI-alpha 104

12 Häufige Fehler Abbildung 3.12: Nicht gerade aussagekräftig: ein»internal Server Error«Alternativ können Sie auch PEAR so konfigurieren, dass ein bestimmter Status als Standard angenommen wird: pear config-set preferred_state alpha Anschließend lässt sich jedes Paket im Alpha-Status mit dem Paketnamen allein installieren. Abbildung 3.13: Noch nicht stabile Pakete können mit einem Schalter und dem Status installiert werden 105

13 Kapitel 3 Test und Hilfe 3.2 Hilfsquellen Hilfsquellen zu PHP gibt es viele wenn Sie gut Englisch können, umso mehr. Unter finden Sie eine Übersicht über alle möglichen Quellen inklusive des Online-Handbuchs ( und einer Reihe von Mailinglisten ( Bei letzterem URL kön nen Sie sich sogar via Webbrowser zur Teilnahme anmelden. Sie erhalten dann eine Bestätigungsmail, die Sie kurz beantworten müssen. Dann sind Sie für die Mailing liste freigeschaltet (eine Maßnahme zum Spam-Schutz). Denken Sie aber daran, dass Mailinglisten vom Geben und Nehmen aller Teilnehmer leben. Und denken Sie an die üblichen Höflichkeitsregeln im Mailverkehr: freundlich und sachlich bleiben, bei Problemen immer minimalisierte Listings angeben (und nicht 100 Zeilen Code, von denen nur eine Zeile Ärger macht), keine Dateien anhängen, keine HTML-Formatie rungen. Dann werden Sie in der Regel sehr schnell Hilfe finden. Abbildung 3.14: Sie können sich im Browser für die Newsgroups anmelden Außerdem gibt es auch eine Reihe von deutschsprachigen Portalen rund um PHP. Wir favorisieren es gibt aber unter anderem auch und 106

14 Hilfsquellen Abbildung 3.15: Das PHP-Portal DynamicWebPages.de 107