kantarciandClaude Opus 5
269fb223af
Arbeitspaket M sagte "Abfragen je Seite zaehlen. Messen, dann zusammenfassen." Messen braucht ein Messgeraet, also gibt es jetzt eines: ein Zaehler als Doctrine-Middleware, dessen Zahl ausserhalb der Produktion im Kopf X-Kant-Queries steht. Keine Profiler-Maschinerie, eine Zahl. Die erste Messung: die Startseite brauchte 18 Abfragen. Nicht wegen einer komplizierten Seite, sondern weil SiteSettings::load() und Theme::load() je Aufrufer dieselbe Zeile erneut holten - Renderer, strukturierte Daten, Einwilligungsschalter, Vorlagen. Beide merken sich ihren Stand jetzt fuer die Dauer einer Anfrage: 18 auf 8. Dabei ist mir die klassische Falle des Merkens selbst passiert, und ein bestehender Test hat sie sofort gezeigt: ich leerte den Merker am Anfang des Speicherns. Das Speichern liest den Stand aber noch einmal und fuellte ihn damit erneut - der Rest der Anfrage bekam den alten Stand. Geleert wird jetzt nach dem Schreiben. Das Ladebudget wird gemessen statt behauptet: die Browserpruefung liest je Seite HTML-Groesse, CSS-Groesse, Anzahl Anfragen, Anzahl Skripte und Abfragezahl und prueft Obergrenzen. Startseite: 7,4 KB HTML, 22,7 KB CSS, 2 Anfragen, 8 Abfragen, 0 Skripte. Die Null ist die wichtigste Zahl - sie haelt als Test fest, was bisher nur Absicht war. Das erste Bild einer Seite ist nicht mehr lazy. Es ist meistens das groesste Ding ueber der Falz, und es zu verzoegern verzoegert genau das Pixel, auf das jemand wartet. Der Renderer bestimmt es in Renderreihenfolge, Kopfbereich zuerst. Eine feste Obergrenze ist kein Blaettern: der Fassungsverlauf hoerte bei dreissig auf, die Einsendungen bei fuenfzig, die Weiterleitungen zeigten bis zu zweitausend auf einmal. Das Erste sieht aus wie "es gibt dreissig" und ist das Einzige, was eine Historie nicht tun darf. Alle drei blaettern jetzt, mit derselben Rechnung und demselben Pager wie Beitragsarchiv und Mediathek. 347 PHP-Tests / 1422 Assertions unter PHP 8.2.12 und 8.4.22. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
33 lines
962 B
PHP
33 lines
962 B
PHP
<?php
|
|
|
|
namespace App\Content;
|
|
|
|
/**
|
|
* The arithmetic every paged list needs, in one place.
|
|
*
|
|
* A fixed upper limit is not pagination: it shows the first thirty entries and says nothing about
|
|
* the rest. This makes "there are more, here is how to reach them" cheap enough that no list has
|
|
* to settle for a cap.
|
|
*/
|
|
final class Pagination
|
|
{
|
|
/**
|
|
* @return array{page: int, pages: int, offset: int, perPage: int, total: int}
|
|
*/
|
|
public static function of(int $page, int $total, int $perPage): array
|
|
{
|
|
$perPage = max(1, min(200, $perPage));
|
|
$pages = max(1, (int) ceil($total / $perPage));
|
|
// A page beyond the end shows the last one rather than an empty screen.
|
|
$page = max(1, min($page, $pages));
|
|
|
|
return [
|
|
'page' => $page,
|
|
'pages' => $pages,
|
|
'offset' => ($page - 1) * $perPage,
|
|
'perPage' => $perPage,
|
|
'total' => $total,
|
|
];
|
|
}
|
|
}
|