Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yannoff/docker-php-fpm
A set of highly configurable PHP-FPM images based on PHP Alpine version, enriched with composer
https://github.com/yannoff/docker-php-fpm
alpine alpine-linux composer docker dockerhub fpm offenbach php php-extensions php-fpm
Last synced: about 2 months ago
JSON representation
A set of highly configurable PHP-FPM images based on PHP Alpine version, enriched with composer
- Host: GitHub
- URL: https://github.com/yannoff/docker-php-fpm
- Owner: yannoff
- License: mit
- Created: 2017-10-21T10:49:53.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-07-12T16:21:03.000Z (6 months ago)
- Last Synced: 2024-07-12T18:32:00.356Z (6 months ago)
- Topics: alpine, alpine-linux, composer, docker, dockerhub, fpm, offenbach, php, php-extensions, php-fpm
- Language: Dockerfile
- Homepage:
- Size: 146 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# yannoff/docker-php-fpm
Home for [yannoff/php-fpm dockerhub repository](https://hub.docker.com/repository/docker/yannoff/php-fpm "dockerhub") sources.
A [PHP-FPM](http://php.net/manual/fr/install.fpm.php "PHP FastCGI Process Manager") [docker](https://www.docker.com/ "docker") image based on [Alpine](https://alpinelinux.org/ "Alpine Linux"), with [composer](https://getcomposer.org/ "composer") and [offenbach](https://github.com/yannoff/offenbach) installed.
## Available tags
- [8.4-rc-fpm-alpine](https://github.com/yannoff/docker-php-fpm/blob/master/8.4-rc/Dockerfile)
, [8.4-rc](https://github.com/yannoff/docker-php-fpm/blob/master/8.4-rc/Dockerfile)
- [8.3-fpm-alpine](https://github.com/yannoff/docker-php-fpm/blob/master/8.3/Dockerfile)
, [8.3](https://github.com/yannoff/docker-php-fpm/blob/master/8.3/Dockerfile)
- [8.2-fpm-alpine](https://github.com/yannoff/docker-php-fpm/blob/master/8.2/Dockerfile)
, [8.2](https://github.com/yannoff/docker-php-fpm/blob/master/8.2/Dockerfile)
- [8.1-fpm-alpine](https://github.com/yannoff/docker-php-fpm/blob/master/8.1/Dockerfile)
, [8.1](https://github.com/yannoff/docker-php-fpm/blob/master/8.1/Dockerfile)
- [8.0-fpm-alpine](https://github.com/yannoff/docker-php-fpm/blob/master/8.0/Dockerfile)
, [8.0](https://github.com/yannoff/docker-php-fpm/blob/master/8.0/Dockerfile) **(1)**
- [7.4-fpm-alpine](https://github.com/yannoff/docker-php-fpm/blob/master/7.4/Dockerfile)
, [7.4](https://github.com/yannoff/docker-php-fpm/blob/master/7.4/Dockerfile) **(1)**
- [7.3-fpm-alpine](https://github.com/yannoff/docker-php-fpm/blob/master/7.3/Dockerfile)
, [7.3](https://github.com/yannoff/docker-php-fpm/blob/master/7.3/Dockerfile) **(1)**
- [7.2-fpm-alpine](https://github.com/yannoff/docker-php-fpm/blob/master/7.2/Dockerfile)
, [7.2](https://github.com/yannoff/docker-php-fpm/blob/master/7.2/Dockerfile) **(1)**
- [7.1-fpm-alpine](https://github.com/yannoff/docker-php-fpm/blob/master/7.1/Dockerfile)
, [7.1](https://github.com/yannoff/docker-php-fpm/blob/master/7.1/Dockerfile) **(1)**
- [7.0-fpm-alpine](https://github.com/yannoff/docker-php-fpm/blob/master/7.0/Dockerfile)
, [7.0](https://github.com/yannoff/docker-php-fpm/blob/master/7.0/Dockerfile) **(1)**
- [5.6-fpm-alpine](https://github.com/yannoff/docker-php-fpm/blob/master/5.6/Dockerfile)
, [5.6](https://github.com/yannoff/docker-php-fpm/blob/master/5.6/Dockerfile) **(1)**
- [5.5-fpm-alpine](https://github.com/yannoff/docker-php-fpm/blob/master/5.5/Dockerfile)
, [5.5](https://github.com/yannoff/docker-php-fpm/blob/master/5.5/Dockerfile) **(1)**
> **(1)** _Those PHP versions have now reached their [EOL](https://www.php.net/eol.php)._
## Usage
- [Dynamically build images](#building-custom-images) for a fine-tuned docker stack
- [Use pre-compiled images](#using-base-images) to run on-the-fly, one-shot commands
### Building custom images
_Dynamic builds allow for flexible, fine-tuned and featherweight images._
_The recommended way is to [use the repository URL](https://docs.docker.com/engine/reference/commandline/build/#git-repositories) as build context._
_**Example:** Integration in a [docker-compose](https://docs.docker.com/compose/compose-file/) stack_
- PHP version `8.0`
- `gd` and `imap` extensions
- `patch` extra package install
- `Europe/Rome` as timezone
- `laravel/installer` as a composer global package
- `latest-preview` version of composer
```yaml
# docker-compose.yaml
fpm:
build:
context: https://github.com/yannoff/docker-php-fpm.git#:8.0
args:
TZ: Europe/Rome
PHP_EXTS: gd imap
APK_EXTRA: patch
PHP_LIBS: laravel/installer
COMPOSER_VERSION: latest-preview
```
*Alternatively, building from the command-line:*
```bash
docker \
build \
-t php8.0 \
--build-arg TZ="Europe/Rome" \
--build-arg PHP_EXTS="gd imap" \
--build-arg APK_EXTRA=patch \
--build-arg PHP_LIBS=laravel/installer \
--build-arg COMPOSER_VERSION=latest-preview \
[email protected]:yannoff/docker-php-fpm.git#:8.0
```
#### Build arguments reference
The following [build arguments](https://docs.docker.com/engine/reference/commandline/build/#set-build-time-variables---build-arg) are available:
| Build arg | Description | Defaults
|--- |--- |---
| `TZ` | The timezone to use for the container | `UTC`
| `PHP_EXTS` | PHP extensions to be installed **(2)** | `pdo_mysql pdo_pgsql intl opcache bcmath`
| `APK_BASE` | Base [alpine](https://pkgs.alpinelinux.org/packages) packages to be installed | `bash git vim`
| `APK_EXTRA`| Extra [alpine](https://pkgs.alpinelinux.org/packages) packages to be installed | -
| `PHP_LIBS` | PHP libraries to be installed as composer global dependencies | -
| `COMPOSER_VERSION` | Specific [composer](https://getcomposer.org/download/) version to be installed **(3)** | `2.2.24`
| `OFFENBACH_VERSION` | Alternative [offenbach](https://github.com/yannoff/offenbach) version to be installed **(4)** | `latest`
| `OFFENBACH_FILENAME` | Alternative name for the [offenbach](https://github.com/yannoff/offenbach) executable | `offenbach`
| `OFFENBACH_INSTALL_DIR` | Install dir for the [offenbach](https://github.com/yannoff/offenbach) executable | `/usr/bin`
> **(2)** _See the [mlocati/docker-php-extension-installer](https://github.com/mlocati/docker-php-extension-installer#supported-php-extensions) repository for the full list of supported extensions._
> **(3)** _May be `latest-preview`, `latest-stable`, or an exact version - eg: `2.4.0`._
> **(4)** _The version **must be** an exact version, eg: `1.6.2`. If left empty, the `latest` release will be used._
### Using base images
_On the other hand, the base pre-compiled images from [dockerhub](https://hub.docker.com/repository/docker/yannoff/php-fpm "dockerhub") may be convenient to [run](https://docs.docker.com/engine/reference/run/) php or composer commands on the fly, providing a minimal PHP ecosystem._
_**Example:** Creating a new [laravel](https://github.com/laravel/laravel) empty project_
```
docker \
run \
--rm \
-it \
-u $UID:$GID \
-w /src \
-v $PWD:/src \
yannoff/php-fpm:8.0 \
composer create-project --ignore-platform-reqs laravel/laravel acme
```
> _Since the base image may not contain all of the required PHP extensions, the `--ignore-platform-reqs` switch is recommended_
#### Pre-compiled images defaults
_Pre-compiled images are built with the following default values:_
| Build arg | Value
|--- |---
| `TZ` | `Europe/Paris`
| `PHP_EXTS` | `intl opcache`
| `APK_BASE` | `bash git vim`
| `APK_EXTRA` | `openssh`
| `COMPOSER_VERSION` | `2.2.24`
## Helper scripts
A set of helper scripts are available in the [bin](bin) directory.
Each of them allows to run any php command on-the-fly, including `composer` or `offenbach` commands.
Based on the BusyBox principle, the [bin/php](bin/php) multi-call script is the main entrypoint.
The way it works is dead simple: php version is deduced from the called script name, as a consequence each `php` symlink must point to the main [`php`](bin/php) entrypoint script.
The version must be one of the following:
`5.5`,
`5.6`,
`7.0`,
`7.1`,
`7.2`,
`7.3`,
`7.4`,
`8.0`,
`8.1`,
`8.2`
> _If invoked without any version suffix, the default PHP version will be used: either the `PHP_VERSION` environment variable (if set), the latest PHP GA release (currently 8.2) otherwise._
### Usage examples
```bash
$ cd $HOME/bin
$ ln -s php php7.4
$ php7.4 --version
PHP 7.4.28 (cli) (built: Mar 29 2022 03:52:02) ( NTS )
Copyright (c) The PHP Group
Zend Engine v3.4.0, Copyright (c) Zend Technologies
with Zend OPcache v7.4.28, Copyright (c), by Zend Technologies
```
_The following examples are given assuming that:_
- _The `php` multi-call script is in one of the `$PATH` dirs_
- _A symlink to it has been created for each php version_
#### Install offenbach dependencies in the current dir
```bash
php8.1 offenbach install
```
#### Open a php interactive command prompt
```bash
php7.4 -a
```
#### Open a bash session
```bash
php8.0
```
## Credits
Licensed under the [MIT License](https://github.com/yannoff/docker-php-fpm/blob/master/LICENSE).
This project uses the awesome [mlocati/docker-php-extension-installer](https://github.com/mlocati/docker-php-extension-installer) script for PHP extensions install.