feat: add debugging for php in docker

README.md

@@ -40,5 +40,37 @@ joomla specific database prefixes like #__
 To set it up, insert into the configuration popup which follows after you enable the framework support:  
 Joomla install path: `./data/joomla_data`  
 JConfig: `./data/joomla_data/configuration.php`
+> This works only with mounted volumes. However, mounted volumes will slow down the joomla instance significantly.  
+> The current setup does not use mounted volumes.
+> An alternative would be to download joomla and use that installation
  
- 
+### Debugging (with Docker/Intellij)
+1. Start Docker Container (see above)
+2. Create a terminal for that container
+    ```shell 
+      docker exec -it <container_name> bash
+    ```
+3. install xdebug within the container since joomla does not come with xdebug preinstalled  
+    ```shell 
+      pecl install xdebug
+    ```
+4. restart the container
+5. In Intellij Go to [File | Settings | Languages & Frameworks | PHP | Servers](jetbrains://idea/settings?name=Languages+%26+Frameworks--PHP--Servers) and setup your server
+
+    |          |           |
+    |----------|-----------|
+    | name     | anything  |
+    | host     | localhost |
+    | port     | 8080      |
+    | debugger | xdebug    |
+    
+    use the path mapping and map the repo structure to the container content
+
+    | File/Directory                                                   | path on server |
+    |------------------------------------------------------------------|----------------|
+    | \<path>/com_sportsmanager/src/structure/administrator/components | /var/www/html/administrator/components |
+    | \<path>/com_sportsmanager/src/structure/components | /var/www/html/components  |
+6. Click on "Start Listening for PHP Debug Connections" in the top row of intellij
+7. (Not sure if optional) Install a browser extension by Jetbrains  
+https://chromewebstore.google.com/detail/xdebug-helper-by-jetbrain/aoelhdemabeimdhedkidlnbkfhnhgnhm
+