Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/justintime50/nginx-php-docker
A lightweight combined Nginx/PHP-FPM Docker image.
https://github.com/justintime50/nginx-php-docker
docker docker-compose dockerfile image nginx php
Last synced: 2 months ago
JSON representation
A lightweight combined Nginx/PHP-FPM Docker image.
- Host: GitHub
- URL: https://github.com/justintime50/nginx-php-docker
- Owner: Justintime50
- License: mit
- Created: 2019-12-10T19:42:21.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2024-05-07T16:24:15.000Z (8 months ago)
- Last Synced: 2024-10-04T21:53:05.978Z (3 months ago)
- Topics: docker, docker-compose, dockerfile, image, nginx, php
- Language: Dockerfile
- Homepage: https://hub.docker.com/repository/docker/justintime50/nginx-php
- Size: 112 KB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Nginx/PHP-FPM Docker Image
A lightweight combined Nginx/PHP-FPM Docker image.
[](https://github.com/Justintime50/nginx-php-docker/actions)
[](https://hub.docker.com/repository/docker/justintime50/nginx-php)
[](https://hub.docker.com/repository/docker/justintime50/nginx-php)
[](LICENSE)
## Features
The following features work out of the box without any configuration:
- `bcmatch` is installed for math/currency functionality
- `composer` is installed for all your PHP dependencies
- `gd` is installed for image processing
- `msmtp` is installed and configured (see `config/msmtprc`) out of the box to send email to `Mailtrap`. Alternatively configure for your use-case in production
- `mysql_pdo` is installed as the driver for database connections
- `Nginx` serves as the web host and reverse proxy
- `npm` is installed for all your Node dependencies
- `PHP-FPM/OPcache` for fast performance in the browser and on the CLI
- `zip` is installed for items that may need that (Laravel)
## Platforms
This image offers platform support for the following architectures starting from image version `8`:
- `linux/amd64`
- `linux/arm/v7`
- `linux/arm64`
## Install
```bash
# Dockerfile
FROM: justintime50/nginx-php:latest
# docker-compose
image: justintime50/nginx-php:latest
```
## Usage
### Vanilla PHP and HTML
Place your `PHP` or `HTML` site files into `/var/www/html/public` inside the container to get started with this image. This can be achieved by using a volume in a `docker-compose` file or by copying them over in a `Dockerfile`. If you are using HTML instead of PHP, ensure you remove the `index.php` file so that your `index.html` file can take priority.
### Laravel
Place the root of your laravel project in `/var/www/html` so that the `public` folder of laravel lines up with the directory served by this nginx image (see `examples/laravel` for more details).
Want to give this image a spin? Simply run the following:
```bash
docker compose up -d
```
Once the container spins up, navigate to `http://localhost:8888` in a browser.
## Docker Tags
Tags for this image follow the syntax of `PHP_VERSION-IMAGE_VERSION`; for instance, a valid tag would be `8.2-16` signifying to use PHP v8.2 and the 16th version of this image (nginx config, Dockerfile, etc).
### PHP Versions
- `8.3` - uses the latest release on the PHP 8.3 Alpine track. (Starting with image version `18`)
- `8.2` - uses the latest release on the PHP 8.2 Alpine track. (Starting with image version `12`)
- `8.1` - uses the latest release on the PHP 8.1 Alpine track. (Starting with image version `9`)
- `8.0` - **DEPRECATED** uses the latest release on the PHP 8.0 Alpine track. (Dropped support with image version `19`)
- `7.4` - **DEPRECATED** uses the latest release on the PHP 7.4 Alpine track. (Dropped support with image version `19`)
### Image Versions (see CHANGELOG for more details)
- `20`
- `19`
- `18`
- `17`
- `16`
- `15`
- `14`
- `13`
- `12`
- `11`
- `10`
- `9`
- `8`
- `7`
### Standalone Tags
- `latest` - uses the latest release (main branch) of this image with all defaults.
- `dev` - the testing branch for this image. Do not use this tag in production.
## Development
**Note:** Alpine Linux does not keep old versions of packages. This image pins to the relative major version to try staying flexibile. Future builds may need to be altered if packages are no longer offered.
```bash
# Test nginx configuration
nginx -T
```
### Releasing
When releasing this project, cut a new GitHub tag/release that iterates the whole-number used (eg: 4, 5, 6, etc). We won't use semver here for simplicity when tagging images.
If you are adding a new PHP version, make sure to add it to the list in the GitHub Workflow files.
### Building New Versions
This image supports swapping in the version number of PHP with a value from the official `PHP-FPM Alpine` [tag list](https://hub.docker.com/_/php).
### Automated Builds
GitHub Actions will automatically build and push supported tags to Docker Hub on each new release. Additionally GitHub Actions will automatically build the `latest` tag on any push to the main branch. It is highly recommended that you use a versioned release of this image to avoid any transient changes introduced in any given `latest` build.
### Manual Builds
```bash
docker build -t justintime50/nginx-php:8.0-7 --build-arg PHP_VERSION=8.0 .
sudo docker push justintime50/nginx-php:8.0-7
```
### msmtp (Mail Client)
msmtp is configured to work with `Mailtrap` out of the box. There is also a gmail template that you can uncomment and use in production. Spin up this container, then run the following to send mail directly with msmtp:
```bash
echo -e "Subject: Test email from msmtp\r\n\r\nThis is a test email direct from msmtp" |msmtp --debug --from [email protected] -t [email protected]
```
You can also send mail with PHP which routes the emails through msmtp:
```bash
php -r "mail('[email protected]','Test email from PHP', 'This is a test email from PHP');"
```