Language: PHP 8 attributes reflection JIT/AOT (phase 2, post-#1354 VM)

[PurHur]

Problem

#1354 ✅ and #1936 ✅ closed VM v1: attributes parse, lint, and compile; runtime ignores #[Attr] metadata in native paths. docs/capabilities-syntax.md still documents attributes as VM-only / reflection deferred.

Self-host and framework-style code may call ReflectionClass::getAttributes() / ReflectionMethod::getAttributes() — today that path is unsupported or stubbed in JIT/AOT binaries.

Goal (v1 subset)

Layer	Target
VM	Store attribute metadata on declared class/method/property nodes
JIT/AOT	Emit const attribute name/arg blobs for spine-smoke units
Reflection	Read path for getAttributes() on declared items — not full newInstance() with arbitrary constructors

Implementation hints

Piece	Path	Notes
Compiler	lib/Compiler.php	Attach attribute list to class/method IR (#1354 hooks)
VM	lib/VM.php, reflection helpers	Backing store for ReflectionAttribute
JIT	lib/JIT.php	Const metadata blobs; defer dynamic instantiation
AOT	lib/AOT/	Link metadata section
Tests	test/compliance/cases/attribute_reflection_*.phpt	Zend subset
Capabilities	php script/capability-syntax.php	Flip syntax row when JIT/AOT green

Out of scope (v1)

• Repeatable/read repeatable attributes on parameters
• newInstance() with user constructors
• Attributes on closures (Language: Closures and anonymous functions #72)

Acceptance criteria

• Compliance PHPT: declared class attribute round-trips via ReflectionClass::getAttributes() on VM
• JIT compliance test green when @group llvm and LLVM present
• php script/capability-syntax.php updates attributes row
• php script/bootstrap-inventory.php --check still clean or documented delta

Verification (local / Docker only)

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh && vendor/bin/phpunit --filter Attribute'
./script/ci-fast.sh --filter Attribute
make test-harness   # when JIT touched

No GitHub Actions (#394 ✅).

Dependencies

• Language: PHP 8 attributes (#[Attr] on classes, methods, properties) #1354 ✅ — parse/compile v1
• Language: PHP 8 attributes — JIT/AOT reflection (phase 2 of #1354) #1936 ✅ — closed umbrella; this issue re-opens implementation track only
• Language features wave 2: JIT/syntax gaps tracker (#1222–#1235) #1238 — wave-2 tracker (link; do not duplicate table rows)
• ROADMAP 🗺️ ROADMAP: Self-host + web-capable PHP subset (living) #78 Phase 1 Language

Links

• docs/roadmap-wave3.md attributes row
• Wave 2 umbrella: Language features wave 2: JIT/syntax gaps tracker (#1222–#1235) #1238