Docker PHP (for lack of a better name) is a Docker client written in PHP. This library aim to reach 100% API support of the Docker Engine.

The test suite currently passes against the Docker Remote API v1.24.

The recommended way to install Docker PHP is of course to use Composer:

composer require docker-php/docker-php

See the documentation.

Setup the test suite using Composer if not already done:

$ composer install --dev

Run it using PHPUnit:

$ composer test

$ docker-compose run php54
$ docker-compose run php55
$ docker-compose run php56
$ docker-compose run php70

It is recommended to run only one service during testing, since composer requirements may depend on the PHP version and we are using a host-volume during local testing.

Please see CONTRIBUTING for details.

Docker PHP does not follow the classic semver versioning, but follow the Docker Remote API versioning starting at the v1.21, the master branch will follow the next major release on the Docker Remote API.

Changes on the core of this library not related to the API, will be merged back to previous versions on a best effort basis.

This README heavily inspired by willdurand/Negotiation by @willdurand. This guy is pretty awesome.

The MIT License (MIT). Please see License File for more information.