feat: Add DevContainer configuration for local development

.devcontainer/devcontainer.json

@@ -0,0 +1,61 @@
+{
+    "name": "BeWelcome Rox (Docker Master)",
+    "dockerComposeFile": [
+        "../docker-compose.yml",
+        "../docker-compose.override.yml.dist"
+    ],
+    "service": "php",
+    "workspaceFolder": "/srv/bewelcome",
+    "overrideCommand": false,
+    "forwardPorts": [80, 1080, 9306, 9308],
+    "portsAttributes": {
+        "80": {
+            "label": "BeWelcome App (Nginx)",
+            "onAutoForward": "openBrowser"
+        },
+        "1080": {
+            "label": "MailPit Web UI",
+            "onAutoForward": "notify"
+        },
+        "9306": {
+            "label": "Manticore MySQL protocol",
+            "onAutoForward": "silent"
+        },
+        "9308": {
+            "label": "Manticore HTTP API",
+            "onAutoForward": "silent"
+        }
+    },
+    "postCreateCommand": "bzip2 -ckd docker/languages.sql.bz2 > docker/db/languages.sql && bzip2 -ckd docker/words.sql.bz2 > docker/db/words.sql",
+    "hostRequirements": {
+        "cpus": 2,
+        "memory": "4gb",
+        "storage": "32gb"
+    },
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                "bmewburn.vscode-intelephense-client",
+                "xdebug.php-debug",
+                "symfony-vscode.symfony-vscode",
+                "bradlc.vscode-tailwindcss",
+                "dbaeumer.vscode-eslint",
+                "esbenp.prettier-vscode",
+                "mikestead.dotenv",
+                "ms-azuretools.vscode-docker",
+                "GitHub.vscode-pull-request-github"
+            ],
+            "settings": {
+                "php.suggest.basic": false,
+                "editor.formatOnSave": true,
+                "editor.defaultFormatter": "esbenp.prettier-vscode",
+                "[php]": {
+                    "editor.defaultFormatter": "bmewburn.vscode-intelephense-client"
+                },
+                "intelephense.environment.phpVersion": "8.4.0",
+                "intelephense.files.maxSize": 5000000,
+                "xdebug.remote_enable": true
+            }
+        }
+    }
+}

Dockerfile

@@ -187,4 +187,7 @@ ARG NODE_ENV=production
 RUN set -eux; \
 	apk add --no-cache \
 		make \
-		mysql-client
+		mysql-client; \
+	install-php-extensions xdebug
+
+COPY docker/php/conf.d/bewelcome.xdebug.ini $PHP_INI_DIR/conf.d/xdebug.ini

docker-compose.yml

@@ -60,7 +60,10 @@ services:
       - ./data:/var/lib/manticore
 
   mailer:
-    image: tophfr/mailcatcher
+    image: axllent/mailpit
+    environment:
+      MP_SMTP_BIND_ADDR: "0.0.0.0:25"
+      MP_UI_BIND_ADDR: "0.0.0.0:80"
 
 volumes:
   db-data: {}

docker/php/conf.d/bewelcome.xdebug.ini

@@ -0,0 +1,6 @@
+; Xdebug configuration for development
+; Disabled by default for performance. To enable, you can set XDEBUG_MODE=debug
+xdebug.mode=off
+xdebug.client_host=host.docker.internal
+xdebug.start_with_request=yes
+xdebug.discover_client_host=1