I am pleased to announce that the Front-Interop standard interface package is now open for public review.
\nFront-Interop provides an interoperable package of standard interfaces for\nfront controller functionality in any execution context (HTTP, CLI, etc.). It\nreflects, refines, and reconciles the common practices identified within\nseveral pre-existing projects.
\nThe central interface is FrontController, which affords an entry point\ninto the outermost presentation layer. Its only method, run(), returns an\ninteger exit status code: 0 for success, 1 to 254 for non-success.
Returning an exit status is a deliberate departure from the majority practice of returning void or a\nresponse object. Doing so allows the same\ninterface to be used across many different execution contexts:\nHTTP, command line, queue workers, CI runners, and long-running processes\nalike.
The reference implementations demonstrate the interface contract across different execution contexts:
\nRequestFrontController reads $_GET, emits HTML, and sets http_response_code() for a traditional HTTP server context.
FrankenFrontController wraps RequestFrontController inside a frankenphp_handle_request() worker loop, demonstrating the same interface in a long-running FrankenPHP worker context.
ConsoleFrontController reads $argv and writes to injected $stdout and $stderr resources for a command line context.
These implementations are intentionally naive -- no router, no IOC container, no request or response -- to highlight the front controller specifics.
\nPlease offer your comments and criticism as issues or PRs out at Github.
\n" }