Layer: Core · Source: lib/core/ApiRouter.php:21 (lines 21–400)

class ApiRouter

API Router

Handles routing of API requests to appropriate controllers Supports GET, POST, PUT, PATCH, DELETE HTTP methods

No parent, interface or trait. This is a root type.

public function get($pattern, $handler)

lines 55–58 (4)

Register a GET route

Returns: (none declared) — self

public function post($pattern, $handler)

lines 67–70 (4)

Register a POST route

Returns: (none declared) — self

public function put($pattern, $handler)

lines 79–82 (4)

Register a PUT route

Returns: (none declared) — self

public function patch($pattern, $handler)

lines 91–94 (4)

Register a PATCH route

Returns: (none declared) — self

public function delete($pattern, $handler)

lines 103–106 (4)

Register a DELETE route

Returns: (none declared) — self

public function query($pattern, $handler)

lines 118–121 (4)

Register a QUERY route (RFC 10008)

QUERY is a safe, idempotent method for server-side queries where the query input is passed as request content rather than URI params.

Returns: (none declared) — self

public function any($method, $pattern, $handler)

lines 131–134 (4)

Register a route for any HTTP method

Returns: (none declared) — self

private function addRoute($method, $pattern, $handler)

lines 144–155 (12)

Add a route to the routing table

Returns: (none declared) — self

private function convertToRegex($pattern)

lines 163–178 (16)

Convert route pattern to regex

Returns: (none declared) — string Regex pattern

public function dispatch($method, $uri, $queryParams = [])

lines 188–266 (79)

Dispatch the request to the appropriate controller

Returns: (none declared) — void

private function matchRoute($method, $uri)

lines 281–321 (41)

Match the request URI to a route using combined-regex dispatch.

Phase 1: Single preg_match per chunk quickly eliminates non-matching URIs. Phase 2: Iterate the chunk's dispatch table to identify the specific route using each entry's original regex. This keeps the fast-fail path (non-matching URI) at O(1) preg_match per chunk, while the identification path uses targeted per-route checks.

Returns: (none declared) — array|false Matched route or false

private function compileRoutes($method)

lines 333–379 (47)

Compile all routes for a given HTTP method into combined regex chunks.

Each chunk contains up to CHUNK_SIZE routes combined into a single (?|…) branch-reset regex. A dispatch table maps each branch to its handler, parameter positions, verification prefix, and suffix.

Returns: (none declared) — array|null

public function getParams()

lines 386–389 (4)

Get route parameters

Takes no parameters.

Returns: (none declared) — array

public function getRoutes()

lines 396–399 (4)

Get all registered routes

Takes no parameters.

Returns: (none declared) — array

This page is generated from source by 'tools/gendoc'. Edits will be overwritten.