self::excerpt($post, $length), ['is_safe' => ['html']] ), new TwigFunction( 'post_url', fn (Post $post) => '/article/'.$post->getStoredSlug() ), new TwigFunction( 'post_thumbnail', fn (Post $post) => self::thumbnail($post) ), new TwigFunction( 'post_initials', fn (Post $post) => self::initials($post) ), ]; } /** * Génère un extrait HTML formaté du contenu de l'article. * * Conserve uniquement les balises sûres et porteuses de sens visuel * (

,
,
1. , , , , ) afin que le formatage * soit perceptible dans l'aperçu (listes à puces, gras, italique…). * Toutes les autres balises sont supprimées par strip_tags(). * * La hauteur de l'aperçu est contrainte côté CSS (max-height sur .card__body + * dégradé de fondu sur .card__excerpt) — c'est CSS qui tronque visuellement, * pas cette méthode. Le paramètre $length sert uniquement de garde-fou serveur : * il évite d'envoyer l'intégralité d'un long article au navigateur. La valeur * par défaut de 400 caractères est volontairement généreuse pour ne jamais * couper un contenu que CSS aurait affiché en entier. * * La troncature opère sur le HTML filtré (pas sur le texte brut) afin de * conserver le formatage de façon cohérente, quelle que soit la longueur * du contenu. Le comptage de caractères ignore les balises. * * Le HTML retourné provient de HTMLPurifier (appliqué à l'écriture) — * strip_tags() avec liste blanche élimine tout balisage résiduel non désiré. * La fonction est déclarée is_safe => ['html'] : Twig ne l'échappe pas * automatiquement, le |raw est inutile dans les templates. * * @param Post $post L'article dont générer l'extrait * @param int $length Longueur maximale en caractères visibles (défaut : 400) * * @return string L'extrait en HTML partiel, tronqué si nécessaire */ private static function excerpt(Post $post, int $length): string { // Balises conservées : structurantes pour les listes, sémantiques pour le gras/italique. // Toutes les autres (p, div, h1-h6, img, a, table…) sont supprimées pour // garder un aperçu compact. $allowed = '
   1. '; $html = strip_tags($post->getContent(), $allowed); // Mesurer sur le texte brut : les balises ne comptent pas dans la limite visible if (mb_strlen(strip_tags($html)) <= $length) { return $html; } // Tronquer en avançant caractère par caractère dans le HTML, en ignorant // les balises dans le comptage — le formatage est ainsi conservé dans la // portion visible, de façon cohérente avec les articles courts. $truncated = ''; $count = 0; $inTag = false; for ($i = 0, $len = mb_strlen($html); $i < $len && $count < $length; $i++) { $char = mb_substr($html, $i, 1); if ($char === '<') { $inTag = true; } $truncated .= $char; if ($inTag) { if ($char === '>') { $inTag = false; } } else { $count++; } } // Fermer proprement les balises laissées ouvertes par la troncature foreach (['li', 'ul', 'ol', 'em', 'strong', 'b', 'i'] as $tag) { $opens = substr_count($truncated, "<{$tag}>") + substr_count($truncated, "<{$tag} "); $closes = substr_count($truncated, ""); for ($j = $closes; $j < $opens; $j++) { $truncated .= ""; } } return $truncated . '…'; } /** * Extrait l'URL de la première image présente dans le contenu de l'article. * * Utilise une regex sur l'attribut src de la première balise trouvée. * Le contenu étant sanitisé par HTMLPurifier, seuls les schémas http/https * sont présents — aucun risque XSS via cet attribut. * L'échappement de l'URL est délégué à Twig (auto-escape activé). * * @param Post $post L'article dont extraire la vignette * * @return string|null L'URL de la première image, ou null si aucune image */ private static function thumbnail(Post $post): ?string { if (preg_match('/]+src=["\']([^"\']+)["\']/', $post->getContent(), $matches)) { return $matches[1]; } return null; } /** * Génère les initiales du titre de l'article (1 à 2 caractères). * * Extrait la première lettre de chaque mot, conserve les deux premières, * et retourne le résultat en majuscules. Les mots vides (articles, prépositions * d'une lettre) sont ignorés pour favoriser les mots porteurs de sens. * * Exemples : * "Article de Blog" → "AB" * "Été en forêt" → "EF" * "PHP" → "P" * "" → "?" * * L'échappement HTML est délégué à Twig (auto-escape activé). * * @param Post $post L'article dont générer les initiales * * @return string Les initiales en majuscules (1–2 caractères), ou "?" si le titre est vide */ private static function initials(Post $post): string { // Filtrer les mots vides fréquents (articles, prépositions, coordinations) // pour favoriser les mots porteurs de sens : "Article de Blog" → ["Article", "Blog"] → "AB" $stopWords = ['a', 'au', 'aux', 'd', 'de', 'des', 'du', 'en', 'et', 'l', 'la', 'le', 'les', 'of', 'the', 'un', 'une']; $words = array_filter( preg_split('/\s+/', trim($post->getTitle())) ?: [], static function (string $w) use ($stopWords): bool { $normalized = mb_strtolower(trim($w, " \t\n\r\0\x0B'\"’`.-_")); return $normalized !== '' && mb_strlen($normalized) > 1 && !in_array($normalized, $stopWords, true); } ); if (empty($words)) { // Repli sur le premier caractère du titre brut si tous les mots font 1 lettre $first = mb_substr(trim($post->getTitle()), 0, 1); return $first !== '' ? mb_strtoupper($first) : '?'; } $words = array_values($words); $initials = mb_strtoupper(mb_substr($words[0], 0, 1)); if (isset($words[1])) { $initials .= mb_strtoupper(mb_substr($words[1], 0, 1)); } return $initials; } }