Separate the PHP versions to multiple dockerfiles

Because there's some difference in installing some libraries
between PHP 5 and PHP 7. There must be multiple php dockerfiles.
For that I created 3 docker files each of a different version,
this will make it easy for the users to switch between the PHP
version by just editing the docker-compose file and not touching
the dockerfiles.

README.md

@@ -1,6 +1,6 @@
 # LaraDock
 
-[![forthebadge](http://forthebadge.com/images/badges/built-with-love.svg)](http://www.zalt.me)
+[![forthebadge](http://forthebadge.com/images/badges/built-by-developers.svg)](http://zalt.me)
 
 
 LaraDock helps you run your **Laravel** App on **Docker** real quick.
@@ -15,6 +15,11 @@ It's like Laravel Homestead but for Docker instead of Vagrant.
 
 
 - [Intro](#Intro)
+	- [Features](#features)
+	- [What is Docker](#what-is-docker)
+	- [What is Laravel](#what-is-laravel)
+	- [Why Docker not Vagrant](#why-docker-not-vagrant)
+	- [LaraDock VS Homestead](#laradock-vs-homestead)
 - [Supported Containers](#Supported-Containers)
 - [Requirements](#Requirements)
 - [Installation](#Installation)
@@ -24,13 +29,13 @@ It's like Laravel Homestead but for Docker instead of Vagrant.
 	- [Close all running Containers](#Close-all-running-Containers)
 	- [Delete all existing Containers](#Delete-all-existing-Containers)
 	- [Build/Re-build Containers](#Build-Re-build-Containers)
-	- [Use Redis](#Use-Redis)
-	- [Use custom Domain](Use-custom-Domain)
 	- [Change the PHP Version](#Change-the-PHP-Version)
 	- [Add/Remove a Docker Container](#AddRemove-a-Docker-Container)
 	- [Add more Software's (Docker Images)](#Add-Docker-Images)
-	- [Edit a Docker Container](#Edit-a-Docker-Container)
+	- [Edit default container configuration](#Edit-Container)
+	- [Use custom Domain](Use-custom-Domain)
 	- [View the Log files](#View-the-Log-files)
+	- [Use Redis](#Use-Redis)
 	- [Enter a Container (SSH into a running Container)](#Enter-Container)
 	- [Edit a Docker Image](#Edit-a-Docker-Image)
 	- [Run a Docker Virtual Host](#Run-Docker-Virtual-Host)
@@ -47,37 +52,96 @@ LaraDock strives to make the development experience easier.
 It contains pre-packaged Docker Images that provides you a wonderful development environment without requiring you to install PHP, NGINX, MySQL, REDIS, and any other software on your local machine.
 
 
+**Usage Overview:** Run `NGINX`, `MySQL` and `Redis`.
 
-### What is Docker?
+```shell
+docker-compose up -d  nginx mysql redis 
+```
 
-[Docker](https://www.docker.com)  is an open-source project that automates the deployment of applications inside software containers, by providing an additional layer of abstraction and automation of [operating-system-level virtualization](https://en.wikipedia.org/wiki/Operating-system-level_virtualization) on Linux, Mac OS and Windows.
+<a name="features"></a>
+### Features
 
-### What is Laravel?
-
-Seriously!!!
-
-### Why Docker not Vagrant!?
-[Vagrant](https://www.vagrantup.com) gives you Virtual Machines in minutes while Docker gives you Virtual Containers in seconds.
-
-Instead of providing a full Virtual Machines, like you get with Vagrant, Docker provides you **lightweight** Virtual Containers, that share the same kernel and allow to safely execute independent processes.
+- Easy switch between PHP versions: 7.0 - 5.6 - 5.5 ...
+- Choose your favorite database engine: MySQL - Postgres - Redis ...
+- Run your own combination of software's: Memcached - MariaDB ...
+- Every software runs on a separate container: PHP - NGINX ...
+- Easy to customize any container, with simple edit to the `dockerfile`.
+- All Images extends from an official base Image. (Trusted base Images).
+- Pre-configured Nginx for Laravel.
+- Data container, to keep Data safe and accessible.
+- Easy to apply configurations inside containers.
+- Clean and well structured Dockerfiles (`dockerfile`).
+- Latest version of the Docker Compose file (`docker-compose`).
+- Everything is visible and editable.
 
 
 <a name="Supported-Containers"></a>
 ## Supported Containers
 
-- PHP
+- PHP (7.0 - 5.6 - 5.5)
 - NGINX
 - MySQL
 - PostgreSQL
+- MariaDB
 - Redis
+- Memcached
+- Beanstalkd
+- Beanstalkd Console
 - Data Volume
 
+>Cannot find your container! we would love to have it as well. Consider contributing your container and adding it to this list.
+
+
+
+
+
+<a name="what-is-docker"></a>
+### What is Docker?
+
+[Docker](https://www.docker.com)  is an open-source project that automates the deployment of applications inside software containers, by providing an additional layer of abstraction and automation of [operating-system-level virtualization](https://en.wikipedia.org/wiki/Operating-system-level_virtualization) on Linux, Mac OS and Windows.
+
+<a name="what-is-laravel"></a>
+### What is Laravel?
+
+Seriously!!!
+
+
+<a name="why-docker-not-vagrant"></a>
+### Why Docker not Vagrant!?
+
+[Vagrant](https://www.vagrantup.com) creates Virtual Machines in minutes while Docker creates Virtual Containers in seconds.
+
+Instead of providing a full Virtual Machines, like you get with Vagrant, Docker provides you **lightweight** Virtual Containers, that share the same kernel and allow to safely execute independent processes.
+
+In addition to the speed, Docker gives tens of features that cannot be achieved with Vagrant.
+
+Most importantly Docker can run on Development and on Production (same environment everywhere). While Vagrant is designed for Development only, (so you have to re-provision your server on Production every time).
+
+
+<a name="laradock-vs-homestead"></a>
+### LaraDock VS Homestead
+
+LaraDock and [Homestead](https://laravel.com/docs/master/homestead) both gives you a complete virtual development environments. (Without the need to install and configure every single software on your own Operating System).
+
+- Homestead is a tool that controls Vagrant for you (using Homestead special commands). And Vagrant manages your Virtual Machine.
+
+- LaraDock is a tool that controls Docker for you (using Docker Compose official commands). And Docker manages you Virtual Containers.
+
+Running a virtual Container is much faster than running a full virtual Machine. 
+<br>Thus **LaraDock is much faster than Homestead**.
+
+
+
 <a name="Requirements"></a>
 ## Requirements
-- Laravel ([Download](https://laravel.com/docs/master/installation))
-- Docker Toolbox ([Download](https://www.docker.com/toolbox))
-- Git ([Download](https://git-scm.com/downloads))
-- Composer ([Download](https://getcomposer.org/download/))
+
+| Linux                                                                                   | Windows & MAC                                           |
+|-----------------------------------------------------------------------------------------|---------------------------------------------------------|
+|                 [Laravel](https://laravel.com/docs/master/installation)                 | [Laravel](https://laravel.com/docs/master/installation) |
+|                           [Git](https://git-scm.com/downloads)                          |           [Git](https://git-scm.com/downloads)          |
+| [Docker Engine](https://docs.docker.com/engine/installation/linux/ubuntulinux/#install) |     [Docker Toolbox](https://www.docker.com/toolbox)    |
+|                [Docker Compose](https://docs.docker.com/compose/install)                |                                                         |
+
 
 <a name="Installation"></a>
 ## Installation
@@ -88,7 +152,7 @@ Instead of providing a full Virtual Machines, like you get with Vagrant, Docker
 git clone https://github.com/LaraDock/laradock.git docker
 ```
 
-Instead of `git clone` you can use `git submodule add` in case you are already using Git for your Laravel project *(Recommended)*:
+You can use `git submodule add` instead of `git clone` if you are already using Git for your Laravel project *(Recommended)*:
 
 ```bash
 git submodule add https://github.com/LaraDock/laradock.git docker
@@ -97,12 +161,15 @@ git submodule add https://github.com/LaraDock/laradock.git docker
 >These commands should create a `docker` folder, on the root directory of your Laravel project.
 
 
+
+
 <a name="Usage"></a>
 ## Usage
 
->**(Windows & MAC users)** Make sure you have a running Docker Virtual Host on your machine first. 
-><br>
->[How to run a Docker Virtual Host?](#Run-Docker-Virtual-Host)
+0 - For **Windows & MAC** users only: make sure you have a running Docker Virtual Host on your machine. 
+(**Linux** users don't need a Virtual Host, so skip this step).
+<br>
+[How to run a Docker Virtual Host?](#Run-Docker-Virtual-Host)
 
 
 <br>
@@ -118,21 +185,21 @@ DB_HOST=xxx.xxx.xxx.xxx
 <br>
 *Make sure you are in the `docker` folder before running the `docker-compose` command.*
 
-> Running PHP, NGINX and MySQL:
+> Running PHP, NGINX, MySQL and Redis:
 
 ```bash
-docker-compose up -d   php nginx mysql
+docker-compose up -d  php nginx mysql redis
 ```
 
 Note: you can choose your own combination of software's (containers), another example:
 
-> Running PHP, NGINX, Postgres and Redis:
+> Running PHP, NGINX, Postgres and Memcached:
 
 ```bash
-docker-compose up -d   php nginx postgres redis
+docker-compose up -d  php nginx postgres memcached
 ```
 
-Supported Containers: `php`, `nginx`, `mysql`, `postgres`, `redis`, `data`.
+Supported Containers: `nginx`, `mysql`, `redis`, `postgres`, `mariadb`, `memcached`, `beanstalkd`, `beanstalkd-console`, `data`, `php`.
 
 <br>
 3 - Open your browser and visit your `{Docker-IP}` address (`http://xxx.xxx.xxx.xxx`).
@@ -172,10 +239,12 @@ docker-compose stop
 
 To stop single container do:
 
-```php
+```bash
 docker-compose stop {container-name}
 ```
 
+
+
 <br>
 <a name="Delete-all-existing-Containers"></a>
 #### Delete all existing Containers
@@ -197,12 +266,127 @@ If you do any change to any `dockerfile` make sure you run this command, for the
 ```bash
 docker-compose build
 ```
-Optionally you can specify which container to rebuild (instead of rebuilding all the containers), example rebuilding `PHP`:
+Optionally you can specify which container to rebuild (instead of rebuilding all the containers):
+
+```bash
+docker-compose build {container-name}
+```
+
+
+
+
+<br>
+<a name="Change-the-PHP-Version"></a>
+#### Change the PHP Version
+By default **PHP 7.0** is running.
+<br>
+To change the default PHP version:
+
+1 - Open the `docker-compose.yml`.
+
+2 - Search for `Dockerfile-php-70` in the PHP container section.
+
+3 - Change the version number. 
+<br>
+Example to select version 5.6 instead of 7.0 you have to replace `Dockerfile-php-70` with `Dockerfile-php-56`.
+
+Sample: 
+
+```txt
+php:
+    build:
+        context: ./php
+        dockerfile: Dockerfile-php-70
+```
+
+Supported Versions:
+
+- For (PHP 7.0.*) use `Dockerfile-php-70`
+- For (PHP 5.6.*) use `Dockerfile-php-56`
+- For (PHP 5.5.*) use `Dockerfile-php-55`
+
+
+4 - Finally rebuild the container
 
 ```bash
 docker-compose build php
 ```
 
+For more details visit the [official PHP docker images](https://hub.docker.com/_/php/).
+
+
+<br>
+<a name="Add-Docker-Images"></a>
+#### Add more Software's (Docker Images)
+
+To add an image (software), just edit the `docker-compose.yml` and add your container details, to do so you need to be familiar with the [docker compose file syntax](https://docs.docker.com/compose/compose-file/).
+
+
+
+<br>
+<a name="Edit-Container"></a>
+#### Edit default container configuration
+Open the `docker-compose.yml` and change anything you want.
+
+Examples: 
+
+Change MySQL Database Name:
+
+```yml
+  environment:
+    MYSQL_DATABASE: laradock
+```
+
+Change Redis defaut port to 1111:
+
+```yml
+  ports:
+    - "1111:6379"
+```
+
+
+
+<br>
+<a name="Use-custom-Domain"></a>
+#### Use custom Domain (instead of the Docker IP)
+
+Assuming your custom domain is `laravel.dev` and your current `Docker-IP` is `xxx.xxx.xxx.xxx`.
+
+1 - Open your `/etc/hosts` file and map your `Docker IP` to the `laravel.dev` domain, by adding the following:
+
+```bash
+xxx.xxx.xxx.xxx    laravel.dev
+```
+
+2 - Open your Laravel's `.env` file and replace the `127.0.0.1` default values with your `{Docker-IP}`.
+<br>
+Example:
+
+```env
+DB_HOST=xxx.xxx.xxx.xxx
+```
+
+3 - Open your browser and visit `{http://laravel.dev}`
+
+
+
+Optionally you can define the server name in the nginx config file, like this:
+
+```
+server_name laravel.dev;
+```
+
+
+
+
+<br>
+<a name="View-the-Log-files"></a>
+#### View the Log files 
+The Log files are stored in the `docker/logs` directory.
+
+
+
+
 
 <br>
 <a name="Use-Redis"></a>
@@ -245,93 +429,11 @@ composer require predis/predis:^1.0
 5 - You can manually test it from Laravel with this code:
 
 ```php
-\Cache::store('redis')->put('laradock', 'awesome', 10);
+\Cache::store('redis')->put('LaraDock', 'Awesome', 10);
 ```
 
 
 
-<br>
-<a name="Use-custom-Domain"></a>
-#### Use custom Domain (instead of the Docker IP)
-
-Assuming your custom domain is `laravel.dev` and your current `Docker-IP` is `xxx.xxx.xxx.xxx`.
-
-1 - Open your `/etc/hosts` file and map your `Docker IP` to the `laravel.dev` domain, by adding the following:
-
-```bash
-xxx.xxx.xxx.xxx    laravel.dev
-```
-
-2 - Open your Laravel's `.env` file and replace the `127.0.0.1` default values with your `{Docker-IP}`.
-<br>
-Example:
-
-```env
-DB_HOST=xxx.xxx.xxx.xxx
-```
-
-3 - Open your browser and visit `{http://laravel.dev}`
-
-
-
-Optionally you can define the server name in the nginx config file, like this:
-
-```
-server_name laravel.dev;
-```
-
-
-
-<br>
-<a name="Change-the-PHP-Version"></a>
-#### Change the PHP Version
-By default **PHP 7.0** is running.
-<br>
-To change the default PHP version:
-
-1 - Open the `dockerfile` of the `php` folder.
-
-2 - Change the PHP version number in the first line,
-
-```txt
-FROM php:7.0-fpm
-```
-
-Supported Versions:
-
-- For (PHP 7.0.*) use `php:7.0-fpm`
-- For (PHP 5.6.*) use `php:5.6-fpm`
-- For (PHP 5.5.*) use `php:5.5-fpm`
-
-For more details visit the [official PHP docker images](https://hub.docker.com/_/php/).
-
-
-<br>
-<a name="Add-Docker-Images"></a>
-#### Add more Software's (Docker Images)
-
-To add an image (software), just edit the `docker-compose.yml` and add your container details, to do so you need to be familiar with the [docker compose file syntax](https://docs.docker.com/compose/compose-file/).
-
-
-
-<br>
-<a name="Edit-a-Docker-Container"></a>
-#### Edit a Docker Container (change Ports or Volumes)
-To modify a container you can simply open the `docker-compose.yml` and change everything you want.
-
-Example: if you want to set the MySQL port to 3333, just replace the default port with yours:
-
-```yml
-  ports:
-    - "3333:3306"
-```
-
-
-
-<br>
-<a name="View-the-Log-files"></a>
-#### View the Log files 
-The Log files are stored in the `docker/logs` directory.
 
 
 <br>
@@ -340,20 +442,12 @@ The Log files are stored in the `docker/logs` directory.
 
 1 - first list the current running containers with `docker ps`
 
-2 - enter any container with:
-
-Example: enter the `php` container
+2 - enter any container using:
 
 ```bash
-docker exec -it php bash
+docker exec -it {container-name-or-id} bash
 ```
-
-Example: enter the `nginx` container
-
-```bash
-docker exec -it nginx bash
-```
-
+3 - to exit a container, type `exit`.
 
 
 <br>
@@ -363,6 +457,7 @@ To prevent a container (software) from running, open the `docker-compose.yml` fi
 
 
 
+
 <br>
 <a name="Edit-a-Docker-Image"></a>
 #### Edit a Docker Image

beanstalkd-console/Dockerfile

@@ -0,0 +1,15 @@
+FROM php:latest
+
+MAINTAINER Mahmoud Zalt <mahmoud@zalt.me>
+
+RUN apt-get update && apt-get install -y curl
+
+RUN curl -sL https://github.com/ptrofimov/beanstalk_console/archive/master.tar.gz | tar xvz -C /tmp
+RUN mv /tmp/beanstalk_console-master /source
+
+RUN apt-get remove --purge -y curl && apt-get autoclean && apt-get clean
+RUN rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
+
+EXPOSE 2080
+
+CMD bash -c 'BEANSTALK_SERVERS=$BEANSTALKD_PORT_11300_TCP_ADDR:11300 php -S 0.0.0.0:2080 -t /source/public'

beanstalkd/Dockerfile

@@ -0,0 +1,16 @@
+FROM phusion/baseimage:latest
+
+MAINTAINER Mahmoud Zalt <mahmoud@zalt.me>
+
+ENV DEBIAN_FRONTEND noninteractive
+ENV PATH /usr/local/rvm/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
+
+RUN apt-get update
+RUN apt-get install -y beanstalkd
+RUN apt-get clean && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
+
+VOLUME /var/lib/beanstalkd/data
+
+EXPOSE 11300
+
+CMD ["/usr/bin/beanstalkd"]

docker-compose.yml

@@ -1,11 +1,11 @@
 version: '2'
+
 services:
 
 ### Nginx Server Container ##################################
 
     nginx:
         build: ./nginx
-        container_name: nginx
         volumes_from:
             - php
         volumes:
@@ -18,8 +18,9 @@ services:
 ### PHP Container ###########################################
 
     php:
-        build: ./php
-        container_name: php
+        build:
+            context: ./php
+            dockerfile: Dockerfile-php-70
         volumes:
             - ../:/var/www/laravel
             - ./logs/php/:/usr/local/var/log
@@ -30,17 +31,17 @@ services:
 
     data:
         build: ./data
-        container_name: data
         volumes:
             - /var/lib/mysql
-            - /var/lib/postgresql/data
+            - /var/lib/postgres
+            - /var/lib/mariadb
             - /var/lib/redis
+            - /var/lib/memcached
 
 ### MySQL Container #########################################
 
     mysql:
         build: ./mysql
-        container_name: mysql
         volumes_from:
             - data
         ports:
@@ -57,7 +58,6 @@ services:
 
     postgres:
         build: ./postgres
-        container_name: postgres
         volumes_from:
             - data
         ports:
@@ -69,14 +69,61 @@ services:
         links:
             - php
 
+### MariaDB Container #######################################
+
+    mariadb:  
+        build: ./mariadb
+        volumes_from:
+            - data
+        ports:
+            - "3306:3306"
+        environment:
+            MYSQL_DATABASE: homestead
+            MYSQL_USER: homestead
+            MYSQL_PASSWORD: secret
+            MYSQL_ROOT_PASSWORD: root
+        links:
+            - php
+
 ### Redis Container #########################################
 
     redis:
         build: ./redis
-        container_name: redis
         volumes_from:
             - data
         ports:
             - "6379:6379"
+        links:
+            - php
+
+### Memcached Container #####################################
+
+    memcached:
+        build: ./memcached
+        volumes_from:
+            - data
+        ports:
+            - "11211:11211"
+        links:
+            - php
+
+### Beanstalkd Container ####################################
+
+    beanstalkd:
+        build: ./beanstalkd
+        ports:
+            - "11300:11300"
+        privileged: true
+        links:
+            - php
+
+### Beanstalkd-Console Container ############################
+
+    beanstalkd-console:
+        build: ./beanstalkd-console
+        ports:
+            - "2080:2080"
+        links:
+            - beanstalkd
 
 ### Add more Containers below ###############################

mariadb/Dockerfile

@@ -0,0 +1,7 @@
+FROM mariadb:latest
+
+MAINTAINER Mahmoud Zalt <mahmoud@zalt.me>
+
+CMD ["mysqld"]
+
+EXPOSE 3306

memcached/Dockerfile

@@ -0,0 +1,7 @@
+FROM memcached:latest
+
+MAINTAINER Mahmoud Zalt <mahmoud@zalt.me>
+
+CMD ["memcached"]
+
+EXPOSE 11211

mysql/Dockerfile

@@ -2,8 +2,6 @@ FROM mysql:latest
 
 MAINTAINER Mahmoud Zalt <mahmoud@zalt.me>
 
-VOLUME /var/lib/mysql
-
 CMD ["mysqld"]
 
 EXPOSE 3306

php/Dockerfile-php-55

@@ -1,16 +1,23 @@
-FROM php:7.0-fpm
+FROM php:5.5-fpm
 
 MAINTAINER Mahmoud Zalt <mahmoud@zalt.me>
 
 ADD ./laravel.ini /usr/local/etc/php/conf.d
 ADD ./laravel.pool.conf /usr/local/etc/php-fpm.d/
 
+RUN apt-get update && apt-get install \
+    libpq-dev -y \
+    curl
+
 # Install extensions using the helper script provided by the base image
 RUN docker-php-ext-install \
-    pdo_mysql
+    pdo_mysql \
+    pdo_pgsql
 
 RUN usermod -u 1000 www-data
 
+WORKDIR /var/www/laravel
+
 CMD ["php-fpm"]
 
 EXPOSE 9000

php/Dockerfile-php-56

@@ -0,0 +1,23 @@
+FROM php:5.6-fpm
+
+MAINTAINER Mahmoud Zalt <mahmoud@zalt.me>
+
+ADD ./laravel.ini /usr/local/etc/php/conf.d
+ADD ./laravel.pool.conf /usr/local/etc/php-fpm.d/
+
+RUN apt-get update && apt-get install \
+    libpq-dev -y \
+    curl
+
+# Install extensions using the helper script provided by the base image
+RUN docker-php-ext-install \
+    pdo_mysql \
+    pdo_pgsql
+
+RUN usermod -u 1000 www-data
+
+WORKDIR /var/www/laravel
+
+CMD ["php-fpm"]
+
+EXPOSE 9000

php/Dockerfile-php-70

@@ -0,0 +1,32 @@
+FROM php:7.0-fpm
+
+MAINTAINER Mahmoud Zalt <mahmoud@zalt.me>
+
+ADD ./laravel.ini /usr/local/etc/php/conf.d
+ADD ./laravel.pool.conf /usr/local/etc/php-fpm.d/
+
+RUN apt-get update && apt-get install \
+	libpq-dev -y \
+    curl \
+    libmemcached-dev
+
+# Install extensions using the helper script provided by the base image
+RUN docker-php-ext-install \
+    pdo_mysql \
+    pdo_pgsql
+
+# Install Memcached for php 7
+RUN curl -L -o /tmp/memcached.tar.gz "https://github.com/php-memcached-dev/php-memcached/archive/php7.tar.gz" \
+    && mkdir -p /usr/src/php/ext/memcached \
+    && tar -C /usr/src/php/ext/memcached -zxvf /tmp/memcached.tar.gz --strip 1 \
+    && docker-php-ext-configure memcached \
+    && docker-php-ext-install memcached \
+    && rm /tmp/memcached.tar.gz
+
+RUN usermod -u 1000 www-data
+
+WORKDIR /var/www/laravel
+
+CMD ["php-fpm"]
+
+EXPOSE 9000

postgres/Dockerfile

@@ -2,8 +2,6 @@ FROM postgres:latest
 
 MAINTAINER Ben M <git@bmagg.com>
 
-VOLUME /var/lib/postgresql/data
-
 CMD ["postgres"]
 
 EXPOSE 5432