Installer Statamic : les 2 méthodes à connaître

On résume ici les deux approches officielles : intégration dans un Laravel existant, ou nouveau projet via la CLI. Le détail et les mises à jour de commandes restent sur la doc Statamic (liens ci‑dessous). Une démo vidéo (lecteur et liens) est en fin d’article.

1. Installer Statamic sur un projet Laravel existant

C’est souvent le scénario le plus intéressant en pratique.

Si vous avez déjà une application Laravel, vous pouvez ajouter Statamic comme dépendance Composer et l’intégrer à votre app. La procédure détaillée est décrite ici : Installing into an Existing Laravel Application.

Étapes principales

1. Vider le cache de config (recommandé avant toute installation) :

php artisan config:clear

2. Adapter votre composer.json : ajouter les scripts indiqués dans la doc (bloc pre-update-cmd et ligne supplémentaire dans post-autoload-dump qui exécute statamic:install). C’est ce qui permet à Composer de finaliser correctement l’installation.

3. Installer le package :

composer require statamic/cms --with-dependencies

4. Utilisateurs : selon la façon dont votre app gère déjà l’authentification, vous devrez peut‑être publier les migrations d’auth Statamic :

php please auth:migration

À garder en tête

Avec cette méthode, aucun contenu ni gabarit de site “clé en main” n’est fourni automatiquement : vous restez maître de la structure (collections, vues, layout, etc.). La doc explique comment poser une collection type “pages” et les vues minimales (layout, default) si vous partez de zéro côté front.

Statamic s’appuie aussi sur une route “catch‑all” pour servir les URLs du CMS : vérifiez que vous n’avez pas une route trop large qui capturerait tout le trafic avant Statamic.

Enfin, si votre stack front impose des contraintes (par exemple Inertia très récent), ouvrez bien la page d’installation Statamic : la doc indique les versions de Laravel et les combinaisons supportées au moment où vous lisez cet article.

2. Installer Statamic pour un nouveau site (méthode recommandée si vous démarrez de zéro)

Si vous lancez un nouveau projet et que vous voulez la voie la plus simple, la doc recommande plutôt l’installation “locale” classique : How to Install Statamic Locally.

L’idée : utiliser la CLI Statamic pour générer un projet déjà structuré.

Installer la CLI (une fois sur votre machine)

composer global require statamic/cli

Créer le projet

Placez-vous dans le dossier parent voulu, puis :

statamic new nom_du_projet

L’outil vous guide : site vide ou starter kit, puis création d’un premier super administrateur. Ensuite, vous pouvez servir le site avec votre stack habituelle (Valet, autre vhost, ou php artisan serve).

Comment choisir ?

• Laravel déjà en place (SaaS, appli métier, API, etc.) → intégration package Composer sur le repo existant.

• Nouveau site vitrine / blog / marketing → en général, statamic new pour aller plus vite et hériter d’une base saine.

Dans tous les cas, la référence reste la doc Statamic : prérequis PHP, commandes exactes et variantes (Docker, Sail, etc.) y sont tenues à jour.

Vidéo : installation en pratique

• Ouvrir sur YouTube (youtu.be)
• Lien watch sur youtube.com

Conclusion

Vous avez donc deux portes d’entrée : package sur Laravel existant ou nouveau projet via la CLI. Les deux sont officielles ; le bon critère est votre contexte (projet neuf vs appli déjà en production).

Dans un prochain volet, on pourra détailler la structure des dossiers (content/, config/statamic/, blueprints, vues) une fois Statamic en place.