Makefile

# =============================================================================
# TYPO3 Docker Images — Makefile
# =============================================================================

PHP_VERSION ?= 8.3
TYPO3_VERSION ?= 13
REGISTRY ?= ghcr.io
BASE_IMAGE ?= $(REGISTRY)/typo3incubator/typo3-base
DEMO_IMAGE ?= $(REGISTRY)/typo3incubator/typo3-demo
CONTRIB_IMAGE ?= $(REGISTRY)/typo3incubator/typo3-contrib
HTTP_PORT ?= 8080
HTTP_PORT_CONTRIB ?= 28080

.PHONY: help build-base build-base-fpm build-base-slim build-base-fpm-slim build-demo build-demo-intro build-contrib build-all demo up down contrib-up contrib-down contrib-enter contrib-db-enter clean test test-fpm test-slim test-fpm-slim

help: ## Show this help
	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | \
		awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'

# ---------------------------------------------------------------------------
# Build
# ---------------------------------------------------------------------------

build-base: ## Build the base image (nginx variant)
	docker build -f Dockerfile.base \
		--target nginx \
		-t $(BASE_IMAGE):$(PHP_VERSION)-nginx \
		--build-arg PHP_VERSION=$(PHP_VERSION) \
		.

build-base-fpm: ## Build the base image (fpm-only variant)
	docker build -f Dockerfile.base \
		--target fpm \
		-t $(BASE_IMAGE):$(PHP_VERSION)-fpm \
		--build-arg PHP_VERSION=$(PHP_VERSION) \
		.

build-base-slim: ## Build the slim base image (nginx, no GraphicsMagick)
	docker build -f Dockerfile.base \
		--target nginx-slim \
		-t $(BASE_IMAGE):$(PHP_VERSION)-nginx-slim \
		--build-arg PHP_VERSION=$(PHP_VERSION) \
		.

build-base-fpm-slim: ## Build the slim base image (fpm-only, no GraphicsMagick)
	docker build -f Dockerfile.base \
		--target fpm-slim \
		-t $(BASE_IMAGE):$(PHP_VERSION)-fpm-slim \
		--build-arg PHP_VERSION=$(PHP_VERSION) \
		.

build-demo: ## Build the demo image (requires base)
	docker build -f Dockerfile.demo \
		-t $(DEMO_IMAGE):$(TYPO3_VERSION)-php$(PHP_VERSION) \
		-t $(DEMO_IMAGE):$(TYPO3_VERSION) \
		--build-arg PHP_VERSION=$(PHP_VERSION) \
		--build-arg TYPO3_VERSION=$(TYPO3_VERSION) \
		.

build-demo-intro: ## Build the demo image with Introduction Package (requires base)
	docker build -f Dockerfile.demo \
		-t $(DEMO_IMAGE):$(TYPO3_VERSION)-intro-php$(PHP_VERSION) \
		-t $(DEMO_IMAGE):$(TYPO3_VERSION)-intro \
		--build-arg PHP_VERSION=$(PHP_VERSION) \
		--build-arg TYPO3_VERSION=$(TYPO3_VERSION) \
		--build-arg TYPO3_DEMO_CONTENT=introduction \
		.

build-contrib: build-base-fpm ## Build the contrib image (requires base fpm)
	docker build -f Dockerfile.contrib \
		-t $(CONTRIB_IMAGE):$(PHP_VERSION) \
		--build-arg PHP_VERSION=$(PHP_VERSION) \
		.

build-all: build-base build-base-fpm build-base-slim build-base-fpm-slim build-demo build-contrib ## Build all images

# ---------------------------------------------------------------------------
# Build Matrix (all combinations)
# ---------------------------------------------------------------------------

matrix: ## Build the full matrix (all PHP + TYPO3 versions, both variants)
	@echo "=== Building Base Images (nginx) ==="
	$(MAKE) build-base PHP_VERSION=8.2
	$(MAKE) build-base PHP_VERSION=8.3
	$(MAKE) build-base PHP_VERSION=8.4
	@echo "=== Building Base Images (fpm) ==="
	$(MAKE) build-base-fpm PHP_VERSION=8.2
	$(MAKE) build-base-fpm PHP_VERSION=8.3
	$(MAKE) build-base-fpm PHP_VERSION=8.4
	@echo "=== Building Base Images (nginx-slim) ==="
	$(MAKE) build-base-slim PHP_VERSION=8.2
	$(MAKE) build-base-slim PHP_VERSION=8.3
	$(MAKE) build-base-slim PHP_VERSION=8.4
	@echo "=== Building Base Images (fpm-slim) ==="
	$(MAKE) build-base-fpm-slim PHP_VERSION=8.2
	$(MAKE) build-base-fpm-slim PHP_VERSION=8.3
	$(MAKE) build-base-fpm-slim PHP_VERSION=8.4
	@echo "=== Building Demo Images ==="
	$(MAKE) build-demo PHP_VERSION=8.2 TYPO3_VERSION=13
	$(MAKE) build-demo PHP_VERSION=8.3 TYPO3_VERSION=13
	$(MAKE) build-demo PHP_VERSION=8.4 TYPO3_VERSION=13
	$(MAKE) build-demo PHP_VERSION=8.3 TYPO3_VERSION=14
	$(MAKE) build-demo PHP_VERSION=8.4 TYPO3_VERSION=14
	@echo "=== Building Demo Images (Introduction Package) ==="
	$(MAKE) build-demo-intro PHP_VERSION=8.2 TYPO3_VERSION=13
	$(MAKE) build-demo-intro PHP_VERSION=8.3 TYPO3_VERSION=13
	$(MAKE) build-demo-intro PHP_VERSION=8.4 TYPO3_VERSION=13
	$(MAKE) build-demo-intro PHP_VERSION=8.3 TYPO3_VERSION=14
	$(MAKE) build-demo-intro PHP_VERSION=8.4 TYPO3_VERSION=14
	@echo "=== Building Contrib Images ==="
	$(MAKE) build-contrib PHP_VERSION=8.2
	$(MAKE) build-contrib PHP_VERSION=8.3
	$(MAKE) build-contrib PHP_VERSION=8.4

# ---------------------------------------------------------------------------
# Run
# ---------------------------------------------------------------------------

demo: build-all ## Build and start the demo
	PHP_VERSION=$(PHP_VERSION) TYPO3_VERSION=$(TYPO3_VERSION) HTTP_PORT=$(HTTP_PORT) \
		docker compose -f docker-compose.demo.yml up --build

up: ## Start demo (without rebuild)
	HTTP_PORT=$(HTTP_PORT) docker compose -f docker-compose.demo.yml up -d

down: ## Stop demo
	docker compose -f docker-compose.demo.yml down

contrib-up: ## Start contribution setup
	HTTP_PORT=$(HTTP_PORT_CONTRIB) docker compose -f docker-compose.contrib.yml up --build

contrib-enter: ## Enter contribution setup
	docker compose -f docker-compose.contrib.yml exec web sh

contrib-db-enter: ## Enter contribution DB
	docker compose -f docker-compose.contrib.yml exec db sh

contrib-down: ## Stop contribution setup
	docker compose -f docker-compose.contrib.yml down

# ---------------------------------------------------------------------------
# Test
# ---------------------------------------------------------------------------

test: build-base ## Run smoke tests on base image (nginx variant)
	@echo "=== Testing PHP extensions ==="
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-nginx -m | grep -q gd && echo "✓ gd"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-nginx -m | grep -q intl && echo "✓ intl"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-nginx -m | grep -qi opcache && echo "✓ opcache"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-nginx -m | grep -q mysqli && echo "✓ mysqli"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-nginx -m | grep -q pdo_mysql && echo "✓ pdo_mysql"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-nginx -m | grep -q pdo_pgsql && echo "✓ pdo_pgsql"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-nginx -m | grep -q redis && echo "✓ redis"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-nginx -m | grep -q apcu && echo "✓ apcu"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-nginx -m | grep -q zip && echo "✓ zip"
	@echo "=== Testing Composer ==="
	docker run --rm --entrypoint composer $(BASE_IMAGE):$(PHP_VERSION)-nginx --version
	@echo "=== Testing Nginx ==="
	docker run --rm --entrypoint sh $(BASE_IMAGE):$(PHP_VERSION)-nginx -c 'sed -i "s|\$$TYPO3_CONTEXT|Production|g" /etc/nginx/conf.d/default.conf && nginx -t'
	@echo "=== Testing GraphicsMagick ==="
	docker run --rm --entrypoint gm $(BASE_IMAGE):$(PHP_VERSION)-nginx version | head -1
	@echo "=== All nginx variant tests passed ==="

test-fpm: build-base-fpm ## Run smoke tests on base image (fpm-only variant)
	@echo "=== Testing PHP extensions ==="
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-fpm -m | grep -q gd && echo "✓ gd"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-fpm -m | grep -q intl && echo "✓ intl"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-fpm -m | grep -qi opcache && echo "✓ opcache"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-fpm -m | grep -q mysqli && echo "✓ mysqli"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-fpm -m | grep -q pdo_mysql && echo "✓ pdo_mysql"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-fpm -m | grep -q pdo_pgsql && echo "✓ pdo_pgsql"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-fpm -m | grep -q redis && echo "✓ redis"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-fpm -m | grep -q apcu && echo "✓ apcu"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-fpm -m | grep -q zip && echo "✓ zip"
	@echo "=== Testing Composer ==="
	docker run --rm --entrypoint composer $(BASE_IMAGE):$(PHP_VERSION)-fpm --version
	@echo "=== Testing GraphicsMagick ==="
	docker run --rm --entrypoint gm $(BASE_IMAGE):$(PHP_VERSION)-fpm version | head -1
	@echo "=== All fpm variant tests passed ==="

test-slim: build-base-slim ## Run smoke tests on slim base image (nginx, no GraphicsMagick)
	@echo "=== Testing PHP extensions ==="
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-nginx-slim -m | grep -q gd && echo "✓ gd"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-nginx-slim -m | grep -q intl && echo "✓ intl"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-nginx-slim -m | grep -qi opcache && echo "✓ opcache"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-nginx-slim -m | grep -q mysqli && echo "✓ mysqli"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-nginx-slim -m | grep -q pdo_mysql && echo "✓ pdo_mysql"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-nginx-slim -m | grep -q pdo_pgsql && echo "✓ pdo_pgsql"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-nginx-slim -m | grep -q redis && echo "✓ redis"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-nginx-slim -m | grep -q apcu && echo "✓ apcu"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-nginx-slim -m | grep -q zip && echo "✓ zip"
	@echo "=== Testing Composer ==="
	docker run --rm --entrypoint composer $(BASE_IMAGE):$(PHP_VERSION)-nginx-slim --version
	@echo "=== Testing Nginx ==="
	docker run --rm --entrypoint sh $(BASE_IMAGE):$(PHP_VERSION)-nginx-slim -c 'sed -i "s|\$$TYPO3_CONTEXT|Production|g" /etc/nginx/conf.d/default.conf && nginx -t'
	@echo "=== Verifying NO GraphicsMagick ==="
	docker run --rm --entrypoint sh $(BASE_IMAGE):$(PHP_VERSION)-nginx-slim -c '! command -v gm' && echo "✓ gm not installed (slim)"
	@echo "=== All nginx-slim variant tests passed ==="

test-fpm-slim: build-base-fpm-slim ## Run smoke tests on slim base image (fpm-only, no GraphicsMagick)
	@echo "=== Testing PHP extensions ==="
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-fpm-slim -m | grep -q gd && echo "✓ gd"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-fpm-slim -m | grep -q intl && echo "✓ intl"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-fpm-slim -m | grep -qi opcache && echo "✓ opcache"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-fpm-slim -m | grep -q mysqli && echo "✓ mysqli"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-fpm-slim -m | grep -q pdo_mysql && echo "✓ pdo_mysql"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-fpm-slim -m | grep -q pdo_pgsql && echo "✓ pdo_pgsql"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-fpm-slim -m | grep -q redis && echo "✓ redis"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-fpm-slim -m | grep -q apcu && echo "✓ apcu"
	docker run --rm --entrypoint php $(BASE_IMAGE):$(PHP_VERSION)-fpm-slim -m | grep -q zip && echo "✓ zip"
	@echo "=== Testing Composer ==="
	docker run --rm --entrypoint composer $(BASE_IMAGE):$(PHP_VERSION)-fpm-slim --version
	@echo "=== Verifying NO GraphicsMagick ==="
	docker run --rm --entrypoint sh $(BASE_IMAGE):$(PHP_VERSION)-fpm-slim -c '! command -v gm' && echo "✓ gm not installed (slim)"
	@echo "=== All fpm-slim variant tests passed ==="

# ---------------------------------------------------------------------------
# Cleanup
# ---------------------------------------------------------------------------

clean: ## Remove all built images and volumes
	docker compose -f docker-compose.demo.yml down -v --rmi local 2>/dev/null || true
	docker compose -f docker-compose.contrib.yml down -v --rmi local 2>/dev/null || true
	docker rmi $(BASE_IMAGE):$(PHP_VERSION)-nginx 2>/dev/null || true
	docker rmi $(BASE_IMAGE):$(PHP_VERSION)-fpm 2>/dev/null || true
	docker rmi $(BASE_IMAGE):$(PHP_VERSION)-nginx-slim 2>/dev/null || true
	docker rmi $(BASE_IMAGE):$(PHP_VERSION)-fpm-slim 2>/dev/null || true
	docker rmi $(DEMO_IMAGE):$(TYPO3_VERSION)-php$(PHP_VERSION) 2>/dev/null || true
	docker rmi $(DEMO_IMAGE):$(TYPO3_VERSION) 2>/dev/null || true
	docker rmi $(DEMO_IMAGE):$(TYPO3_VERSION)-intro-php$(PHP_VERSION) 2>/dev/null || true
	docker rmi $(DEMO_IMAGE):$(TYPO3_VERSION)-intro 2>/dev/null || true
	docker rmi $(CONTRIB_IMAGE):$(PHP_VERSION) 2>/dev/null || true