https://github.com/congcoi123/docker-php-nginx
This project helps you quickly create a web development environment with PHP-FPM, Nginx, MySQL, and Redis.
https://github.com/congcoi123/docker-php-nginx
docker docker-compose mysql nginx php php-fpm redis web-development
Last synced: about 1 year ago
JSON representation
This project helps you quickly create a web development environment with PHP-FPM, Nginx, MySQL, and Redis.
- Host: GitHub
- URL: https://github.com/congcoi123/docker-php-nginx
- Owner: congcoi123
- License: mit
- Created: 2019-12-13T13:15:29.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-02-22T08:00:03.000Z (over 6 years ago)
- Last Synced: 2025-03-29T22:41:17.378Z (about 1 year ago)
- Topics: docker, docker-compose, mysql, nginx, php, php-fpm, redis, web-development
- Language: Shell
- Homepage: https://congcoi123.dev
- Size: 578 KB
- Stars: 6
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Overview
This project helps you quickly create a web development environment with [PHP-FPM](https://php-fpm.org/), [Nginx](https://www.nginx.com/), [MySQL](https://www.mysql.com/), and [Redis](https://redis.io/). The environment is based on [Amazon Linux 2](https://aws.amazon.com/amazon-linux-2/?nc1=h_ls).
## Technology
[Docker](https://www.docker.com/) is a set of the platform as service products that use
OS-level virtualization to deliver software in packages called
containers. Containers are isolated from one another and bundle
their own software, libraries and configuration files; they can
communicate with each other through well-defined channels.
## Test Environment
**Host machine**
- MacBook Pro (13-inch, 2017, Two Thunderbolt 3 ports)
- OS: macOS Mojave (10.14.2)
**Docker**
- Version: 2.1.0.4 (39773)
- Channel: stable
- Engine: 19.03.4
## License
This project is currently available under the [MIT](https://github.com/congcoi123/docker-php-nginx/blob/master/LICENSE) License.
## Installation
You can get the sources:
```sh
git clone https://github.com/congcoi123/docker-php-nginx.git
```
## Manual
### Project Structure
#### a. docker/ app cache db web
Include all of the environment’s settings by Docker for this project.
#### b. docker/gen/cache
>
Reference to Redis cache ‘s data. The data in this folder will be removed when the Redis’s container is destroyed.
#### c. docker/gen/data
>
Reference to MySQL ‘s data. The data in this folder will be removed when MySQL’s container is destroyed.
#### d. docker/gen/logs
>
Reference to all necessary logs by several services (Nginx, MySQL, PHP-fpm, Redis, Xhprof). The logging data will be removed with the destruction of the reference containers.
#### e. docker/gen/tmp
>
Reference to the `/tmp` folder in the application container.
#### f. docker/db/dump
This folder can be empty. Hold the dummy database for local testing.
#### g. docker/startup
Include all necessary scripts for setting up a development environment by Docker for this project. **`It must be seen first!`**
#### h. sample-app
Hold the project’s source code. All the changes here will be updated immediately to all services in containers.
#### i. .env
Hold the environment variables for the development environment.
#### j. docker-compose.yml
>
Define the services that make up your app. So they can be run together in an isolated environment.
### Scripts
Saved in the startup folder. Only `docker_setup.sh` script is necessary for this setup.
#### a. docker_setup.sh
>
Automatic setup of the development environment. Take about 10 minutes for all processes. You can check the log in your console screen.
#### b. access_application.sh
>
Quick access to the development’s container (`amazon-linux:2`)
#### c. access_nginx.sh
>
Quick access to the web service container (`nginx`)
#### d. env_setup.sh
>
This script is automatically called in the `docker_setup.sh` process. But you can use it manually for running a composer setting.
#### e. env_status.sh
>
Check the status of the current containers.
#### f. get_os_name.sh
>
Check the current OS’s name of your host machine.
#### g. mysql_migrations
>
Migrations all the scripts that hold in `/sample-app/migrations`
#### h. restart_application.sh
>
Restart the current application service. It can be helpful when you want to change some configurations in `php.ini` or `www.conf` (Please make the changes before restarting)
#### i. restart_nginx.sh
>
Restart the current web service (Nginx). It can be helpful when you want to change some configurations in `nginx.conf` file or any files in `web/conf/` folder
#### k. start
>
Start all services.
#### l. stop
>
Stop all services.
### Environment Variables
All the environment is saved in the `.env` file.
#### COMPOSE_PROJECT_NAME
The project’s name and identification. Please do not modify it.
#### WEB_PORT
Nginx service port, because of the containers and host machine share resources. So you can access the program by your browser. Just use: **`localhost:/`** . In my case, I can use **`localhost:8000/`**
#### WEB_SSL_PORT
Same with `WEB_PORT` but for SSL.
#### DB_PORT
For preventing conflict with your in-use port in your host machine, you can change the MySQL’s port.
- **Step 1:**
Change the `DB_PORT` definition with your new port.
- **Step 2:**
Make the change in `/docker/db/conf/my.cnf` file with the same new port.
#### FPM_PORT
For preventing conflict with your in-use port in your host machine, you can change the PHP-fpm port. FPM is a process manager to manage the FastCGI SAPI (Server API) in PHP. Basically, it replaces the need for something like SpawnFCGI . It spawns the FastCGI children adaptively (meaning launching more if the current load requires it). Otherwise, there's not much operating difference between it and FastCGI (The request pipeline from the start of the request to end is the same). It's just there to make implementing it easier.
- **Step 1:**
Change the `FPM_PORT` definition with your new port.
- **Step 2:**
Make the same change in `/docker/app/conf/www.conf` file at listen
definition.
- **Step 3:**
Make some changes in `/docker/web/conf/nginx.conf` . All the
`fastcgi_pass` definition must be set to new pattern **`sample_app:;`**
In my case is **`fastcgi_pass sample_app:9001;`**
### Start
Run the following instructions for the starting setup.
```sh
$cd /docker-php-nginx/docker/startup
$bash docker_setup.sh
```
### Notes
- When you get errors when running the database container, you can delete the old `docker/gen/data` folder and retry again
Please note that the data folder holds your real MySQL backup. But if it’s not important for you, it should be deleted (In some case, that folder make some troubles)
- Access the URL below for starting:
`http://localhost:< WEB_PORT >`
. In my case:
`http://localhost:8000`
> Happy coding !