PHPackages                             voral/joke - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. voral/joke

ActiveLibrary[Framework](/categories/framework)

voral/joke
==========

A minimal PHP microframework with manual routing and dependency injection container.

1.4.0(1w ago)0222MITPHPPHP ^8.4CI passing

Since Jan 16Pushed 3w agoCompare

[ Source](https://github.com/joke-php/joke)[ Packagist](https://packagist.org/packages/voral/joke)[ RSS](/packages/voral-joke/feed)WikiDiscussions master Synced today

READMEChangelog (7)Dependencies (21)Versions (10)Used By (2)

Joke — Микрофреймворк для PHP
=============================

[](#joke--микрофреймворк-для-php)

[EN](#joke--a-micro-framework-for-php)

---

[![Scrutinizer Code Quality](https://camo.githubusercontent.com/9d05e8faf0896339fe32726f4c3d04abdb32dcea8b4c2b9e4f3a9ae5eddb1b8f/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f566f72616c2f6a6f6b652f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/Voral/joke/?branch=master)[![Code Coverage](https://camo.githubusercontent.com/6a01a17e316c00e184d2ae77d41e3efafce58bba6f7475ef3484d0f55cdb7429/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f566f72616c2f6a6f6b652f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/Voral/joke/?branch=master)[![PHP Tests](https://github.com/Voral/joke/actions/workflows/php.yml/badge.svg)](https://github.com/Voral/joke/actions/workflows/php.yml/badge.svg)

---

Joke — это учебный микрофреймворк с ручной маршрутизацией и встроенным DI-контейнером. Он разрабатывается в рамках образовательного челленджа и не претендует на конкуренцию с промышленными решениями, такими как Laravel или Symfony.

Несмотря на скромный функционал, реализуемые компоненты стремятся быть надёжными, тестируемыми и пригодными для использования в реальных проектах — в том числе в обучающих или прототипных задачах.

По условиям челенджа: не использовать существующие решения (кромe composer, PHPUnit, [voral/version-increment](https://github.com/Voral/vs-version-incrementor))

Требования
----------

[](#требования)

- PHP 8.4+
- Composer

Реализованная функциональность
------------------------------

[](#реализованная-функциональность)

- Ручная маршрутизация HTTP-запросов
- DI-контейнер с поддержкой автовайринга параметров
- Система middleware (блокирующие и неблокирующие)
- Управление сессиями (включая поддержку «неблокирующего» режима — данные сессии считываются в начале обработки запроса, после чего сессия немедленно закрывается, позволяя другим запросам от того же пользователя работать параллельно без ожидания завершения текущего.)
- Обработка ошибок и исключений

Как начать
----------

[](#как-начать)

Самый простой способ начать — использовать официальный [скелетон](../skeleton/minimal.md):

```
composer create-project voral/joke-minimal my-app
cd my-app
composer run dev
```

Приложение будет доступно по адресу:

Документация
------------

[](#документация)

Документация по фреймворку размещена [здесь](./docs/index.md)

Основные этапы челенджа
-----------------------

[](#основные-этапы-челенджа)

- **Создание фреймворка**
    - Реализация маршрутизации
    - Реализация сервисный контейнер
    - Консольная система команд
    - Авторизация
    - Валидация данных
    - Обработка ошибок
    - Логирование
    - Создание построителя SQL запросов
    - Миграции
    - Настраиваемое окружение через .env файл
- **Создание шаблонизатора**
    - Создание базового шаблонизатора HTML
    - Рендер Markdown файлов для быстрого создания документационных сайтов из .md файлов.
    - Рендер Swagger yaml файлов для автоматического отображения OpenAPI-спецификаций без внешних UI (например, без Swagger UI)
- **Создание приложения форума**
- **Создание скелетонов**
    - REST API приложения
    - Приложения веб представления Markdown файлов

---

Joke — A Micro Framework for PHP
================================

[](#joke--a-micro-framework-for-php)

Joke is an educational microframework featuring manual routing and a built-in DI container. It is developed as part of a learning challenge and is not intended to compete with production-grade frameworks like Laravel or Symfony.

Despite its limited scope, the implemented components aim to be reliable, testable, and suitable for real-world use—even in educational or prototyping scenarios.

As per the challenge rules, no existing solutions may be used except for Composer, PHPUnit, and [voral/version-increment](https://github.com/Voral/vs-version-incrementor).

Requirements
------------

[](#requirements)

- PHP 8.4+
- Composer

Implemented Features
--------------------

[](#implemented-features)

- Manual HTTP request routing
- DI container with automatic parameter wiring
- Middleware system (blocking and non-blocking)
- Session management, including **non-blocking mode** — session data is read at the beginning of request processing and the session is immediately closed, allowing concurrent requests from the same user to proceed without waiting for the current request to finish
- Error and exception handling

Getting Started
---------------

[](#getting-started)

The easiest way to get started is to use the official [skeleton](../skeleton/minimal.md):

```
composer create-project voral/joke-minimal my-app
cd my-app
composer run dev
```

Your application will be available at:

Challenge Roadmap
-----------------

[](#challenge-roadmap)

- **Framework Core**

    - Implement routing
    - Implement service container
    - Console command system
    - Authentication
    - Data validation
    - Error handling
    - Logging
    - SQL query builder
    - Database migrations
    - Environment configuration via `.env` file
- **Template Engine**

    - Basic HTML template engine
    - Render Markdown files for quickly generating documentation sites from `.md` files
    - Render Swagger YAML files to display OpenAPI specifications without external UIs (e.g., without Swagger UI)
- **Build a Forum Application**
- **Create Project Skeletons**

    - For REST API applications
    - For documentation sites based on Markdown files

###  Health Score

45

—

FairBetter than 91% of packages

Maintenance96

Actively maintained with recent releases

Popularity8

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~22 days

Total

8

Last Release

10d ago

Major Versions

0.0.1 → 1.0.02026-01-20

### Community

Maintainers

![](https://www.gravatar.com/avatar/ce4dfd67b12e198becd71253723d0c83044cb4689b735f2fd4eee4ac191c41ec?d=identicon)[Voral](/maintainers/Voral)

---

Top Contributors

[![Voral](https://avatars.githubusercontent.com/u/327165?v=4)](https://github.com/Voral "Voral (206 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/voral-joke/health.svg)

```
[![Health](https://phpackages.com/badges/voral-joke/health.svg)](https://phpackages.com/packages/voral-joke)
```

###  Alternatives

[laravel/dusk

Laravel Dusk provides simple end-to-end testing and browser automation.

1.9k39.6M297](/packages/laravel-dusk)[nineinchnick/edatatables

Grid widget for the Yii Framework, wrapper for the DataTables jQuery plugin

173.2k](/packages/nineinchnick-edatatables)[link-cloud/fast-hyperf

LinkCloud Fast Hyperf

241.2k1](/packages/link-cloud-fast-hyperf)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)