PHPackages                             voral/joke-minimal - 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-minimal

ActiveProject[Framework](/categories/framework)

voral/joke-minimal
==================

Minimal skeleton for projects using the Joke micro-framework

v1.1.0(3mo ago)03MITPHPPHP ^8.4

Since Jan 20Pushed 3mo agoCompare

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

READMEChangelog (2)Dependencies (1)Versions (3)Used By (0)

Joke: Минимальный скелетон
==========================

[](#joke-минимальный-скелетон)

> Минимальный стартовый шаблон для проектов на основе [Joke микрофреймворк](https://github.com/Voral/joke).

Этот скелетон предоставляет готовую структуру приложения с базовой маршрутизацией, контроллером и встроенным веб-сервером PHP — хорошо подходит для обучения или быстрого старта.

Быстрый старт
-------------

[](#быстрый-старт)

Создайте новый проект одной командой:

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

Запустите встроенный сервер разработки:

```
composer run dev
```

Откройте в браузере:

Вы увидите:

> **Hello from Joke Framework!**

### Запуск с помощью Docker (без установки PHP или Composer)

[](#запуск-с-помощью-docker-без-установки-php-или-composer)

Если у вас установлен [Docker](https://www.docker.com/), вы можете запустить приложение без глобальной установки PHP или Composer:

```
git clone https://github.com/Voral/joke-minimal my-app
cd my-app
docker compose up -d
```

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

> При первом запуске контейнер автоматически установит зависимости через Composer.
> Все изменения в коде применяются мгновенно благодаря volume-монтированию.

Остановить сервер:

```
docker compose down
```

Структура проекта
-----------------

[](#структура-проекта)

```
my-app/
├── app/                # Код приложения (контроллеры, сервисы)
│   └── Controllers/
├── bootstrap/          # Инициализация фреймворка
│   └── app.php
├── public/             # Публичная точка входа
│   ├── index.php
│   └── .htaccess
├── routes/             # Определение маршрутов
│   └── web.php
└── composer.json

```

Как добавить свой маршрут
-------------------------

[](#как-добавить-свой-маршрут)

1. **Создайте контроллер** в `app/Controllers/`, например:

    ```
    // app/Controllers/AboutController.php
    namespace App\Controllers;

    class AboutController
    {
        public function __invoke(): string
        {
            return 'About page';
        }
    }
    ```
2. **Зарегистрируйте маршрут** в `routes/web.php`:

    ```
    use App\Controllers\AboutController;

    $router->get('/about', AboutController::class);
    ```
3. Готово! Откройте

> Контроллеры необходимо реализовывать согласно [документации](https://github.com/Voral/joke/tree/master/docs)

Поддержка ЧПУ
-------------

[](#поддержка-чпу)

Скелетон включает `.htaccess` для Apache, который:

- Перенаправляет все запросы в `index.php`,
- Сохраняет заголовки `Authorization` и `X-XSRF-TOKEN`,
- Убирает завершающий слеш из URL.

Работает корректно на хостингах с включённым `mod_rewrite`.

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

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

Более подробно о возможностях фреймворка — см. [официальный репозиторий Joke](https://github.com/Voral/joke).

Отлично! Ты всё правильно понял: **твой `README.md` уже хорош**, но его нужно **дополнить Docker-вариантом запуска**, чтобы пользователь мог выбрать:

- либо классический путь через Composer на хосте (`composer run dev`),
- либо полностью изолированный путь через Docker (без установки PHP/Composer).

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance79

Regular maintenance activity

Popularity3

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity53

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 ~0 days

Total

2

Last Release

111d ago

### 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 (3 commits)")

### Embed Badge

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

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

###  Alternatives

[laravel/telescope

An elegant debug assistant for the Laravel framework.

5.2k67.8M192](/packages/laravel-telescope)[spiral/roadrunner

RoadRunner: High-performance PHP application server and process manager written in Go and powered with plugins

8.4k12.2M84](/packages/spiral-roadrunner)[nolimits4web/swiper

Most modern mobile touch slider and framework with hardware accelerated transitions

41.8k177.2k1](/packages/nolimits4web-swiper)[laravel/dusk

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

1.9k36.7M259](/packages/laravel-dusk)[laravel/prompts

Add beautiful and user-friendly forms to your command-line applications.

708181.8M596](/packages/laravel-prompts)[cakephp/chronos

A simple API extension for DateTime.

1.4k47.7M121](/packages/cakephp-chronos)

PHPackages © 2026

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