Hoe Xdebug PHP te installeren en PHPStorm in te stellen via CLI Zonder Apache

Inhoudsopgave

  1. Introductie
  2. Stap 1: PHP en Xdebug installeren
  3. Stap 2: Xdebug configureren in xdebug.ini
  4. Stap 3: PHPStorm configureren
  5. Stap 4: Xdebug testen
  6. Xdebug gebruiken met Magento CLI
  7. Veelvoorkomende problemen oplossen
  8. Conclusie
  9. FAQ

Introductie

Het ontwikkelen van PHP-applicaties kan uitdagend zijn, vooral als het gaat om het debuggen van complexe code. Wist je dat het gebruik van Xdebug dit proces aanzienlijk kan stroomlijnen? Xdebug is een krachtige tool waarmee PHP-ontwikkelaars hun code efficiënter kunnen debuggen. In deze blogpost gaan we dieper in op een stapsgewijze handleiding over hoe je Xdebug installeert en PHPStorm instelt via CLI zonder Apache.

Dit artikel is met name gunstig voor PHP-ontwikkelaars die hun debugworkflow willen verbeteren en hun productiviteit willen maximaliseren. Tegen het einde van deze handleiding heb je een duidelijk inzicht in hoe je Xdebug en PHPStorm instelt, waardoor je ontwikkelingsproces soepel en foutloos verloopt.

Stap 1: PHP en Xdebug installeren

Om het proces op gang te brengen, moet je PHP en Xdebug op je systeem installeren. Hier is een eenvoudige manier om dat te doen:

  1. Open uw terminal en voer het volgende commando uit om de nieuwste versie van PHP en Xdebug te installeren:

    sudo apt-get install php8.3-xdebug

  2. Controleer de installatie door de PHP-versie te controleren:

    php -v

Zodra je de installatie hebt bevestigd, kun je doorgaan naar de volgende stap.

Stap 2: Xdebug configureren in xdebug.ini

Het configureren van Xdebug is cruciaal voor een naadloze werking met PHP. Volg deze stappen om Xdebug te configureren:

  1. Zoek het xdebug.ini-bestand. Dit bestand bevindt zich meestal in de map waar PHP is geïnstalleerd.

  2. Open xdebug.ini ter bewerking. Gebruik een teksteditor zoals nano of vim hiervoor:

    sudo nano /etc/php/8.3/mods-available/xdebug.ini

  3. Voeg de volgende configuratie-instellingen toe:

    zend_extension=xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes

  4. Sla het bestand op en sluit de editor af.

  5. Herstart de Apache-service om de wijzigingen toe te passen:

    sudo service apache2 restart

Hoewel deze handleiding zich richt op het gebruik van CLI zonder Apache, is het essentieel om hier Apache te herstarten om ervoor te zorgen dat de configuraties worden toegepast. Dit kan worden beschouwd als een veiligheidsstap bij het voorbereiden van uw omgeving.

Stap 3: PHPStorm configureren

Om effectief te debuggen, moet je PHPStorm synchroniseren met Xdebug. Zo kun je PHPStorm configureren:

  1. Open PHPStorm en ga naar Instellingen (of Voorkeuren op macOS).

  2. Klik op PHP in de linker zijbalk en klik vervolgens op Debug.

  3. Stel een nieuwe PHP-interpreter in door de versie van PHP te selecteren die je eerder hebt geïnstalleerd. Controleer of de Xdebug-instellingen correct worden herkend.

  4. Navigeer naar PHP -> Servers en voeg een nieuwe serverconfiguratie toe:

    • Naam: localhost
    • Host: localhost
    • Poort: 9000
    • Debugger: Xdebug

  5. Wijzigingen toepassen en het instellingenvenster sluiten.

Stap 4: Xdebug testen

Door te testen, zorg je ervoor dat Xdebug correct is ingesteld en klaar is om je PHP-code te debuggen. Volg deze stappen:

  1. Maak een nieuw PHP-bestand in je projectmap, bijvoorbeeld test.php.

    <?php
echo "Test Xdebug";
?>

  2. Stel een breakpoint in in het test.php-bestand door te klikken in de linkermarge van het regelnummer waar je de uitvoering wilt onderbreken in PHPStorm.

  3. Voer het PHP-bestand uit met Xdebug ingeschakeld:

    XDEBUG_SESSION_START="PHPSTORM" php test.php

PHPStorm zou nu de uitvoering moeten onderbreken bij het breakpoint dat je hebt ingesteld, wat aangeeft dat Xdebug correct werkt.

Xdebug gebruiken met Magento CLI

Magento-ontwikkelaars kunnen ook profiteren van het gebruik van Xdebug met Magento CLI-opdrachten. Zo kun je dat doen:

  1. Voer een willekeurige Magento CLI-opdracht uit met Xdebug ingeschakeld. Bijvoorbeeld:
    XDEBUG_SESSION_START="PHPSTORM" php bin/magento se:up

Deze opdracht zal de Magento installatie-upgrade-opdracht triggeren met Xdebug-sessie.

Veelvoorkomende problemen oplossen

Soms werkt Xdebug mogelijk niet zoals verwacht. Een veelvoorkomende fout is de onmogelijkheid om verbinding te maken met de debugclient:

Xdebug: [Stap Debug] Kon geen verbinding maken met de debugclient. Geprobeerd: localhost:9000 (via xdebug.client_host/xdebug.client_port).

Dit probleem kan worden opgelost door:

  1. Controleren van PHPStorm debug-opties. Zorg ervoor dat instellingen zoals Forceer een onderbreking op de eerste regel en Onderbrekingen oplossen als deze niet beschikbaar zijn zijn ingeschakeld.

  2. PHPStorm opnieuw opstarten om eventuele wijzigingen toe te passen en het debugproces opnieuw te proberen.

Conclusie

Door deze gedetailleerde stappen te volgen, kun je efficiënt Xdebug en PHPStorm instellen voor het debuggen via de command-line interface, zonder de noodzaak van Apache. Deze aanpak maakt een gestroomlijnder debugproces mogelijk, waardoor het voor ontwikkelaars gemakkelijker wordt om problemen in hun PHP-code te identificeren en op te lossen.

Voor verdere vragen of uitdagingen die je tegenkomt bij het volgen van deze tutorial, neem gerust contact met ons op. Veel debugplezier!

FAQ

V1: Kan ik Xdebug gebruiken met andere IDE's dan PHPStorm?

Ja, Xdebug kan worden geconfigureerd om te werken met veel andere IDE's, zoals Visual Studio Code, Eclipse en NetBeans. De exacte configuratiestappen kunnen variëren, maar de kernprincipes blijven hetzelfde.

V2: Is het noodzakelijk om Apache te herstarten als ik de CLI gebruik?

Het herstarten van Apache na het configureren van Xdebug is een extra voorzorgsmaatregel om ervoor te zorgen dat eventuele lopende PHP-processen de nieuwe configuratie oppikken. Voor CLI-bewerkingen kan deze stap soms worden overgeslagen, afhankelijk van de opstelling.

V3: Kan Xdebug worden gebruikt in een productieomgeving?

Hoewel mogelijk, wordt het niet aanbevolen om Xdebug te gebruiken in een productieomgeving vanwege prestatieoverhead en mogelijke beveiligingsrisico's. Xdebug is ontworpen voor lokale ontwikkelomgevingen waar het kan helpen bij debuggen en profileren.

V4: Werkt Xdebug met alle versies van PHP?

Xdebug is compatibel met de meeste PHP-versies, maar je moet altijd de specifieke versiecompatibiliteit op de Xdebug-website controleren om ervoor te zorgen dat het werkt met jouw PHP-versie.

V5: Hoe kan ik Xdebug automatisch laten starten bij elke PHP-aanvraag?

Je kunt het xdebug.ini-bestand aanpassen om de directive xdebug.start_with_request=yes op te nemen, zodat Xdebug automatisch start bij elke PHP-aanvraag.