Add local test environment via docker-compose + Makefile

docker-compose.yml mirrors the CI setup: MySQL 8 + FrankenPHP on a
shared named network. wp-cli runs in a container on that network so
DB_HOST=mysql works consistently. Makefile exposes three targets:
  make test-env   — first-time setup (downloads WP, starts stack)
  make test       — run the suite
  make test-reset — tear down and start completely fresh

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: osbre

.gitignore

@@ -6,3 +6,4 @@ node_modules/
 var
 drivers
 driver
+tmp/

Makefile

@@ -0,0 +1,47 @@
+WP_VERSION  ?= 6.8
+WP_URL       = http://localhost:8100
+WP_PATH      = /var/www/html
+NETWORK      = simpleanalytics-wptest
+WP_CLI       = docker run --rm --network $(NETWORK) -v $(PWD)/tmp/wp:$(WP_PATH) wordpress:cli
+
+.PHONY: test-env test test-reset _wp-install
+
+## Start containers + install WordPress (idempotent)
+test-env: tmp/wp/wp-login.php
+	docker compose up -d --build --wait
+	$(MAKE) _wp-install
+
+## Run the test suite
+test:
+	./vendor/bin/phpunit --colors=always
+
+## Tear everything down and start fresh
+test-reset:
+	docker compose down -v
+	rm -rf tmp/wp
+	$(MAKE) test-env
+
+# ── internals ──────────────────────────────────────────────────────────────────
+
+tmp/wp/wp-login.php:
+	mkdir -p tmp/wp
+	curl -s -O https://wordpress.org/wordpress-$(WP_VERSION).tar.gz
+	tar -xzf wordpress-$(WP_VERSION).tar.gz --strip-components=1 -C tmp/wp
+	rm -f wordpress-$(WP_VERSION).tar.gz
+
+_wp-install:
+	rm -f tmp/wp/wp-config.php
+	$(WP_CLI) wp config create \
+		--dbname=wordpress --dbuser=root --dbpass=root \
+		--dbhost=mysql --path=$(WP_PATH) --skip-check
+	$(WP_CLI) wp core install \
+		--url=$(WP_URL) --title="Test Site" \
+		--admin_user=admin --admin_password=admin \
+		--admin_email=test@example.com \
+		--path=$(WP_PATH) --skip-email --allow-root
+	$(WP_CLI) wp user create author author@local.test \
+		--role=author --user_pass=author --path=$(WP_PATH) --allow-root
+	$(WP_CLI) wp user create editor editor@local.test \
+		--role=editor --user_pass=editor --path=$(WP_PATH) --allow-root
+	$(WP_CLI) wp user create subscriber subscriber@local.test \
+		--role=subscriber --user_pass=subscriber --path=$(WP_PATH) --allow-root

docker-compose.yml

@@ -0,0 +1,43 @@
+services:
+    mysql:
+        image: mysql:8.0
+        environment:
+            MYSQL_DATABASE: wordpress
+            MYSQL_ROOT_PASSWORD: root
+        ports:
+            - "3306:3306"
+        healthcheck:
+            test: ["CMD", "mysqladmin", "ping", "-h", "127.0.0.1", "-uroot", "-proot"]
+            interval: 5s
+            timeout: 3s
+            retries: 10
+        networks:
+            - wptest
+
+    frankenphp:
+        build:
+            context: .
+            dockerfile: .github/docker/Dockerfile
+            args:
+                PHP_VERSION: 8.4
+        ports:
+            - "8100:8100"
+        volumes:
+            - ./tmp/wp:/var/www/html
+            - .:/var/www/html/wp-content/plugins/simpleanalytics
+            - ./Caddyfile:/etc/frankenphp/Caddyfile
+        depends_on:
+            mysql:
+                condition: service_healthy
+        healthcheck:
+            test: ["CMD", "curl", "-sf", "http://localhost:8100"]
+            interval: 5s
+            timeout: 3s
+            retries: 20
+            start_period: 10s
+        networks:
+            - wptest
+
+networks:
+    wptest:
+        name: simpleanalytics-wptest