Skip to content

Latest commit

 

History

History
189 lines (131 loc) · 4.8 KB

README.md

File metadata and controls

189 lines (131 loc) · 4.8 KB
Raw

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: