Leitfaden

Infrastruktur

Cache, Sessions, Uploads, Filesystem und HTTP-Client ohne Kopplung an Framework-Interna.

Cache für wiederherstellbare Daten

Verwende CacheManager für Daten, die neu berechnet werden können, etwa Artikellisten oder Navigation. Der Cache ist keine Quelle der Wahrheit.

example.php
use Lemonade\Framework\Cache\CacheManager;

final class ArticleFeed
{
    public function __construct(
        private readonly CacheManager $cache,
    ) {}

    public function latest(): array
    {
        return $this->cache->remember('articles.latest', 600, function (): array {
            return [];
        });
    }
}

Sessions und Flash-Nachrichten

In Controllern ist flash() ein bequemer Weg für einmalige Nachrichten über einen Redirect. Außerhalb von Controllern injizierst du die Session- oder Flash-Abstraktion explizit.

example.php
$this->flash()->set('success', 'Article saved.');

return $this->redirect($this->url()->route('articles.index'));

Uploads und Filesystem

Verwende upload() mit konfigurierten Profilen für Uploads und filesystem() für Dateiarbeit. Limits und Zielverzeichnisse gehören in die YAML-Konfiguration.

example.php
$image = $this->upload()->uploadImage('image', 'article_image');
$content = $this->filesystem()->read($this->app()->basePath('README.md'));

HTTP-Client

Für ausgehende Integrationen injiziere Psr\Http\Client\ClientInterface zusammen mit einer PSR Request Factory. Timeouts und SSL werden in HttpClient.yaml konfiguriert.

example.php
<?php

declare(strict_types=1);

namespace App\Services;

use Psr\Http\Client\ClientInterface;
use Psr\Http\Message\RequestFactoryInterface;

final class StatusApi
{
    public function __construct(
        private readonly ClientInterface $client,
        private readonly RequestFactoryInterface $requests,
    ) {}

    public function check(): void
    {
        $request = $this->requests->createRequest('GET', 'https://status.example.test/health');
        $this->client->sendRequest($request);
    }
}