1. Go to this page and download the library: Download waffle-commons/routing library. Choose the download type require.
2. Extract the ZIP file and open the index.php.
3. Add this code to the index.php.
<?php
require_once('vendor/autoload.php');
/* Start to develop here. Best regards https://php-download.com/ */
waffle-commons / routing example snippets
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final readonly class Route
{
/**
* @param array<string> $methods Allowed HTTP methods. Default ['GET']; empty [] accepts any.
* @param array<Argument>|null $arguments
* @param int $priority Higher matches first. Use negative
* values (e.g. -1000) for catch-all routes.
*/
public function __construct(
public string $path,
public array $methods = ['GET'],
public ?string $name = null,
public ?array $arguments = null,
public int $priority = 0,
) {}
}
#[Attribute]
final class Argument
{
public function __construct(
public string $classType,
public string $paramName,
public bool $
use Waffle\Commons\Contracts\Routing\Attribute\Route;
use Waffle\Commons\Routing\Attribute\Argument;
use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
final class UserController
{
#[Route(path: '/users/{id}', name: 'users.show')]
public function show(ServerRequestInterface $request): ResponseInterface
{
// The {id} placeholder is exposed via $request->getAttribute('_route_params')['id']
}
#[Route(
path: '/users',
name: 'users.create',
arguments: [
new Argument(classType: UserRepository::class, paramName: 'repo'),
],
)]
public function create(ServerRequestInterface $request, UserRepository $repo): ResponseInterface
{
// $repo is auto-injected via the container.
}
}
use Waffle\Commons\Routing\Router;
use Waffle\Commons\Container\Container;
$router = new Router(/* …discoverer, cache… */);
$router->boot($container);
$match = $router->matchRequest($psr7Request);
/* @var \Waffle\Commons\Contracts\Routing\MatchedRoute|null $match
*
* MatchedRoute exposes: className, method, arguments, path, name, params, priority.
* Use $match->withParams([...]) to attach the captured path parameters immutably.
*/
use Waffle\Commons\Contracts\Routing\Attribute\Route;
final class ArticleController
{
#[Route(path: '/articles', methods: ['GET'], name: 'articles.list')]
public function list(): ResponseInterface { /* … */ }
#[Route(path: '/articles', methods: ['POST'], name: 'articles.create')]
public function create(): ResponseInterface { /* … */ }
}
Loading please wait ...
Before you can download the PHP files, the dependencies should be resolved. This can take some minutes. Please be patient.