Démarrer un projet Drupal 11 avec Upsun Fixed : guide pour bien débuter

Platform.sh, la plateforme d’hébergement cloud bien connue des développeurs web, est devenue Upsun le 23/09/2025.

Upsun se décline désormais en deux offres : Upsun Fixed et Upsun Flex.

• Upsun Fixed propose des environnements prédéfinis et stables, idéals pour démarrer rapidement sans se soucier de la configuration serveur.
• Upsun Flex, plus avancé, permet une personnalisation fine de l’infrastructure et des services, adaptée aux besoins spécifiques ou aux projets à forte charge.

Pour débuter avec Drupal, Upsun Fixed est largement suffisant. Basé sur une infrastructure conteneurisée et des workflows Git intégrés, il offre un socle technique stable pour déployer rapidement vos projets en Drupal sans configuration complexe.

Ce guide s’adresse aux débutants qui veulent comprendre comment lancer leur projet Drupal sur Upsun Fixed, étape par étape.

Les configurations fournies dans ce guide sont prévues pour des environnements de “staging” et non pas de “production”.

Guide de lecture

Ce guide vous accompagne pas à pas dans la mise en place d’un projet Drupal 11 sur Upsun Fixed.

1. Configuration de l’application : mise en place de la base technique et des paramètres essentiels d’Upsun.
2. Services (MariaDB, Memcached, Varnish) : définition d’une stack performante et adaptée à Drupal.
3. Variables d’environnement : configuration dynamique pour relier Drupal à ses services.
4. Hooks : automatisation du build, du déploiement et du nettoyage des caches.
5. Tuning PHP : optimisations avancées pour les projets plus volumineux ou exigeants.
6. Pour aller plus loin : automatisation CI/CD, intégration locale avec DDEV et sécurité avancée.

1. Configuration de l’application Upsun Fixed

Pour initialiser un projet Drupal 11 sur Upsun Fixed, il est recommandé de suivre la configuration de base proposée dans la documentation officielle d’Upsun et d’y apporter quelques modifications.

Cette configuration se fait dans le fichier .platform.app.yaml.

Voici les principaux ajustements recommandés pour Drupal 11 :

• Upsun Fixed prend en charge jusqu’à PHP 8.4. Il est conseillé de spécifier explicitement la version de PHP utilisée, ainsi qu’une version fixe de Composer pour garantir la reproductibilité du build. Il est conseillé également de désactiver le flavor prédéfini pour contrôler le build via Composer.
• Si vous ne comptez pas utiliser Redis, vous pouvez supprimer la relation correspondante du fichier de configuration.
• Ajouter les extensions PHP nécessaires à votre projet.
• Utiliser la commande drush de votre vendor et définir le cron sur sa fréquence minimale (5min).
• Supprimer la section source, devenue obsolète dans la configuration Upsun Fixed.
• Définir une taille (par défaut automatique) : pour un projet Drupal 11 standard, la taille M est suffisante.
• Définir votre timezone.
• Au besoin, permettre aux rôles contributeur de récupérer la base de données ou les fichiers en local.

Voici un résumé des modifications conseillées par rapport à la configuration fournie par Upsun :

2. Configuration des services

Pour débuter, ce guide recommande de configurer trois services : MariaDB, Memcached et Varnish. Ensemble, ils forment une stack performante et équilibrée pour un projet Drupal 11 sur un sizing Upsun Fixed de petite ou moyenne taille.

Ajoutez d’abord les relations vers la base de données et le cache dans le fichier précédemment configuré, ainsi que l’extension PHP memcached :

Ces relations permettent à votre application Drupal de communiquer automatiquement avec les services correspondants.

Les services sont définis dans le fichier .platform/services.yaml. Voici une configuration de base adaptée à Drupal 11 :

Les tailles peuvent être fixes (S, M, L, XL…) ou automatiques. Pour un projet Drupal 11 standard, les tailles indiquées ci-dessus sont suffisantes.

Le fichier de configuration VCL de Varnish doit être ajouté ici : .platform/varnish/default.vcl

Pour terminer, mettre à jour votre configuration .platform/routes.yaml pour passer par Varnish :

3. Variables d’environnement

Les variables d’environnement permettent à votre application de récupérer dynamiquement les informations de connexion et les paramètres liés à l’environnement d’exécution. Sur Upsun Fixed, elles sont définies dans le fichier racine .environment, exécuté automatiquement à chaque démarrage du conteneur.

L’exemple ci-dessous permet de :

• définir une fonction utilitaire pour extraire les valeurs des relations Upsun,
• exporter les variables liées à MariaDB, Memcached et à la base URL de l’environnement,
• ajouter un PATH contenant les exécutables Composer (utile pour exécuter des commandes comme drush sans chemin absolu).

4. Hooks de déploiement

Les hooks Upsun sont des scripts exécutés à différentes étapes du cycle de déploiement. Ils permettent d’automatiser les tâches de build, de déploiement et de post-démarrage de votre application Drupal.

Pour plus de clarté et de maintenabilité, il est conseillé de séparer chaque hook dans un fichier distinct, puis de les inclure dans votre fichier .platform.app.yaml :

Le script build prépare l’environnement avant le déploiement effectif :

• Installation des dépendances PHP via Composer
• Copie du fichier de configuration settings.platformsh.php dans Drupal

Le script deploy s’exécute après le démarrage de l’application mais avant qu’elle n’accepte du trafic. C’est le moment idéal pour effectuer votre drush deploy.

Le script post_deploy est exécuté une fois le site en ligne. Il est idéal pour le nettoyage du cache Drupal et le purge du cache HTTP (Varnish, CDN…).

5. Tuning PHP

L’intégration de Drupal avec Upsun Fixed repose sur une configuration dynamique adaptée à chaque environnement. Il est recommandé d’isoler cette logique dans un fichier spécifique, par convention nommé settings.platformsh.php, puis inclus depuis votre settings.php principal.

Ce fichier contiendra toutes les configurations propres à Upsun Fixed, comme par exemple les paramètres essentiels liés à la sécurité, au cache et à la configuration d’environnement :

Le tuning PHP permet d’optimiser les performances de votre instance Drupal 11 sur Upsun Fixed et de renforcer la sécurité de l’environnement d’exécution. Ces paramètres se définissent dans le fichier .platform.app.yaml .

• Par défaut, la limite mémoire allouée aux processus PHP peut être insuffisante pour Drupal. Une valeur de 1024M est recommandée pour éviter les erreurs lors des opérations intensives (mises à jour, imports, Drush, etc.).
• Certaines fonctions PHP ne sont pas nécessaires au fonctionnement de Drupal et peuvent présenter des risques si elles sont exploitées depuis un module compromis. Il est recommandé de les désactiver.
• Upsun propose des valeurs OPcache par défaut conservatrices, peu adaptées à Drupal. Le tableau ci-dessous récapitule les ajustements recommandés :

Exemple complet de configuration :

6. Pour aller plus loin

Une fois votre application en place, vous pouvez aller plus loin en automatisant vos déploiements et en améliorant votre intégration continue avec Upsun.

Upsun permet de déployer automatiquement votre application lors d’un push sur la branche principale, de créer des environnements temporaires pour chaque nouvelle branche ou merge request, de supprimer automatiquement ceux qui n’ont plus de branche Git associée etc…

Vous pouvez également intégrer Upsun avec DDEV via un add-on afin de récupérer facilement la base de données et les fichiers de vos environnements distants.

Enfin, pour renforcer la sécurité, Upsun offre la possibilité de filtrer les adresses IP ou de protéger vos environnements par mot de passe directement depuis la console.