docker-library · tianon · Dec 3, 2025 · Dec 3, 2025 · tianon · Dec 3, 2025
diff --git a/8.2/alpine3.21/cli/Dockerfile → 8.2/alpine3.23/cli/Dockerfile b/8.2/alpine3.21/cli/Dockerfile → 8.2/alpine3.23/cli/Dockerfile
diff --git a/8.2/alpine3.21/cli/docker-php-entrypoint → 8.2/alpine3.23/cli/docker-php-entrypoint b/8.2/alpine3.21/cli/docker-php-entrypoint → 8.2/alpine3.23/cli/docker-php-entrypoint
diff --git a/8.2/alpine3.21/cli/docker-php-ext-configure → 8.2/alpine3.23/cli/docker-php-ext-configure b/8.2/alpine3.21/cli/docker-php-ext-configure → 8.2/alpine3.23/cli/docker-php-ext-configure
diff --git a/8.2/alpine3.21/cli/docker-php-ext-enable → 8.2/alpine3.23/cli/docker-php-ext-enable b/8.2/alpine3.21/cli/docker-php-ext-enable → 8.2/alpine3.23/cli/docker-php-ext-enable
diff --git a/8.2/alpine3.21/cli/docker-php-ext-install → 8.2/alpine3.23/cli/docker-php-ext-install b/8.2/alpine3.21/cli/docker-php-ext-install → 8.2/alpine3.23/cli/docker-php-ext-install
diff --git a/8.2/alpine3.21/cli/docker-php-source → 8.2/alpine3.23/cli/docker-php-source b/8.2/alpine3.21/cli/docker-php-source → 8.2/alpine3.23/cli/docker-php-source
diff --git a/8.2/alpine3.21/fpm/Dockerfile → 8.2/alpine3.23/fpm/Dockerfile b/8.2/alpine3.21/fpm/Dockerfile → 8.2/alpine3.23/fpm/Dockerfile
diff --git a/8.2/alpine3.21/fpm/docker-php-entrypoint → 8.2/alpine3.23/fpm/docker-php-entrypoint b/8.2/alpine3.21/fpm/docker-php-entrypoint → 8.2/alpine3.23/fpm/docker-php-entrypoint
diff --git a/8.2/alpine3.21/fpm/docker-php-ext-configure → 8.2/alpine3.23/fpm/docker-php-ext-configure b/8.2/alpine3.21/fpm/docker-php-ext-configure → 8.2/alpine3.23/fpm/docker-php-ext-configure
diff --git a/8.2/alpine3.21/fpm/docker-php-ext-enable → 8.2/alpine3.23/fpm/docker-php-ext-enable b/8.2/alpine3.21/fpm/docker-php-ext-enable → 8.2/alpine3.23/fpm/docker-php-ext-enable
diff --git a/8.2/alpine3.21/fpm/docker-php-ext-install → 8.2/alpine3.23/fpm/docker-php-ext-install b/8.2/alpine3.21/fpm/docker-php-ext-install → 8.2/alpine3.23/fpm/docker-php-ext-install
diff --git a/8.2/alpine3.21/fpm/docker-php-source → 8.2/alpine3.23/fpm/docker-php-source b/8.2/alpine3.21/fpm/docker-php-source → 8.2/alpine3.23/fpm/docker-php-source
diff --git a/8.2/alpine3.21/zts/Dockerfile → 8.2/alpine3.23/zts/Dockerfile b/8.2/alpine3.21/zts/Dockerfile → 8.2/alpine3.23/zts/Dockerfile
diff --git a/8.2/alpine3.21/zts/docker-php-entrypoint → 8.2/alpine3.23/zts/docker-php-entrypoint b/8.2/alpine3.21/zts/docker-php-entrypoint → 8.2/alpine3.23/zts/docker-php-entrypoint
diff --git a/8.2/alpine3.21/zts/docker-php-ext-configure → 8.2/alpine3.23/zts/docker-php-ext-configure b/8.2/alpine3.21/zts/docker-php-ext-configure → 8.2/alpine3.23/zts/docker-php-ext-configure
diff --git a/8.2/alpine3.21/zts/docker-php-ext-enable → 8.2/alpine3.23/zts/docker-php-ext-enable b/8.2/alpine3.21/zts/docker-php-ext-enable → 8.2/alpine3.23/zts/docker-php-ext-enable
diff --git a/8.2/alpine3.21/zts/docker-php-ext-install → 8.2/alpine3.23/zts/docker-php-ext-install b/8.2/alpine3.21/zts/docker-php-ext-install → 8.2/alpine3.23/zts/docker-php-ext-install
diff --git a/8.2/alpine3.21/zts/docker-php-source → 8.2/alpine3.23/zts/docker-php-source b/8.2/alpine3.21/zts/docker-php-source → 8.2/alpine3.23/zts/docker-php-source
diff --git a/8.3/alpine3.21/cli/Dockerfile → 8.3/alpine3.23/cli/Dockerfile b/8.3/alpine3.21/cli/Dockerfile → 8.3/alpine3.23/cli/Dockerfile
diff --git a/8.3/alpine3.21/cli/docker-php-entrypoint → 8.3/alpine3.23/cli/docker-php-entrypoint b/8.3/alpine3.21/cli/docker-php-entrypoint → 8.3/alpine3.23/cli/docker-php-entrypoint
diff --git a/8.3/alpine3.21/cli/docker-php-ext-configure → 8.3/alpine3.23/cli/docker-php-ext-configure b/8.3/alpine3.21/cli/docker-php-ext-configure → 8.3/alpine3.23/cli/docker-php-ext-configure
diff --git a/8.3/alpine3.21/cli/docker-php-ext-enable → 8.3/alpine3.23/cli/docker-php-ext-enable b/8.3/alpine3.21/cli/docker-php-ext-enable → 8.3/alpine3.23/cli/docker-php-ext-enable
diff --git a/8.3/alpine3.21/cli/docker-php-ext-install → 8.3/alpine3.23/cli/docker-php-ext-install b/8.3/alpine3.21/cli/docker-php-ext-install → 8.3/alpine3.23/cli/docker-php-ext-install
diff --git a/8.3/alpine3.21/cli/docker-php-source → 8.3/alpine3.23/cli/docker-php-source b/8.3/alpine3.21/cli/docker-php-source → 8.3/alpine3.23/cli/docker-php-source
diff --git a/8.3/alpine3.21/fpm/Dockerfile → 8.3/alpine3.23/fpm/Dockerfile b/8.3/alpine3.21/fpm/Dockerfile → 8.3/alpine3.23/fpm/Dockerfile
diff --git a/8.3/alpine3.21/fpm/docker-php-entrypoint → 8.3/alpine3.23/fpm/docker-php-entrypoint b/8.3/alpine3.21/fpm/docker-php-entrypoint → 8.3/alpine3.23/fpm/docker-php-entrypoint
diff --git a/8.3/alpine3.21/fpm/docker-php-ext-configure → 8.3/alpine3.23/fpm/docker-php-ext-configure b/8.3/alpine3.21/fpm/docker-php-ext-configure → 8.3/alpine3.23/fpm/docker-php-ext-configure
diff --git a/8.3/alpine3.21/fpm/docker-php-ext-enable → 8.3/alpine3.23/fpm/docker-php-ext-enable b/8.3/alpine3.21/fpm/docker-php-ext-enable → 8.3/alpine3.23/fpm/docker-php-ext-enable
diff --git a/8.3/alpine3.21/fpm/docker-php-ext-install → 8.3/alpine3.23/fpm/docker-php-ext-install b/8.3/alpine3.21/fpm/docker-php-ext-install → 8.3/alpine3.23/fpm/docker-php-ext-install
diff --git a/8.3/alpine3.21/fpm/docker-php-source → 8.3/alpine3.23/fpm/docker-php-source b/8.3/alpine3.21/fpm/docker-php-source → 8.3/alpine3.23/fpm/docker-php-source
diff --git a/8.3/alpine3.21/zts/Dockerfile → 8.3/alpine3.23/zts/Dockerfile b/8.3/alpine3.21/zts/Dockerfile → 8.3/alpine3.23/zts/Dockerfile
diff --git a/8.3/alpine3.21/zts/docker-php-entrypoint → 8.3/alpine3.23/zts/docker-php-entrypoint b/8.3/alpine3.21/zts/docker-php-entrypoint → 8.3/alpine3.23/zts/docker-php-entrypoint
diff --git a/8.3/alpine3.21/zts/docker-php-ext-configure → 8.3/alpine3.23/zts/docker-php-ext-configure b/8.3/alpine3.21/zts/docker-php-ext-configure → 8.3/alpine3.23/zts/docker-php-ext-configure
diff --git a/8.3/alpine3.21/zts/docker-php-ext-enable → 8.3/alpine3.23/zts/docker-php-ext-enable b/8.3/alpine3.21/zts/docker-php-ext-enable → 8.3/alpine3.23/zts/docker-php-ext-enable
diff --git a/8.3/alpine3.21/zts/docker-php-ext-install → 8.3/alpine3.23/zts/docker-php-ext-install b/8.3/alpine3.21/zts/docker-php-ext-install → 8.3/alpine3.23/zts/docker-php-ext-install
diff --git a/8.3/alpine3.21/zts/docker-php-source → 8.3/alpine3.23/zts/docker-php-source b/8.3/alpine3.21/zts/docker-php-source → 8.3/alpine3.23/zts/docker-php-source
diff --git a/8.4/alpine3.21/cli/Dockerfile → 8.4/alpine3.23/cli/Dockerfile b/8.4/alpine3.21/cli/Dockerfile → 8.4/alpine3.23/cli/Dockerfile
diff --git a/8.4/alpine3.21/cli/docker-php-entrypoint → 8.4/alpine3.23/cli/docker-php-entrypoint b/8.4/alpine3.21/cli/docker-php-entrypoint → 8.4/alpine3.23/cli/docker-php-entrypoint
diff --git a/8.4/alpine3.21/cli/docker-php-ext-configure → 8.4/alpine3.23/cli/docker-php-ext-configure b/8.4/alpine3.21/cli/docker-php-ext-configure → 8.4/alpine3.23/cli/docker-php-ext-configure
diff --git a/8.4/alpine3.21/cli/docker-php-ext-enable → 8.4/alpine3.23/cli/docker-php-ext-enable b/8.4/alpine3.21/cli/docker-php-ext-enable → 8.4/alpine3.23/cli/docker-php-ext-enable
diff --git a/8.4/alpine3.21/cli/docker-php-ext-install → 8.4/alpine3.23/cli/docker-php-ext-install b/8.4/alpine3.21/cli/docker-php-ext-install → 8.4/alpine3.23/cli/docker-php-ext-install
diff --git a/8.4/alpine3.21/cli/docker-php-source → 8.4/alpine3.23/cli/docker-php-source b/8.4/alpine3.21/cli/docker-php-source → 8.4/alpine3.23/cli/docker-php-source
diff --git a/8.4/alpine3.21/fpm/Dockerfile → 8.4/alpine3.23/fpm/Dockerfile b/8.4/alpine3.21/fpm/Dockerfile → 8.4/alpine3.23/fpm/Dockerfile
diff --git a/8.4/alpine3.21/fpm/docker-php-entrypoint → 8.4/alpine3.23/fpm/docker-php-entrypoint b/8.4/alpine3.21/fpm/docker-php-entrypoint → 8.4/alpine3.23/fpm/docker-php-entrypoint
diff --git a/8.4/alpine3.21/fpm/docker-php-ext-configure → 8.4/alpine3.23/fpm/docker-php-ext-configure b/8.4/alpine3.21/fpm/docker-php-ext-configure → 8.4/alpine3.23/fpm/docker-php-ext-configure
diff --git a/8.4/alpine3.21/fpm/docker-php-ext-enable → 8.4/alpine3.23/fpm/docker-php-ext-enable b/8.4/alpine3.21/fpm/docker-php-ext-enable → 8.4/alpine3.23/fpm/docker-php-ext-enable
diff --git a/8.4/alpine3.21/fpm/docker-php-ext-install → 8.4/alpine3.23/fpm/docker-php-ext-install b/8.4/alpine3.21/fpm/docker-php-ext-install → 8.4/alpine3.23/fpm/docker-php-ext-install
diff --git a/8.4/alpine3.21/fpm/docker-php-source → 8.4/alpine3.23/fpm/docker-php-source b/8.4/alpine3.21/fpm/docker-php-source → 8.4/alpine3.23/fpm/docker-php-source
diff --git a/8.4/alpine3.21/zts/Dockerfile → 8.4/alpine3.23/zts/Dockerfile b/8.4/alpine3.21/zts/Dockerfile → 8.4/alpine3.23/zts/Dockerfile
diff --git a/8.4/alpine3.21/zts/docker-php-entrypoint → 8.4/alpine3.23/zts/docker-php-entrypoint b/8.4/alpine3.21/zts/docker-php-entrypoint → 8.4/alpine3.23/zts/docker-php-entrypoint
diff --git a/8.4/alpine3.21/zts/docker-php-ext-configure → 8.4/alpine3.23/zts/docker-php-ext-configure b/8.4/alpine3.21/zts/docker-php-ext-configure → 8.4/alpine3.23/zts/docker-php-ext-configure
diff --git a/8.4/alpine3.21/zts/docker-php-ext-enable → 8.4/alpine3.23/zts/docker-php-ext-enable b/8.4/alpine3.21/zts/docker-php-ext-enable → 8.4/alpine3.23/zts/docker-php-ext-enable
diff --git a/8.4/alpine3.21/zts/docker-php-ext-install → 8.4/alpine3.23/zts/docker-php-ext-install b/8.4/alpine3.21/zts/docker-php-ext-install → 8.4/alpine3.23/zts/docker-php-ext-install
diff --git a/8.4/alpine3.21/zts/docker-php-source → 8.4/alpine3.23/zts/docker-php-source b/8.4/alpine3.21/zts/docker-php-source → 8.4/alpine3.23/zts/docker-php-source
diff --git a/8.5/alpine3.21/cli/Dockerfile → 8.5/alpine3.23/cli/Dockerfile b/8.5/alpine3.21/cli/Dockerfile → 8.5/alpine3.23/cli/Dockerfile
diff --git a/8.5/alpine3.21/cli/docker-php-entrypoint → 8.5/alpine3.23/cli/docker-php-entrypoint b/8.5/alpine3.21/cli/docker-php-entrypoint → 8.5/alpine3.23/cli/docker-php-entrypoint
diff --git a/8.5/alpine3.21/cli/docker-php-ext-configure → 8.5/alpine3.23/cli/docker-php-ext-configure b/8.5/alpine3.21/cli/docker-php-ext-configure → 8.5/alpine3.23/cli/docker-php-ext-configure
diff --git a/8.5/alpine3.21/cli/docker-php-ext-enable → 8.5/alpine3.23/cli/docker-php-ext-enable b/8.5/alpine3.21/cli/docker-php-ext-enable → 8.5/alpine3.23/cli/docker-php-ext-enable
diff --git a/8.5/alpine3.21/cli/docker-php-ext-install → 8.5/alpine3.23/cli/docker-php-ext-install b/8.5/alpine3.21/cli/docker-php-ext-install → 8.5/alpine3.23/cli/docker-php-ext-install
diff --git a/8.5/alpine3.21/cli/docker-php-source → 8.5/alpine3.23/cli/docker-php-source b/8.5/alpine3.21/cli/docker-php-source → 8.5/alpine3.23/cli/docker-php-source
diff --git a/8.5/alpine3.21/fpm/Dockerfile → 8.5/alpine3.23/fpm/Dockerfile b/8.5/alpine3.21/fpm/Dockerfile → 8.5/alpine3.23/fpm/Dockerfile
diff --git a/8.5/alpine3.21/fpm/docker-php-entrypoint → 8.5/alpine3.23/fpm/docker-php-entrypoint b/8.5/alpine3.21/fpm/docker-php-entrypoint → 8.5/alpine3.23/fpm/docker-php-entrypoint
diff --git a/8.5/alpine3.21/fpm/docker-php-ext-configure → 8.5/alpine3.23/fpm/docker-php-ext-configure b/8.5/alpine3.21/fpm/docker-php-ext-configure → 8.5/alpine3.23/fpm/docker-php-ext-configure
diff --git a/8.5/alpine3.21/fpm/docker-php-ext-enable → 8.5/alpine3.23/fpm/docker-php-ext-enable b/8.5/alpine3.21/fpm/docker-php-ext-enable → 8.5/alpine3.23/fpm/docker-php-ext-enable
diff --git a/8.5/alpine3.21/fpm/docker-php-ext-install → 8.5/alpine3.23/fpm/docker-php-ext-install b/8.5/alpine3.21/fpm/docker-php-ext-install → 8.5/alpine3.23/fpm/docker-php-ext-install
diff --git a/8.5/alpine3.21/fpm/docker-php-source → 8.5/alpine3.23/fpm/docker-php-source b/8.5/alpine3.21/fpm/docker-php-source → 8.5/alpine3.23/fpm/docker-php-source
diff --git a/8.5/alpine3.21/zts/Dockerfile → 8.5/alpine3.23/zts/Dockerfile b/8.5/alpine3.21/zts/Dockerfile → 8.5/alpine3.23/zts/Dockerfile
diff --git a/8.5/alpine3.21/zts/docker-php-entrypoint → 8.5/alpine3.23/zts/docker-php-entrypoint b/8.5/alpine3.21/zts/docker-php-entrypoint → 8.5/alpine3.23/zts/docker-php-entrypoint
diff --git a/8.5/alpine3.21/zts/docker-php-ext-configure → 8.5/alpine3.23/zts/docker-php-ext-configure b/8.5/alpine3.21/zts/docker-php-ext-configure → 8.5/alpine3.23/zts/docker-php-ext-configure
diff --git a/8.5/alpine3.21/zts/docker-php-ext-enable → 8.5/alpine3.23/zts/docker-php-ext-enable b/8.5/alpine3.21/zts/docker-php-ext-enable → 8.5/alpine3.23/zts/docker-php-ext-enable
diff --git a/8.5/alpine3.21/zts/docker-php-ext-install → 8.5/alpine3.23/zts/docker-php-ext-install b/8.5/alpine3.21/zts/docker-php-ext-install → 8.5/alpine3.23/zts/docker-php-ext-install
diff --git a/8.5/alpine3.21/zts/docker-php-source → 8.5/alpine3.23/zts/docker-php-source b/8.5/alpine3.21/zts/docker-php-source → 8.5/alpine3.23/zts/docker-php-source
diff --git a/versions.json b/versions.json
@@ -36,12 +36,12 @@
       "bookworm/apache",
       "bookworm/fpm",
       "bookworm/zts",
+      "alpine3.23/cli",
+      "alpine3.23/fpm",
+      "alpine3.23/zts",
       "alpine3.22/cli",
       "alpine3.22/fpm",
-      "alpine3.22/zts",
-      "alpine3.21/cli",
-      "alpine3.21/fpm",
-      "alpine3.21/zts"
+      "alpine3.22/zts"
     ]
   },
   "8.2-rc": null,
@@ -59,12 +59,12 @@
       "bookworm/apache",
       "bookworm/fpm",
       "bookworm/zts",
+      "alpine3.23/cli",
+      "alpine3.23/fpm",
+      "alpine3.23/zts",
       "alpine3.22/cli",
       "alpine3.22/fpm",
-      "alpine3.22/zts",
-      "alpine3.21/cli",
-      "alpine3.21/fpm",
-      "alpine3.21/zts"
+      "alpine3.22/zts"
     ]
   },
   "8.3-rc": null,
@@ -82,12 +82,12 @@
       "bookworm/apache",
       "bookworm/fpm",
       "bookworm/zts",
+      "alpine3.23/cli",
+      "alpine3.23/fpm",
+      "alpine3.23/zts",
       "alpine3.22/cli",
       "alpine3.22/fpm",
-      "alpine3.22/zts",
-      "alpine3.21/cli",
-      "alpine3.21/fpm",
-      "alpine3.21/zts"
+      "alpine3.22/zts"
     ]
   },
   "8.4-rc": null,
@@ -105,12 +105,12 @@
       "bookworm/apache",
       "bookworm/fpm",
       "bookworm/zts",
+      "alpine3.23/cli",
+      "alpine3.23/fpm",
+      "alpine3.23/zts",
       "alpine3.22/cli",
       "alpine3.22/fpm",
-      "alpine3.22/zts",
-      "alpine3.21/cli",
-      "alpine3.21/fpm",
-      "alpine3.21/zts"
+      "alpine3.22/zts"
     ]
   },
   "8.5-rc": null

diff --git a/versions.sh b/versions.sh
@@ -82,6 +82,7 @@ for version in "${versions[@]}"; do
 	for suite in \
 		trixie \
 		bookworm \
+		alpine3.23 \
 		alpine3.22 \
 		alpine3.21 \
 	; do
@@ -90,6 +91,14 @@ for version in "${versions[@]}"; do
 				if [ "$variant" = 'apache' ]; then
 					continue
 				fi
+				if [[ "$rcVersion" = '8.1' ]] && [[ "$suite" = 'alpine3.23' ]]; then
+					# Keep PHP 8.1 with Alpine 3.21 default until end of year; see also https://github.com/docker-library/php/blob/9ab2e4b37addffaa10f06d9e5f54f7bd1f5ef18f/generate-stackbrew-library.sh#L120
 		# intl will not compile on Alpine 3.22 causing build failures for downstream images (joomla, mediawiki, wordpress): https://github.com/docker-library/php/issues/1585 
 		# since PHP 8.1 is EOL at the end of the year and wont likely get fixes, keep the default Alpine at 3.21 
 		| if env.version == "8.1" then 
 			"alpine3.21" 
 		# intl will not compile on Alpine 3.22 causing build failures for downstream images (joomla, mediawiki, wordpress): https://github.com/docker-library/php/issues/1585 
 		# since PHP 8.1 is EOL at the end of the year and wont likely get fixes, keep the default Alpine at 3.21 
 		| if env.version == "8.1" then 
 			"alpine3.21" 
+					continue
+				fi
+				if [[ "$rcVersion" != '8.1' ]] && [[ "$suite" = 'alpine3.21' ]]; then
+					# Keep Alpine 3.21 just for 8.1
+					continue
+				fi
 			fi
 			export suite variant
 			variants="$(jq <<<"$variants" -c '. + [ env.suite + "/" + env.variant ]')"