Guida

Infrastruttura

Cache, session, upload, filesystem e client HTTP senza accoppiare l’applicazione agli internals del framework.

Cache per dati ricostruibili

Usa CacheManager per dati che possono essere ricalcolati, come liste di articoli o navigazione. La cache non è una fonte di verità.

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 [];
        });
    }
}

Session e messaggi flash

Nei controller, flash() è un modo comodo per inviare messaggi una tantum attraverso un redirect. Fuori dai controller, inietta esplicitamente l’astrazione di session o flash.

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

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

Upload e filesystem

Usa upload() con profili configurati per gli upload e filesystem() per lavorare con i file. Mantieni limiti e directory di destinazione nella configurazione YAML.

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

Client HTTP

Per integrazioni in uscita, inietta Psr\Http\Client\ClientInterface insieme a una PSR request factory. Configura timeout e SSL in HttpClient.yaml.

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);
    }
}