Public | Automated Build

Last pushed: 3 months ago
Short Description
Short description is empty for this repo.
Full Description


This is a docker image for installing/executing PHPUnit.


This docker image builds on top of nubs/composer-build and
adds PHPUnit including xdebug for code coverage support. It provides several
key features in addition to those of the base image:

  • A phpunit installed in the PATH at $COMPOSER_HOME/vendor/bin/phpunit
    via composer global require. This will always install the newest stable
    version of PHPUnit.
  • Xdebug code coverage support.


Assuming you have a phpunit.xml that specifies your build parameters in a
supported location under your project at /tmp/my-code, you can run:

docker run --interactive --tty --rm --volume /tmp/my-code:/code nubs/phpunit

# Using short-options:
# docker run -i -t --rm -v /tmp/my-code:/code nubs/phpunit

This will execute the default command (phpunit) and update your code
directory with the result (e.g., code coverage reports).

Other commands can also be executed. For example, to install composer
dependencies (note this can also be done using composer-build):

docker run -i -t --rm -v /tmp/my-code:/code nubs/phpunit composer install

Or to run with custom parameters:

docker run -i -t --rm -v /tmp/my-code:/code nubs/phpunit phpunit --coverage-html coverage

Dockerfile build

Alternatively, you can create your own Dockerfile that builds on top of this
image. This allows you to modify the environment by installing additional
software needed, altering the commands to run, etc.

A simple one that just installs another package but leaves the rest of the
process alone could look like this:

FROM nubs/phpunit

RUN docker-php-ext-install iconv

You can then build this docker image and run it against your codebase like
normal (this example assumes the phpunit.xml and Dockerfile are in your
current directory):

docker build --tag my-code .
docker run -i -t --rm -v "$(pwd):/code" my-code
docker run -i -t --rm -v "$(pwd):/code" my-code phpunit --coverage-html


docker-phpunit is licensed under the MIT license. See LICENSE for
the full license text.

Docker Pull Command
Source Repository

Comments (0)