Skip to content

Add Support for PHP 8.5 and remove support for bullseye #1676

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
AlvaroRausell merged 15 commits into from
Dec 15, 2025
Merged

Add Support for PHP 8.5 and remove support for bullseye #1676

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
6b6aff7
Add support for PHP 8.5
sireeshajonnalagadda Nov 25, 2025
10a6a73
Add support for PHP 8.5
sireeshajonnalagadda Nov 26, 2025
ce4813f
Merge branch 'main' into php-8.5
sireeshajonnalagadda Nov 26, 2025
f7b028d
removing bullseye variant
sireeshajonnalagadda Nov 26, 2025
2cf8979
Merge remote-tracking branch 'refs/remotes/origin/php-8.5' into php-8.5
sireeshajonnalagadda Nov 26, 2025
307b90a
Merge branch 'main' into php-8.5
sireeshajonnalagadda Dec 2, 2025
d92abe2
Add support for php 8.5
sireeshajonnalagadda Dec 2, 2025
dd466d6
Merge remote-tracking branch 'refs/remotes/origin/php-8.5' into php-8.5
sireeshajonnalagadda Dec 2, 2025
53cb5ea
Add support for PHP 8.5
sireeshajonnalagadda Dec 2, 2025
062f7f8
Update xdebug installation comment to specify version 3.5.0
sireeshajonnalagadda Dec 12, 2025
2ca389f
Update PHP feature to use version 8.5.0 and change additional version…
sireeshajonnalagadda Dec 12, 2025
3a7b33c
Update src/php/README.md
sireeshajonnalagadda Dec 12, 2025
aff79b7
Update src/php/README.md
sireeshajonnalagadda Dec 12, 2025
762bac7
Update src/php/README.md
sireeshajonnalagadda Dec 12, 2025
0f3d90c
Update src/php/README.md
sireeshajonnalagadda Dec 12, 2025
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
5 changes: 2 additions & 3 deletions src/php/.devcontainer/Dockerfile
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
ARG VARIANT=8.4-apache-trixie
ARG VARIANT=8.5-apache-trixie
Copy link

@bretthowell714-source bretthowell714-source Jan 1, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks

FROM php:${VARIANT}

# Install xdebug
# Install xdebug(3.5.0)
RUN yes | pecl install xdebug \
&& echo "zend_extension=$(find /usr/local/lib/php/extensions/ -name xdebug.so)" > /usr/local/etc/php/conf.d/xdebug.ini \
&& echo "xdebug.mode = debug" >> /usr/local/etc/php/conf.d/xdebug.ini \
Expand All @@ -13,7 +13,6 @@ RUN yes | pecl install xdebug \
RUN curl -sSL https://getcomposer.org/installer | php \
&& chmod +x composer.phar \
&& mv composer.phar /usr/local/bin/composer

# [Optional] Uncomment this section to install additional packages.
# RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
# && apt-get -y install --no-install-recommends <your-package-list-here>
21 changes: 11 additions & 10 deletions src/php/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@
| *Categories* | Languages |
| *Image type* | Dockerfile |
| *Published images* | mcr.microsoft.com/devcontainers/php |
| *Available image variants* | 8 / 8-trixie, 8.4 / 8.4-trixie, 8.3 / 8.3-trixie, 8.2 / 8.2-trixie, 8-bookworm, 8.4-bookworm, 8.3-bookworm, 8.2-bookworm, 8-bullseye, 8.4-bullseye,,8.3-bullseye, 8.2-bullseye ([full list](https://mcr.microsoft.com/v2/devcontainers/php/tags/list)) |
| *Published image architecture(s)* | x86-64, arm64/aarch64 for `bookworm`, and `bullseye` variants |
| *Available image variants* | 8 / 8-trixie, 8.5 / 8.5-trixie, 8.4 / 8.4-trixie, 8.3 / 8.3-trixie, 8.2 / 8.2-trixie, 8-bookworm, 8.5-bookworm, 8.4-bookworm, 8.3-bookworm, 8.2-bookworm ([full list](https://mcr.microsoft.com/v2/devcontainers/php/tags/list)) |
| *Published image architecture(s)* | x86-64, arm64/aarch64 for `trixie`, and `bookworm` variants |
| *Container host OS support* | Linux, macOS, Windows |
| *Container OS* | Debian |
| *Languages, platforms* | PHP |
Expand All @@ -22,20 +22,21 @@ See **[history](history)** for information on the contents of published images.
You can directly reference pre-built versions of `Dockerfile` by using the `image` property in `.devcontainer/devcontainer.json` or updating the `FROM` statement in your own `Dockerfile` with one of the following:

- `mcr.microsoft.com/devcontainers/php` (latest)
- `mcr.microsoft.com/devcontainers/php:8` (or `8-trixie`, `8-bookworm`, `8-bullseye` to pin to an OS version)
- `mcr.microsoft.com/devcontainers/php:8.4` (or `8.4-trixie`, `8.4-bookworm`, `8.4-bullseye` to pin to an OS version)
- `mcr.microsoft.com/devcontainers/php:8.3` (or `8.3-trixie`, `8.3-bookworm`, `8.3-bullseye` to pin to an OS version)
- `mcr.microsoft.com/devcontainers/php:8.2` (or `8.2-trixie`, `8.2-bookworm`, `8.2-bullseye` to pin to an OS version)
- `mcr.microsoft.com/devcontainers/php:8` (or `8-trixie`, `8-bookworm` to pin to an OS version)
- `mcr.microsoft.com/devcontainers/php:8.5` (or `8.5-trixie`, `8.5-bookworm` to pin to an OS version)
- `mcr.microsoft.com/devcontainers/php:8.4` (or `8.4-trixie`, `8.4-bookworm` to pin to an OS version)
- `mcr.microsoft.com/devcontainers/php:8.3` (or `8.3-trixie`, `8.3-bookworm` to pin to an OS version)
- `mcr.microsoft.com/devcontainers/php:8.2` (or `8.2-trixie`, `8.2-bookworm` to pin to an OS version)

Refer to [this guide](https://containers.dev/guide/dockerfile) for more details.

You can decide how often you want updates by referencing a [semantic version](https://semver.org/) of each image. For example:

- `mcr.microsoft.com/devcontainers/php:2-8` (or `2-8-bookworm`, `2-8-bullseye`)
- `mcr.microsoft.com/devcontainers/php:2.0-8` (or `2.0-8-bookworm`, `2.0-8-bullseye`)
- `mcr.microsoft.com/devcontainers/php:2.0.0-8` (or `2.0.0-8-bookworm`, `2.0.0-8-bullseye`)
- `mcr.microsoft.com/devcontainers/php:3-8` (or `3-8-trixie`, `3-8-bookworm` )
- `mcr.microsoft.com/devcontainers/php:2.0-8` (or `3.0-8-trixie`, `3.0-8-bookworm` )
- `mcr.microsoft.com/devcontainers/php:3.0.0-8` (or `3.0.0-8-trixie`, `3.0.0-8-bookworm` )

However, we only do security patching on the latest [non-breaking, in support](https://github.com/devcontainers/images/issues/90) versions of images (e.g. `2-8`). You may want to run `apt-get update && apt-get upgrade` in your Dockerfile if you lock to a more specific version to at least pick up OS security updates.
However, we only do security patching on the latest [non-breaking, in support](https://github.com/devcontainers/images/issues/90) versions of images (e.g. `3-8`). You may want to run `apt-get update && apt-get upgrade` in your Dockerfile if you lock to a more specific version to at least pick up OS security updates.

See [history](history) for information on the contents of each version and [here for a complete list of available tags](https://mcr.microsoft.com/v2/devcontainers/php/tags/list).

Expand Down
64 changes: 28 additions & 36 deletions src/php/manifest.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,20 +1,24 @@
{
"version": "2.0.4",
"version": "3.0.0",

"variants": [
"8.5-apache-trixie",
"8.4-apache-trixie",
"8.3-apache-trixie",
"8.2-apache-trixie",
"8.5-apache-bookworm",
"8.4-apache-bookworm",
"8.3-apache-bookworm",
"8.2-apache-bookworm",
"8.4-apache-bullseye",
"8.3-apache-bullseye",
"8.2-apache-bullseye"
"8.2-apache-bookworm"
],
"build": {
"latest": "8.4-apache-trixie",
"latest": "8.5-apache-trixie",
"rootDistro": "debian",
"architectures": {
"8.5-apache-trixie": [
"linux/amd64",
"linux/arm64"
],
"8.4-apache-trixie": [
"linux/amd64",
"linux/arm64"
Expand All @@ -26,72 +30,60 @@
"8.2-apache-trixie": [
"linux/amd64",
"linux/arm64"
],
"8.5-apache-bookworm": [
"linux/amd64",
"linux/arm64"
],
"8.4-apache-bookworm": [
"linux/amd64",
"linux/arm64"
],
],
"8.3-apache-bookworm": [
"linux/amd64",
"linux/arm64"
],
"8.2-apache-bookworm": [
"linux/amd64",
"linux/arm64"
],
"8.4-apache-bullseye": [
"linux/amd64",
"linux/arm64"
],
"8.3-apache-bullseye": [
"linux/amd64",
"linux/arm64"
],
"8.2-apache-bullseye": [
"linux/amd64",
"linux/arm64"
]
},
"tags": [
"php:${VERSION}-${VARIANT}"
],
"variantTags": {
"8.4-apache-trixie": [
"8.5-apache-trixie": [
"php:${VERSION}-8",
"php:${VERSION}-8.4",
"php:${VERSION}-8.5",
"php:${VERSION}-8-trixie",
"php:${VERSION}-8.4-trixie",
"php:${VERSION}-8.5-trixie",
"php:${VERSION}-trixie"
],
"8.4-apache-trixie": [
"php:${VERSION}-8.4",
"php:${VERSION}-8.4-trixie"
],
"8.3-apache-trixie": [
"php:${VERSION}-8.3",
"php:${VERSION}-8.3-trixie"
],
"8.2-apache-trixie": [
"php:${VERSION}-8.2",
"php:${VERSION}-8.2-trixie"
],
"8.4-apache-bookworm": [
],
"8.5-apache-bookworm": [
"php:${VERSION}-8-bookworm",
"php:${VERSION}-8.4-bookworm",
"php:${VERSION}-8.5-bookworm",
"php:${VERSION}-bookworm"
],
"8.4-apache-bookworm": [
"php:${VERSION}-8.4-bookworm"
],
"8.3-apache-bookworm": [
"php:${VERSION}-8.3-bookworm"
],
"8.2-apache-bookworm": [
"php:${VERSION}-8.2-bookworm"
],
"8.4-apache-bullseye": [
"php:${VERSION}-8-bullseye",
"php:${VERSION}-8.4-bullseye",
"php:${VERSION}-bullseye"
],
"8.3-apache-bullseye": [
"php:${VERSION}-8.3-bullseye"
],
"8.2-apache-bullseye": [
"php:${VERSION}-8.2-bullseye"
]
}
},
Expand Down
4 changes: 2 additions & 2 deletions src/universal/.devcontainer/devcontainer.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,8 +30,8 @@
"useOryxIfAvailable": "false"
},
"ghcr.io/devcontainers/features/php:1": {
"version": "8.4.8",
"additionalVersions": "8.3.14",
"version": "8.5.0",
"additionalVersions": "8.4.15",
"installComposer": "true"
},
"ghcr.io/devcontainers/features/conda:1": {
Expand Down