Wie Sie Fehler in der Programmierung selbst finden, verrät Kapitel 38,»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 38,»Fehlersuche und Debugging«. 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 Bild 3.1 zeigt eine der häufigsten Fehlermeldungen zumindest wenn Sie den Microsoft Internet Explorer unter Windows einsetzen. Dieser ist nämlich ganz besonders»schlau«und will seine Anwender nicht durch allzu viele technische Details erschrecken. 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. 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 verwenden Sie am besten gleich einen anderen Webbrowser. 2 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. 2 In der professionellen Webentwicklung ist es sowieso unumgänglich, auf mehreren Webbrowsern zu testen. ( KOMPENDIUM ) PHP

3 Kapitel 3 Test und Hilfe Abbildung 3.1: Die Seite kann nicht angezeigt werden Abbildung 3.2: Die»hübschen«Fehlermeldungen können hier ausgeschaltet werden 88 ( KOMPENDIUM ) PHP 5.1

4 Häufige Fehler Kapitel 3 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 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... 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 System, prüfen Sie, ob ein Router, eine Firewall oder ein Virenscanner den Verbindungsaufbau blockiert. Bei einem lokalen System lohnt sich ein Blick in die Proxy- Einstellungen des Webbrowsers. 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 Zwischenglied 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 Adressen 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 Bild 3.5 finden Sie den Hinweis, dass die Moduloptionen nicht zusammenpassen. Das liegt entweder an unterschiedlichen Kompilierungsoptionen (beispielsweise Debug ja/nein), meist jedoch an unterschiedlichen PHP-Versionen. Eine PHP-Erweiterung ist meist mehrere PHP-Unterversionen lang gültig, da sich am Sprachkern von PHP nichts ( KOMPENDIUM ) PHP

5 Kapitel 3 Test und Hilfe Abbildung 3.4: Das teilweise Deaktivieren funktioniert auch im Firefox 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ärdistribution, 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 90 ( KOMPENDIUM ) PHP 5.1

6 Häufige Fehler Kapitel 3 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 folgenden 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 separat verfügbaren PECL-Paket enthalten ist. Ist der Pfad zu den Erweiterungen in der php.ini korrekt gesetzt: (Schalter 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 23 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. 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 von bei diesen oder anderen Zugriffsproblemen sehr nützliche Dienste leisten, da es anzeigt, auf welche Dateien gerade von welchen Prozessen zugegriffen wird. In Bild 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). ( KOMPENDIUM ) PHP

7 Kapitel 3 Test und Hilfe 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. 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 (vergleiche Kapitel 2: bei Apache in der Datei httpd.conf, beim IIS in der Management-Konsole). Abbildung 3.8: Der Webbrowser will das Skript abspeichern 92 ( KOMPENDIUM ) PHP 5.1

8 Häufige Fehler Kapitel 3 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 wieder finden. 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. Abbildung 3.9: Die PHP-Datei test.php existiert nicht 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. Eine zweite Variante von»datei nicht gefunden«sehen Sie in Bild 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 ( KOMPENDIUM ) PHP

9 Kapitel 3 Test und Hilfe Abbildung 3.10: HTTP-Fehler 400 deutet auf eine falsche Konfiguration hin 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. Manchmal 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-Version 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) 94 ( KOMPENDIUM ) PHP 5.1

10 Häufige Fehler Kapitel 3 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. Abbildung 3.12: Nicht gerade aussagekräftig: ein»internal Server Error«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 Abbildung 3.13: Noch nicht stabile Pakete können mit einem Schalter und dem Status installiert werden ( KOMPENDIUM ) PHP

11 Kapitel 3 Test und Hilfe 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. 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önnen 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 Mailingliste 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-Formatierungen. Dann werden Sie in der Regel sehr schnell Hilfe finden. Abbildung 3.14: Sie können sich im Browser für die Newsgroups anmelden 96 ( KOMPENDIUM ) PHP 5.1

12 Hilfsquellen Kapitel 3 Außerdem gibt es eine Reihe auch von deutschsprachigen Portalen rund um PHP. Wir favorisieren es gibt aber unter anderem auch und Abbildung 3.15: Das PHP-Portal DynamicWeb Pages.de ( KOMPENDIUM ) PHP