tommylau/xdebug repository overview

⁠lnmpa-xdebug

lnmpa-xdebug is an Apache Server with Xdebug enabled and boxed in a Docker image built by Tommy Lau⁠.

⁠What is in this image?

This image is a php web development environment cooked based on the offical docker image php:apache and my personal image tommylau/apache. This image's features are exactly the same as tommylau/apache⁠, and with Xdebug⁠ added for remote PHP debugging.

WARNING: This image is used for local php development only, running this image in production or intranet while debugging might blocking other users from visiting the websites.

⁠How to use this image

⁠Single instance mode

Get the docker image by running the following commands:

docker pull tommylau/xdebug

Start an instance:

docker run --name xdebug -v /path/to/web:/var/www/html -p 80:80 -d tommylau/xdebug

This will start an instance, and you are ready to go.

⁠Boot2Docker under Mac OS or Windows

If you are running boot2docker⁠ under MacOS or Windows, it is a good idea to add BOOT2DOCKER=1 as an environment variable. In this way, Apache2 will run under user docker (uid 1000) and group staff (gid 50), so that PHP won't complain about the permission denied when you try to write something to the disk through PHP, like say, upload an image to server.

docker run --name xdebug -v /path/to/web:/var/www/html -p 80:80 -e BOOT2DOCKER=1 -d tommylau/xdebug

⁠Linking with other containers

To use this image linking with MySQL, you have to have a running MySQL instance, more information about MySQL docker image, please refer to tommylau/mysql⁠. Suppose you have a MySQL instance named mysql5.6_server, we can link it in our Apache2 instance with the name mysql like this:

docker run --name xdebug -v /path/to/web:/var/www/html --link mysql5.6_server:mysql -p 80:80 -d tommylau/xdebug

Then in the instance, you can use the hostname mysql to connect to the database.