https://gitlab.com/paveljame/docker-lemp

development docker lemp

Last synced: 7 months ago
JSON representation

Host: gitlab.com
URL: https://gitlab.com/paveljame/docker-lemp
Owner: paveljame
License: mit
Archived: true
Created: 2019-08-02T14:47:22.896Z (about 6 years ago)
Default Branch: master
Last Synced: 2024-07-29T17:54:48.365Z (about 1 year ago)
Topics: development, docker, lemp
Stars: 0
Forks: 3
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

![hcrGX8b.png](https://i.imgur.com/hcrGX8b.png)

LEMP development envirement using Docker.

About • Packages versions • Usage • Author • License

## About

Are you tired of using MAMP, WAMP, LAMP, etc? A good alternative is Docker. It's easier to manage, it's easier to control, and there are no limits.
LEMP Docker is based on NGINX, PHP 7.3, MariaDB, phpMyAdmin, and Mailhog. You can customize Nginx configuration inside ./nginx/nginx.conf, you can do the same for PHP configuration inside the dockerfile. Support for non-ssl, and SSL protocol (self-signed).

## Packages versions
NGINX Mainline • PHP-FPM 7.3 - alpine • MariaDB latest • phpMyAdmin • Mailhog

### PHP Versions

I tested multiple PHP versions as listed below.

| PHP Version | OS Alpine |
|:---------------:|:-------------:|
| **5.6 FPM** | ✓ |
| **7.0 FPM** | ✓ |
| **7.1 FPM** | ✓ |
| **7.2 FPM** | ✓ |
| **7.3 FPM** | ✓ |

### Supported OS

| | |
|-|-|
| **Windows 10** | ✓ |
| **MacOS** | ✓ |
| **Linux** | ✓ |

## Usage

### Prerequisites

You need to have Docker installed. If you dont have it, you can grab it here

### Installation

You can download this project in two ways.

**Get the zip file - [Download Docker LEMP .zip](https://gitlab.com/paveljame/docker-lemp/-/archive/master/docker-lemp-master.zip).**

or just clone repository
```sh
git clone git@gitlab.com:paveljame/docker-lemp.git
```
### Controling containers - basic control

Starting containers
```sh
docker-compose up -d
```

Stoping containers
```sh
docker-compose stop
```

Stoping and destroying the containers
```sh
docker-compose down
```

### .env Configuration
Basic settings of the project can be changed inside the .env file.

**.env file containes variables for:**

### File structure

```sh
├── nginx
│ ├── cert.pem # SSL Cert
│ ├── key.pem # SSL Key
│ └── nginx.conf # Basic Nginx configuration
│
├── php-docker
│ ├── permissions.sh # Script to autogenerate env variables for user and group ID
│ ├── php-*_*.dockerfile # PHP dockerfiles for different versions with added addons
│ └── cron # Files needed for enabling cronjob
│ ├── crontab.txt # Your crontab file
│ └── supervisord.conf # Supervisor file that enables running cron and PHP services at the same time
├── logs
│ ├── nginx # NGINX logs
│ │ ├── access.log
│ │ └── error.log
│ ├── cron # cron log
│ │ └── cron.log
│ └── supervisord # supervisor log
│ └── supervisord.log
├── mysql # You can place SQL files here if you want to import them
│ └── dump.sql
│
├── www # Project files
│ └── index.php
│
├── .env
│
├── docker-compose.yml
│
└── README.md
```

### Ports

| Port | Description  |
|:---------------:|:-------------:|
| **80** | http |
| **443** | https |
| **3306**  | Database  |
| **8181** | Phpmyadmin|
| **25** | SMTP   |
| **8025**  | Mailhog |

## Specific setups

#### If you are using Linux as host

If you are using Linux as host os, and you have some issues with the php app, then you will need to add your user id and group id into .env file. You can do that in two ways:

**Running our script**
To run our script you just need to be in the root of the project, and enter this command in your terminal:

```sh
sh ./php-docker/permissions.sh
```
or

**Enter user id and group id manually**

Open .env file and you will see two variables **USER_ID** and **GROUP_ID**. To find out your user ID and group ID, you will need to enter ```id -u``` for user ID, and ```id -g``` for group ID into your terminal

```sh
# Permission settings (your user and group IDs)
#***************
USER_ID=1000
GROUP_ID=1000
```

**Update docker-compose file**

After that go inside the docker-compose.yml and uncomment ```# user: "${USER_ID}:${GROUP_ID}"``` inside the php services.

#### How to change PHP version?

Inside the .env file, you can find a section

```sh
# PHP version
# Add PHP version in the same style as shown bellow (7.3, 5.6, 7, etc)
#**************
PHP_VERSION=7.3
```
The default version of PHP is 7.3, but you can change it to any of the listed above. If you want to change the PHP version to 7.1, just make sure that this part of the .env file looks like this:

```sh
# PHP version
# Add PHP version in the same style as shown below (7.3, 5.6, 7, etc)
#**************
PHP_VERSION=7.1
```

If you change those settings before you run for the first time command ``` docker-compose up ``` then you don't need to do anything else, but if you make that change after you run that command you will need to run a command like this:

```sh
docker-compose up -d --force-recreate --build
```
All dockerfiles are located inside **php-docker **folder.

#### Using cron job inside the PHP container

In case you want to use a **cronjob inside the PHP container**, you can do this with the help of a dockerfile template located within the php-docker folder (**php-7.3-cron.dockerfile**).

There is currently only one template for PHP version 7.3 and you can activate it immediately within the .env file:

```sh
# PHP version
# Add PHP version in the same style as shown below (7.3, 5.6, 7, etc)
#**************
PHP_VERSION=7.3-cron

```

If you want a cronjob option on another version of PHP, just copy the existing dockerfile of the desired PHP version and add the part that applies to cron and supervisor.

```sh

# Create cron log files
RUN mkdir -p /var/log/cron \
&& touch /var/log/cron/cron.log \
&& touch /var/log/cron/crontab.log

# Copy our cronjob list
COPY ./cron/crontab.txt /cronjob.txt
RUN crontab /cronjob.txt

# Copy our supervisor config file
COPY ./cron/supervisord.conf /etc/supervisor/supervisord.conf

# Let's go
CMD ["/usr/bin/supervisord", "-c", "/etc/supervisor/supervisord.conf"]

```

Don't forget to remove ``` CMD ["php-fpm"] ``` from the new template, becaouse supervisior is taking care for that part.

Custom cronjobs can be defined inside the php-docer/cron/crontab.txt.
Supervisor (the tool that enables us to run multiple services in one container) config file is located inside the php-docer/cron/supervisord.conf

#### Using other special options inside the PHP container

In case there is a need to install special tools and php plugins, I have created additional predefined options within the dockerfile to install them. There is currently only one, but I will add more over the time.

**How to enable the installation of additional tools**

Open the dockerfile of your chosen PHP version, and on the top of the file you will see ARG defined:

```sh
FROM php:7.3-fpm-alpine
# You can add options for image instalation. See readme for more info
ARG OPTIONS=no
```

If you want to enable additional installation, just insert yes as an argument

```sh
FROM php:7.3-fpm-alpine
# You can add options for image instalation. See readme for more info
ARG OPTIONS=yes
```

**Existing options:**

**Wordpress:** Wordpress install will add new packages: ``` curl, mysql-client, less, zlib ``` and will enable php plugins: ``` pdo, pdo_mysql, mysqli, gd ```. Main tool that we are installing is [Wordpress CLI](https://wp-cli.org/). If you want to enable this option, just use ``` ARG wordpress=yes ```

### Other Tips

**Starting docker-compose with active logs shown in terminal**

Run containers with active output (showing logs and if you want to stop containers you need to press ctrl + c)
```sh
docker-compose up
```
----------
**Destroying containers and volumes**

By default, with ```docker-compose down```, the only things removed are:

- Containers for services defined in the Compose file
- Networks defined in the networks section of the Compose file
- The default network, if one is used

Source

If you want to remove volumes data too, just use:
```sh
docker-compose down -v
```

----------
**SSH to individual container**

If you want to have ssh access to some of the containers just use this template:
```sh
docker exec -it name-of-container /bin/bash
```
For example, if you want to have access to Nginx container with the default project name "dev":
```sh
docker exec -it dev_nginx /bin/bash
```
*NOTE: Alpine version of containers (in our case PHP and maihlog containers), you need to start this command with ``` /bin/ash ``` insted of ``` /bin/bash ```*

-----
**Getting IP address of individual container**

If you want to see the IP address of single container use this template:
```sh
docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' name-of-container
```
For example, if you want to see the Nginx container IP address with the default project name "dev":
```sh
docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' dev_nginx
```

-----
**Changing dockerfile**

If you change the dockerfile after you already run ```docker-compose up```, you will need to run this command if you want to build a new image
```sh
docker-compose build
```

or if you want to force new build and starting containers at the same time:
```sh
docker-compose up -d --force-recreate --build
```

-----
**Connecting to the database**

If you want to connect to the database, just use **db** (sometimes with added **:3306**) as host, not localhost!

## Author

**Bruno Pavelja**

[LinkedIn](https://www.linkedin.com/in/brunopavelja/) / [Twitter](https://twitter.com/Bruno_AFK) / [Gitlab](https://gitlab.com/bruno-afk) / [Github](https://github.com/BrunoAFK) / [Paveljame](https://pavelja.me)

## License

This project is using [MIT license](https://gitlab.com/paveljame/docker-lemp/blob/master/LICENSE)

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://gitlab.com/paveljame/docker-lemp

Awesome Lists containing this project

README

![hcrGX8b.png](https://i.imgur.com/hcrGX8b.png)

LEMP development envirement using Docker.