https://github.com/devsazal/docker-nginx-php8-server
A Docker workflow that will setup PHP 8.0.5, MySQL 5.7.34, Nginx, Redis & MailHog
https://github.com/devsazal/docker-nginx-php8-server
Last synced: over 1 year ago
JSON representation
A Docker workflow that will setup PHP 8.0.5, MySQL 5.7.34, Nginx, Redis & MailHog
- Host: GitHub
- URL: https://github.com/devsazal/docker-nginx-php8-server
- Owner: DevSazal
- License: mit
- Created: 2021-07-13T20:15:34.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2022-11-10T00:47:42.000Z (over 3 years ago)
- Last Synced: 2025-03-29T04:51:37.495Z (over 1 year ago)
- Language: Dockerfile
- Size: 13.7 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Docker Nginx PHP Server
A pretty simplified Docker Compose workflow that sets up a LEMP network of containers for local Laravel/PHP development.
`php 8.0.5`
`MySQL 5.7.34`
`Nginx`
`Redis`
`MailHog`
## Usage ``
To get started, make sure you have [Docker installed](https://docs.docker.com/docker-for-mac/install/) on your system, and then clone this repository.
Next, navigate in your terminal to the directory you cloned this, and spin up the containers for the web server by running:
`docker-compose up -d --build nginx-server`
OR
`sudo docker-compose build && sudo docker-compose up -d nginx-server`
After that completes, follow the steps from the [server/README.md](server/README.md) file to get your Laravel project added in (or create a new blank one).
Bringing up the Docker Compose network with `nginx` instead of just using `up`, ensures that only our site's containers are brought up at the start, instead of all of the command containers as well. The following are built for our web server, with their exposed ports detailed:
- **nginx** - `:8000`
- **mysql** - `:3306`
- **php** - `:9000`
- **redis** - `:6379`
- **mailhog** - `:8025`
Three additional containers are included that handle Composer, NPM, and Artisan commands *without* having to have these platforms installed on your local computer. Use the following command examples from your project root, modifying them to fit your particular use case.
- `docker-compose run --rm composer update`
- `docker-compose run --rm npm run dev`
- `docker-compose run --rm artisan migrate`
## Persistent MySQL Storage
By default, whenever you bring up the Docker network, your MySQL data will be stored with `mysql` folder when the containers will run.
## Using BrowserSync with Laravel Mix
If you want to enable the hot-reloading that comes with Laravel Mix's BrowserSync option, you'll have to follow a few small steps. First, ensure that you're using the updated `docker-compose.yml` with the `:3000` and `:3001` ports open on the npm service. Then, add the following to the end of your Laravel project's `webpack.mix.js` file:
```javascript
.browserSync({
proxy: 'nginx',
open: false,
port: 3000,
});
```
From your terminal window at the project root, run the following command to start watching for changes with the npm container and its mapped ports:
```bash
docker-compose run --rm --service-ports npm run watch
```
That should keep a small info pane open in your terminal (which you can exit with Ctrl + C). Visiting [localhost:3000](http://localhost:3000) in your browser should then load up your Laravel application with BrowserSync enabled and hot-reloading active.
## MailHog
The current version of Laravel (8 as of today) uses MailHog as the default application for testing email sending and general SMTP work during local development. Using the provided Docker Hub image, getting an instance set up and ready is simple and straight-forward. The service is included in the `docker-compose.yml` file, and spins up alongside the webserver and database services.
To see the dashboard and view any emails coming through the system, visit [localhost:8025](http://localhost:8025) after running `docker-compose up -d nginx-server`.