Public | Automated Build

Last pushed: 2 years ago
Short Description
Short description is empty for this repo.
Full Description


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.

Docker Pull Command
Source Repository

Comments (2)
a year ago

Thanks man. I had lot problems with the configuration in PHPStorm, but with your hub I can use xdebug with my IDE congratulations +fav and thank you again

2 years ago

This works great! I had to install php-soap though. It's a bit of a pain to do:

apt-get install php-soap
apt-get install libxml2-dev
cd /usr/src/php/ext/soap
make install 
cp /usr/src/php/ext/soap/modules/ /usr/local/lib/php/extensions/no-debug-non-zts-20131226/