Dockervel

A complete Laravel development environment in Docker Containers

Update (11/18): Now with PHP7 & Unit test support

Bring Up a Laravel development environment with a single command easy as dup
Execute Artisan commands easy as dartisan make:auth
Run Composer command easy as dcomposer update
Run NodeJS script easy as dnodejs npm install
Run gulp watch easy as dgulp-watch
Containers managed with docker-compose
Lightweight as it is mostly based in Linux Alpine base image of 5MB.
Using Docker-composer version 2 (new)

Containers included

Nginx 1.14 & PHP 7.2 running in Alpine
MySQL running in Alpine
Redis running in Alpine
Composer PHP running in Alpine.
Artisan running in Alpine
NodeJS with gulp, grunt and bower -g installed in official node:4.2.2-slim base image
Volumes mounted as containers

Usage

Make sure you have docker docker-machine and docker-compose installed. See here for installing them

clone this repo: git clone https://github.com/SpiralOutDotEu/dockervel.git
cd in: cd dockervel
run as su: sudo su
add aliases: . ./aliases.sh
run: dup

and you have a server running! Hit localhost in your browser and you will see nginx fault message becasuse there is no www/public/index.php.

create new Laravel project: dcomposer-create
or create new Lumen project: dcomposer-create-lumen
fix permissions: dpermit
change .env: see below for options
run artisan commands: dartisan make:auth , dartisan migrate
fix permissions: dpermit

Now you have a registration system active. Go to localhost and register a new user to see that db's are running ok.

npm install: dnodejs npm install
gulp install: dnodejs gulp install
gulp watch: dulp-watch

Now there is one container running gulp watch and monitors changes on files according your gulpfile.js

Run PhpUnit test with dunit

aliases

aliases.sh contains shortcuts to common commands. run dot space dot /aliases.sh to activate aliases for this terminal session.

 . ./aliases.sh

and now for this terminal session you have aliases like dartisan, dcomposer, dnodejs, dup, dstop, dunit.

If you don't want to work with aliases, open the script and see the coressponding commands next to each alias. In the following document it is supposed that you have executed aliashes.sh as su and you have the aliases active.

Create new Laravel Project

create new laravel project: dcomposer-create
type localhost in your browser and you see the Laravel welcome screen

or Create new Lumen Project

create new laravel project: dcomposer-create-lumen
type localhost in your browser and you see the Lumen welcome screen

Fix permitions

since containers have different user in them, you have to change the permisions in www/ folder to be able to write. type:

 dpermit

it will simply chmod -R 777 www Remember to run dpermit after each time the www folder has a new file.

Configure Laravel for mysql

change DB_HOST in .env to point to mysql. This is the name that it is used in docker-compose.yml (link: -mysql:mysql)

DB_HOST=mysql
DB_DATABASE=homestead
DB_USERNAME=homestead
DB_PASSWORD=secret

Configure Laravel for redis

change REDIS_HOST in .env to point to predis. This is the name that it is used in docker-compose.yml (link: -redis:predis).

REDIS_HOST=predis
REDIS_PASSWORD=null
REDIS_PORT=6379

in Laravel 5.2 there are some issues with redis namespace, so to avoid conflicts predis is used. Also you have to change /config/app.php, and replace:

'Redis'     => Illuminate\Support\Facades\Redis::class,

with

'LaravelRedis'     => Illuminate\Support\Facades\Redis::class,

Use it like:

$redis= LaravelRedis::connection();
$redis->set('name', 'myname');
$redis->get('name');

Running Artisan commands

type dartisan followed by an artisan command

example:
$ dartisan make:auth
$ dartisan migrate
$ dartisan tinker

Running composer commands

type dcomposer followed by a composer command

example:
$ dcomposer update
$ dcomposer require predis/predis

Nodejs

to install node modules in your project run

dnodejs npm install

Gulp

install gulp with:

dnodejs gulp install:

run gulp once:

dgulp

add gulp watch:

dgulp-watch

Credits

Thanx to:

Cheap and reliable Node.js hosting starts at $3/month, and $1/month static HTML hosting

SpiralOutDotEu / dockervel

Programming Languages

Labels

Projects that are alternatives of or similar to dockervel