https://github.com/trafex/docker-php-nginx

Docker image with PHP-FPM 8.3 & Nginx 1.26 on Alpine Linux
https://github.com/trafex/docker-php-nginx

alpine alpine-linux arm64 armv7 composer container containers docker docker-image nginx nginx-docker php php-fpm php8 php8-docker php83 php83-docker

Last synced: 24 days ago
JSON representation

Docker image with PHP-FPM 8.3 & Nginx 1.26 on Alpine Linux

• Host: GitHub
• URL: https://github.com/trafex/docker-php-nginx
• Owner: TrafeX
• License: mit
• Created: 2016-02-15T17:20:49.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2024-08-26T19:33:50.000Z (2 months ago)
• Last Synced: 2024-10-11T18:41:16.115Z (24 days ago)
• Topics: alpine, alpine-linux, arm64, armv7, composer, container, containers, docker, docker-image, nginx, nginx-docker, php, php-fpm, php8, php8-docker, php83, php83-docker
• Language: Dockerfile
• Homepage: https://hub.docker.com/r/trafex/php-nginx
• Size: 146 KB
• Stars: 1,374
• Watchers: 33
• Forks: 737
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Security: SECURITY.md

Awesome Lists containing this project

README

        
# Docker PHP-FPM 8.3 & Nginx 1.26 on Alpine Linux

Example PHP-FPM 8.3 & Nginx 1.26 container image for Docker, built on [Alpine Linux](https://www.alpinelinux.org/).

Repository: https://github.com/TrafeX/docker-php-nginx

* Built on the lightweight and secure Alpine Linux distribution

* Multi-platform, supporting AMD4, ARMv6, ARMv7, ARM64

* Very small Docker image size (+/-40MB)

* Uses PHP 8.3 for the best performance, low CPU usage & memory footprint

* Optimized for 100 concurrent users

* Optimized to only use resources when there's traffic (by using PHP-FPM's `on-demand` process manager)

* The services Nginx, PHP-FPM and supervisord run under a non-privileged user (nobody) to make it more secure

* The logs of all the services are redirected to the output of the Docker container (visible with `docker logs -f `)

* Follows the KISS principle (Keep It Simple, Stupid) to make it easy to understand and adjust the image to your needs

[![Docker Pulls](https://img.shields.io/docker/pulls/trafex/php-nginx.svg)](https://hub.docker.com/r/trafex/php-nginx/)

![nginx 1.26](https://img.shields.io/badge/nginx-1.26-brightgreen.svg)

![php 8.3](https://img.shields.io/badge/php-8.3-brightgreen.svg)

![License MIT](https://img.shields.io/badge/license-MIT-blue.svg)

## [![Trafex Consultancy](https://timdepater.com/logo/mini-logo.png)](https://timdepater.com?mtm_campaign=github)

I can help you with [Containerization, Kubernetes, Monitoring, Infrastructure as Code and other DevOps challenges](https://timdepater.com/?mtm_campaign=github).

## Goal of this project

The goal of this container image is to provide an example for running Nginx and PHP-FPM in a container which follows

the best practices and is easy to understand and modify to your needs.

## Usage

Start the Docker container:

    docker run -p 80:8080 trafex/php-nginx

See the PHP info on http://localhost, or the static html page on http://localhost/test.html

Or mount your own code to be served by PHP-FPM & Nginx

    docker run -p 80:8080 -v ~/my-codebase:/var/www/html trafex/php-nginx

## Versioning

Major or minor changes are always published as a [release](https://github.com/TrafeX/docker-php-nginx/releases) with correspondending changelogs.

The `latest` tag is automatically updated weekly to include the latests patches from Alpine Linux.

## Configuration

In [config/](config/) you'll find the default configuration files for Nginx, PHP and PHP-FPM.

If you want to extend or customize that you can do so by mounting a configuration file in the correct folder;

Nginx configuration:

    docker run -v "`pwd`/nginx-server.conf:/etc/nginx/conf.d/server.conf" trafex/php-nginx

PHP configuration:

    docker run -v "`pwd`/php-setting.ini:/etc/php83/conf.d/settings.ini" trafex/php-nginx

PHP-FPM configuration:

    docker run -v "`pwd`/php-fpm-settings.conf:/etc/php83/php-fpm.d/server.conf" trafex/php-nginx

_Note; Because `-v` requires an absolute path I've added `pwd` in the example to return the absolute path to the current directory_

## Documentation and examples

To modify this container to your specific needs please see the following examples;

* [Adding xdebug support](https://github.com/TrafeX/docker-php-nginx/blob/master/docs/xdebug-support.md)

* [Adding composer](https://github.com/TrafeX/docker-php-nginx/blob/master/docs/composer-support.md)

* [Getting the real IP of the client behind a load balancer](https://github.com/TrafeX/docker-php-nginx/blob/master/docs/real-ip-behind-loadbalancer.md)

* [Sending e-mails](https://github.com/TrafeX/docker-php-nginx/blob/master/docs/sending-emails.md)