diff --git a/Dockerfile-linux.template b/Dockerfile-linux.template
index 06c4c32c8..14c9d15c2 100644
--- a/Dockerfile-linux.template
+++ b/Dockerfile-linux.template
@@ -385,11 +385,18 @@ RUN set -eux; \
 {{ if [ "8.1", "8.2" ] | index(env.version | rtrimstr("-rc")) then ( -}}
 		--enable-zend-max-execution-timers \
 {{ ) else "" end -}}
+{{ ) else "" end -}}
+{{ if env.DOCKER_PHP_ENABLE_DEBUG then ( -}}
+{{ # DOCKER_PHP_ENABLE_DEBUG is not used or supported by official-images; this is for users who want to build their own php image with debug enabled -}}
+{{ # example usage to regenerate Dockerfiles with debug enabled: "DOCKER_PHP_ENABLE_DEBUG=1 ./apply-templates" -}}
+		--enable-debug \
 {{ ) else "" end -}}
 	; \
 	make -j "$(nproc)"; \
 	find -type f -name '*.a' -delete; \
 	make install; \
+{{ if env.DOCKER_PHP_ENABLE_DEBUG then "" else ( -}}
+{{ # DOCKER_PHP_ENABLE_DEBUG is not used by official-images -}}
 	find \
 		/usr/local \
 		-type f \
@@ -398,6 +405,7 @@ RUN set -eux; \
 			strip --strip-all "$@" || : \
 		' -- '{}' + \
 	; \
+{{ ) end -}}
 	make clean; \
 	\
 # https://github.com/docker-library/php/issues/692 (copy default example "php.ini" files somewhere easily discoverable)