Lumen Starter Template

This Laravel Lumen starter template is intended to be forked and used for new projects.

For details on how to contribute to this repo, please check out the contributing guide.

What's Included

• Latest version of Lumen
• Pre-configured docker-compose.yml that uses nginx, php-fpm and PostgreSQL
• Travis-CI integration:
  • checks psr-2 compliance (with phpcs)
  • runs phpunit tests within docker containers
  • pushes deploy-ready containers for develop, staging, master branches to DockerHub

Requirements

• Docker Toolbox
• GIT Version Control client

Setup TravisCI and DockerHub Integration

• Setup DockerHub repo mirroring repo/namespace of github project
• Setup travis-ci integration with env vars:
  • DOCKER_EMAIL
  • DOCKER_USERNAME
  • DOCKER_PASSWORD

Using This Repository

1. FORK this repo (do not clone)
2. Reference the contributing guide for running this application locally
3. After running locally docker exec -it $(docker ps -f name=fpm -q) php artisan clean:template to strip out example migrations, seeds, tests, etc...

FAQ

Is there a shortcut for running commands within specific containers?

Yes! Using an alias below, you can run commands in containers with dockerexc fpm php -v instead of docker exec -it $(docker ps -f name=fpm -q) php -v.

alias dockerexc='function _docker_exec(){ service=$1; shift; docker exec -it $(docker-compose ps -q ${service}) "$@" };_docker_exec'