Lemonade Framework

PHP framework postavený na PSR standardech pro webový i CLI runtime.

Modulární základ pro PHP 8.1+ s PSR HTTP, PSR loggingem, PSR-11 kompatibilním containerem, routingem, views, databází, sessions, validací, uploady a CLI příkazy.

Runtime postavený na PSR

HTTP messages, middleware, factories, logging, integrace HTTP klienta i DI container respektují PSR kontrakty tam, kde to dává smysl.

Sdílený bootstrap pro web a CLI

Webové requesty i CLI příkazy sdílejí stejnou konfiguraci, provider model a container se samostatnými entrypointy Kernel a CliKernel.

Komponentový základ

Routing, views, databáze, sessions, validace, uploady, security, events, queues i dokumentace jsou organizované jako explicitní framework komponenty.

Frameworkové komponenty

Přehled hlavních zabudovaných částí, které tvoří základ pro webové aplikace, CMS projekty, administrace a integrační systémy.

Core

Application Core

ApplicationContext, kernels, runtime lifecycle, načítání konfigurace a orchestrace service providerů.

$kernel->handle();
Dokumentace
Core

CLI Runtime

CLI entrypoint, lifecycle CliKernelu, command registry, exit codes a cron pattern se zámkem.

vendor/bin/lemonade list
Dokumentace
Core

Localization

Resolving aktuální locale, načítání překladů, fallback strategie a použití jazyka během runtime.

$title = $helpers->lang('home.hero.title');
Dokumentace
Core

Dependency Injection Container

Service lifetimes, bindings, aliases, dependency resolution a praktické patterny pro registraci služeb.

$container->singleton(MyService::class, MyService::class);
Dokumentace
Core

Registered Services

Strategie registrace služeb v DI. Provider-specific registrace a praktické příklady jsou rozdělené do podstránek.

$container->get(Lemonade\Framework\Routing\UrlGenerator::class);
Dokumentace
HTTP

HTTP Layer

HTTP request/response runtime, middleware pipeline, dispatch handlers a error rendering flow.

(new KernelFactory())->create($context)->handle();
Dokumentace
HTTP

Framework API

Aplikace má framework API vrstvu s health endpointem, OpenAPI specifikací a jednoduchou HTML dokumentací.

GET /api/framework/health
Dokumentace
HTTP

Middleware

Middleware contracts, pořadí zpracování, zásahy do request/response flow a pravidla kompozice.

$framework->middleware(fn (MiddlewareStack $stack) => $stack->add(App\Http\Middleware\AuthMiddleware::class));
Dokumentace
Optimization

HTML Minification

Chování HTML response minification middleware, safety guards a integrační body.

$pipeline->pipe(HtmlMinifyMiddleware::class);
Dokumentace
HTTP

Routing

Router s explicitními a convention routes, named URL generation, route groups a middleware stack.

$router->getNamed('home', '/', 'HomeController@index');
Dokumentace
Presentation

View Rendering

Napojení view engine, shared variables, component integration a rendering workflow.

$html = $this->view()->render('home.index', ['title' => 'Homepage']);
Dokumentace
Presentation

UI Components

Znovupoužitelné presentation blocks registrované přes service providers a dostupné přes ComponentRegistry.

$components = $container->get(ComponentRegistry::class);
Dokumentace
Persistence

Database Layer

Sdílená database infrastruktura, provider boundaries, schema API a základní praktické použití.

use Lemonade\Framework\Database\Database;

$db = $container->get(Database::class);
$rows = $db->select('SELECT * FROM users WHERE active = ?', [1]);
Dokumentace
State

Session

Session lifecycle, flash messages, handler bindings a integrace do request flow.

$session->set('user_id', 42);
Dokumentace
Security

Security

Security primitives, CSRF protection, bezpečné hranice request processingu a poznámky k autentizaci.

<?= $helpers->csrfField() ?>
Dokumentace
Input

Validation

Přehled FormValidation, schema usage a samostatné stránky pro detailní popis validačních pravidel.

$result = $validator->field('email')->required()->email()->validate($payload);
Dokumentace
Diagnostics

Debug

Debug komponenta s dumper service, zachycením contextu a výběrem CLI/HTML rendereru.

dump($payload);
Dokumentace
SEO

Discovery

Integrace robots.txt a sitemap.xml pro technickou dohledatelnost webu.

$router->get("/sitemap.xml", ...);
Dokumentace
Files

Filesystem

Filesystem service, storage path helpers, file operations a bezpečné zápisy během runtime.

$filesystem->write($context->resolveCachePath('example.json'), json_encode($payload, JSON_THROW_ON_ERROR));
$data = json_decode($filesystem->read($context->resolveCachePath('example.json')), true, 512, JSON_THROW_ON_ERROR);
Dokumentace
Files

Upload

Upload service flow, file validation boundaries, storage strategies a příklady zpracování souborů.

$image = $this->upload()->uploadImage('avatar', 'avatar');
Dokumentace
Observability

Observability

Benchmarking, request logging, tracing hooks a integrační body pro provozní diagnostiku.

$logger->info('Import started');
Dokumentace
Support

Support Utilities

Helper utilities, sdílené support abstractions a doporučené usage patterns napříč aplikací.

$url = $helpers->url('documentation.show', ['path' => 'core']);
Dokumentace