# Regrouper titre, description et canonical dans un objet PHP 8.1 non modifiable

> Trois filtres épars pour gérer le titre, la description et le canonical d'une page finissent toujours par se marcher dessus. Architecture d'un objet-valeur immuable en PHP 8.1.

- Auteur : WordPress Développement
- Publié le : 2022-01-03
- Mis à jour le : 2022-01-03
- Catégorie : SEO & GEO
- URL : https://www.wpmoderne.fr/seo/regrouper-titre-description-canonical-objet-php81/

## L’essentiel

- readonly (PHP 8.1) empêche toute modification accidentelle après construction
- Un seul point de construction évite les incohérences entre trois filtres épars
- L'objet reste indépendant de l'affichage dans le head

```
final class MetadonneesPage {
    public function __construct(
        public readonly string $titre,
        public readonly string $description,
        public readonly string $canonical
    ) {}
}
```

Cette classe de quelques lignes règle un problème récurrent sur les projets où le titre, la description et l'URL canonique d'une page sont calculés à trois endroits différents du thème, parfois par des développeurs différents, à des moments différents du cycle de requête. PHP 8.1, sorti fin novembre 2021, introduit les propriétés `readonly` qui rendent ce genre d'objet réellement immuable une fois construit.

Voici l'architecture complète de cet objet-valeur, pensée pour un développeur backend qui centralise ces trois métadonnées avant qu'elles ne soient affichées dans le `<head>` du thème — l'affichage lui-même relevant d'une autre couche, non traitée ici.

## Le problème que cette architecture résout

Sur un thème sans structure claire, le titre peut être défini par un filtre `document_title_parts`, la description par une fonction accrochée à `wp_head`, et le canonical par un filtre `get_canonical_url` encore différent. Rien n'empêche ces trois points de code d'entrer en contradiction : un canonical qui pointe vers une page dont le titre a été calculé pour une autre URL, par exemple, en cas de logique dupliquée ou mal synchronisée entre les trois filtres.

## La classe centrale

> L'essentiel à retenir : readonly (PHP 8.1) empêche toute modification accidentelle après construction ; Un seul point de construction évite les incohérences entre trois filtres épars ; L'objet reste indépendant de l'affichage dans le head

L'objet `MetadonneesPage` devient l'unique source de vérité pour ces trois valeurs. Une fois construit, aucune de ses propriétés ne peut être modifiée : toute tentative déclenche une erreur, ce qui élimine par construction toute une catégorie de bugs liés à une modification tardive et non maîtrisée.

```
$metadonnees = new MetadonneesPage(
    titre: 'Guide complet du filtre document_title_parts',
    description: 'Comment personnaliser le titre affiché par WordPress sans extension.',
    canonical: home_url( '/guide-document-title-parts/' )
);

// $metadonnees->titre = 'Autre titre'; // Error: Cannot modify readonly property
```

## La fabrique qui construit l'objet

Une classe fabrique centralise la logique de calcul, en s'appuyant sur les données de l'article WordPress courant :

```
final class FabriqueMetadonnees {
    public static function depuisArticle( \WP_Post $article ): MetadonneesPage {
        $titre = get_the_title( $article );
        $description = has_excerpt( $article )
            ? get_the_excerpt( $article )
            : wp_trim_words( $article->post_content, 25 );

        return new MetadonneesPage(
            titre: $titre,
            description: $description,
            canonical: get_permalink( $article )
        );
    }
}
```

## Ce que cette architecture apporte concrètement

- Un seul point d'entrée à tester unitairement, plutôt que trois filtres dispersés dans le thème
- Une garantie structurelle contre les modifications accidentelles après construction, grâce à `readonly`
- Une base réutilisable pour d'autres types de contenu (page, taxonomie) via d'autres méthodes de fabrique

## Étendre l'objet à d'autres types de contenu

La même fabrique peut être complétée par d'autres méthodes statiques, chacune produisant le même type d'objet `MetadonneesPage` à partir d'une source différente : une page de taxonomie, une page de résultats de recherche, ou une archive d'auteur.

```
final class FabriqueMetadonnees {
    public static function depuisTerme( \WP_Term $terme ): MetadonneesPage {
        return new MetadonneesPage(
            titre: $terme->name,
            description: wp_trim_words( term_description( $terme ), 25 ),
            canonical: get_term_link( $terme )
        );
    }
}
```

Cette extensibilité découle directement du fait que l'objet `MetadonneesPage` ne connaît rien de sa source : il ne fait qu'exposer trois propriétés en lecture seule, quel que soit le type de contenu qui les a produites.

## Les limites de cette approche

Cet objet ne remplace pas les filtres natifs de WordPress comme `document_title_parts` : il constitue plutôt la source de données que ces filtres viendront lire au moment de l'affichage. Sa valeur tient dans la centralisation du calcul, pas dans le remplacement du mécanisme d'affichage lui-même, qui reste couplé aux hooks natifs du cœur.

> Le principe qu'on applique désormais sur nos thèmes maison : toute donnée calculée à plusieurs endroits mérite un objet unique qui en devient la seule source de vérité.

## En résumé

Centraliser titre, description et canonical dans un objet-valeur immuable élimine un défaut d'architecture fréquent : la dispersion de la même logique dans plusieurs filtres qui finissent par se contredire. Les propriétés `readonly` de PHP 8.1 rendent cette centralisation robuste, en empêchant structurellement toute modification tardive une fois l'objet construit.