Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/joseluisq/alpine-php-fpm
Lightweight & optimized Multi-Arch Docker Images (x86_64/arm/arm64) for PHP-FPM (PHP 8.1, 8.2, 8.3) with essential extensions on top of latest Alpine Linux. :elephant:
https://github.com/joseluisq/alpine-php-fpm
alpine alpine-linux arm arm64 armv6 armv7 composer docker docker-image php php-extensions php-fpm php7 php8 x86 x86-64
Last synced: 9 days ago
JSON representation
Lightweight & optimized Multi-Arch Docker Images (x86_64/arm/arm64) for PHP-FPM (PHP 8.1, 8.2, 8.3) with essential extensions on top of latest Alpine Linux. :elephant:
- Host: GitHub
- URL: https://github.com/joseluisq/alpine-php-fpm
- Owner: joseluisq
- License: apache-2.0
- Created: 2020-03-16T22:23:34.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-04-03T23:05:52.000Z (10 months ago)
- Last Synced: 2024-04-14T05:35:43.738Z (10 months ago)
- Topics: alpine, alpine-linux, arm, arm64, armv6, armv7, composer, docker, docker-image, php, php-extensions, php-fpm, php7, php8, x86, x86-64
- Language: Dockerfile
- Homepage:
- Size: 269 KB
- Stars: 156
- Watchers: 6
- Forks: 40
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
Alpine PHP-FPM
Lightweight & optimized Multi-Arch Docker Images (x86_64/arm/arm64) for PHP-FPM (PHP 8.1, 8.2, 8.3, 8.4) with essential extensions on top of latest Alpine Linux. 🐘
## Stable versions
| v8.1 | v8.2 | v8.3 | v8.4 |
| -----: | -----: | -----: | -----: |
| 
 | 
 | 
 | 
 |
### PHP versions support
We **only** support stable PHP versions according to the [PHP Release Cycle](https://www.php.net/supported-versions.php).
However, you can still find legacy versions like `7.4.x` or `8.0.x` on [Releases](https://github.com/joseluisq/alpine-php-fpm/releases) and [Docker Hub](https://hub.docker.com/r/joseluisq/php-fpm/).
## Built-in extensions
`curl`, `ftp`, `hash` (`mhash`), `libedit`, `libsodium`, `mbstring`, `mysqlnd`, `openssl`, `password-argon2`, `pdo-sqlite`, `pear`, `sqlite3`, `zlib`
## Additional extensions
| Extension | v8.1 | v8.2 | v8.3 | v8.4 |
| ---------- | -----: | -----: | -----: | -----: |
| amqp | ✓ | ✓ | ✓ | ✓ |
| apcu | ✓ | ✓ | ✓ | ✓ |
| bcmath | ✓ | ✓ | ✓ | ✓ |
| bz2 | ✓ | ✓ | ✓ | ✓ |
| exif | ✓ | ✓ | ✓ | ✓ |
| gd | ✓ | ✓ | ✓ | ✓ |
| gettext | ✓ | ✓ | ✓ | ✓ |
| gmp | ✓ | ✓ | ✓ | ✓ |
| imagick | ✓ | ✓ | ✓ | ? |
| igbinary | ✓ | ✓ | ✓ | ✓ |
| imap | ✓ | ✓ | ✓ | ? |
| intl | ✓ | ✓ | ✓ | ✓ |
| lz4 | ✓ | ✓ | ✓ | ✓ |
| memcache | ✓ | ✓ | ✓ | ✓ |
| mongodb | ✓ | ✓ | ✓ | ✓ |
| msgpack | ✓ | ✓ | ✓ | ✓ |
| mysqli | ✓ | ✓ | ✓ | ✓ |
| oauth | ✓ | ✓ | ✓ | ✓ |
| opcache | ✓ | ✓ | ✓ | ✓ |
| pcntl | ✓ | ✓ | ✓ | ✓ |
| pdo_dblib | ✓ | ✓ | ✓ | ✓ |
| pdo_mysql | ✓ | ✓ | ✓ | ✓ |
| pdo_pgsql | ✓ | ✓ | ✓ | ✓ |
| pdo_sqlsrv | ✓ (64-bit only) | ✓ (64-bit only) | ✓ (64-bit only) | ✓ (64-bit only) |
| pgsql | ✓ | ✓ | ✓ | ✓ |
| phalcon | ✓ | ✓ | ✓ | ? |
| psr | ✓ | ✓ | ✓ | ✓ |
| redis | ✓ | ✓ | ✓ | ✓ |
| rdkafka | ✓ | ✓ | ✓ | ✓ |
| soap | ✓ | ✓ | ✓ | ✓ |
| sockets | ✓ | ✓ | ✓ | ✓ |
| sqlsrv | ✓ (64-bit only) | ✓ (64-bit only) | ✓ (64-bit only) | ✓ (64-bit only) |
| ssh2 | ✓ | ✓ | ✓ |
| swoole | ✓ (64-bit only) | ✓ (64-bit only) | ✓ (64-bit only) | ✓ (64-bit only) |
| sysvmsg | ✓ | ✓ | ✓ | ✓ |
| sysvsem | ✓ | ✓ | ✓ | ✓ |
| sysvshm | ✓ | ✓ | ✓ | ✓ |
| tidy | ✓ | ✓ | ✓ | ✓ |
| uuid | ✓ | ✓ | ✓ | ✓ |
| vips | ✓ | ✓ | ✓ | ✓ |
| xdebug | ✓ | ✓ | ✓ | ✓ |
| xsl | ✓ | ✓ | ✓ | ✓ |
| yaml | ✓ | ✓ | ✓ | ✓ |
| zip | ✓ | ✓ | ✓ | ✓ |
| zstd | ✓ | ✓ | ✓ | ✓ |
| | | | | |
| **Others** | | | | |
| composer | v2.8 | v2.8 | v2.8 | v2.8 |
| | | | | |
| **Extensions file** | [8.1-fpm](8.1-fpm) | [8.2-fpm](8.2-fpm) | [8.3-fpm](8.3-fpm/extensions.txt) | [8.4-fpm](8.4-fpm/extensions.txt) |
**Footnotes**
- (?) It means that this extension is obsolete/unmaintained/discouraged or simply is not supported yet.
- The `mcrypt` extension is obsolete. Use `libsodium` or `openssl` instead.
### List all extensions included
If you want to know the whole list of the included extensions then type `php -m` as follows.
```sh
docker run --rm joseluisq/php-fpm:8.4 php -m
```
Or use `php -i` to get more detailed information.
## Usage
```sh
docker pull joseluisq/php-fpm:8.4
# Or
docker pull joseluisq/php-fpm:8.3
# Or
docker pull joseluisq/php-fpm:8.2
# Or
docker pull joseluisq/php-fpm:8.1
```
🐳 Available on Docker Hub → [hub.docker.com/r/joseluisq/php-fpm](https://hub.docker.com/r/joseluisq/php-fpm/)
### Dockerfile
```Dockerfile
FROM joseluisq/php-fpm:8.4
# Or
FROM joseluisq/php-fpm:8.3
# Or
FROM joseluisq/php-fpm:8.2
# Or
FROM joseluisq/php-fpm:8.1
```
### Run a container
To give a Docker image a quick try, just execute any of those commands and then navigate to [localhost:8088](http://localhost:8088)
```sh
docker run --rm -p 8088:80 joseluisq/php-fpm:8.4 sh -c "echo ' index.php; php -S [::]:80 -t ."
# Or
docker run --rm -p 8088:80 joseluisq/php-fpm:8.3 sh -c "echo ' index.php; php -S [::]:80 -t ."
# Or
docker run --rm -p 8088:80 joseluisq/php-fpm:8.2 sh -c "echo ' index.php; php -S [::]:80 -t ."
# Or
docker run --rm -p 8088:80 joseluisq/php-fpm:8.1 sh -c "echo ' index.php; php -S [::]:80 -t ."
```
[View Docker Compose Examples](#docker-compose-examples)
## Default paths
- Default Docker working directory: `/var/www/html`
- Additional PHP `.ini` files to load: `/usr/local/etc/php/conf.d`
- Custom PHP `.ini` file generated (only if `ENV_SUBSTITUTION_ENABLE=true`): `/usr/local/etc/php/conf.d/default-php.ini`
## Configurable Environment Variables
**PHP-FPM** and **PHP** configurations can be overwritten using environment variables.
To do so, just indicate the substitution of values using `ENV_SUBSTITUTION_ENABLE=true` (since it is disabled by default).
Below are the environment variables with their default values:
### PHP-FPM
#### Global FPM
Settings replaced into `/usr/local/etc/php-fpm.conf` file.
- `PHP_FPM_ERROR_LOG=/proc/self/fd/2`
- `PHP_FPM_LOG_LEVEL=error`
#### FPM WWW Pool
Settings replaced into `/usr/local/etc/php-fpm.d/www.conf` file.
- `PHP_FPM_LISTEN=9000`
- `PHP_FPM_USER=www-data`
- `PHP_FPM_GROUP=www-data`
- `PHP_FPM_LISTEN_OWNER=www-data`
- `PHP_FPM_LISTEN_GROUP=www-data`
### PHP Config
Settings replaced into `/usr/local/etc/php/conf.d/default-php.ini` file (`php.ini`).
- `PHP_MEMORY_LIMIT=512M`
- `PHP_EXPOSE_PHP=On`
- `PHP_SESSION_GC_MAXLIFETIME=1440`
### Disable PHP additional extensions
The PHP additional extensions can be disabled at startup by providing the `PHP_DISABLE_EXTENSIONS` environment variable with one or more names. For example `PHP_DISABLE_EXTENSIONS=psr,exif,bz2`.
Find the valid extension names in `extensions.txt` file of every PHP version directory or by using `php -m`. For example `docker run --rm joseluisq/php-fpm:8.3 php -m | grep "exif"`.
## Docker Compose examples
[docker-compose](https://docs.docker.com/compose/) examples for [Nginx](https://hub.docker.com/_/nginx) and [Apache](https://hub.docker.com/_/httpd) servers can be found under the [./examples](./examples) directory.
### Nginx example
```sh
docker-compose -f examples/nginx/docker-compose.yml up
```
### Apache example
```sh
docker-compose -f examples/apache/docker-compose.yml up
```
## Contributions
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in current work by you, as defined in the Apache-2.0 license, shall be dual licensed as described below, without any additional terms or conditions.
Feel free to send some [pull request](https://github.com/joseluisq/alpine-php-fpm/pulls) or file an [issue](https://github.com/joseluisq/alpine-php-fpm/issues).
## License
This work is primarily distributed under the terms of both the [MIT license](LICENSE-MIT) and the [Apache License (Version 2.0)](LICENSE-APACHE).
© 2020-present [Jose Quintana](https://joseluisq.net)