Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .oss-scanner/Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
# lines in src/variations/*/Dockerfile: keep them in step when those change.
# The intermediate stages are copied as whole filesystems and never run, so they stay root.
# hadolint global ignore=DL3002,DL3067
ARG PHP_VERSION='8.5'
ARG PHP_VERSION='8.6'

##########
# Laravel app, so AUTORUN automations can run without network access
Expand Down
6 changes: 3 additions & 3 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,9 +72,9 @@ Then build it with `docker build -f .oss-scanner/Dockerfile -t oss-scanner .`, r
Requires Docker with buildx, and `yq`. If Docker isn't running, ask the user to start it.

```sh
scripts/dev.sh --variation fpm-nginx --version 8.5 --os bookworm
scripts/dev.sh --variation cli --version 8.5 --os alpine3.24 --no-cache
bash scripts/test-image.sh serversideup/php:8.5-fpm-nginx-bookworm
scripts/dev.sh --variation fpm-nginx --version 8.6 --os bookworm
scripts/dev.sh --variation cli --version 8.6 --os alpine3.24 --no-cache
bash scripts/test-image.sh serversideup/php:8.6-fpm-nginx-bookworm
```

Pick `--os` from that minor's `base_os` list in the base config.
Expand Down
12 changes: 6 additions & 6 deletions README.md

Large diffs are not rendered by default.

10 changes: 5 additions & 5 deletions docs/content/docs/1.getting-started/5.choosing-an-image.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ The `unit` variation was removed in v4.1.0 (November 21, 2025) after NGINX archi

Pick the newest PHP version your dependencies support that php.net still [supports](https://www.php.net/supported-versions.php){target="_blank"}. The [PHP changelog](https://www.php.net/ChangeLog-8.php){target="_blank"} lists what changed in each release.

New PHP patches don't wait on us. We check php.net every hour, and a new patch starts a build right away. The images publish once that build passes its tests. `8.6-rc` tracks the newest PHP 8.6 release candidate, such as `serversideup/php:8.6-rc-fpm-nginx`. Use it for testing, not production.
New PHP patches don't wait on us. We check php.net every hour, and a new patch starts a build right away. The images publish once that build passes its tests.

PHP 8.1 is end of life upstream. We still build it for operating system fixes, but PHP itself gets none. PHP 7.4 and 8.0 are no longer built at all. Their tags still pull, frozen with no updates. See [EOL versions and the legacy-modernization path](https://github.com/serversideup/docker-php/blob/main/SECURITY.md#eol-versions-and-the-legacy-modernization-path).

Expand Down Expand Up @@ -56,9 +56,9 @@ Every image runs on `amd64` and `arm64`, from Docker Hub or GitHub Packages. Thi

| Variation | `bookworm` | `trixie` | `alpine3.22` | `alpine3.23` | `alpine3.24` |
|---|---|---|---|---|---|
| `cli`, `fpm`, `fpm-nginx` | 8.1 to 8.6-rc | 8.1 to 8.6-rc | 8.1 | 8.2 to 8.6-rc | 8.2 to 8.6-rc |
| `fpm-apache` | 8.1 to 8.6-rc | 8.1 to 8.6-rc | ❌ | ❌ | ❌ |
| `frankenphp` | 8.3 to 8.6-rc | 8.3 to 8.6-rc | ❌ | 8.3 to 8.6-rc | 8.3 to 8.6-rc |
| `cli`, `fpm`, `fpm-nginx` | 8.1 to 8.6 | 8.1 to 8.6 | 8.1 | 8.2 to 8.6 | 8.2 to 8.6 |
| `fpm-apache` | 8.1 to 8.6 | 8.1 to 8.6 | ❌ | ❌ | ❌ |
| `frankenphp` | 8.3 to 8.6 | 8.3 to 8.6 | ❌ | 8.3 to 8.6 | 8.3 to 8.6 |

## Every tag reads the same way

Expand All @@ -72,7 +72,7 @@ Every part is optional except the repository.
|---|---|---|
| `{{registry}}` | Docker Hub | `ghcr.io` for GitHub Packages |
| `{{prefix}}` | none (stable) | `beta` |
| `{{php-version}}` | newest stable minor | `8.4`, `8.1`, `8.6-rc`, a major such as `8`, or a patch such as `8.4.27` |
| `{{php-version}}` | newest stable minor | `8.4`, `8.1`, a major such as `8`, or a patch such as `8.4.27` |
| `{{variation}}` | `cli` | `fpm`, `fpm-nginx`, `fpm-apache`, `frankenphp` |
| `{{os}}` | `debian` (Trixie) | `bookworm`, `trixie`, `alpine`, `alpine3.22`, `alpine3.23`, `alpine3.24` |
| `{{release}}` | none (floating tag) | a [GitHub release](https://github.com/serversideup/docker-php/releases){target="_blank"} such as `v5.0.5` |
Expand Down
2 changes: 1 addition & 1 deletion docs/content/docs/2.image-variations/cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ The `cli` variation runs PHP from the command line, with no web server and no pr
| Stop signal | `SIGTERM` |
| Default health check | None |
| Webroot variable | Not used |
| PHP versions | 8.1 to 8.5, plus the 8.6 release candidate |
| PHP versions | 8.1 to 8.6 |
| Operating systems | Debian and Alpine |

The image also includes `composer` and `install-php-extensions`. See [default configurations](/docs/getting-started/default-configurations) for the full list of extensions and settings.
Expand Down
2 changes: 1 addition & 1 deletion docs/content/docs/2.image-variations/fpm-apache.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ The `fpm-apache` variation runs Apache and PHP-FPM in one container, supervised
| Stop signal | `SIGQUIT` |
| Default health check | `curl` to `http://localhost:${APACHE_HTTP_PORT}${HEALTHCHECK_PATH}` (`/healthcheck` by default) |
| Webroot variable | `APACHE_DOCUMENT_ROOT` (default `/var/www/html/public`) |
| PHP versions | 8.1 to 8.5, plus the 8.6 release candidate |
| PHP versions | 8.1 to 8.6 |
| Operating systems | Debian only. There is no Alpine build. |

Requests flow the same way as in [`fpm-nginx`](/docs/image-variations/fpm-nginx#how-a-request-flows-through-nginx-and-php-fpm), with Apache in place of NGINX. One difference: Apache has no built-in rule that sends unknown paths to `index.php`. Your app's `.htaccess` does that, such as the one Laravel ships in `public/.htaccess`. Without it, routes other than real files return `404`.
Expand Down
2 changes: 1 addition & 1 deletion docs/content/docs/2.image-variations/fpm-nginx.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ The `fpm-nginx` variation runs NGINX and PHP-FPM in one container, supervised by
| Stop signal | `SIGQUIT` |
| Default health check | `curl` to `http://localhost:${NGINX_HTTP_PORT}${HEALTHCHECK_PATH}` (`/healthcheck` by default) |
| Webroot variable | `NGINX_WEBROOT` (default `/var/www/html/public`) |
| PHP versions | 8.1 to 8.5, plus the 8.6 release candidate |
| PHP versions | 8.1 to 8.6 |
| Operating systems | Debian and Alpine |

## How a request flows through NGINX and PHP-FPM
Expand Down
2 changes: 1 addition & 1 deletion docs/content/docs/2.image-variations/fpm.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ The `fpm` variation runs PHP-FPM alone and answers FastCGI requests on port `900
| Stop signal | `SIGQUIT` (FPM finishes in-flight requests, then exits) |
| Default health check | [`php-fpm-healthcheck`](https://github.com/renatomefi/php-fpm-healthcheck){target="_blank"}, which reads FPM's status page |
| Webroot variable | None. Your web server sets the document root. |
| PHP versions | 8.1 to 8.5, plus the 8.6 release candidate |
| PHP versions | 8.1 to 8.6 |
| Operating systems | Debian and Alpine |

## Quick start
Expand Down
2 changes: 1 addition & 1 deletion docs/content/docs/2.image-variations/frankenphp.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ The `frankenphp` variation runs [FrankenPHP](https://frankenphp.dev){target="_bl
| Stop signal | `SIGTERM` |
| Default health check | `curl` to `http://localhost:${CADDY_HTTP_PORT}${HEALTHCHECK_PATH}` (`/healthcheck` by default) |
| Webroot variable | `CADDY_SERVER_ROOT` (default `/var/www/html/public`) |
| PHP versions | 8.3 to 8.5, plus the 8.6 release candidate. Not built for 8.1 or 8.2. |
| PHP versions | 8.3 to 8.6. Not built for 8.1 or 8.2. |
| Operating systems | Debian and Alpine |

The image also includes a [Mercure](#mercure) hub, turned off by default.
Expand Down
10 changes: 5 additions & 5 deletions scripts/conf/php-versions-base-config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
dependencies:
# The docker-library/php commit the PHP base images are compiled from. Renovate moves it
# to the latest commit on master once a week and merges it when every check passes. A minor version can pin its own with docker_library_ref.
DOCKER_LIBRARY_PHP_REF: 5ec2a6a0dad498e89a91a39454dbb52e98ce2bdb
DOCKER_LIBRARY_PHP_REF: 3b25f4162a9bd144d3f447d03cb8fe16c0d2c9cc
# renovate: datasource=github-releases depName=phpredis/phpredis
PHPREDIS_VERSION: 6.3.0
# The liblzf commit that phpredis bundles as a submodule. GitHub tarballs leave submodules
Expand Down Expand Up @@ -96,16 +96,16 @@ php_versions:
- name: trixie
patch_versions:
# - 8.5.8 # Pull latest from Official PHP source
# "8.6-rc" builds the newest release candidate php.net lists. docker-library builds
# every 8.6 image with ZTS and has no separate zts variant, so FrankenPHP uses cli.
- minor: "8.6-rc"
# docker-library builds every 8.6 image with ZTS and has no separate zts variant,
# so FrankenPHP uses cli.
- minor: "8.6"
base_os:
- name: alpine3.23
- name: alpine3.24
- name: bookworm
- name: trixie
patch_versions:
- 8.6-rc
# - 8.6.0 # Pull latest from Official PHP source
php_base_overrides:
frankenphp: cli
# phpredis 6.3.0 does not compile on PHP 8.6, so 8.6 builds the last develop commit
Expand Down
Loading