Sulu 3 : organiser un projet multisite sans mélanger les contenus

Webspaces, domaines, langues et SEO : une méthode concrète pour isoler les contenus et vérifier un projet multisite avec Sulu 3.

Un même Sulu peut héberger plusieurs sites, mais chaque domaine doit afficher le bon contenu, la bonne identité et les bonnes métadonnées. Un second webspace correctement configuré ne suffit pas si un contrôleur personnalisé interroge encore les pages du premier site. Voici une méthode pour organiser un projet multisite après une migration vers Sulu 3.

Repères vérifiés le . Exemple de configuration contrôlé sur Sulu 3.0.11. Il illustre un webspace français et anglais ; les noms de templates et les domaines sont des exemples à adapter au projet.

Séparer les sites avec des webspaces

Un webspace correspond à un arbre de contenu distinct dans l’administration. Sa clé doit être unique. Les portails associent les URL aux environnements, et les localisations définissent les langues disponibles. La documentation Sulu sur les webspaces décrit cette configuration XML.

Je crée un webspace lorsque les contenus, la navigation ou l’équipe éditoriale ont réellement leur propre périmètre. Une simple traduction du même site reste généralement une localisation du même arbre. Cette décision doit précéder les premières publications : déplacer ensuite les URL et les habitudes éditoriales coûte plus cher qu’ajouter un fichier XML.

Un fichier explicite pour les domaines et les langues

Enregistrez cet exemple dans config/webspaces/studio.xml. Il suppose que les templates studio-page et studio-homepage existent. Les chemins /fr et /en rendent la langue visible ; les domaines de démonstration ne doivent pas être recopiés en production.

<?xml version="1.0" encoding="utf-8"?>
<webspace xmlns="http://schemas.sulu.io/webspace/webspace">
    <name>Studio</name>
    <key>studio</key>
    <localizations>
        <localization language="fr" default="true"/>
        <localization language="en"/>
    </localizations>
    <default-templates>
        <default-template type="page">studio-page</default-template>
        <default-template type="home">studio-homepage</default-template>
    </default-templates>
    <navigation>
        <contexts>
            <context key="main">
                <meta><title lang="fr">Navigation principale</title></meta>
            </context>
        </contexts>
    </navigation>
    <resource-locator>
        <strategy>tree_leaf_edit</strategy>
    </resource-locator>
    <portals>
        <portal>
            <name>Studio</name>
            <key>studio</key>
            <environments>
                <environment type="dev">
                    <urls><url>studio.localhost/{localization}</url></urls>
                </environment>
                <environment type="prod">
                    <urls><url>studio.example.com/{localization}</url></urls>
                </environment>
            </environments>
        </portal>
    </portals>
</webspace>

Les domaines doivent aussi être reconnus par le serveur HTTP, le certificat et la configuration des hôtes de confiance de Symfony. Une URL déclarée dans le XML ne crée ni DNS ni certificat. En développement, vérifiez également que le nom local se résout vers votre serveur.

Pour ajouter une langue à un arbre existant, Sulu documente php bin/adminconsole sulu:page:initialize. Exécutez les opérations de préparation sur une copie sauvegardée, puis attribuez les permissions nécessaires aux utilisateurs. Déclarer une langue ne traduit aucun texte : la documentation des localisations distingue la configuration et l’utilisation éditoriale.

Éviter les collisions entre les identités visuelles

Dans mon organisation de projet, les clés de templates et les fichiers Twig portent un préfixe de site : studio-page, studio/base.html.twig, puis les gabarits qui en héritent. Le favicon, le logo et les métadonnées sociales appartiennent au même périmètre. Une page d’erreur ou de recherche oubliée peut facilement afficher l’habillage du site voisin.

Les éléments techniques partagés restent communs : date, formatage des durées ou composant de pagination. Les textes de marque et les destinations de navigation restent propres au site. Cette frontière rend une extraction future plus simple sans imposer plusieurs installations dès le départ.

Les contrôleurs personnalisés doivent connaître leur contexte

Une requête qui ne filtre que le statut « publié » peut mélanger plusieurs sites. Pour une liste de recettes, un annuaire ou un moteur de recherche personnalisé, je vérifie au minimum le webspace, la langue, le statut de publication et le type de contenu attendu. Une requête d’administration qui voit les brouillons n’est pas réutilisée telle quelle pour le site public.

Même contrôle pour les routes communes comme /contact ou /ingredients. Une route Symfony globale peut intercepter plusieurs domaines avant le rendu d’une page Sulu. Chaque contrôleur doit alors traiter le contexte attendu ou renvoyer vers la bonne destination. Je teste également l’URL sur un autre domaine du projet pour détecter les fuites de contenu.

Contrôler les URL de langue avant de les indexer

Une traduction publiée doit disposer de sa propre URL et de ses métadonnées. Pour des pages traduites distinctes, je vérifie une URL canonique cohérente et des liens hreflang réciproques, incluant la page elle-même. Les cibles doivent être les pages équivalentes, accessibles et indexables ; je ne fabrique pas une alternative vers une traduction absente. Google explique les règles des versions localisées.

Le sitemap mérite le même contrôle : seules les URL du domaine concerné doivent y figurer. Un index peut organiser plusieurs fichiers, mais un sitemap de pages ne doit pas mélanger arbitrairement les hôtes. Le protocole Sitemaps précise le périmètre des URL et l’encodage XML.

Une matrice de recette courte, mais systématique

  • Pour chaque domaine et langue : accueil, page interne, recherche, formulaire, page 404.
  • Pour chaque page : logo, navigation, title, description, canonical et destination des liens.
  • Pour chaque liste : absence des brouillons et des contenus du site voisin.
  • Pour chaque traduction : langue réellement publiée, sélecteur et liens alternatifs corrects.
  • Après publication : invalidation du cache sur le domaine concerné et absence de contenu ancien.

Un contrôle qui visite seulement la page d’accueil française peut manquer presque tous ces problèmes. Je garde donc quelques URL représentatives par site dans les tests de navigateur, puis je vérifie les réponses HTTP et les métadonnées après chaque déploiement. Cette matrice constitue aussi une base concrète pour valider une migration Sulu sans parcourir manuellement tout le contenu.

← Tous les articles