install xdebug for remote debugging

Author: briskt

development/run.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+
+set -x
+
+# establish a signal handler to catch the SIGTERM from a 'docker stop'
+# reference: https://medium.com/@gchudnov/trapping-signals-in-docker-containers-7a57fdda7d86
+term_handler() {
+  apache2ctl stop
+  exit 143; # 128 + 15 -- SIGTERM
+}
+trap 'kill ${!}; term_handler' SIGTERM
+
+export XDEBUG_CONFIG="remote_enable=1 remote_host="$REMOTE_DEBUG_IP
+
+apt-get update
+apt-get install php-xdebug
+
+cd /data
+
+# Send info about this image's O/S and PHP version to our logs.
+cat /etc/*release | grep PRETTY
+php -v | head -n 1
+
+apache2ctl -k start -D FOREGROUND
+
+# endless loop with a wait is needed for the trap to work
+while true
+do
+  tail -f /dev/null & wait ${!}
+done

docker-compose.yml

@@ -4,6 +4,7 @@ services:
   hub1:
     image: silintl/ssp-base:develop
     volumes:
+      - ./development/run.sh:/data/run.sh
       - ./development/cert:/data/vendor/simplesamlphp/simplesamlphp/cert
       - ./development/hub1/authsources.php:/data/vendor/simplesamlphp/simplesamlphp/config/authsources.php
       - ./development/hub1/saml20-idp-remote.php:/data/vendor/simplesamlphp/simplesamlphp/metadata/idp-remote.php
@@ -37,6 +38,7 @@ services:
   idp1:  # used for basic testing
     image: silintl/ssp-base:develop
     volumes:
+      - ./development/run.sh:/data/run.sh
       - ./development/cert:/data/vendor/simplesamlphp/simplesamlphp/cert
       - ./development/idp1/authsources.php:/data/vendor/simplesamlphp/simplesamlphp/config/authsources.php
       - ./development/idp1/saml20-idp-hosted.php:/data/vendor/simplesamlphp/simplesamlphp/metadata/saml20-idp-hosted.php
@@ -59,6 +61,7 @@ services:
   idp2:  # used for expiry testing
     image: silintl/ssp-base:develop
     volumes:
+      - ./development/run.sh:/data/run.sh
       - ./development/cert:/data/vendor/simplesamlphp/simplesamlphp/cert
       - ./development/idp2/enable:/data/vendor/simplesamlphp/simplesamlphp/modules/exampleauth/enable
       - ./development/idp2/authsources.php:/data/vendor/simplesamlphp/simplesamlphp/config/authsources.php
@@ -89,6 +92,7 @@ services:
   idp4:  # used for mfa testing (as well as some helpful links)
     image: silintl/ssp-base:develop
     volumes:
+      - ./development/run.sh:/data/run.sh
       - ./development/cert:/data/vendor/simplesamlphp/simplesamlphp/cert
       - ./development/idp4/authsources.php:/data/vendor/simplesamlphp/simplesamlphp/config/authsources.php
       - ./development/idp4/saml20-idp-hosted.php:/data/vendor/simplesamlphp/simplesamlphp/metadata/saml20-idp-hosted.php
@@ -193,6 +197,7 @@ services:
   hub2:  # used for announcement testing
     image: silintl/ssp-base:develop
     volumes:
+      - ./development/run.sh:/data/run.sh
       - ./development/cert:/data/vendor/simplesamlphp/simplesamlphp/cert
       - ./development/hub2/authsources.php:/data/vendor/simplesamlphp/simplesamlphp/config/authsources.php
       - ./development/hub2/saml20-idp-remote.php:/data/vendor/simplesamlphp/simplesamlphp/metadata/saml20-idp-remote.php
@@ -223,6 +228,7 @@ services:
   idp3:  # used for announcement testing
     image: silintl/ssp-base:develop
     volumes:
+      - ./development/run.sh:/data/run.sh
       - ./development/cert:/data/vendor/simplesamlphp/simplesamlphp/cert
       - ./development/idp3/authsources.php:/data/vendor/simplesamlphp/simplesamlphp/config/authsources.php
       - ./development/idp3/saml20-idp-hosted.php:/data/vendor/simplesamlphp/simplesamlphp/metadata/saml20-idp-hosted.php
@@ -250,6 +256,7 @@ services:
   sp1:
     image: silintl/ssp-base:develop
     volumes:
+      - ./development/run.sh:/data/run.sh
       - ./development/cert:/data/vendor/simplesamlphp/simplesamlphp/cert
       - ./development/sp1/authsources.php:/data/vendor/simplesamlphp/simplesamlphp/config/authsources.php
       - ./development/sp1/saml20-idp-remote.php:/data/vendor/simplesamlphp/simplesamlphp/metadata/saml20-idp-remote.php
@@ -271,6 +278,7 @@ services:
   sp2:  # used for announcement testing
     image: silintl/ssp-base:develop
     volumes:
+      - ./development/run.sh:/data/run.sh
       - ./development/cert:/data/vendor/simplesamlphp/simplesamlphp/cert
       - ./development/sp2/authsources.php:/data/vendor/simplesamlphp/simplesamlphp/config/authsources.php
       - ./development/sp2/saml20-idp-remote.php:/data/vendor/simplesamlphp/simplesamlphp/metadata/saml20-idp-remote.php

local.env.dist

@@ -10,3 +10,5 @@ MFA_U2F_appId=
 ### Optional ENV vars ###
 LOGENTRIES_KEY=
 COMPOSER_AUTH=
+
+REMOTE_DEBUG_IP=