Skip to content
A Docker client in PHP
PHP Other
  1. PHP 99.9%
  2. Other 0.1%
Branch: master
Clone or download
Pull request Compare This branch is 12 commits ahead, 71 commits behind docker-php:master.
xgin Merge pull request #5 from alexsibtihon/atikhonov-merge-upstream
Merge 1.24 branch from the upstream to master
Latest commit 1259ffe Jan 9, 2020

Docker PHP

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.

Documentation Status Latest Version Software License Build Status Code Coverage Quality Score Total Downloads


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

composer require docker-php/docker-php


See the documentation.

Unit Tests

Setup the test suite using Composer if not already done:

$ composer install --dev

Run it using PHPUnit:

$ composer test

Running Tests with docker-compose

$ 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.

You can’t perform that action at this time.