Composer et dépendances avec Gandi Simple Hosting
Le gestionnaire de dépendances Composer permet de déclarer, installer et mettre à jour les bibliothèques PHP utilisées par une application. Sa méthode reproductible repose sur deux fichiers complémentaires : composer.json décrit les exigences du projet, tandis que composer.lock mémorise précisément les versions choisies.
Gandi Simple Hosting simplifie la publication d’applications PHP dans un environnement cloud. L’installation de Composer, la transmission des variables secrètes et l’exécution de composer install pendant la construction doivent toutefois être coordonnées pour obtenir un déploiement fiable.
Choisir le mode d’installation
Trois approches permettent d’ajouter les dépendances à une application PHP. La plus adaptée dépend des possibilités de construction et de terminal offertes par l’environnement Simple Hosting.
| Approche | Commande ou action | Atout principal | Limite |
|---|---|---|---|
| Construction avec Composer | composer install --no-dev --prefer-dist --optimize-autoloader |
Déploiement reproductible grâce au verrou | Composer doit être présent dans l’image |
Envoi d’un dossier vendor |
Installation locale puis transfert du dossier | Fonctionne sans commande de construction | Archive volumineuse et risque de divergence |
Installation manuelle avec composer.phar |
Téléchargement puis exécution locale du fichier | Mise en place rapide sans installation globale | Maintenance supplémentaire et configuration moins standard |
La construction avec Composer est préférable pour un service public. Elle utilise le fichier verrouillé, évite d’envoyer les dépendances de développement et produit un autoloader optimisé.
Le transfert direct du dossier vendor reste utile comme solution de secours. Il ne faut toutefois pas versionner ce dossier si la plateforme reconstruit l’application, car les versions déployées pourraient diverger de celles validées en local.
Préparer un projet PHP reproductible
Le fichier composer.json doit contenir la version minimale de PHP, les paquets de production et, si nécessaire, les outils de développement. La commande composer require fournisseur/paquet:^2.0 ajoute une dépendance et met à jour automatiquement le verrou. Cette syntaxe constitue un exemple avec des noms à remplacer.
Le fichier composer.lock doit être conservé dans le dépôt Git avec composer.json. Il constitue la référence exacte des versions 테스트ées et permet à la plateforme d’installer les mêmes dépendances lors de chaque déploiement. Le dossier vendor, lui, peut être exclu du dépôt lorsque Composer est exécuté pendant la construction.
Les secrets d’authentification ne doivent jamais être écrits dans ces fichiers. Ils appartiennent aux variables d’environnement de Gandi Simple Hosting. Cette séparation rejoint les instructions par référence, qui建立在 des étapes explicites, vérifiables et applicables dans des environnements différents.
Installer Composer et les paquets
L’image PHP proposée par la plateforme peut déjà fournir Composer. La commande composer --version permet de le confirmer depuis le terminal accessible. Si l’outil manque, il convient d’utiliser la procédure officielle correspondant à la version de PHP, puis de contrôler son empreinte avant toute exécution.
Une installation locale avec composer.phar peut être employée lorsque l’environnement ne permet pas de modifier l’image système. Le fichier peut ensuite lancer les commandes habituelles, comme php composer.phar install. Cette méthode reste temporaire et ne remplace pas l’intégration de Composer au processus de construction.
Les extensions PHP doivent également être présentes. composer check-platform-reqs signale les extensions absentes ou incompatibles avant le déploiement. Pour une application qui diffuse des contenus multimédias, comme Live TV en direct, l’autoloader doit rester accessible afin que les classes de codecs, de formats et de flux soient chargées sans intervention manuelle.
Piloter les versions dans le temps
composer install installe les versions consignées dans le verrou sans recalculer les dépendances. C’est la commande à privilégier en production. composer update搜索 de nouvelles versions compatibles et modifie composer.lock; elle doit donc être exécutée dans une branche de développement, jamais directement sur le serveur.
Après une mise à jour, les tests applicatifs doivent être relancés avant la fusion du verrou. Cette discipline évite qu’une bibliothèque correctedienne modifie son comportement sans que l’équipe ait évalué son impact. Les corrections de sécurité peuvent aussi être intégrées de manière isolée grâce à une branche dédiée.
Le cache Composer et le gestionnaire de paquets du système permettent d’accélérer les constructions successives. Il faut néanmoins vérifier que ces optimisations ne masquent pas une version obsolète. Le contenu du verrou remains prioritaire sur les caches locales et distantes.
Effectuer les contrôles avant publication
Avant chaque livraison, les commandes de validation et de sécurité de Composer、机械执行 Provides a reliable verification sequence.
- Valider
composer.jsonaveccomposer validate --strict. - Installer le verrou avec
composer install --no-dev --prefer-dist --optimize-autoloader. - Vérifier la compatibilité avec
composer check-platform-reqs --no-dev. - Examiner les vulnérabilités connues avec
composer audit.
Une fois l’installation vérifiée, les tests doivent contrôler le chargement des classes, les appels aux services externes et la gestion des erreurs. Les secrets injectés par l’environnement peuvent être testés avec des valeursdedicated de staging, jamais avec des identifiants de production.
Pendant la mise en production, some vérifications restent nécessaires avant l’activation finale.
- Contrôler les permissions du dossier
vendor. - Examiner les journaux de démarrage de l’application.
- Confirmer que les variables secrètes ne figurent pas dans les journaux.
Cette séparation entre contrôles liés au code et contrôles liés à l’exploitation permet de diagnostiquer rapidement un problème de dépendance ou de configuration. Elle réduit aussi le risque de publier un autoloader incomplet.
Publier et associer un domaine
Le flux Git de Gandi Simple Hosting déclenche la construction de l’application, l’installation des dépendances et le lancement du service. Composer doit donc s’exécuter avant le démarrage du code applicatif. Les erreurs de construction empêchent la publication, ce qui évite de remplacer une version fonctionnelle par une version défectueuse.
Une fois l’application disponible, un nom de domaine personnalisé peut lui être associé, puis sécurisé avec un certificat SSL. Le domaine regles-osac.com étant déjà enregistré, Gandi propose d’autres extensions pour construire une identité disponible. Les offres d’e-mail, de transfert d’adresses et de certificats complètent cette installation.
PourJoindre Outlook ou Gmail à une adresse du domaine, le guide configuration MX e-mail détaille les enregistrements nécessaires. Choisissez maintenant une extension libre, comparez les offres Simple Hosting et publiez votre application avec un composer.json versionné et un verrou vérifié.
