Download the PHP package jeph/frame without Composer
On this page you can find all versions of the php package jeph/frame. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package frame
JEPH/Frame
Just Enough PHP for a bit of a framework.
A minimal PHP routing framework built on FastRoute. Define routes, match HTTP methods, and handle requests with closures, files, or classes.
Requirements
- PHP >= 8.3
- nikic/fast-route 1.3.0
Installation
Basic Usage
HTTP Methods
Supports GET, POST, PUT, DELETE, PATCH, OPTIONS, and HEAD:
Use any() to match all methods:
Route Parameters
Named parameters with regex patterns:
Optional parameters:
Handler Types
Closures
File Includes
In the included file, route parameters are available via the $_frame array:
Class Handlers
The class method matching the HTTP method is called automatically.
Route Caching
By default, routes are compiled on every request, which is ideal for development since changes take effect immediately.
For production, enable route caching to avoid recompiling routes on each request:
A common pattern is to enable caching based on environment:
When routes change in production, delete the cache file to regenerate it on the next request.
Custom Error Handlers
By default, unmatched routes return a plain text "404 Not Found" or "405 Method Not Allowed" response. You can customize these with your own handlers.
Error handlers support the same handler types as routes: closures, file includes, and classes.
404 Not Found Handler
The handler receives:
$vars['uri']- The requested URI that was not found
405 Method Not Allowed Handler
The handler receives:
$vars['uri']- The requested URI$vars['allowed']- Array of HTTP methods that are allowed for this path
File Include Handlers
In the included file, use the $_frame array:
Note: The HTTP response code (404 or 405) is set automatically before your handler is called.
Behavior
- Trailing slashes: Redirects
/path/to/pathwith a 302 response - Query strings: Stripped during route matching, still accessible via
$_GET - URL encoding: Parameters are automatically decoded
- 404 Not Found: Returned when no route matches (customizable via
set_not_found_handler) - 405 Method Not Allowed: Returned when the path matches but the method does not (customizable via
set_method_not_allowed_handler)