Overview¶

Welcome to the documentation pages for the WebDevOps PHP Docker Boilerplate.

Here you will find informations about the usage of the PHP Docker Boilerplate, as well as informations about the components we used to compose it.
This documentation is work in progess and we appeciate every help we can get, so feel free to contribute.

Introduction¶

What is the PHP Docker Boilerplate for?¶

This PHP Docker Boilerplate is for an example layout for an PHP application with most common services like MySQL or Postgres and with a development and production context and settings.

Getting Started¶

Requirements¶

Docker host (eg. Vagrant Docker VM or dinghy)
Docker compose

Installation¶

Clone the boilerplate and link or copy docker-compose.development.yml

git clone https://github.com/webdevops/php-docker-boilerplate.git project
cd project
cp docker-compose.development.yml docker-compose.yml

Usage¶

Startup containers and run the services:

docker-compose up -d

Web access (dinghy http proxy)¶

If you’re using dinghy docker](https://github.com/codekitchen/dinghy) you can access the services via

Application: http://app.boilerplate.docker/
Mailhog: http://mail.boilerplate.docker
PHPMyAdmin: http://pma.boilerplate.docker
Solr: http://solr.boilerplate.docker
Elasticsearch: http://elasticsearch.boilerplate.docker

Usage¶

This section is not done yet!

Docker Compose Configuration¶

Inside the docker-compose.*.yml files the service layout and links between the layout can be defined.

For some services also the version can be chosen, eg. MySQL-5.7.Dockerfile

Customizing Docker Images¶

The main Dockerfile.* for the php application container can be customized as any normal Dockerfile image.

Synergy with Vagrant Docker VM¶

The [Vagrant Docker VM](https://github.com/webdevops/vagrant-docker-vm) (Ubuntu 16.04) is using [dinghy docker](https://github.com/codekitchen/dinghy) for providing an automatic and dynamic reverse proxy which makes easy to start multiple instances of the boilerplate.

You can also use [dinghy docker](https://github.com/codekitchen/dinghy) standalone if you don’t need an full Linux environment.

Project Structure¶

This section is not done yet!

Dockerfiles¶

This section is not done yet!

Docker Compose Setup¶

This section is not done yet!

Scripts and Provisioning¶

This section is not done yet!

Ansible Roles¶

This section is not done yet!

Ansible Roles Configuration¶

This section is not done yet!

How to Contribute¶

This section is not done yet!

Contributing Code¶

How to contribute Code

Contribute Documentation¶

How to contribute Documentation