nfra/kickstart-flavor-php repository overview

⁠kickstart-flavor PHP :: Apache2, PHP7.4 development container

see (http://github.com/infracamp/kickstart⁠) for more information.

Document Index:

• Development Guide for this flavor⁠
• Dockerhub page⁠
  • Tags available⁠
  • Build details⁠

⁠Tags

Use -min images in Dockerfile and main image in .kick.yml

⁠Container specific ENV Configuration

⁠Container specific .kick.yml-directives

⁠Additional configuration

In .kick.yml you can modify the vhost settings

apache_document_root: /opt/www
apache_vhost_config: |
    FallbackResource /index.php
    php_admin_value file_uploads 0

See kickstart/conf/⁠ for default configuration. You can override these by placing the files into .kicker/conf/ directory of your project.

⁠Installed Software

Make sure your IDE has plugins installed for:

• editorconfig⁠

⁠Using the xdebug debugger / profiler with PhpStorm

Xdebug is enabled by default if you are in development mode (the project is run by kickstart.sh)

Xdebug is configured to connect the IDE on the Docker-Host-IP (which is the first configured IP of your host machine - determined by kickstart.sh) on Port 9000

⁠PhpStorm IDE settings (global)

Activate remote debugging in Settings:

⁠Project settings

Open Run > Edit configurations...

The idekey and serverName is the name of your project!

Enable Path Mappings:

⁠Start Debugging via browser

To start debugging via browser open:

http://localhost/?XDEBUG_SESSION_START=project123-name

⁠Start CLI debugging

just set the breakpoint

⁠Troubleshooting the debugging

If debugging won't work, use our checklist to determine the cause:

1. Check the docker-host's IP was propagated correctly.

   • The IP should be set as environment-variable DOCKER_HOST_IP

   • Inside the container type echo $DOCKER_HOST_IP should print your ip

   A) Check kickstart.sh is the newest version (perform ./kickstart.sh --upgrade)

   B) Solution: Check hostname -i returns your primary IP address on your host machine.

2. Check the IDE is connectable from within the container on Port 9000

   • Install netcat and try the script below:

   sudo apt install netcat
   nc -zw3 $DOCKER_HOST_IP 9000 && echo "OK: IDE is reachable on port 9000" || echo "ERROR: IDE unreachable"
   

   Copy

   A) Check if you can reach this PORT from outside the container. If not your IP might be wrong, or your IDE is not correctly configured.

3. Check your IDE-Settings.