silintl/ssp-base repository overview

⁠ssp-base

Base image for simpleSAMLphp

Docker image: silintl/ssp-base⁠

⁠Prerequisite software

Docker⁠ and docker-compose⁠ must be installed.

Make⁠ is optional but simplifies the build process.

Vagrant⁠ for Windows users.

⁠Local testing

1. cp local.env.dist local.env within project root and make adjustments as needed.
2. Add your github token to the COMPOSER_AUTH variable in the local.env file.
3. make or docker-compose up -d within the project root.
4. Visit http://localhost⁠ to see SSP running

⁠Setup PhpStorm for remote debugging with Docker

1. Make sure you're running PhpStorm 2016.3 or later
2. Setup Docker server by going to Preferences (or Settings on Windows) -> Build, Execution, Deployment -> Click + to add a new server. Use settings:

• Name it Docker
• API URL should be tcp://localhost:2375
• Certificates folder should be empty
• Docker Compose executable should be full path to docker-compose script

1. Hit Apply
2. Next in Preferences -> Languages & Frameworks -> PHP click on the ... next to the CLI Interpreter and click + to add a new interpreter. Use settings:

• Name: Remote PHP7
• Remote: Docker
• Server: chose the Docker server we added
• Debugger extension: /usr/lib/php/20151012/xdebug.so

1. Hit Apply and OK
2. On PHP for Path mappings edit it so the project root folder maps to /data on remote server
3. Hit Apply and OK
4. Click on Run and then Edit Configurations
5. Click on + and select PHP Web Application
6. Name it Debug via Docker
7. Click on ... next to Server and then + to add a server.
8. Name it Localhost and use settings:

• Host: localhost
• Port: 80
• Debugger: Xdebug
• Check use path mappings and add map from project root to /data

1. Hit Apply and OK
2. Click on Run and then Debug 'Debug on Docker'

⁠Use of sildisco's LogUser module is optional and triggered via an authproc.