linkedin-ico github-ico

Démarrer Sulu avec Docker, sans PHP sur l’hôte

sulu docker

Démarrer Sulu sans installer PHP sur sa machine est possible : Composer, PHP, Node et PostgreSQL peuvent être exécutés dans des conteneurs. Le point important est de distinguer la création du squelette, l’installation des dépendances, la préparation des assets et l’initialisation d’une base neuve.

Article complété et vérifié le . Parcours vérifié sur un projet jetable Sulu Skeleton 3.0.11, PHP 8.4 et PostgreSQL 16. Les commandes ci-dessous concernent exclusivement un nouveau projet local.

Créer le squelette officiel

Prérequis : Docker avec le plugin Compose, un terminal et un dossier parent accessible en écriture. Cette commande crée un répertoire sulu-demo, sans installer encore les dépendances PHP :

docker run --rm --user "$(id -u):$(id -g)"   -e COMPOSER_HOME=/tmp/composer   -v "$PWD":/app -w /app composer:2   create-project --no-install --no-scripts --no-interaction sulu/skeleton sulu-demo 3.0.11
cd sulu-demo

Nous utilisons le squelette officiel Sulu avec une version fixée pour rendre le tutoriel vérifiable. --no-install reporte la résolution des dépendances au conteneur PHP du projet. Cette étape évite de dépendre des extensions PHP présentes dans l’image Composer. Les options de création sont documentées par Composer.

Installer la configuration des conteneurs

Ajoutez les trois fichiers du guide Docker pour Symfony et Sulu : .docker/Dockerfile, .docker/nginx/default.conf et compose.yaml. Ils utilisent PostgreSQL 16, le nom de service database et le port HTTP local 8080. Sous Linux :

export LOCAL_UID="$(id -u)"
export LOCAL_GID="$(id -g)"
docker compose -f compose.yaml build php
docker compose -f compose.yaml up -d database
docker compose -f compose.yaml run --rm php composer install
docker compose -f compose.yaml run --rm php composer check-platform-reqs

La variable DATABASE_URL est fournie au service PHP par Compose. L’hôte de connexion est database, qui désigne le conteneur PostgreSQL ; localhost désignerait le conteneur PHP lui-même. Le paramètre serverVersion=16 correspond ici à PostgreSQL 16, sans mélange avec un exemple MySQL 5.7.

Avant l’initialisation, choisissez la clé et les langues du webspace dans config/webspaces/website.xml. Le squelette propose ses propres valeurs ; adaptez-les à votre site. La documentation de démarrage Sulu rappelle que changer la clé après création des données demande des précautions.

Initialiser uniquement une base neuve

docker compose -f compose.yaml run --rm php php bin/adminconsole sulu:build dev --no-interaction

Cette commande est réservée à la base locale neuve de ce tutoriel. Elle initialise le schéma, les données système et un utilisateur de démonstration. Elle ne constitue pas une procédure de mise à jour pour un site qui contient déjà des pages ou des médias. Ne la lancez pas sur une base existante pour résoudre une erreur de démarrage.

Le mode dev crée ici le compte local admin avec le mot de passe admin. Gardez cette installation sur la boucle locale, et changez ces identifiants avant tout accès partagé. Un déploiement réel nécessite un provisionnement des comptes et secrets adapté à son environnement.

Compiler l’administration

Le squelette possède une application JavaScript dans assets/admin. Elle a son propre arbre de dépendances. Pour une première installation, utilisez Node dans un conteneur :

docker run --rm --user "$(id -u):$(id -g)"   -v "$PWD":/app -w /app/assets/admin node:22 npm install
docker run --rm --user "$(id -u):$(id -g)"   -v "$PWD":/app -w /app/assets/admin node:22 npm run build

Après ce premier calcul, conservez le lockfile généré dans le dépôt et utilisez npm ci pour les installations reproductibles. Compilez depuis le répertoire prévu par le squelette : installer quelques paquets React à la racine ne remplace pas le build de l’administration.

Démarrer et créer le premier contenu

docker compose -f compose.yaml up -d php nginx
docker compose -f compose.yaml ps

Ouvrez http://localhost:8080/admin, puis créez et publiez la page d’accueil dans la langue du webspace. Le site public sera accessible sur http://localhost:8080/. Si aucun contenu n’est publié à cette adresse ou dans la bonne langue, une page 404 peut refléter cet état éditorial plutôt qu’une erreur de Nginx.

Une interface d’administration dont les scripts répondent 404 indique souvent un build absent ou un mauvais chemin public. Une erreur de connexion à la base invite à vérifier le nom de service et la disponibilité PostgreSQL. Les journaux permettent de distinguer ces deux familles de problème avant de réinitialiser quoi que ce soit.

Conserver les données entre deux sessions

Pour arrêter le projet, utilisez docker compose -f compose.yaml down. Le volume PostgreSQL reste présent tant qu’il n’est pas supprimé. L’option -v supprimerait les volumes associés : elle ne fait pas partie de la procédure d’arrêt habituelle.

Versionnez les fichiers de configuration et les lockfiles ; conservez les secrets locaux hors Git. Quand ce socle fonctionne, ajoutez progressivement les besoins du projet : mails de développement, recherche, tâches asynchrones ou stockage des médias. Un premier démarrage réussi constitue un point de référence utile pour les évolutions suivantes.