Die Entwicklung von Software ist ein komplexer Prozess, der ohne das Debuggen von Code nicht auskommt. Eines der beliebtesten und benutzerfreundlichsten Tools zum Debuggen von PHP-Anwendungen ist xdebug. Es ermöglicht Ihnen, schrittweise Codeausführung durchzuführen, Variablenwerte zu überwachen und die Anwendungsleistung zu analysieren. In diesem Artikel erfahren Sie, wie Sie xdebug auf dem Server installieren und konfigurieren.
Schritt 1: Installieren von xdebug
Der erste Schritt ist, xdebug zu installieren. Gehen Sie dazu auf die offizielle xdebug-Website und wählen Sie die entsprechende Version für Ihr Betriebssystem und die PHP-Version aus. Normalerweise besteht die Einstellung darin, der PHP-Konfigurationsdatei (php) eine Zeile hinzuzufügen.ini) mit dem Pfad zum Modul xdebug.so für Linux oder xdebug.dll für Windows.
Schritt 2: Konfigurieren der Xdebug-Konfiguration
Nach der Installation von xdebug müssen Sie seine Parameter in der PHP-Konfigurationsdatei konfigurieren. Öffnen Sie die PHP-Datei.ini und fügen Sie die folgenden Codezeilen hinzu:
Schritt 3: Starten Sie den Webserver neu
Nachdem Sie Änderungen an der PHP-Konfigurationsdatei vorgenommen haben, müssen Sie den Webserver neu starten, damit die Änderungen wirksam werden. Auf Linux-Systemen kann dies mit einem Befehl ausgeführt werden sudo systemctl restart apache2 oder sudo systemctl restart nginx. Unter Windows können Sie die Dienststeuerungsleiste oder den Befehl verwenden net stop iisadmin & net start w3svc.
Schritt 4: Überprüfen der Integrität von xdebug
Nach dem Neustart des Servers können Sie die Integrität von xdebug überprüfen. Erstellen Sie dazu eine phpinfo-Datei.php mit dem Inhalt und platzieren Sie ihn im Stammverzeichnis des Webservers. Öffnen Sie dann diese Datei in einem Browser und suchen Sie nach dem Block mit den Informationen über xdebug. Wenn xdebug erfolgreich installiert und konfiguriert wurde, ist der Informationsblock vorhanden.
Nachdem Sie alle diese Schritte ausgeführt haben, ist xdebug einsatzbereit. Sie können Ihren Code bearbeiten, Haltepunkte festlegen und seine Ausführung mit Debugging-Tools wie PhpStorm oder Xdebug Helper für den Browser verfolgen. Die Installation und Konfiguration von xdebug auf dem Server macht die Entwicklung von PHP-Anwendungen viel bequemer und effizienter.
Vorbereiten des Servers
Bevor Sie xdebug auf dem Server installieren und konfigurieren können, müssen Sie einige vorbereitende Schritte zur Vorbereitung ausführen. Diese Schritte umfassen die Installation und Konfiguration der erforderlichen Software.
1. Installieren von PHP und seinen Abhängigkeiten.
Stellen Sie sicher, dass PHP auf Ihrem Server installiert ist. Wenn es nicht vorhanden ist, installieren Sie es gemäß den Anweisungen für Ihr Betriebssystem. Es ist wichtig sicherzustellen, dass PHP mit Unterstützung für Debugging-Funktionen wie gdb installiert ist.
2. Installieren Sie Xdebug.
Installieren Sie nun Xdebug, eine PHP-Erweiterung zum Debuggen. Führen Sie dazu die folgenden Schritte aus:
Schritt 1: Finden Sie heraus, welche Version von PHP auf Ihrem Server installiert ist. Sie können dies tun, indem Sie den Befehl php -v an der Eingabeaufforderung ausführen.
Schritt 2: Besuchen Sie die offizielle Xdebug-Website (https://xdebug.org ) und suchen Sie auf der Download-Seite nach der entsprechenden Xdebug-Version für Ihre installierte PHP-Version.
Schritt 3: Laden Sie das Archiv von Xdebug herunter.
Schritt 4: Entpacken Sie das Archiv mit Xdebug und navigieren Sie zu dem Verzeichnis, das die entpackten Dateien enthält.
Schritt 5: Wechseln Sie an der Eingabeaufforderung zum Verzeichnis mit Xdebug, und führen Sie den folgenden Befehl aus, um Xdebug zu kompilieren:
Schritt 6: Führen Sie nach der erfolgreichen Kompilierung von Xdebug den folgenden Befehl aus, um die Installation durchzuführen:
Schritt 7: Führen Sie dann den Befehl make aus.
Schritt 8: Führen Sie schließlich den Befehl sudo make install aus, um Xdebug auf Ihrem Server zu installieren.
3. Konfigurieren Sie PHP für die Verwendung von Xdebug.
Sobald Xdebug erfolgreich installiert wurde, müssen Sie PHP so konfigurieren, dass es verwendet wird. Führen Sie dazu die folgenden Schritte aus:
Schritt 1: Öffnen Sie die PHP-Konfigurationsdatei.
Schritt 2: Suchen Sie nach einer Zeile, die mit zend_extension beginnt.
Schritt 3: Fügen Sie die folgende Zeile nach der Zeile zend_extension hinzu :
Schritt 4: Speichern und schließen Sie die PHP-Konfigurationsdatei.
Ihr Server ist jetzt bereit, Xdebug zu verwenden. Sie können Xdebug weiterhin an Ihre Bedürfnisse und Anforderungen anpassen, um PHP-Skripts zu debuggen.
Xdebug herunterladen und installieren
Schritt 1: Überprüfen Sie, ob xdebug bereits auf dem Server installiert ist. Führen Sie den Befehl php -m | grep xdebug im Terminal aus. Wenn Sie als Ergebnis "xdebug" sehen, ist xdebug bereits installiert und Sie müssen diesen Schritt nicht ausführen.
Schritt 2: Wenn xdebug nicht installiert ist, laden Sie es von der offiziellen Website herunter xdebug.org . Suchen Sie den Abschnitt "Download" und wählen Sie die entsprechende Xdebug-Version für Ihre PHP-Installation aus.
Schritt 3: Entpacken Sie das heruntergeladene xdebug-Archiv.
Schritt 4: Wechseln Sie zum entpackten xdebug-Ordner und führen Sie den folgenden Befehl im Terminal aus:
Hinweis: Stellen Sie sicher, dass Sie die PHP Development Tools (php-devel oder ähnliches Paket) installiert haben, damit der Befehl phpize funktioniert.
Schritt 5: Führen Sie nach dem Ausführen des Befehls phpize den folgenden Befehl aus:
Schritt 6: Führen Sie nach Abschluss der Konfiguration den folgenden Befehl aus:
Schritt 7: Führen Sie nach dem Ausführen des make-Befehls den folgenden Befehl aus:
sudo make install
Hinweis: Für diesen Befehl sind möglicherweise Administratorrechte erforderlich.
Konfigurieren der Konfigurationsdatei
1. Öffnen Sie die PHP-Datei.ini auf dem Server. Normalerweise befindet es sich im Verzeichnis /etc/php/.
2. Suchen und auskommentieren (entfernen Sie das ";" -Zeichen) die folgende Zeile:
- zend_extension=/path/to/xdebug.so
Geben Sie anstelle von "/path/to/xdebug.so" den Pfad zur Datei an xdebug.so auf Ihrem Server.
3. Fügen Sie am Ende der Datei die folgenden Einstellungen hinzu:
- zend_extension=xdebug.so
- xdebug.remote_enable=1
- xdebug.remote_autostart=1
- xdebug.remote_host=127.0.0.1
- xdebug.remote_port=9000
Die Einstellungen umfassen Xdebug-Unterstützung, geben an, dass xdebug mit Remote-Sitzungen arbeiten muss, legen den Host und den Port für die Verbindung fest.
4. Speichern Sie die Änderungen, und starten Sie den Webserver neu, damit die Änderungen wirksam werden.
Verbinden von xdebug mit der IDE
Damit Sie xdebug zum Debuggen auf Ihrem Server verwenden können, müssen Sie Ihre Entwicklungsumgebung (IDE) für die Interaktion mit xdebug konfigurieren.
Die für die Verbindung von xdebug mit Ihrer IDE erforderlichen Vorgänge können je nach verwendeter Entwicklungsumgebung erheblich variieren. Hier sind einige beliebte IDEs und Anweisungen, wie Sie sie für die Arbeit mit xdebug konfigurieren können:
- Öffnen Sie die PhpStorm-Einstellungen und suchen Sie den Abschnitt "Languages & Frameworks" und wählen Sie dann "PHP".
- Wählen Sie im Abschnitt "Debug" xdebug als Debug-Treiber aus.
- Geben Sie die Host- und Portinformationen ein, an denen xdebug die Verbindungen abhören soll, und konfigurieren Sie die anderen Parameter nach Belieben.
- Speichern Sie die Einstellungen und starten Sie PhpStorm neu.
2. Visual Studio Code:
- Installieren und aktivieren Sie die PHP Debug-Erweiterung in Visual Studio Code.
- Öffnen Sie die Visual Studio Code-Einstellungen und suchen Sie den Abschnitt "PHP Debug" in den Erweiterungseinstellungen.
- Geben Sie die Host- und Portinformationen ein, an denen xdebug die Verbindungen abhören soll, und konfigurieren Sie die anderen Parameter nach Belieben.
- Speichern Sie die Einstellungen und starten Sie Visual Studio Code neu.
- Öffnen Sie die NetBeans-Einstellungen und wählen Sie den Abschnitt "PHP" aus.
- In der Registerkarte "Debugging" wählen Sie xdebug als Debug-Treiber aus.
- Geben Sie die Host- und Portinformationen ein, an denen xdebug die Verbindungen abhören soll, und konfigurieren Sie die anderen Parameter nach Belieben.
- Speichern Sie die Einstellungen und starten Sie NetBeans neu.
Die Verbindungseinstellungen von xdebug zur IDE können auch Einstellungen für Projektdateipfade und andere erweiterte Einstellungen enthalten. Lesen Sie bei Bedarf die Dokumentation Ihrer IDE oder die ausführlichere Anleitung zum Konfigurieren von xdebug für Ihre Entwicklungsumgebung.
Testen und Debuggen
Nach der erfolgreichen Installation und Konfiguration von Xdebug auf dem Server können Sie mit dem Testen und Debuggen Ihres Codes beginnen. Xdebug bietet verschiedene Tools und Funktionen, mit denen Sie Fehler in Ihrem Programm identifizieren und beheben können.
Zu den wichtigsten Funktionen von Xdebug gehören:
| Funktion | Die Beschreibung |
| Debuggen von Code in Echtzeit | Mit Xdebug können Sie die Codeausführung in einer bestimmten Zeile stoppen und die Ausführung des Codes schrittweise analysieren. Sie können Haltepunkte festlegen, Variablenwerte überprüfen und den Funktionsaufrufstapel beobachten. |
| Fehlerverfolgung | Xdebug verfolgt und gibt automatisch Fehlermeldungen in Ihrem Code aus, damit Sie sie schnell identifizieren und beheben können. |
| Codeprofilerstellung | Mit Xdebug können Sie die Ausführung Ihres Codes profilieren und die Leistung Ihres Codes optimieren. Xdebug sammelt Informationen über die Laufzeit jedes Codeabschnitts, Funktionsaufrufe und die Speichernutzung. |
Um diese Funktionen nutzen zu können, müssen Sie Ihre Entwicklungsumgebung oder IDE für die Verwendung mit Xdebug konfigurieren. Einige der beliebtesten Entwicklungsumgebungen, wie PhpStorm, NetBeans und Eclipse, bieten native Unterstützung für Xdebug.
Nachdem Sie Ihre Entwicklungsumgebung eingerichtet haben, können Sie mit den Xdebug-Funktionen beginnen, um Ihren Code zu testen und zu debuggen. Denken Sie daran, dass die Verwendung von Xdebug Ihr Programm verlangsamen kann, daher sollte es nur während der Entwicklung und des Tests verwendet werden.
