PHP code example of hengeb / router

    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

hengeb / router example snippets

use App\Service\Router\Router;
use Symfony\Component\HttpFoundation\Request;

(will also look in subdirectories)
$router = new Router(__DIR__ . '/../Classes/Controller');
$request = Request::createFromGlobals();
$router->dispatch($request)->send();

use Symfony\Component\HttpFoundation\Response;
use App\Service\Router\Attribute\Route;
use Hengeb\Db\Db;

class MyController extends Controller {
    // the route matcher starts with the HTTP method, followed by the path. You can use some regular expressions to some extend
    // do not use the ? symbol because this separates the query from the path)
    // this will match /search and / and also /search/ and also /search?foo=bar but not /search?q=theQuery because of the next route
    #[Route('GET /(search|)', allow: true)]
    public function form(): Response {
        return $this->render('SearchController/search');
    }

    // you can use identifiers in the path or in the query, they will be passed as arguments and casted to the desired type
    // the Db object will be injected (in this case via the Db::getInstance() method)
    #[Route('GET /(search|)?q={query}', allow: true)]
    public function search(string $query, Db $db): Response {
        $sql = $this->buildQuery($query);
        $results = $db->query($sql);
        return $this->showResults($ids);
    }

    // access control: only allow logged-in users (in the above examples: allow public access)
    // the dispatch method needs an object that implements the CurrentUserInterface
    #[Route('GET /users', allow: ['loggedIn' => true])]
    public function users(): Response {
        ...
    }

    // you can have multiple route matchers, make sure they fit together
    // \d+ regex for number, get the user object by its id
    #[Route('GET /user/{\d+:id=>user}', allow: ['loggedIn' => true])]
    // if the above matcher does not fit, get the user by its username
    #[Route('GET /user/{username=>user}', allow: ['loggedIn' => true])]
    // the user object will be fetched from the database and injected
    public function show(User $user): Response {
        ...
    }

    // access control: only give access if the current user has the admin role OR is the user himself/herself
    // this will look for a method like hasRole, getRole, isRole, role, get("role") and so on
    // the '$user->get("id")' is a template string that will be evaluated. This does only allow simple function calls because the string will be parsed.
    #[Route('GET /user/{username=>user}/edit', allow: ['role' => 'admin', 'id' => '$user->get("id")'])]
    public function edit(User $user, CurrentUser $currentUser): Response {
        ...
    }

    // this route will only match if the method is POST
    // this will also check for a POST variable _csrfToken and validate it to prevent CSRF attacks
    // you can override this by passing `checkCsrfToken: false` to the Route attribute
    // generate the CSRF token with $router->createCsrfToken()
    #[Route('POST /login', allow: true)]
    public function login() {

    }

    // you can inject the router object, the request, the current user
    #[Route('GET /foo', allow: true)]
    public function foo() {
        ...
    }
}

$router->addType(User::class, fn($id) => User::find($id), 'id')

class User implements RetrievableModel {
    public function retrieveModel($userId): ?static {
        return UserRepository::getInstance()->findOneById((int)$userId);
    }
}

$templateEngine = new TemplateEngine();
$router->addService(TemplateEngine::class, $templateEngine);

$router->addExceptionHandler(InvalidRouteException::class, [Controller::class, 'handleException']);

$router->addExceptionHandler(InvalidRouteException::class, fn(\Exception $e) => (new Controller)->handleException($e));