laravel-hhvm-docker

A super fast, production hardened HHVM / PHP-7 Dockerfile served by Nginx forward proxy. See link for the why. Perfect for horizontally distributed Laravel applications run within a Docker container cluster.

Note due to issues with Boot2Docker and VirtualBox response times on a local environment (with these tools) is slightly degraded with local volumes enabled.

Note Installs hirak/prestissimo composer parallel install plugin. If you have issues with composer installs remove this plugin.

Stack

• HHVM (Facebooks PHP-7 runtime)
• Nginx (FastCGI web-server)
• Composer (PHP package manager)
• PHPUnit (PHP unit testing)

Usage

Preferably used in a horizontally scaled Docker container environment (such as docker-compose) run alongside other services such as Redis and MariaDB.

Docker

To create the base image andrewmclagan/nginx-hhvm-docker, execute the following command within the folder:

docker build -t andrewmclagan/nginx-hhvm-docker ./

Start your image binding the external ports 80 in all interfaces to your container:

docker run -d -p 80:80 andrewmclagan/nginx-hhvm-docker

Test your deployment:

curl http://localhost/

Docker Compose

Below is an example running Laravel in a distributed environment:

load_balancer:
    image: tutum/haproxy
    links:
        - web
    ports:
        - "80:80"   
        - "443:443"    

cache:
    image: bitnami/redis
    ports:
        - "6379:6379"        

database:
    image: bitnami/mariadb
    environment:
        - MARIADB_DATABASE=laravel 
        - MARIADB_PASSWORD=SecretPassword123
    ports:
        - "3306:3306"         

web:
    image: andrewmclagan/nginx-hhvm-docker
    volumes:
        - ./path/to/laravel:/var/www
    links:
        - database
        - cache
    environment:
        - APP_ENV=production
        - DB_DATABASE=laravel          
        - DB_PASSWORD=SecretPassword123  
        - VIRTUAL_HOST=laravel.local

Firstly lets scale the web servers, from your project execute:

docker-compose scale web=3

Now we boot the rest of the services by executing:

docker-compose up

Voila! simply visit laravel.local and you have a fully load-balanced, horizintally scaled application inferstructure!

NOTE: Make sure you add laravel.local to your hosts file if developing locally with the IP address of the docker-machine instance.

Configuration

We reccomend you create your own Dockerfile build, based upon this image.

Image is based upon the official nginx docker repository, see git repo for more information.