Added dev build tag.

Author: Bilge

.github/workflows/build image.yaml

@@ -19,6 +19,12 @@ jobs:
         distro:
           - Alpine
           - Debian
+        target:
+          - prod
+          - dev
+        exclude:
+          - distro: Debian
+            target: dev
 
     steps:
       - uses: actions/checkout@v4
@@ -34,15 +40,21 @@ jobs:
         run: image=${GITHUB_REPOSITORY,,} && <<<image=${image%-*} tee -a "$GITHUB_ENV"
 
       - name: Build Docker image (${{ matrix.distro }})
-        run: docker build --tag ${tag=${{ env.registry }}/${{ env.image }}:${distro,,}} - <$distro.Dockerfile
+        run: <$distro.Dockerfile docker build --target $target -
+          --tag ${tag=${{ env.registry }}/${{ env.image }}:$([[ $target = dev ]] && echo $target || echo ${distro,,})}
           && <<<tag=$tag tee -a "$GITHUB_ENV"
         env:
           distro: ${{ matrix.distro }}
+          target: ${{ matrix.target }}
+
+      - name: Validate image
+        run: docker run --rm ${{ env.tag }} php -m |
+          grep -Fxq $([[ ${{ matrix.target }} = dev ]] || echo --invert-match) xdebug
 
       - name: Push Docker image (${{ env.tag }})
         run: docker push ${{ env.tag }}
 
       - name: Push "latest" tag
         run: docker tag "$tag" ${latest=${{ env.registry }}/${{ env.image }}}
           && docker push "$latest"
-        if: ${{ matrix.distro == 'Alpine' }}
+        if: matrix.target == 'prod' && matrix.distro == 'Alpine'

Alpine.Dockerfile

@@ -1,34 +1,49 @@
 # https://hub.docker.com/_/php/tags?name=-fpm-alpine
-FROM php:8.4.2-fpm-alpine
+FROM php:8.4.2-fpm-alpine AS prod
 
 RUN \
-    apk add icu icu-dev jemalloc libxslt libxslt-dev libffi libffi-dev libpq libpq-dev gmp gmp-dev \
-    && docker-php-ext-install opcache \
-        # Number formatting in our own application templates requires intl.
-        intl \
-        # symfony/messenger requires PCNTL for graceful shutdown of queue workers.
-        pcntl \
-        # Pheanstalk requires sockets extension otherwise it throws SocketException with "Unknown error" (CLUB-250-B6).
-        sockets \
-        # lorenzo/pinky requires XSL extension.
-        xsl \
-        # amphp/hpack can benefit from FFI extension.
-        ffi \
-        # amphp/postgres requires either pecl-pq or ext-pgsql.
-        pgsql \
-        # Phinx requires pdo_pgsql extension.
-        pdo_pgsql \
-        # xpaw/steamid requires GMP extension.
-        gmp \
-    # All dev packages can be removed post-compile, however the main packages cannot.
-    && apk del icu-dev libxslt-dev libffi-dev libpq-dev gmp-dev
+	apk add icu icu-dev jemalloc libxslt libxslt-dev libffi libffi-dev libpq libpq-dev gmp gmp-dev \
+	&& docker-php-ext-install opcache \
+		# Number formatting in our own application templates requires intl.
+		intl \
+		# symfony/messenger requires PCNTL for graceful shutdown of queue workers.
+		pcntl \
+		# Pheanstalk requires sockets extension otherwise it throws SocketException with "Unknown error" (CLUB-250-B6).
+		sockets \
+		# lorenzo/pinky requires XSL extension.
+		xsl \
+		# amphp/hpack can benefit from FFI extension.
+		ffi \
+		# amphp/postgres requires either pecl-pq or ext-pgsql.
+		pgsql \
+		# Phinx requires pdo_pgsql extension.
+		pdo_pgsql \
+		# xpaw/steamid requires GMP extension.
+		gmp \
+	# All dev packages can be removed post-compile, however the main packages cannot.
+	&& apk del icu-dev libxslt-dev libffi-dev libpq-dev gmp-dev
 
 # Replace the slow musl allocator.
 ENV LD_PRELOAD=libjemalloc.so.2
 
 RUN \
-    # Validate jemalloc preloaded.
-    ldd `which php` | grep libjemalloc.so.2 && \
-    # Install Composer.
-    wget https://raw.githubusercontent.com/composer/getcomposer.org/main/web/installer -qO- |\
-        php -- --install-dir /usr/local/bin --filename composer
+	# Validate jemalloc preloaded.
+	ldd `which php` | grep libjemalloc.so.2 && \
+	# Install Composer.
+	wget https://raw.githubusercontent.com/composer/getcomposer.org/main/web/installer -qO- |\
+		php -- --install-dir /usr/local/bin --filename composer
+
+FROM prod AS dev
+
+RUN \
+	apk add autoconf gcc libc-dev linux-headers make \
+	&& pecl install xdebug \
+	&& docker-php-ext-enable xdebug \
+	&& apk del autoconf gcc libc-dev linux-headers make
+
+RUN <<-'.'
+	>>/usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini echo -n '
+		xdebug.mode=debug
+		xdebug.client_host=host.docker.internal
+	'
+.

Debian.Dockerfile

@@ -1,30 +1,30 @@
 # https://hub.docker.com/_/php/tags
-FROM php:8.4.2-fpm
+FROM php:8.4.2-fpm AS prod
 
 RUN apt-get update && \
-    apt-get --assume-yes install libicu-dev libxslt1.1 libxslt1-dev libffi-dev libpq5 libpq-dev libgmp-dev unzip \
-    && docker-php-ext-install opcache \
-        # Number formatting in our own application templates requires intl.
-        intl \
-        # symfony/messenger requires PCNTL for graceful shutdown of queue workers.
-        pcntl \
-        # Pheanstalk requires sockets extension otherwise it throws SocketException with "Unknown error" (CLUB-250-B6).
-        sockets \
-        # lorenzo/pinky requires XSL extension.
-        xsl \
-        # amphp/hpack can benefit from FFI extension.
-        ffi \
-        # amphp/postgres requires either pecl-pq or ext-pgsql.
-        pgsql \
-        # Phinx requires pdo_pgsql extension.
-        pdo_pgsql \
-        # xpaw/steamid requires GMP extension.
-        gmp \
-    # All dev packages can be removed post-compile, however the main packages cannot.
-    && apt-get --assume-yes purge libicu-dev libxslt1-dev libffi-dev libpq-dev libgmp-dev \
-    && apt-get --assume-yes autoremove \
-    && rm -rf /var/lib/apt/lists/*
+	apt-get --assume-yes install libicu-dev libxslt1.1 libxslt1-dev libffi-dev libpq5 libpq-dev libgmp-dev unzip \
+	&& docker-php-ext-install opcache \
+		# Number formatting in our own application templates requires intl.
+		intl \
+		# symfony/messenger requires PCNTL for graceful shutdown of queue workers.
+		pcntl \
+		# Pheanstalk requires sockets extension otherwise it throws SocketException with "Unknown error" (CLUB-250-B6).
+		sockets \
+		# lorenzo/pinky requires XSL extension.
+		xsl \
+		# amphp/hpack can benefit from FFI extension.
+		ffi \
+		# amphp/postgres requires either pecl-pq or ext-pgsql.
+		pgsql \
+		# Phinx requires pdo_pgsql extension.
+		pdo_pgsql \
+		# xpaw/steamid requires GMP extension.
+		gmp \
+	# All dev packages can be removed post-compile, however the main packages cannot.
+	&& apt-get --assume-yes purge libicu-dev libxslt1-dev libffi-dev libpq-dev libgmp-dev \
+	&& apt-get --assume-yes autoremove \
+	&& rm -rf /var/lib/apt/lists/*
 
 # Install Composer.
 RUN curl https://raw.githubusercontent.com/composer/getcomposer.org/main/web/installer |\
-    php -- --install-dir /usr/local/bin --filename composer
+	php -- --install-dir /usr/local/bin --filename composer