Formuláře a POST zpracování - Lemonade Framework

Kompletní tok formuláře

Běžný server-rendered flow vypadá takto: GET vyrenderuje formulář, POST projde přes CsrfMiddleware, controller načte vstup a jednou ho zvaliduje. Při chybě vrátí formulář s chybami a původními hodnotami, při úspěchu předá zápis aplikační službě, uloží flash zprávu, provede redirect a skončí navazujícím GET. To je Post/Redirect/Get pattern. Pro detailnější návrh validačních pravidel pokračuj na Validaci a pro další HTTP guardy na Middleware.

Routy a ochrana CSRF

GET route nech jednoduchou a CsrfMiddleware připoj k POST routě, která mění stav. View vyrenderuje token přes vestavěný CSRF helper, takže request i view používají stejný mechanismus frameworku.

<?php

use App\Controllers\ContactController;
use Lemonade\Framework\Routing\Router;
use Lemonade\Framework\Security\Csrf\CsrfMiddleware;

return static function (Router $router): void {
    $router->getNamed('contact.form', '/contact', ContactController::class . '@form');

    $router
        ->postNamed('contact.submit', '/contact', ContactController::class . '@submit')
        ->middleware(CsrfMiddleware::class);
};

GET akce, POST akce, validace a redirect

GET akce připraví výchozí hodnoty a vyrenderuje stránku. POST akce načte vstup přes controller helpery, jednou ho zvaliduje, při chybě vrátí stejný formulář s HTTP 422 a při úspěchu zavolá aplikační službu pro zápis, nastaví flash zprávu a provede redirect.

<?php

declare(strict_types=1);

namespace App\Controllers;

use App\Services\ContactSubmissionService;
use Lemonade\Framework\Core\AbstractController;
use Lemonade\Framework\Validation\ValidationSchema;
use Psr\Http\Message\ResponseInterface;

final class ContactController extends AbstractController
{
    public function __construct(
        private readonly ContactSubmissionService $contactService,
    ) {}

    public function form(): ResponseInterface
    {
        return $this->renderForm(
            values: [
                'name' => '',
                'email' => '',
                'message' => '',
            ],
            errors: [],
        );
    }

    public function submit(): ResponseInterface
    {
        $values = [
            'name' => $this->inputString('name'),
            'email' => $this->inputString('email'),
            'message' => $this->inputString('message'),
        ];

        $schema = ValidationSchema::create()
            ->field('name', 'Name')
                ->required()
                ->maxLength(100)
            ->end()
            ->field('email', 'E-mail')
                ->required()
                ->email()
            ->end()
            ->field('message', 'Message')
                ->required()
                ->maxLength(2000)
            ->end();

        $result = $this->validator()->validate($values, $schema);

        if (!$result->isValid()) {
            return $this->renderForm(
                values: $values,
                errors: $result->errors(),
                status: 422,
            );
        }

        $this->contactService->store($result->validated());
        $this->flash()->set('success', 'Your message has been sent.');

        return $this->redirect($this->url()->route('contact.form'));
    }

    /**
     * @param array{name:string,email:string,message:string} $values
     * @param array<string, string> $errors
     */
    private function renderForm(array $values, array $errors, int $status = 200): ResponseInterface
    {
        return $this->html(
            $this->view()->template('layouts.app', 'pages.contact-form', [
                'values' => $values,
                'errors' => $errors,
            ]),
            $status,
        );
    }
}

Vyrenderuj formulář s CSRF, hodnotami a chybami

Form view vyrenderuje csrfField(), vrátí odeslané hodnoty zpět do inputů a na redirectovaném GET přečte success flash zprávu. values a errors předávej z controlleru explicitně, aby view nezáviselo na skrytých helperech demo aplikace.

<?php

/**
 * @var \Lemonade\Framework\View\View $this
 * @var \Lemonade\Framework\View\ViewHelpers $helpers
 * @var \Lemonade\Framework\View\RequestViewHelpers $requestHelpers
 * @var array<string, string> $errors
 * @var array{name:string,email:string,message:string} $values
 */
?>
<?php if ($success = $requestHelpers->flash('success')): ?>
    <div class="alert alert-success"><?= e((string) $success) ?></div>
<?php endif; ?>

<form method="post" action="<?= e($helpers->url('contact.submit')) ?>">
    <?= $helpers->csrfField() ?>

    <input name="name" value="<?= e($values['name']) ?>">
    <input name="email" value="<?= e($values['email']) ?>">
    <textarea name="message"><?= e($values['message']) ?></textarea>

    <?php if (isset($errors['message'])): ?>
        <p><?= e($errors['message']) ?></p>
    <?php endif; ?>

    <button type="submit">Send</button>
</form>

Zápis drž mimo controller

Controller má řešit HTTP orchestrace. Samotný zápis může žít v malé aplikační službě, jakmile už nejde jen o jednoduché propojení requestu s frameworkem. Controller tak zůstane čitelný, aniž by se service nebo repository vrstva stala povinností.

<?php

declare(strict_types=1);

namespace App\Services;

use Lemonade\Framework\Database\Database;

final class ContactSubmissionService
{
    public function __construct(
        private readonly Database $db,
    ) {}

    /**
     * @param array{name:string,email:string,message:string} $data
     */
    public function store(array $data): void
    {
        $this->db->table('contact_messages')->insert($data);
    }
}