Language: static methods on user-defined classes (Expr_StaticCall) #2209

Problem

#58 tracks instance methods ($obj->method()). #2185 ✅ closed ::class and minimal static factory patterns for MiniWebApp bootstrap PHPTs.

Many compiler and app trees still need user-defined static methods:

class Router {
    public static function fromConfig(array $config): self {
        return new self($config);
    }
}
Router::fromConfig($config)->dispatch($method, $route);

Today Expr_StaticCall on user classes is unsupported or JIT-throws while instance calls are in flight.

Goal

VM + AOT (+ JIT follow-up) for public static methods on user classes:

• No $this in static methods
• Static calls resolve to the declared class (no late static binding — Compiler: Class inheritance (extends) and interfaces #101 out of scope)
• Pair with Language: Visibility, constructors, and destructors #145 for new self() inside static methods when ctor lands

Implementation hints

Acceptance criteria

./phpc run -r 'class C{public static function id():string{return "ok";}} echo C::id();'
# → ok

./phpc lint examples/003-MiniWebApp   # no unsupported Expr_StaticCall on Router (if refactored to use static factory)

Harness:

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh && vendor/bin/phpunit --filter class_static_method'

Dependencies

• Language: Class methods and property access in JIT #58 / Language: Visibility, constructors, and destructors #145 — instance methods (parallel; static can land first)
• DevEx: phpc.json autoload phase 2 — static class discovery for AOT project build #1803 / Examples: Migrate 003 + init-miniwebapp phpc.json to PSR-4 autoload (post-#1803) #1856 — PSR-4 may introduce more static entrypoints
• JIT project: Language: JIT include/require compile-time lowering (#54 follow-up) #475 includes still required for 003

Links

• Language: MiniWebApp static calls and ::class for project build (Router autoload slice) #2185 ✅ · Testing: MiniWebApp VM OOP e2e — phpc serve Router when #58/#145/#54 land #2059 VM OOP e2e · ROADMAP 🗺️ ROADMAP: Self-host + web-capable PHP subset (living) #78 Phase 1 Language