PHP Docker

Create PHP Applications in a Docker Container

To-Do

• Add redis/redis-stack so that you can use RedisInsight to visualize your data
• [ ]

This setup spools up the following containers:

• mariadb (10.3)
• postgresql (12.0)
• nginx (latest)
• php-fpm (php 8.1 with almost all modules)
• mailhog (latest)
• phpmyadmin (latest)
• redis (7.0)
• memcached (1.6.17)
• composer (2.5.1)

To use different docker image tags:

• mariadb - use any version from 10.3 to latest
• postgresql - use any version from 12-alpine to latest
• nginx - use any version of nginx:alpine
• php-fpm - use any version from phpdockerio/php72-fpm to phpdockerio/php81-fpm
• phpmyadmin - use any version of phpmyadmin
• redis - use any version of bitnami/redis
• memcached - use any version of bitnami/memcached

Getting started

For Windows users run docker login -u yourdockerhubusername -p yoursecretpassword before starting

For those looking to get started in 60 sec using just the defaults (which are fine for dev) do the following:

1. Create the following folder structure

• Put your php app inside the project folder

• and the files from this repo into the docker folder

  source/
  ├── docker/ # git clone https://github.com/josephgodwinkimani/php-docker.git docker
  └── project/
  
  

  If you want to do that all from commandline...

  cd ~/Projects
  mkdir source
  mkdir source/project

  And then to simultaneously download the latest master file, unpack it, stuff it into a folder named docker, and clone the .env file ... run this...

  cd source
  curl -Lo docker.zip https://github.com/josephgodwinkimani/php-docker/archive/master.zip && \
  unzip docker.zip && \
  mv docker-master docker && \
  cp docker/.env.sample docker/.env
  rm docker.zip

3. Change database values in your .env

By default the .env file will contain the following

MYSQL_ROOT_PASSWORD=root
MYSQL_DATABASE=project
MYSQL_USER=project
MYSQL_PASSWORD=project
POSTGRESQL_USER=postgres
POSTGRESQL_ROOT_PASSWORD=project
POSTGRESQL_DATABASE=project

Docker Compose will automatically replace things like ${MYSQL_USER} in the docker-compose.yml file with whatever corresponding variables it finds defined in .env

You can configure MySQL overrides by editing /mysql/my.cnf

Using mysql cli

$ docker exec -it mysql /usr/bin/mysql -u root -p project

4. Start the docker container

```bash
$ cd ~/Projects/source/docker
$ docker-compose up
```

5. Adding your first PHP project

If you're creating a new php app using a framework, follow the steps under PHP Frameworks below

Go to localhost:8180 and your PHP app will be live.

For Windows users you need to create a folder project/webroot then place any frameworks and files here to be served. For Laravel or Lumen you can always place the public folder files in project/webroot and app files inside project/app for example. Remember to change the file links in project/webroot/index.php

6. Accessing your database

You can access your MySQL database from phpmyadmin on

http://localhost:8080/

Whereas other databases you can access from adminer on

http://localhost:8282/

To add adminer plugins and css, add them like this:

source/
├── docker/ # git clone https://github.com/josephgodwinkimani/php-docker.git docker
├── adminer/  # add adminer.css here https://github.com/vrana/adminer/tree/master/designs
│   └── plugins-enabled   # add adminer plugins here such as tinymce etc https://www.adminer.org/pl/plugins/
└── project/

7. Entering the PHP container

$ docker exec -it php-fpm /bin/bash

8. Accessing MailHog

This is just a built-in mail server you can use to 'send' and intercept mail coming from your application.

You can access the Web GUI (using the defaults) for mailhog at

http://localhost:8125

9. Accessing Redis

$ docker exec -it docker_redis_1 redis-cli
# monitor keys
127.0.0.1:6379> monitor
# to view logs
$ docker-compose logs redis

PHP Frameworks

Most of the time I set this up without an existing CakePHP app. This will cause the initial up command to fail because folders are missing. To solve this run the install command (from the official CakePHP docs) but set the app name to . instead of project.

Start a CakePHP/Laravel/Lumen/LeafPHP project

cd ~/Projects/source
$ docker exec -it php-fpm /bin/bash

and then, inside the PHP Container

$ composer create-project --prefer-dist cakephp/app:~4.0 . 
$ composer create-project --prefer-dist laravel/laravel . "5.6.*"
$ composer create-project --prefer-dist laravel/lumen .
$ composer create-project leafs/api .

Next, fix the database connection configurations in respective frameworks.

Visit http://localhost:8180 or whatever you set nginx to respond to.

Extra tweaks for your Laravel/Lumen/LeafPHP project

1. Environment configuration for MySQL or PostgreSQL

DB_CONNECTION=mysql or pgsql
DB_HOST=172.18.0.1 # use network gateway this maybe 172.17.0.1 or 172.18.0.1. The exact IP address may be different on your system.
DB_PORT=8106 or 5004 # what you set in docker compose config file for either postgresql or mariadb
DB_DATABASE=project # mysql or pgsql database we created on creating the container
DB_USERNAME=root 
DB_PASSWORD=root