twmbx / docker-mate

Local PHP development made easy

Docker Mate

For local PHP based project development

Easy-to-use Docker setup for local development by Docker Mate.

please note that this is intended for local development - deploying it to production is probably a bad idea

Features

• Fast configuration: Choose system, enter your project's name and maybe add a git
• Backup/Restore routines for the database
• MailHog: Catch all outgoing mail for easy mail debugging
• phpMyAdmin: Direct database access

Documentation

Please take a look into documentation.

Quick overview

Linux

• docker & docker-compose
• Configure your system to resolve .docker domains to 127.0.0.1 e.g. with dnsmasq

macOS

• For native docker installs you need to configure your system to resolve .docker domains to 127.0.0.1
• envsubstr for creating the env file & mkcert for SSL support

Usage

First time setup

1. git clone https://github.com/docker-mate/docker-mate.git your-project
2. cd your-project
3. Run make up and follow the instructions
4. Adjust your projects name (use kebap-case as this is also used for your local development domain)
5. Your new project should start and you should be greeted with the local URLs where you can access it
6. clone/put what-ever in app and app/web is document root

Starting, stopping etc

Run make up to start everything and all other make commands and how to extend them can be found in the documentation.