Need help with docker-php-tutorial?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

144 Stars 41 Forks 9 Commits 3 Opened issues


Example files of my tutorial on PHP on Docker (check out the branches!)

Services available


Need anything else?

Contributors list

# 492,419
9 commits

Docker PHP Tutorial - Learning Docker for PHP Developers

In this tutorial I'll take you on "my" journey of learning Docker as a PHP developer. Since I actively use everything explained along the way (and force it upon my team ;)) I can hopefully shed some light onto some more advanced issues like cross-OS-setups and seamless IDE integration.

Two words of caution: - I tend to write rather lengthy, in-dept articles so you should allocate some time to work it all through - my main OS is Windows. Although most of the things should be easily transferable into OSX/Linux you might run into some quirks that I didn't encounter.


Each tutorial is placed in a separate branch and has an accompanying article in my blog I recommend to clone the full repository and check out the corresponding branch for easy reference. Example:

mkdir -p /c/codebase
cd /c/codebase/
git clone
cd docker-php-tutorial

git checkout part_2_setting-up-phpstorm-with-xdebug-for-local-development-on-docker


Please subscribe to my RSS Feed and/or subscribe via email to be automatically notified when a new part gets published. I'll also probably brag on Twitter about it ;)


Planned (already used by us but not put into writing):

Roadmap (wow much want, such little time):

Setting up PHP, PHP-FPM and NGINX for local development on Docker

  • Status: published ✓
  • Link:
  • Branch: Part 1

A primer on Docker. What is Docker? How to install it / transition from Vagrant? How to interact with containers? How to organize multiple services (php-cli, php-fpm, nginx) via docker-compose?

Setting up PhpStorm with Xdebug for local development on Docker

  • Status: published ✓
  • Link:
  • Branch: Part 2

Using docker for Development. How to configure PhpStorm to play nicely with Docker? How to setup Xdebug (including the solution for the dreaded 'Connection with Xdebug was not established.' error)?

Structuring the Docker setup for PHP Projects

  • Status: published ✓
  • Link:
  • Branch: Part 3

Running a battle-tested development infrastructure for PHP developers in Docker. How to organize the docker folder structure (e.g. shared scripts for containers)? How to establish a convenient workflow via


Building a CI Pipeline with Jenkins for Dockerized PHP Applications

Deploying Dockerized PHP Applications via CD Pipeline with Jenkins to Production

  • Status: Wishful thinking
  • Link:
  • Branch:

Scaling Dockerized PHP Applications with Terraform and Kubernetes on GCP/AWS

  • Status: Dream Caused by the Flight of a Bee Around a Pomegranate a Second Before Awakening
  • Link:
  • Branch:

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.