Makefile

#!make
# Primary dev image: make docker-build-22 → php-compiler:22.04-dev (issues #73, #202).
# Legacy ircmaxell/php-compiler:* targets below are deprecated (Docker Hub 404).

.PHONY: composer-install
composer-install:
	docker run -v $(shell pwd):/compiler ircmaxell/php-compiler:16.04-dev composer install --no-ansi --no-interaction --no-progress
	#docker run -v $(shell pwd):/compiler ircmaxell/php-compiler:16.04-dev php vendor/pre/plugin/source/environment.php
	#docker run -v $(shell pwd):/compiler --entrypoint "/usr/bin/patch" ircmaxell/php-compiler:16.04-dev -p0 -d /compiler/vendor/pre/plugin/hidden/vendor/yay/yay/src -i /compiler/Docker/yaypatch.patch

.PHONY: composer-update
composer-update:
	docker run -v $(shell pwd):/compiler ircmaxell/php-compiler:16.04-dev composer update --no-ansi --no-interaction --no-progress

.PHONY: shell
shell:
	docker run -it --cap-add=SYS_PTRACE --security-opt seccomp=unconfined -v $(shell pwd):/compiler ircmaxell/php-compiler:16.04-dev /bin/bash

.PHONY: shell-18
shell-18:
	docker run -it --cap-add=SYS_PTRACE --security-opt seccomp=unconfined -v $(shell pwd):/compiler ircmaxell/php-compiler:18.04-dev /bin/bash

.PHONY: docker-build-clean
docker-build-clean:
	docker build --no-cache -t ircmaxell/php-compiler:16.04-dev Docker/dev/ubuntu-16.04
	docker build --no-cache -t ircmaxell/php-compiler:16.04 -f Docker/ubuntu-16.04/Dockerfile .

.PHONY: docker-build
docker-build:
	docker build -t ircmaxell/php-compiler:16.04-dev Docker/dev/ubuntu-16.04
	docker build --no-cache -t ircmaxell/php-compiler:16.04 -f Docker/ubuntu-16.04/Dockerfile .

.PHONY: docker-build-clean-18
docker-build-clean-18:
	docker build --no-cache -t ircmaxell/php-compiler:18.04-dev Docker/dev/ubuntu-18.04
	docker build --no-cache -t ircmaxell/php-compiler:18.04 -f Docker/ubuntu-18.04/Dockerfile .

.PHONY: docker-build-18
docker-build-18:
	docker build -t ircmaxell/php-compiler:18.04-dev Docker/dev/ubuntu-18.04
	docker build --no-cache -t ircmaxell/php-compiler:18.04 -f Docker/ubuntu-18.04/Dockerfile .

.PHONY: benchmark
benchmark: rebuild-changed
	docker run -v $(shell pwd):/compiler --entrypoint php -e PHP_7_4=php ircmaxell/php-compiler:16.04 script/bench.php

.PHONY: build
build: composer-install rebuild fix rebuild-examples

.PHONY: rebuild
rebuild:
	docker run -v $(shell pwd):/compiler ircmaxell/php-compiler:16.04-dev php script/rebuild.php

.PHONY: rebuild-changed
rebuild-changed:
	docker run -v $(shell pwd):/compiler ircmaxell/php-compiler:16.04-dev php script/rebuild.php onlyChanged

.PHONY: rebuild-examples
rebuild-examples:
	docker run -v $(shell pwd):/compiler ircmaxell/php-compiler:16.04-dev php script/rebuild-examples.php

# Host: refresh examples/README.md benchmark table (requires LLVM for AOT columns)
.PHONY: bench
bench:
	./script/php-local.sh script/rebuild-examples.php

.PHONY: fix
fix:
	docker run -v $(shell pwd):/compiler ircmaxell/php-compiler:16.04-dev php vendor/bin/php-cs-fixer fix --allow-risky=yes

.PHONY: phan
phan:
	docker run -v $(shell pwd):/compiler ircmaxell/php-compiler:16.04-dev php vendor/bin/phan

# Default CI: Ubuntu 22.04 + PHP 8.2 dev image (issues #73, #249). Uses bind-mount or tar fallback.
.PHONY: test
test: docker-build-22
	./script/docker-ci-local.sh

# Harness/dev convenience: install vendor/ without host PHP/composer.
.PHONY: vendor-docker
vendor-docker: docker-build-22
	./script/docker-composer-install.sh

# Deprecated: PHP 7.4 on Ubuntu 16.04 (ircmaxell/php-compiler:16.04-dev image often unavailable).
.PHONY: test-legacy-16
test-legacy-16: rebuild-changed
	docker run -v $(shell pwd):/compiler ircmaxell/php-compiler:16.04-dev php vendor/bin/phpunit

# Run the full PHPUnit suite on the host PHP (no Docker). Requires composer install.
.PHONY: test-local test-fast test-fast-bootstrap test-fast-jit-preflight test-docker-fast test-docker-fast-jit-preflight
test-local:
	./script/ci-local.sh

# Fast CI: VM/compliance only — no JIT/AOT compile (issue #436).
test-fast:
	./script/ci-fast.sh

# Fast CI with optional bootstrap tail (aot-lint + probe + wave-check when LLVM present).
test-fast-bootstrap:
	CI_FAST_BOOTSTRAP=1 ./script/ci-fast.sh

# Fast CI with optional JIT bootstrap preflight (issue #728; LLVM present → MCJIT probe).
test-fast-jit-preflight:
	JIT_PREFLIGHT_GATE=1 ./script/ci-fast.sh

test-docker-fast: docker-build-22
	./script/docker-ci-local.sh fast

test-docker-fast-jit-preflight: docker-build-22
	JIT_PREFLIGHT_GATE=1 ./script/docker-ci-local.sh fast

# VM smoke: examples/001-SimpleWeb with ?name=Test
.PHONY: web-smoke miniwebapp-gates miniwebapp-aot-bisect north-star1-verify north-star2-verify north-star3-verify north-star4-verify north-star5-verify
web-smoke:
	./script/web-smoke.sh

# MiniWebApp CI gate ladder status (issue #503; no full CI)
miniwebapp-gates:
	./script/miniwebapp-gates.sh

# Example web integration verify (legacy target name north-star1-verify; issue #1845)
north-star1-verify:
	./script/north-star1-verify.sh

north-star2-verify:
	./script/north-star2-verify.sh

north-star3-verify:
	./script/north-star3-verify.sh

north-star4-verify:
	./script/north-star4-verify.sh
north-star5-verify:
	./script/north-star5-verify.sh

# Ordered #764 AOT PHPT ladder (issue #879; requires LLVM 9)
miniwebapp-aot-bisect:
	./script/miniwebapp-aot-bisect.sh

# HTTP smoke: phpc serve + curl for 001-SimpleWeb and 002-StaticWeb (issue #298)
.PHONY: examples-web-smoke examples-sessions-smoke examples-throws-smoke examples-throws-jit-smoke examples-fastcgiweb-smoke examples-selfhostprobe-smoke examples-serve-jit-smoke examples-fileupload-deploy-smoke examples-throwsweb-deploy-smoke examples-fastcgiweb-deploy-smoke examples-web-smoke-prebuild examples-aot-smoke deploy-smoke deploy-smoke-all
examples-web-smoke:
	./script/examples-web-smoke.sh

examples-sessions-smoke:
	./script/examples-web-smoke.sh --sessions-only

examples-throws-smoke:
	THROWS_WEB_SMOKE_GATE=1 ./script/examples-web-smoke.sh --throws-only

# 007-ThrowsWeb phpc serve --jit caught invalid POST (THROWSWEB_SERVE_JIT_SMOKE_GATE=1; issue #2408)
examples-throws-jit-smoke:
	THROWSWEB_SERVE_JIT_SMOKE_GATE=1 ./script/examples-web-smoke.sh --throws-only --jit

examples-fastcgiweb-smoke:
	FASTCGI_WEB_SMOKE_GATE=1 ./script/examples-web-smoke.sh --fastcgi-only

# 008-SelfHostProbe VM lint+run presenter (issue #2240)
examples-selfhostprobe-smoke:
	./script/examples-selfhostprobe-smoke.sh

# 001 (+ 003 when lint green, + 007 caught POST when lint green; SERVE_JIT_SMOKE_GATE=1; #2274, #2478)
examples-serve-jit-smoke:
	SERVE_JIT_SMOKE_GATE=1 ./script/examples-serve-jit-smoke.sh

# 006-FileUploadWeb deploy CGI only (FILE_UPLOAD_WEB_DEPLOY_SMOKE_GATE=1; issue #2044)
examples-fileupload-deploy-smoke:
	./script/examples-fileupload-deploy-smoke.sh

# 007-ThrowsWeb deploy CGI only (THROWSWEB_DEPLOY_SMOKE_GATE=1; issue #2124)
examples-throwsweb-deploy-smoke:
	./script/examples-throwsweb-deploy-smoke.sh

# 009-FastCGIWeb deploy CGI only (FASTCGI_WEB_DEPLOY_SMOKE_GATE=1; issue #2359)
examples-fastcgiweb-deploy-smoke:
	./script/examples-fastcgiweb-deploy-smoke.sh

examples-web-smoke-prebuild:
	./script/examples-web-smoke-prebuild.sh

# AOT build + CLI execute for 000-004 (issue #667); skips when LLVM missing
# Slice: EXAMPLES_AOT_SMOKE_ONLY=007 THROWSWEB_AOT_SMOKE_GATE=1 (#2104)
examples-aot-smoke:
	./script/examples-aot-smoke.sh

# phpc deploy + PHPC_DEPLOY_ROOT CGI smoke for 001/002 (issue #718); skips when LLVM missing
# DEPLOY_SMOKE_ALL=1 runs full ladder with skip reasons for 005/006/007/009 (#2077, #2359)
deploy-smoke:
	@if [ "$${DEPLOY_SMOKE_ALL:-0}" = "1" ]; then ./script/deploy-smoke-all.sh; else \
		./script/deploy-smoke.sh --example 001; \
		./script/deploy-smoke.sh --example 002; \
		if [ "$${DEPLOY_SMOKE_003_EXECUTE:-1}" = "1" ]; then ./script/deploy-smoke.sh --example 003; fi; \
		if [ "$${SESSIONS_WEB_DEPLOY_SMOKE_GATE:-0}" = "1" ]; then ./script/deploy-smoke.sh --example 005; fi; \
		if [ "$${FILE_UPLOAD_WEB_DEPLOY_SMOKE_GATE:-0}" = "1" ]; then ./script/deploy-smoke.sh --example 006; fi; \
		if [ "$${THROWSWEB_DEPLOY_SMOKE_GATE:-0}" = "1" ]; then ./script/deploy-smoke.sh --example 007; fi; \
		if [ "$${FASTCGI_WEB_DEPLOY_SMOKE_GATE:-0}" = "1" ]; then ./script/deploy-smoke.sh --example 009; fi; \
	fi

# Full deploy ladder 001–007/009 with explicit skip messages when gates=0 (#2077, #2359)
deploy-smoke-all:
	./script/deploy-smoke-all.sh

# Local HTTP dev server (see bin/serve.php)
SERVE_ADDR ?= 127.0.0.1:8080
SERVE_ROOT ?= examples/001-SimpleWeb
.PHONY: serve
serve:
	./phpc serve $(SERVE_ADDR) $(SERVE_ROOT)

# Deprecated: PHP 7.4 on Ubuntu 18.04. Prefer `make test` (22.04).
.PHONY: test-legacy-18
test-legacy-18: rebuild-changed
	docker run -v $(shell pwd):/compiler ircmaxell/php-compiler:18.04-dev php vendor/bin/phpunit

.PHONY: test-18
test-18: test-legacy-18

# Ubuntu 22.04 + PHP 8.2 dev image (issues #73, #202). Build once: make docker-build-22
PHP_COMPILER_DEV_IMAGE ?= ghcr.io/purhur/php-compiler:dev
LOCAL_DEV_IMAGE ?= php-compiler:22.04-dev

.PHONY: docker-build-22 docker-publish-dev
docker-build-22:
	docker build -f Docker/dev/ubuntu-22.04/Dockerfile -t $(LOCAL_DEV_IMAGE) -t $(PHP_COMPILER_DEV_IMAGE) .

# Maintainer: push dev image to ghcr.io (issue #202; requires docker login ghcr.io)
docker-publish-dev:
	./script/docker-publish-dev.sh --push

# Run full local CI inside Docker (memory-capped; see script/ci-defaults.env)
.PHONY: test-docker test-docker-safe
test-docker: docker-build-22
	./script/ci-docker-safe.sh ci-local.sh

# Alias: explicit name for memory-capped Docker CI (issues #497, #501)
test-docker-safe: test-docker

test-docker-fast-safe: docker-build-22
	./script/ci-docker-safe.sh ci-fast.sh

# Runforge / harness CI: uses docker-ci-local.sh tar fallback when bind-mount is empty (#272).
# Optional: make test-harness ARGS='--filter VMTest'
.PHONY: test-harness test-docker-exec
test-harness:
	PHP_COMPILER_REQUIRE_DOCKER_RUN_OPTS=1 ./script/docker-ci-local.sh $(ARGS)

# Ad-hoc commands in the dev image (tar fallback when bind-mount is incomplete).
test-docker-exec:
	PHP_COMPILER_REQUIRE_DOCKER_RUN_OPTS=1 ./script/docker-exec.sh $(ARGS)

# Quick PHPUnit in 22.04 dev image (deprecated: prefer test-docker-fast / ci-fast.sh)
.PHONY: test-docker-quick
test-docker-quick: test-docker-fast

.PHONY: bootstrap-inventory bootstrap-spine-phpcfg-parse-check bootstrap-profile bootstrap-aot-lint bootstrap-aot-link bootstrap-aot-link-lib bootstrap-vendor-prelink-bundles bootstrap-vendor-objects bootstrap-selfhost-probe bootstrap-selfhost-link bootstrap-selfhost-compile-smoke bootstrap-selfhost-compile-smoke-strict bootstrap-selfhost-runtime-compile-smoke bootstrap-selfhost-runtime-compile-smoke-strict bootstrap-m3-emit-tu-execute bootstrap-selfhost-compiler-driver-smoke bootstrap-selfhost-compiler-unit-probe bootstrap-selfhost-compiler-unit-probe-strict bootstrap-selfhost-jit-unit-probe bootstrap-selfhost-jit-unit-probe-strict bootstrap-selfhost-vm-unit-probe bootstrap-selfhost-parser-unit-probe bootstrap-selfhost-types-unit-probe bootstrap-selfhost-lib-spine-smoke bootstrap-selfhost-lib-spine-vm-smoke bootstrap-selfhost-vm-driver-execute-probe bootstrap-selfhost-helloworld bootstrap-selfhost-helloworld-compile-bin bootstrap-selfhost-cli-driver-emit bootstrap-selfhost-driver-host-compile bootstrap-selfhost-driver-smoke bootstrap-selfhost-full-revision-probe bootstrap-native-compile-driver-smoke bootstrap-loop-gen1-link bootstrap-loop-gen1-full-spine-emit bootstrap-loop-gen2-recompile-spine bootstrap-loop-gen2-recompile-bin-compile bootstrap-loop-gen2-recompile-minimal bootstrap-loop-probe bootstrap-loop-full-spine-probe bootstrap-loop-probe-dry bootstrap-loop-probe-dry-run bootstrap-wave-check
bootstrap-inventory:
	php script/bootstrap-inventory.php
.PHONY: bootstrap-inventory-check bootstrap-inventory-regenerate
# Phase A inventory freshness gate (works with/without host php; issue #2537).
bootstrap-inventory-check:
	@bash -lc 'if command -v php >/dev/null 2>&1; then php script/bootstrap-inventory.php --check; else ./script/docker-exec.sh -- bash -lc "php script/bootstrap-inventory.php --check"; fi'
# Regenerate docs/bootstrap-inventory.md into the host working tree (harness-safe; issue #2527, #2537).
bootstrap-inventory-regenerate:
	@bash -lc 'if command -v php >/dev/null 2>&1; then php script/bootstrap-inventory.php; else \
	  ./script/docker-exec.sh --sync-back docs/bootstrap-inventory.md -- php script/bootstrap-inventory.php; \
	fi'
bootstrap-spine-phpcfg-parse-check:
	php script/bootstrap-spine-php-cfg-parse-check.php --minimal
bootstrap-profile: bootstrap-inventory
	php script/bootstrap-profile.php
bootstrap-aot-lint: bootstrap-profile
	php script/bootstrap-aot-lint.php
bootstrap-aot-link: bootstrap-profile
	./script/bootstrap-aot-link.sh
bootstrap-aot-link-lib: bootstrap-profile
	./script/bootstrap-aot-link-lib.sh
bootstrap-vendor-prelink-bundles:
	php script/bootstrap-vendor-objects.php
bootstrap-vendor-objects: bootstrap-vendor-prelink-bundles
	./script/bootstrap-vendor-objects.sh --compile
bootstrap-selfhost-probe:
	./script/bootstrap-selfhost-compile-probe.sh
bootstrap-selfhost-ensure-gen0-driver:
	@test -x build/bin-compile-aot || BOOTSTRAP_M5_DRIVER_SMOKE=1 ./script/bootstrap-selfhost-driver-smoke.sh
bootstrap-selfhost-link:
	./script/bootstrap-selfhost-link.sh
bootstrap-selfhost-link-compiled: bootstrap-selfhost-ensure-gen0-driver
	BOOTSTRAP_GEN0_ENSURE_COMPILED_DRIVER=1 ./script/bootstrap-selfhost-link.sh
bootstrap-selfhost-compile-smoke:
	./script/bootstrap-selfhost-compile-smoke-link.sh
bootstrap-selfhost-compile-smoke-run:
	./script/bootstrap-selfhost-compile-smoke-run.sh
bootstrap-selfhost-runtime-compile-smoke:
	./script/bootstrap-selfhost-runtime-compile-smoke.sh
bootstrap-selfhost-compile-smoke-strict:
	BOOTSTRAP_M3_USE_INVENTORY_EMIT_DRIVER=1 \
	BOOTSTRAP_M3_COMPILE_SMOKE_STRICT=1 \
	./script/bootstrap-selfhost-compile-smoke-probe.sh
bootstrap-selfhost-runtime-compile-smoke-strict:
	BOOTSTRAP_M3_USE_INVENTORY_EMIT_DRIVER=1 \
	BOOTSTRAP_M3_RUNTIME_COMPILE_SMOKE_STRICT=1 \
	./script/bootstrap-selfhost-runtime-compile-smoke.sh
bootstrap-m3-emit-tu-execute:
	./script/bootstrap-m3-emit-tu-execute.sh
bootstrap-selfhost-compiler-driver-smoke:
	./script/bootstrap-selfhost-compiler-driver-smoke-link.sh
bootstrap-selfhost-compile-driver-link:
	./script/bootstrap-selfhost-compile-driver-link-probe.sh
bootstrap-selfhost-compiler-unit-probe:
	./script/bootstrap-selfhost-compiler-unit-probe.sh
bootstrap-selfhost-compiler-unit-probe-strict:
	BOOTSTRAP_M3_LINK_COMPILE_DRIVER=1 \
	BOOTSTRAP_M3_COMPILE_DRIVER_REAL_LOWERING=1 \
	BOOTSTRAP_M3_RUNTIME_COMPILE=1 \
	BOOTSTRAP_M3_USE_INVENTORY_EMIT_DRIVER=1 \
	BOOTSTRAP_M3_COMPILER_UNIT_PROBE_STRICT=1 \
	./script/bootstrap-selfhost-compiler-unit-probe.sh
bootstrap-selfhost-jit-unit-probe:
	./script/bootstrap-selfhost-jit-unit-probe.sh
bootstrap-selfhost-jit-unit-probe-strict:
	BOOTSTRAP_M3_LINK_COMPILE_DRIVER=1 \
	BOOTSTRAP_M3_COMPILE_DRIVER_REAL_LOWERING=1 \
	BOOTSTRAP_M3_RUNTIME_COMPILE=1 \
	BOOTSTRAP_M3_USE_INVENTORY_EMIT_DRIVER=1 \
	BOOTSTRAP_M3_JIT_UNIT_PROBE_STRICT=1 \
	./script/bootstrap-selfhost-jit-unit-probe.sh
bootstrap-selfhost-vm-unit-probe:
	./script/bootstrap-selfhost-vm-unit-probe.sh
bootstrap-selfhost-parser-unit-probe:
	./script/bootstrap-selfhost-parser-unit-probe.sh
bootstrap-selfhost-types-unit-probe:
	./script/bootstrap-selfhost-types-unit-probe.sh
bootstrap-selfhost-lib-spine-smoke:
	./script/bootstrap-selfhost-lib-spine-smoke-link.sh
bootstrap-selfhost-lib-spine-vm-smoke:
	./script/bootstrap-selfhost-lib-spine-vm-smoke.sh
bootstrap-selfhost-vm-driver-execute-probe:
	./script/bootstrap-selfhost-vm-driver-execute-probe.sh
bootstrap-selfhost-helloworld:
	BOOTSTRAP_M3_LINK_COMPILE_DRIVER=1 \
	BOOTSTRAP_M3_COMPILE_DRIVER_REAL_LOWERING=1 \
	BOOTSTRAP_M3_RUNTIME_COMPILE=1 \
	BOOTSTRAP_M3_HELLOWORLD_STRICT=1 \
	./script/bootstrap-selfhost-helloworld-probe.sh
bootstrap-selfhost-helloworld-compile-bin:
	./script/bootstrap-selfhost-helloworld-compile-bin.sh
bootstrap-selfhost-cli-driver-emit:
	./script/bootstrap-selfhost-cli-driver-emit.sh
bootstrap-selfhost-driver-host-compile:
	./script/bootstrap-selfhost-driver-host-compile.sh
bootstrap-selfhost-driver-smoke:
	./script/bootstrap-selfhost-driver-smoke.sh
bootstrap-selfhost-full-revision-probe:
	./script/bootstrap-selfhost-full-revision-probe.sh
bootstrap-native-compile-driver-smoke:
	./script/bootstrap-native-compile-driver-smoke.sh
bootstrap-loop-gen1-link:
	BOOTSTRAP_M4_LINK_COMPILE_DRIVER=1 \
	BOOTSTRAP_M4_COMPILE_DRIVER_REAL_LOWERING=1 \
	BOOTSTRAP_M4_RUNTIME_COMPILE=1 \
	./script/bootstrap-loop-gen1-link.sh
bootstrap-loop-gen1-full-spine-emit:
	./script/bootstrap-loop-gen1-full-spine-emit.sh
.PHONY: bootstrap-loop-full-spine-probe
bootstrap-loop-full-spine-probe:
	./script/bootstrap-loop-full-spine-probe.sh
bootstrap-loop-gen2-recompile-spine:
	./script/bootstrap-loop-gen2-recompile-spine.sh
bootstrap-loop-gen2-recompile-bin-compile:
	./script/bootstrap-loop-gen2-recompile-bin-compile.sh
bootstrap-loop-gen2-recompile-minimal: bootstrap-loop-gen2-recompile-spine
# Script dry-run ladder: make bootstrap-loop-probe-dry (not `make bootstrap-loop-probe --dry-run`, which is GNU make recipe print only — #2828).
bootstrap-loop-probe:
	./script/bootstrap-loop-probe.sh
bootstrap-loop-probe-dry:
	./script/bootstrap-loop-probe.sh --dry-run
bootstrap-loop-probe-dry-run: bootstrap-loop-probe-dry
bootstrap-wave-check:
	./script/bootstrap-wave-check.sh