Koumbit.org

Pour un internet libre et solidaire

Utilisation de composer avec l'hébergement auto-géré (HAG)

Composer est maintenant largement utilisé pour gérer les dépendances dans les projets PHP. Plusieurs projets obligent même l'utilisation. Ici on verra comment utiliser composer pour télécharger Drupal, ces dépendances et cibler la version de PHP pour une plateforme spécifique.

Dans cette example on utilisera Drupal 8 mais ce processus peut être modifier pour marcher avec d'autres systèmes de gestion de contenu (CMS). On incluera également des commandes git, mais vous pouvez les ignorer si vous ne l'utilise pas. Ces instructions sont adaptés à la ligne de commande dans une environnement linux donc ça se peut que vous devez les adapter à votre situation. On présume également que vous avez déjà installé PHP et composer.

Prérequis:

Création d'un nouveau projet

La première étape et de créer un nouveau dossier et d'initializer un projet composer. On utilise l'outil hussainweb/drupal-composer-init ici, mais il y existe d'autres moyens de débuter des projets Drupal avec composer.

composer global require hussainweb/drupal-composer-init
mkdir mysite && cd mysite
composer drupal-initadmin
# Répondre aux questions dans une manière intéractive:
# Package name: koumbit/monsite
# Author: Nom <courriel>
# Minimum stability: dev
# License: GPLv2.0+
# Public web directory: web
# Drupal core or distribution: drupal/core
# Version for drupal/core: ^8.4
# Define dependencies: no
# Define dev dependencies: no
# Confirm generation: yes
git init . && echo 'vendor/' >> .gitignore && git add . && git commit -m "Initial commit" # Seulement si vous utilisez git.

Modifier composer.json pour cibler la plateforme HAG

Les nodes web de HAG roule présentement PHP 5.6. On veut specifier ce détail dans le fichier composer.json pour que l'application puisse bien résoudre tout les dépendences et ne choisisse pas des libraries qui pourraient planter. On travail présentement sur l'implementation des nodes web en PHP 7.0 - on vous donnera des nouvelles dès qu'ils sont disponible.

Pour entrer l'information de la version PHP, on le mets dans la section config['platform'] de composer.json. Il va avoir l'air un peu comme la suite:

"config": {
  "platform": {
    "php": "5.6"
  }
}

Une fois que cette changement est faite, on veut assurer que les dependences sont re-installer.

composer update --with-dependencies
git add . ; git commit -m "Changed PHP requirement to match HAG environment" # Encore, seulement si vous utlisez git

Autres changements & téléversement

On peut utiliser composer pour télécharger les modules Drupal - eg. composer require drupal/search_api pour télécharger le module search_api. Avec le template du projet qu'on a utilisé ici les modules sont placés dans web/modules/contrib. Vous pouvez placer vos modules custm dans web/modules/custom ou dans le dossier des modules pour un site spécifique si vous utilisez la fonctionallité multi-site.

Du au fait que les fichiers peut être téléverser seulement par FTP ou à partir de votre navigateur vers l'Hébergement Auto-Géré, on crée un fichier comprimé pour éviter de télécharger les ~20,000 fichiers (~200Mo) que Drupal 8 pèse.

tar czf site.tar.gz web/ vendor/

Note: Il est important d'utiliser .tar.gz au lieu de .tgz pour que la routine dans l'interface web d'AlternC peut bien le décomprimé.

Télécharger site.tar.gz vers le dossier de votre site et le décomprimer dans l'interface web à https://bureau.koumbit.net

À propos de Koumbit

Koumbit est une organisation à but non-lucratif auto-géré dans une manière horizontale qui offre des serivces d'hébergement auto-géré, l'hébergement Drupal mutualisé avec des mises à jours de sécurité automatiques, des services de consultation web et plus. Si vous avez des questions ou commentaires, hésitez pas à nous contacter.

Si vous êtes membre d'une organisation qui promouves la justice social et vous avez besoin d'éspace web, on a une programme d'hébergement solidaire à travers laquelle vous pourriez avoir accès à certaines de nos services sans frais.

Permanence téléphonique

☏ +1 514 907 9494
Lun: 10h à 12h
Mar/Mer: 10h à 12h et 13h à 16h
Jeu: 10h à 12h
Mon: 10AM to 12PM
Tue/Wed: 10AM to 12PM et 13AM to 16PM
Thu: 10AM to 12PM

Venez nous voir!

1883, rue Amherst, Montréal (Québec) H2L 3L7, Canada
Veuillez noter que nos bureaux n'ont pas de stationnement attitré.
1883 Amherst Street, Montreal, Quebec, H2L 3L7, Canada
Please note that you'll need to find on-street parking.

Écrivez-nous

Informations générales

Support technique

Pour une demande de devis, voir le formulaire à la page contact.

General inquiries

Technical support

For a free estimate, see the form on our contact page.

Suivez-nous

ktweb_menu_social