https://github.com/byjg/docker-php
A complete and small PHP Docker image based on Alpine Linux.
https://github.com/byjg/docker-php
apache docker fpm nginx php php56 php7 php7-fpm php71 php72 php73 php74 php8 php8-fpm
Last synced: 3 months ago
JSON representation
A complete and small PHP Docker image based on Alpine Linux.
- Host: GitHub
- URL: https://github.com/byjg/docker-php
- Owner: byjg
- License: mit
- Created: 2016-11-19T17:36:46.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2025-03-14T15:58:47.000Z (4 months ago)
- Last Synced: 2025-04-09T20:02:31.336Z (3 months ago)
- Topics: apache, docker, fpm, nginx, php, php56, php7, php7-fpm, php71, php72, php73, php74, php8, php8-fpm
- Language: Python
- Homepage:
- Size: 391 KB
- Stars: 6
- Watchers: 2
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# PHP Docker Images ByJG
[](http://opensource.byjg.com)
[](https://github.com/byjg/docker-php/)
[](https://github.com/byjg/docker-php/actions/workflows/build.yml)
## Overview
A complete, lightweight, and versatile PHP Docker image collection based on Alpine Linux. These images are designed to be small, efficient, and ready to use in various environments.
### Key Features
- **Lightweight**: Based on Alpine Linux, with optimized image sizes (~135-154MB)
- **Multi-architecture support**: Runs on amd64 (x86_64) and arm64 (Raspberry PI, Graviton)
- **Multiple PHP versions**: From PHP 5.6 to the latest PHP 8.4
- **Variety of configurations**: Base, CLI, FPM, FPM-Nginx, and FPM-Apache variants
- **Pre-installed extensions**: 45+ PHP extensions included in all images
- **Development tools**: Composer, PHPUnit, PHP Code Sniffer, and more in CLI images
- **Production-ready**: Optimized for both development and production environments
## Documentation Index
- [Base Image](docs/image-base.md) - Minimal image with 45+ extensions
- [CLI Image](docs/image-cli.md) - Command-line tools for development
- [FPM Images](docs/image-fpm.md) - PHP-FPM, Nginx, and Apache variants
- [Environment Variables](docs/environment.md) - Configuration options
- [Building Custom Images](docs/building.md) - Create your own images
- [IDE Integration](docs/ide.md) - Using with your IDE
- [Dockerfile Reference](docs/dockerfile.md) - Dockerfile details
- [Tagging Convention](docs/tagging.md) - Understanding image tags
**See full documentation at: [https://opensource.byjg.com/devops/docker-php](https://opensource.byjg.com/devops/docker-php)**
A complete and small PHP Docker image based on Alpine Linux and run on the archictectures
- amd64 (x86_64)
- arm64 (Raspberry PI, Graviton, etc) - available after February 2021
The Docker ByJG PHP Images has several bundled images based on PHP in different versions.
The PHP images are ready to use in:
- Development Environment
- Production Environment
- CI/CD environments (like Travis-CI, Circle-CI, Jenkis, Bitbucket Pipelines, and others)
- [IDE Integration](docs/ide.md)
## PHP Versions Available
| Version | Latest Version | Monthly Builds | Alpine Version |
|:-------:|:--------------:|:--------------:|:--------------:|
| **8.4** | **8.4.5** | **yes** | **edge** |
| **8.3** | **8.3.18** | **yes** | **edge** |
| **8.2** | **8.2.28** | **yes** | **edge** |
| 8.1 | 8.1.31 | - | 3.19 |
| 8.0 | 8.0.30 | - | 3.16 |
| 7.4 | 7.4.33 | - | 3.15 |
| 7.3 | 7.3.33 | - | 3.12 |
| 7.2 | 7.2.33 | - | 3.9 |
| 7.1 | 7.1.33 | - | 3.7 |
| 7.0 | 7.0.33 | - | 3.5 |
| 5.6 | 5.6.40 | - | 3.8 |
Notes:
- PHP Images with no monthly builds are not updated anymore and there is no support.
- PHP images using the edge base image are suitable for production. However, they may receive package updates. If you extend these images by adding more packages, those packages may not be available in future updates.
## PHP Images
Five different images for each PHP Version
- [base](docs/image-base.md) - Minimal Image, base for the other
- [cli](docs/image-cli.md) - PHP with Command Line installed (composer, phpunit, etc)
- [fpm](docs/image-fpm.md) - PHP with FPM installed
- [fpm-apache](docs/image-fpm.md) - PHP and Apache using FPM
- [fpm-nginx](docs/image-fpm.md) - PHP and Nginx using FPM
## Image Tag Convention
Since January 2021 de tag convention is:
```
byjg/php:-[-YYYY.MM]
```
Where:
- PHP_VERSION: It is `.`, e.g `8.2`
- TYPE: It is `base`, `cli`, `fpm`, `fpn-nginx`, `fpm-apache`
- YYYY: The Year of the Build
- MM: The month of the build.
The images without YYYY-MM can be updated to the latest PHP version and new features.
The images with YYYY-MM are immutable
e.g.
```
byjg/php:8.3-fpm
byjg/php:8.3-fpm-2024.10
```
## Environment variables
[Here](docs/environment.md) a list of environment variables.
## Image Sizes
Below a table with images uncompressed
| Build Type | Uncompressed Size |
|:-----------|------------------:|
| base | ~135MB |
| cli | ~154MB |
| fpm | ~139MB |
| fpm-nginx | ~154MB |
| fpm-apache | ~154MB |
## Building your own image
Detailed instructions can be found [here](docs/building.md).
----
[Open source ByJG](http://opensource.byjg.com)