Merge pull request #1 from strayobject/xdebugv3php7.4

feat: Updated to php7.4 + xdebug3

Author: strayobject

README.md

@@ -3,7 +3,20 @@ Flip between non xdebug local dev (much fast) to xdebug local dev (not fast but
 
 Setup
 
+Full guide available at https://strayobject.medium.com/php-docker-and-xdebug-v3-with-no-performance-loss-9d0f49ac53ba
+
 1. Create a docker network:
 `docker network create --subnet=192.168.50.0/24 pxd-docker`
 2. Add `127.0.0.1 php-xdebug-docker` to your hosts file.  
 3. Run `docker-compose up -d` to start the env
+4. Open index.php in editor and add a breakpoint on line 6
+5. Open your browser, set up the plugin from the list: https://www.jetbrains.com/help/phpstorm/browser-debugging-extensions.html
+6. In browser navigate to http://php-xdebug-docker and turn on the extension.
+7. Reload the page (breakpoint should be triggered in the code editor)
+
+Note: To see the breakpoint triggered via cli, you need to execute your commands in the app_xdebug container.
+
+`docker-compose exec app_xdebug php index.php`
+
+
+Enjoy!

docker/app/.env

@@ -1,9 +1,8 @@
 PHP_XDEBUG_ENABLED=1
-PHP_XDEBUG_REMOTE_PORT=9002
+#PHP_XDEBUG_REMOTE_PORT=9002
 # Xdebug remote host likely 192.168.50.1 if on linux, use host.docker.internal on a Mac
 PHP_XDEBUG_REMOTE_HOST=192.168.50.1
 PHP_XDEBUG_IDKEY=pxd
 PHP_MEMORY_LIMIT=1G
 
-APP_ENV=dev
 PHP_IDE_CONFIG="serverName=pxd"

docker/app/Dockerfile

@@ -1,4 +1,4 @@
-FROM php:7.3-fpm
+FROM php:7.4-fpm
 
 ARG USER_ID
 ARG GROUP_ID

docker/app/Dockerfile_xdebug

@@ -1,4 +1,4 @@
-FROM php:7.3-fpm
+FROM php:7.4-fpm
 
 ARG USER_ID
 ARG GROUP_ID

docker/app/php/xdebug.ini

@@ -2,8 +2,8 @@
 xdebug.default_enable=${PHP_XDEBUG_ENABLED}
 xdebug.max_nesting_level=256
 
-xdebug.remote_enable=1
-xdebug.remote_autostart=1
-xdebug.remote_host=${PHP_XDEBUG_REMOTE_HOST}
-xdebug.remote_port=${PHP_XDEBUG_REMOTE_PORT}
+xdebug.start_with_request=yes
+xdebug.mode=debug
 xdebug.idekey=${PHP_XDEBUG_IDKEY}
+xdebug.client_host=${PHP_XDEBUG_REMOTE_HOST}
+#xdebug.client_port=${PHP_XDEBUG_REMOTE_PORT}

docker/nginx/nginx.conf

@@ -4,7 +4,7 @@ resolver 127.0.0.11;
 # idea from https://github.com/developersalliance/magento2-dockergento/blob/master/config/dockergento/nginx/conf/default.conf
 map $cookie_XDEBUG_SESSION $fastcgi_pass {
     default app;
-    wordpress app_xdebug;
+    pxd app_xdebug;
 }
 
 server {