Add xDebug configuration (#104)

* #103 - Add xDebug configuration

* Create .lando folder

* Add xdebug info in README.md

* Rearrange README.md points

Co-authored-by: mhawwari <[email protected]>

.lando.yml

@@ -11,6 +11,9 @@ services:
       - "composer global require drupal/coder dealerdirect/phpcodesniffer-composer-installer mglaman/drupal-check phpunit/phpunit"
       - 'export PATH="/var/www/.composer/vendor/bin"'
       - "wget https://asm89.github.io/d/twig-lint.phar -P /var/www"
+    xdebug: true
+    config:
+      php: .lando/.php.ini
   node:
     type: node
     build:

.lando/.php.ini

@@ -0,0 +1,13 @@
+[PHP]
+
+; Xdebug
+xdebug.max_nesting_level = 256
+xdebug.show_exception_trace = 0
+xdebug.collect_params = 0
+; Extra custom Xdebug setting for debug to work in VSCode.
+xdebug.mode = debug
+xdebug.client_host = ${LANDO_HOST_IP}
+xdebug.client_port = 9003
+xdebug.start_with_request = trigger
+; xdebug.remote_connect_back = 1
+xdebug.log = /tmp/xdebug.log

README.md

@@ -22,9 +22,6 @@ composer create-project vardot/varbase-project:9.0.x-dev PROJECT_DIR_NAME --stab
 
 ## [Automated Functional Testing](https://github.com/Vardot/varbase/blob/9.0.x/tests/README.md)
 
-1. Install lando locally, steps for installing can be found [here](https://docs.lando.dev/basics/installation.html).
-2. Run lando start.
-
 ## [Varbase 9.0.x Developer Guide](https://docs.varbase.vardot.com)
 
 ## [CHANGELOG for Varbase](https://github.com/Vardot/varbase/blob/9.0.x/CHANGELOG.md)
@@ -36,3 +33,13 @@ composer create-project vardot/varbase-project:9.0.x-dev PROJECT_DIR_NAME --stab
 ## [CHANGELOG for Varbase](https://github.com/Vardot/varbase/blob/9.0.x/CHANGELOG.md)
 
 ## [General instructions on how to update Varbase](https://github.com/Vardot/varbase/blob/9.0.x/UPDATE.md)
+
+## Local development with Lando
+
+1. Install Lando locally, steps for installing can be found [here](https://docs.lando.dev/basics/installation.html).
+2. Run Lando start.
+
+## Debugging using Lando
+
+- xDebug is enabled on Lando by default for PHP debugging.
+- The debugger is set to listen for the port 9003 but can be changed in .lando/.php.ini