Enhance Docker configuration and add Xdebug support

.dockerignore

@@ -0,0 +1,35 @@
+# Include any files or directories that you don't want to be copied to your
+# container here (e.g., local build artifacts, temporary files, etc.).
+#
+# For more help, visit the .dockerignore file reference guide at
+# https://docs.docker.com/go/build-context-dockerignore/
+
+**/.classpath
+**/.dockerignore
+**/.env
+**/.git
+**/.gitignore
+**/.project
+**/.settings
+**/.toolstarget
+**/.vs
+**/.vscode
+**/.next
+**/.cache
+**/*.*proj.user
+**/*.dbmdl
+**/*.jfm
+**/charts
+**/docker-compose*
+**/compose.y*ml
+!**/composer.json
+!**/composer.lock
+**/Dockerfile*
+**/node_modules
+**/npm-debug.log
+**/obj
+**/secrets.dev.yaml
+**/values.dev.yaml
+**/vendor
+LICENSE
+README.md

docker-compose.yml

@@ -41,8 +41,9 @@ services:
       - database-password
     networks:
       - app-network
-    volumes:
-      - database-data:/var/lib/mysql
+    #* Uncomment the following lines to persist the database data
+    # volumes:
+    #   - database-data:/var/lib/mysql
     ports:
       - "3306:3306"
     environment:

docker/server/Dockerfile

@@ -1,26 +1,34 @@
 # syntax=docker/dockerfile:1
 
+#* Create a prod stage for installing app dependencies defined in Composer.
 FROM composer:lts AS prod-deps
 WORKDIR /app
 RUN --mount=type=bind,source=./composer.json,target=composer.json \
     --mount=type=bind,source=./composer.lock,target=composer.lock \
     --mount=type=cache,target=/tmp/cache \
     composer install --no-dev --no-interaction
 
+#* Create a dev stage for installing app dev dependencies defined in Composer.
 FROM composer:lts AS dev-deps
 WORKDIR /app
 RUN --mount=type=bind,source=./composer.json,target=composer.json \
     --mount=type=bind,source=./composer.lock,target=composer.lock \
     --mount=type=cache,target=/tmp/cache \
     composer install --no-interaction
 
+#* Create a base stage for building the app image.
 FROM php:8.2-apache AS base
 RUN docker-php-ext-install pdo pdo_mysql
 RUN a2enmod rewrite
 COPY ./src /var/www/html
 
+#* Create a development stage.
 FROM base AS development
 COPY ./tests /var/www/html/tests
+# Add PECL extensions, and enable Xdebug.
+# See https://github.com/docker-library/docs/tree/master/php#pecl-extensions
+RUN pecl install xdebug-3.2.1 \
+    && docker-php-ext-enable xdebug
 RUN mv "$PHP_INI_DIR/php.ini-development" "$PHP_INI_DIR/php.ini"
 COPY --from=dev-deps app/vendor/ /var/www/html/vendor
 
@@ -29,7 +37,10 @@ COPY --from=dev-deps app/vendor/ /var/www/html/vendor
 # WORKDIR /var/www/html
 # RUN ./vendor/bin/phpunit tests/HelloWorldTest.php
 
+#* Create a production stage.
 FROM base AS final
 RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"
 COPY --from=prod-deps app/vendor/ /var/www/html/vendor
+# Switch to a non-privileged user (defined in the base image) that the app will run under.
+# See https://docs.docker.com/go/dockerfile-user-best-practices/
 USER www-data