README

Minimal PHP microframework — attribute-routed, zero runtime dependencies, PHP 8.3+.

Why karhu?

A small framework you can read end-to-end. ~1200 LOC core, no closures-as-routes, no YAML, no required dependencies — controllers declare routes via PHP attributes. Extras (DB, queue, view) ship as separate packages.

Install

composer create-project bjornbasar/karhu-skeleton myapp
cd myapp
composer serve   # http://localhost:8080

Or add karhu to an existing project:

composer require bjornbasar/karhu

Hello world

use Karhu\Attributes\Route;
use Karhu\Http\Response;

final class HomeController {
    #[Route('GET', '/hello/{name}')]
    public function hello(string $name): Response {
        return Response::json(['hello' => $name]);
    }
}

Register the controller in config/controllers.php and karhu's attribute scanner wires the route automatically.

What's in the box

Companion packages

Development

composer install
composer check           # cs-check + phpstan + tests
composer test            # PHPUnit only
composer analyse         # PHPStan level 8
composer cs-fix          # php-cs-fixer (PER-CS2.0)
bin/karhu route:cache    # compile route cache for production

PHP 8.3 + 8.4 are tested via the GitHub Actions matrix.

Documentation

• DOCS.md — tech stack, directory layout, design decisions
• docs/ — MkDocs Material source (full reference, ADRs)
• docs/adr/ — architectural decision records

License

MIT