/docker-php

A Docker client in PHP

Primary LanguagePHPMIT LicenseMIT

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

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

Installation

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

composer require docker-php/docker-php

Usage

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.

Contributing

Please see CONTRIBUTING for details.

Versioning

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.

Credits

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

License

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