Feat: support multiple methods per route via Http::routes()

[ChiragAgg5k]

What does this PR do?

Adds Http::routes() so one route handler can be registered for multiple HTTP methods:

Http::routes([Http::REQUEST_METHOD_GET, Http::REQUEST_METHOD_POST], '/oauth/userinfo')
->action(...);

This supports endpoints such as OpenID Connect UserInfo, where the same endpoint must accept both GET and POST, without duplicating route actions or adding another alias-specific public API.

Implementation

• Adds Http::routes(string|array $methods, string $url): Route.
• Keeps Http::get(), post(), put(), patch(), and delete() as single-method wrappers around routes().
• Stores route methods as one ordered array on Route; the first method remains the primary method for backwards compatibility.
• Adds Route::getMethods() for route metadata and keeps Route::getMethod() as a deprecated compatibility accessor.
• Registers every method in the router under the same path template and Route instance.
• Preserves path alias behavior so Http::routes([GET, POST], '/new')->alias('/old') matches both methods under both paths.
• Pre-validates method support, method path conflicts, and alias path conflicts before writing to the route table, preventing partial registrations when an exception is thrown.
• Keeps router override and duplicate-route semantics unchanged.

Test plan

• vendor/bin/phpunit --configuration phpunit.xml tests/RouteTest.php tests/RouterTest.php tests/HttpTest.php
• composer format:check
• composer analyze

Note: the full PHPUnit suite includes FPM/Swoole e2e tests that require fpm and swoole hosts; those were not available in the local shell environment.

Have you read the Contributing Guidelines on issues?

Yes

[github-actions]

k6 benchmark

Throughput	Requests	Fail rate	p50	p95
7784 req/s	544955	0%	5.4 ms	11.06 ms

[greptile-apps]

Greptile Summary

This PR introduces Http::routes(string|array $methods, string $url) so a single route can be registered under multiple HTTP methods without duplicating the action. The single-method helpers (get(), post(), etc.) are updated to delegate to it.

• Router::addRoute() and Router::addRouteAlias() now pre-validate all methods before writing any entry to the routes table, preserving atomicity when a conflict is detected.
• Route gains getMethods() and stores methods as an ordered array; getMethod() is deprecated and returns methods[0] for backwards compatibility.
• Router::reset() now clears $allowOverride, and a setUp() guard was added to RouterTest to prevent test-isolation leaks.

Confidence Score: 5/5

Safe to merge; atomicity of multi-method registration and alias registration is correctly enforced by pre-validating all methods before touching the routes table.

The core correctness concern for this feature — partial route registration when one of N methods conflicts — is handled in both addRoute() and addRouteAlias(), and the test suite explicitly asserts the atomicity invariant. The only finding is a write-only $aliasPaths field that has no consumer.

src/Http/Route.php — the new $aliasPaths field is never read; worth clarifying intent or adding an accessor.

Important Files Changed

Filename	Overview
src/Http/Http.php	Adds Http::routes() as the new multi-method entry point; single-method helpers now delegate to it. Logic is clean and validates methods early.
src/Http/Route.php	Upgrades $method to $methods array; adds getMethods(), deprecates getMethod(), and introduces $aliasPaths for deduplication — but $aliasPaths has no getter and is never consumed externally.
src/Http/Router.php	addRoute() and addRouteAlias() now pre-validate all methods before writing any entry, preserving atomicity. reset() now correctly clears $allowOverride.
tests/RouterTest.php	Good coverage of multi-method registration, override, unknown method, and atomicity invariants; setUp resets allowOverride to prevent test-isolation leaks.
tests/HttpTest.php	Adds an end-to-end test that dispatches the same multi-method route as both GET and POST and asserts the correct method echoed back.
tests/RouteTest.php	Minimal addition verifying getMethods() returns the expected single-element array alongside the existing getMethod() assertion.

_{Reviews (9): Last reviewed commit: "Fix Docker test image file list" | Re-trigger Greptile}

[ChiragAgg5k]

Closing this mirror PR because the change has been merged through the monorepo: utopia-php/monorepo#1