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 https://github.com/paslandau/docker-php-tutorial.git
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 ;)
There a Youtube playlist available containing all videos of the tutorial series.
- Setting up PHP, PHP-FPM and NGINX for local development on Docker
- Setting up PhpStorm with Xdebug for local development on Docker
- Structuring the Docker setup for PHP Projects
- PhpStorm, Docker and Xdebug 3 on PHP 8.1 in 2022
- Run Laravel 9 on Docker in 2022
- Status: published ✓
- Link: https://www.pascallandau.com/blog/php-php-fpm-and-nginx-on-docker-in-windows-10/
- 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?
- Status: published ✓
- Link: https://www.pascallandau.com/blog/setup-phpstorm-with-xdebug-on-docker/
- 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)?
- Status: published ✓
- Link: https://www.pascallandau.com/blog/structuring-the-docker-setup-for-php-projects/
- 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 make?
- Status: published ✓
- Link: https://www.pascallandau.com/blog/docker-from-scratch-for-php-applications-in-2022/
- Branch: Part 4.1
An update of the previous article (Part 3) with the learnings of the past 3 years:
- simplify the setup
- add more containers (redis, mysql, workers)
- prepare for additional environments (CI, production)
- Status: published ✓
- Link: https://www.pascallandau.com/blog/phpstorm-docker-xdebug-3-php-8-1-in-2022/
- Branch: Part 4.2
An update of the pervious article on setting up PhpStorm (Part 2) using the latest PHP version (PHP 8.1) as well as the latest Xdebug version (3). The article also covers additional debugging challenges (from the browser, from the CLI, from a long running worker process).
- Status: published ✓
- Link: https://www.pascallandau.com/blog/run-laravel-9-docker-in-2022/
- Branch: Part 4.3
A step-by-step walkthrough to set up a new Laravel 9 project on the docker setup of this tutorial, using a couple of common Laravel components (Commands, Controllers, Queues, Databases).
- Status: in progress
- Link:
- Branch:
Setting up common code quality tools (style checkers, static analyzers, etc.) and running them as part of a CI pipeline via Github Actions and Gitlab Pipelines.
- Status: Dream Caused by the Flight of a Bee Around a Pomegranate a Second Before Awakening
- Link:
- Branch: