Installer le CMS Contao sur OVH

Pour suivre les étapes de ce tutoriel, nous utiliserons une offre OVH « perso2014 » avec un accès SSH (que nous allons configurer ensemble), ainsi que la version 4.13 de Contao et la version 7.4 de PHP.

Il est important de noter que certaines instructions peuvent avoir évoluées depuis la rédaction de ce guide, il est donc important de vérifier la documentation OVH et Contao pour s'assurer que les étapes décrites sont toujours valides.

Préparer OVH

Avant de commencer la configuration de votre site web Contao sur OVH, il est important de préparer votre hébergement en effectuant quelques étapes préliminaires. Ces étapes incluent la création d'une base de données et la modification du dossier racine.

Pour débuter, connectez-vous à votre espace client OVH, accédez à l'onglet « Hébergements » et sélectionnez l'hébergement qui accueillera votre site web Contao.

Dans l'onglet « Informations général », vérifiez que la version de PHP est compatible avec la version de Contao que vous avez choisie. Si ce n'est pas le cas, vous devrez peut-être mettre à jour votre version de PHP pour garantir un fonctionnement optimal de votre site web.

Créer une base de donnée

Pour configurer correctement votre site web Contao, il est nécessaire de créer une base de données. Pour ce faire, accédez à l'onglet « Bases de données » et cliquez sur l'option « Créer une base de données ». Il est important de noter que Contao n'a pas besoin de beaucoup d'espace de stockage, vous pouvez donc créer une base de données avec une capacité réduite.

Modifier le dossier racine

Contao utilise un dossier nommé "Public" dans son système de fichiers. Pour configurer correctement votre hébergement OVH, il est important de définir le dossier racine approprié.

Pour ce faire, accédez à l'onglet « Multisite », localisez la ligne correspondant à votre nom de domaine. Cliquez sur l'icône des actions et sélectionnez l'option « Modifier le domaine ».
Dans le formulaire de modification, remplacez la valeur du champ « Dossier racine » par « www/public » et n'oubliez pas de sauvegarder les changements.
Note : il se peut que le temps d’application des changements prennent quelques minutes.

Un dossier racine est le répertoire principal d'un hébergement web. Il contient tous les fichiers et dossiers nécessaires pour faire fonctionner un site web, tels que les fichiers HTML, CSS, JavaScript, images, etc.

Le fichier index.html ou index.php, qui est la page d'accueil d'un site web, se trouve généralement dans le dossier racine. Lorsque quelqu'un tape l'URL d'un site web dans son navigateur, il est redirigé vers le fichier index dans le dossier racine.

Installation avec Contao-manager

L'utilisation de contao-manager pour installer Contao ne fonctionnera pas sur ce type d'hébergement OVH. En effet, ce système nécessite l'accès au fichier binaire de PHP, ce qui n'est pas possible sur OVH à l'heure actuelle.

Au lieu de cela, nous devrons utiliser des lignes de commandes pour installer et configurer Contao sur notre hébergement OVH. Cela peut sembler un peu plus complexe, mais c'est un moyen efficace de configurer correctement votre site web sur cet hébergeur. Il est important de se munir d'une documentation fiable et de bien comprendre les commandes utilisées pour ne pas se perdre.

Installation en ligne de commande (avec SSH)

Pour pouvoir utiliser les lignes de commandes pour installer et configurer Contao sur votre hébergement OVH, il est nécessaire d'activer l'accès SSH sur votre compte. Pour ce faire, vous pouvez suivre les instructions détaillées dans la documentation OVH.

Une fois l'accès SSH activé, vous pourrez vous connecter à votre hébergement en utilisant des lignes de commandes directement depuis un terminal ou en utilisant un logiciel tel que PuTTY, selon vos préférences. Il est important de noter que l'utilisation de l'outil PuTTY nécessite de disposer de certaines connaissances pour l'utiliser de manière efficace.

Créer un utilisateur SSH sur OVH

Pour accéder à votre hébergement OVH via SSH, il est nécessaire de créer un utilisateur avec des droits spécifiques. Pour ce faire, accédez à l'onglet « FTP - SSH » de votre hébergement OVH, et cliquez sur le bouton « Créer un utilisateur ».
Dans le formulaire de création, saisissez un nom d'utilisateur, choisissez un mot de passe sécurisé et enregistrez.

Le nouvel utilisateur sera ajouté à la liste des utilisateurs de l'onglet, cependant, il n'aura aucun droit spécifique pour l'instant. Il est donc nécessaire de modifier le profil de l'utilisateur en cliquant sur l'icône des actions en bout de ligne, et en sélectionnant l'option « Modifier ».
Dans le formulaire de modification, sélectionnez l'option « SSH » puis enregistrez. Si OVH retourne une erreur lors de la modification du profil, actualisez la page et recommencez la modification.

Une fois que les droits SSH ont été activés pour votre utilisateur, un lien apparaîtra dans la colonne correspondante pour vous permettre de vous connecter via SSH. Il est important de noter que cette étape est cruciale pour pouvoir utiliser les commandes de lignes de commandes pour installer et configurer correctement Contao sur votre hébergement OVH.

Connexion en SSH à OVH

Nous pouvons maintenant nous connecter à SSH. Il est possible que l'utilisation de PuTTY ne fonctionne pas et que OVH déconnecte la connexion. Nous allons donc utiliser un terminal pour nous connecter.

Ouvrez le terminal de votre choix et exécutez la commande de connexion fournie par OVH dans sa documentation correspondante.
La commande à utiliser est : « ssh votrelogin@ssh.cluster000.hosting.ovh.net -p 22 » (où "votrelogin" est le nom d'utilisateur que vous avez créé).
Note : cette documentation peut avoir été mise à jour depuis la rédaction de ce tutoriel.

La première fois que vous lancez cette commande, le système vous demandera de confirmer si vous êtes sûr de vouloir continuer, répondez « yes ».

Si la connexion a été fermée après votre réponse, relancez la commande. OVH vous demandera alors de saisir le mot de passe de votre compte SSH, qui est celui que vous avez créé précédemment.
Note 1 : la plupart des terminaux masquent les mots de passe lors de la saisie, il peut donc sembler que vous ne saisissiez rien.
Note 2 : Si vous restez trop longtemps inactif, vous serez déconnecté.

Installer composer

Par défaut, Composer n'est pas installé sur les hébergements OVH. Heureusement, grâce à notre connexion SSH, nous pouvons facilement l'ajouter.
Pour des instructions détaillées sur l'installation de Composer sur un hébergement OVH, vous pouvez consulter la documentation OVH.

Si, comme moi, vous n'avez pas besoin de modifier la version de PHP, vous pouvez vous connecter en SSH et saisir la commande suivante : « curl -sS https://getcomposer.org/installer | php ».
Note : cette documentation peut avoir été mise à jour depuis la rédaction de ce tutoriel. Il est donc important de vérifier la documentation OVH pour s'assurer que la commande donnée est toujours valide.

Installer Contao

Maintenant que nous sommes connectés à notre compte OVH via SSH, nous pouvons installer Contao. Pour des instructions détaillées sur l'installation de Contao, vous pouvez consulter la documentation officielle de Contao.

A l'heure où ces signes sont écrites, la commande d'installation est la suivante : « php composer.phar create-project contao/managed-edition example 4.11 ». Vous devez ajuster cette commande en fonction de vos besoins. Premièrement, remplacez « example » par « www » pour indiquer où vous voulez installer Contao. Deuxièmement, remplacez « 4.11 » par la version de Contao que vous souhaitez installer.
Par exemple, si vous voulez installer la version 4.13 de Contao, la commande sera « php composer.phar create-project contao/managed-edition test 4.13 ».
Exécutez la commande, l'installation devrait prendre environ une minute.

Note : cette documentation peut avoir été mise à jour depuis la rédaction de ce tutoriel. Il est donc important de vérifier la documentation officielle de Contao pour s'assurer que la commande donnée est toujours valide.

Connexion à la base de donnée

Nous accédons à l'outil d'installation de Contao (/contao/install), dans le panneau de configuration de la base de données, nous renseignons les informations de connexion. Il est nécessaire de récupérer les informations de connexion de votre base de données depuis l'onglet « Bases de données » de votre compte « Hébergements » OVH. Ces informations incluent l'adresse du serveur, le port, le nom d'utilisateur et le mot de passe.

Lors de la configuration, remplacez « localhost » par l'adresse du serveur indiquée dans votre compte OVH. Cela permettra à Contao de se connecter correctement à la base de données pour stocker et récupérer les données de votre site web. Il est important de vérifier que vous avez correctement saisi toutes les informations nécessaires pour éviter tout problème de connexion à la base de données.

Migration de Contao sur OVH

Lorsque vous effectuez une migration vers un hébergement OVH, il est important de suivre les instructions fournies dans la documentation officielle de Contao. Cela vous permettra de transférer de manière efficace et sécurisée les fichiers et dossiers de votre ancien hébergement vers le nouveau.

Dans mon cas, j'ai déplacé les fichiers et dossiers indiqués dans la procédure via FTP vers le dossier « www » de mon hébergement OVH.
Une fois que les fichiers ont été migrés, il suffit de se connecter en SSH, d'accéder au dossier « www » en utilisant la commande « cd www », puis d'utiliser la commande « php ../composer.phar install » pour installer les fichiers nécessaires.
Il est important de ne pas oublier d'importer la base de données depuis l'ancien hébergement vers la nouvelle base de données OVH pour que toutes les données restent accessibles sur le nouveau site.

Si l'adresse du site est différente, et que la procédure est terminée, accédez au backoffice de Contao et modifiez la racine du site.