PHP 8.3–8.5 · PSR-7 · PSR-15

PHP framework pro web a CLI.

Lemonade poskytuje PSR-7 HTTP runtime, PSR-15 middleware, pojmenované routy, dependency injection, serverové PHP views a konzolové příkazy.

Začít s frameworkem ↗Zobrazit na GitHubu ↗

HTTP RUNTIME · DI CONTAINER · CLI

app/Controllers/HomeController.phpPHP 8.3–8.5

<?php

declare(strict_types=1);

namespace App\Controllers;

use Lemonade\Framework\View\ViewRendererInterface;
use Psr\Http\Message\ResponseInterface;

final readonly class HomeController
{
    public function __construct(
        private ViewRendererInterface $views,
    ) {
    }

    public function index(): ResponseInterface
    {
        return $this->views->render('home.index');
    }
}

● Constructor DI · PSR-7 · ViewsPSR-7 / PSR-15

{ services }CONSTRUCTOR DI · REQUEST SCOPE

01 / PHP 8.3+02 / PSR-7 & PSR-1503 / SERVICE PROVIDERS · TYPED CONFIG04 / WEB + CLI↘ POKRAČOVAT NÍŽ

Součásti frameworku

Přehled
funkcí.

Základ tvoří HTTP runtime, routing, dependency injection a CLI. Další moduly zajišťují práci s databází, validaci, cache a fronty.

01 / APLIKAČNÍ ZÁKLAD ↗

Architektura a správa služeb

Kernel řídí běh aplikace, service providery registrují služby a DI kontejner zajišťuje jejich vytváření a závislosti.

KernelService provideryDI kontejner

02 / HTTP VRSTVA ↗

HTTP a PSR standardy

PSR-7 požadavky a odpovědi, PSR-15 middleware, routing a zpracování controllerů.

Požadavek → Middleware → Odpověď

03 / WEB A CLI ⌘

HTTP a konzolové aplikace

Společný model konfigurace a registrace služeb pro webové požadavky i konzolové příkazy.

KernelCliKernel

04 / DATA ▤

Databáze a migrace

Databázové adaptéry, transakce, práce se schématem a verzované databázové migrace.

DatabázeMigrace

05 / DALŠÍ KOMPONENTY ✳

Další služby

Validace, cache, sessions, nahrávání souborů, lokalizace, události a fronty.

ValidaceCacheFronty

Zpracování HTTP požadavku

Od požadavku
k odpovědi.

Kernel vytvoří Request scope, spustí PSR-15 middleware, router vybere controller akci a emitter odešle výslednou PSR-7 odpověď.

KROK 0101

Požadavek

Do aplikace přichází HTTP požadavek. Lemonade jej reprezentuje jako PSR-7 ServerRequest s metodou, URI, hlavičkami, cookies, soubory a parsovaným tělem.

ServerRequestInterface · ServerRequestFactory · PSR-7

01 / Požadavek

Do aplikace přichází HTTP požadavek. Lemonade jej reprezentuje jako PSR-7 ServerRequest s metodou, URI, hlavičkami, cookies, soubory a parsovaným tělem.

ServerRequestInterface · ServerRequestFactory · PSR-7

02 / Kernel

Kernel načte konfiguraci, vytvoří izolovaný Request scope a připraví aplikaci. Při bootstrapu zaregistruje služby prostřednictvím providerů a dokončí registraci rout.

Kernel · ApplicationBootstrapper · ScopeKind::Request

03 / Middleware

PSR-15 middleware zpracovávají požadavek před routováním. Mohou například ověřit přístup nebo požadavek ukončit vlastní odpovědí. Další middleware mohou být navázané na konkrétní routu.

MiddlewarePipeline · MiddlewareInterface · PSR-15

04 / Router

Router podle HTTP metody a URL vybere odpovídající routu. Zjistí, který controller a metoda se mají zavolat, a připraví parametry adresy.

Router · RouteMatch · DispatchRequestHandler

05 / Controller

Framework sestaví controller pomocí DI containeru, předá argumenty a zavolá jeho veřejnou metodu. Akce může vykreslit view nebo vrátit například JSON.

ControllerResolver · ControllerAction · DI container

06 / Odpověď

Výsledek akce se převede na PSR-7 odpověď, pokud jí ještě není. Odpověď projde zpět příslušnými middleware a emitter odešle HTTP status, hlavičky a tělo klientovi.

ControllerResultNormalizer · ResponseInterface · ResponseEmitter

PSR-7 REQUEST / PSR-15 MIDDLEWARE / PSR-7 RESPONSEKERNEL → ROUTER → CONTROLLER →

Ukázky API

Jednoduché API v praxi.

Na příkladu jednoduchého API pro články uvidíte, jak v Lemonade spolupracují routing, controllery a dependency injection. Od registrace endpointu přes načtení dat až po výslednou JSON odpověď.

PožadavekGET /api/articles/42

Router přiřadí požadavek controlleru.
Controller načte článek přes službu, která vrací model.
Aplikace vrátí PSR-7 JSON odpověď.

Route zachytí ID článku z URL a předá požadavek controlleru.

✳ LEMONADE / UKÁZKA APIPHP 8.3+

app/Config/Routing.php

<?php

declare(strict_types=1);

use Demo\ArticleApi\Controllers\ArticleController;
use Lemonade\Framework\Routing\ControllerAction;
use Lemonade\Framework\Routing\Router;

return static function (Router $router): void {
    $router->get(
        '/api/articles/{id}',
        ControllerAction::for(ArticleController::class, 'show'),
    );
};

app/Controllers/ArticleController.php

<?php

declare(strict_types=1);

namespace Demo\ArticleApi\Controllers;

use Demo\ArticleApi\Services\ArticleService;
use Lemonade\Framework\Http\HttpStatus;
use Lemonade\Framework\Http\Response\Responses;
use Psr\Http\Message\ResponseInterface;

final readonly class ArticleController
{
    public function __construct(
        private ArticleService $articles,
        private Responses $responses,
    ) {
    }

    public function show(int $id): ResponseInterface
    {
        $article = $this->articles->find($id);

        if ($article === null) {
            return $this->responses->json(['error' => 'Article not found'], HttpStatus::NOT_FOUND->value);
        }

        return $this->responses->json([
            'data' => [
                'id' => $article->getId(),
                'title' => $article->getTitle(),
            ],
        ]);
    }
}

app/Services/ArticleService.php

<?php

declare(strict_types=1);

namespace Demo\ArticleApi\Services;

use Demo\ArticleApi\Models\Article;

final class ArticleService
{
    public function find(int $id): ?Article
    {
        if ($id !== 42) {
            return null;
        }

        return new Article(42, 'First article');
    }
}

app/Models/Article.php

<?php

declare(strict_types=1);

namespace Demo\ArticleApi\Models;

final readonly class Article
{
    public function __construct(
        private int $id,
        private string $title,
    ) {
    }

    public function getId(): int
    {
        return $this->id;
    }

    public function getTitle(): string
    {
        return $this->title;
    }
}

GET /api/articles/42

HTTP/1.1 200 OKContent-Type: application/json; charset=UTF-8

{"data":{"id":42,"title":"First article"}}

HTTP/1.1 404 Not FoundGET /api/articles/99

{"error":"Article not found"}

Routing · Constructor DI · PSR-7 JSONPHP 8.3+ / UTF-8

Zobrazit všechny ukázky

Ekosystém / Composer balíčky

Administrace, CMS a obsah.

Admin Platform poskytuje administrační runtime, CMS Core veřejné CMS routy a další balíčky správu stránek, aktualit a variant obrázků.

Zobrazit balíčky ↗

01 / AdministraceLemonade Admin Platform

Administrační rozhraní, správa uživatelů a rolí, DataGrid, editory a audit.

02 / CMS routingLemonade CMS Core

Veřejné CMS routování, kanonické URL a společné kontrakty pro obsahové moduly.

03 / Obsah a obrázkyCMS Page · CMS News · Admin Image

Samostatné balíčky pro stránky, aktuality a veřejné URL variant obrázků.

Dokumentace

Od instalace
po nasazení.

Kapitoly pokrývají routing, controllery, views, DI, konfiguraci, databáze, middleware, lokalizaci, CLI a produkční provoz.

Procházet dokumentaci