So aktivieren Sie das integrierte Xdebug-Modul von ServBay

Als leistungsstarkes integriertes Webentwicklungstool verfügt ServBay über ein Xdebug-Modul, dessen Aktivierungsprozess sehr einfach ist. Xdebug ist ein Debugging- und Profiler-Tool für PHP, das Entwicklern hilft, Code zu debuggen, Leistungsanalysen durchzuführen und die Codeabdeckung zu überprüfen. Es ist ein unschätzbares Werkzeug für die Entwicklung und Wartung von PHP-Anwendungen.

Einführung in das Xdebug-Modul

Xdebug ist eine leistungsstarke PHP-Erweiterung für das Debugging und die Analyse von PHP-Code. Es bietet eine Vielzahl von Debugging-Funktionen, darunter Breakpoint-Debugging, Stack-Tracking, Variablenüberwachung usw. Darüber hinaus unterstützt Xdebug Leistungsanalyse und Codeabdeckung, um Entwicklern zu helfen, die Codeleistung zu optimieren und die Codequalität sicherzustellen.

Hauptmerkmale

1. Breakpoint-Debugging: Xdebug ermöglicht das Setzen von Breakpoints im Code, um den Code Zeile für Zeile zu debuggen und Fehler leicht zu finden und zu beheben.
2. Stack-Tracking: Bei Auftreten eines Fehlers kann Xdebug detaillierte Stack-Trace-Informationen erzeugen, um Entwicklern bei der schnellen Problemlokalisierung zu helfen.
3. Performance-Analyse: Xdebug bietet Leistungsanalysefunktionen, die detaillierte Performance-Berichte erstellen, um Entwicklern zu helfen, die Codeleistung zu optimieren.
4. Codeabdeckung: Xdebug unterstützt die Codeabdeckung, um sicherzustellen, dass alle Codepfade getestet werden.
5. Unterstützung von integrierten Entwicklungsumgebungen: Xdebug kann in verschiedene integrierte Entwicklungsumgebungen (IDEs) wie PHPStorm, Visual Studio Code usw. integriert werden, um eine komfortable Debugging-Erfahrung zu bieten.

Xdebug-Modulversionen in ServBay

ServBay unterstützt mehrere PHP-Versionen und installiert automatisch das entsprechende Xdebug-Modul für jede Version. Die spezifischen Versionen sind wie folgt:

• PHP 5.6, 7.0, 7.1: Xdebug 2.5.5
• PHP 7.2, 7.3, 7.4: Xdebug 3.1.6
• PHP 8.0, 8.1, 8.2, 8.3: Xdebug 3.3.1
• PHP 8.4: Xdebug 3.4.0-dev

Hinweis

Die Xdebug-Ports jeder PHP-Version sind unabhängig voneinander und mit der Versionsnummer verknüpft, z.B. ist der Xdebug-Port für PHP 7.2 39072, und der Xdebug-Port für PHP 8.3 ist 39083.

So aktivieren Sie das Xdebug-Modul

Standardmäßig ist das Xdebug-Modul deaktiviert. Der Prozess zur Aktivierung des Xdebug-Moduls ist sehr einfach und erfordert lediglich die Änderung der Konfigurationsdatei der entsprechenden PHP-Version. Hier sind die detaillierten Schritte:

Schritt 1: Finden der Konfigurationsdatei

Zuerst müssen Sie das conf.d-Verzeichnis der entsprechenden PHP-Version lokalisieren. Um beispielsweise das Xdebug-Modul für PHP 8.3 zu aktivieren, müssen Sie die folgende Datei bearbeiten:

/Applications/ServBay/etc/php/8.3/conf.d/xdebug.ini

Schritt 2: Bearbeiten der Konfigurationsdatei

Öffnen Sie die xdebug.ini-Datei und kommentieren Sie den folgenden Inhalt aus:

[Xdebug]
; Uncomment the following line to enable XDebug
zend_extension = xdebug.so

Schritt 3: Konfigurieren der Xdebug-Parameter

Um die Funktionen von Xdebug vollständig nutzen zu können, können Sie einige gängige Parameter in der xdebug.ini-Datei konfigurieren. Zum Beispiel:

xdebug.mode=debug,develop
xdebug.start_with_request=yes
xdebug.client_host=localhost
xdebug.client_port=39083
xdebug.log=/Applications/ServBay/logs/xdebug/8.3/xdebug.log

Schritt 4: Neustarten des PHP-Dienstes

Starten Sie den entsprechenden PHP-Dienst im ServBay-Dienstverwaltungsfeld neu. Zum Beispiel, starten Sie den PHP 8.3-Dienst neu. Nach dem Neustart wird das Xdebug-Modul erfolgreich geladen.

Überprüfen, ob das Xdebug-Modul erfolgreich geladen wurde

Sie können testen, ob das Xdebug-Modul erfolgreich geladen wurde, indem Sie eine einfache PHP-Datei erstellen. Erstellen Sie in dem Stammverzeichnis des Webservers eine phpinfo.php-Datei mit folgendem Inhalt:

<?php
phpinfo();
?>

Besuchen Sie https://servbay.host/phpinfo.php und suchen Sie auf der ausgegebenen PHP-Informationsseite nach Informationen zum Xdebug-Modul. Wenn Sie relevante Informationen zu Xdebug sehen, wurde das Modul erfolgreich geladen.

Konfigurieren von Xdebug in PHPStorm

Um Xdebug in PHPStorm für das Debugging zu nutzen, müssen folgende Schritte durchgeführt werden:

Schritt 1: Öffnen Sie PHPStorm und gehen Sie zu den Einstellungen

1. Öffnen Sie PHPStorm.
2. Klicken Sie in der Menüleiste auf File und wählen Sie dann Settings (Windows/Linux) oder Preferences (macOS).

Schritt 2: Konfigurieren des PHP-Interpreters

1. Navigieren Sie im Einstellungsfenster zu Languages & Frameworks -> PHP.
2. Klicken Sie im Abschnitt CLI Interpreter auf die Schaltfläche ... auf der rechten Seite.
3. Klicken Sie im Popup-Fenster auf das +-Symbol, um einen neuen PHP-Interpreter hinzuzufügen, und wählen Sie Local.
4. Setzen Sie den Pfad des PHP-Interpreters auf den entsprechenden Pfad der PHP-Version in ServBay, z.B. /Applications/ServBay/package/php/8.3/8.3.7/bin/php.
5. Klicken Sie auf OK, um die Einstellungen zu speichern.

Schritt 3: Konfigurieren des Xdebug-Debuggings

Hinweis

Die Xdebug-Ports jeder PHP-Version sind unabhängig voneinander und mit der Versionsnummer verknüpft, z.B. ist der Xdebug-Port für PHP 7.2 39072, und der Xdebug-Port für PHP 8.3 ist 39083.

1. Navigieren Sie im Einstellungsfenster zu Languages & Frameworks -> PHP -> Debug.
2. Setzen Sie im Abschnitt Xdebug den Debug Port auf 39083, entsprechend der xdebug.client_port-Konfiguration.
3. Stellen Sie sicher, dass die Option Can accept external connections aktiviert ist.
4. Klicken Sie auf Apply und dann auf OK, um die Einstellungen zu speichern.

Schritt 4: Konfigurieren des PHP-Webanwendungsservers

1. Navigieren Sie im Einstellungsfenster zu Languages & Frameworks -> PHP -> Servers.
2. Klicken Sie auf das +-Symbol auf der rechten Seite, um eine neue Serverkonfiguration hinzuzufügen.
3. Setzen Sie den Servernamen, z.B. ServBay Localhost.
4. Setzen Sie Host auf den entsprechenden Host in ServBay, z.B. servbay.new, und den Port auf 443 (HTTPS).
5. Setzen Sie Debugger auf Xdebug.
6. Klicken Sie auf OK, um die Einstellungen zu speichern.

Schritt 5: Starten der Debugging-Sitzung

1. Öffnen Sie in PHPStorm das PHP-Projekt, das Sie debuggen möchten.
2. Setzen Sie Breakpoints im Code (klicken Sie auf den leeren Bereich links neben der Zeilennummer).
3. Klicken Sie auf die Schaltfläche Start Listening for PHP Debug Connections (kleines Käfersymbol) in der oberen Symbolleiste von PHPStorm.
4. Greifen Sie in Ihrem Browser auf Ihre PHP-Anwendung zu, Xdebug wird automatisch eine Verbindung zu PHPStorm herstellen und die Ausführung am Breakpoint anhalten.

Fazit

ServBay bietet einen einfachen Weg, um das Xdebug-Modul zu verwalten und zu aktivieren. Durch einfache Konfigurations- und Neustartvorgänge können Entwickler das Xdebug-Modul in verschiedenen PHP-Versionen schnell aktivieren und die leistungsstarken Debugging- und Analysefunktionen voll ausschöpfen. Die Breakpoint-Debugging-, Performance-Analyse- und Codeabdeckungsfunktionen von Xdebug machen es zu einem unverzichtbaren Werkzeug für PHP-Entwickler.