, (*1)
Golem
Long story short: I got a pretty damn good name for an app and I need something to build around it. No clue. So I decided to make yet another Docker bootstrap for PHP. Just to have a running environment with PHP, apache and mysql in a few commands. I usually do this when I need to do some small stuff, playgrounds, package testing, that needs a fast boostrap., (*2)
Since is a Composer plugin, it can be used on existing projects as long as these files and directories does not exist:
* ./Makefile
* ./docker-compose.yml
* ./build/docker
, (*3)
It will fail otherwise., (*4)
Usage
Is a Composer plugin, so just require it in your project., (*5)
composer require --dev utnaf/golem
What I have?
You have:
- php:7.3-apache
Docker image with a virtual host configured on http://app.local
- latest Composer version
- mariadb:10.3
Docker image
- a Makefile
to easily handle your docker images, (*6)
How do I make it work?
Just run:, (*7)
$ make up
Now you can visit http://localhost or add an entry to your /etc/hosts
file:, (*8)
127.0.0.1 app.local
and then visit http://app.local, (*9)
Note for docker-machine user
If you are using any kind of docker-machine please replace 127.0.0.1
with the IP of your docker-machine., (*10)
Connect to the DB
Your DB host will be named <project dir>_database
, the database itself is <project dir>_db
, username and password can be found in the docker-compose.yml
., (*11)
Ex: if your project is in the directory my-awesome-project
the db hostname will be myawesomeproject_database
and the DB myawesomeproject_db
., (*12)
Makefile
There is a Makefile that allows you to easily interact with the docker container., (*13)
bash
$ make up
$ make kill
$ make build
$ make reset
$ make composer [command]
$ make sh
, (*14)
Disclaimer
I'm not an expert in Docker, but this is working good for me. In any case please feel free to contribute in improving this if you feel the need by writing an issue. Any help or comment is highly appreciated., (*15)