Prérequis

Avant de pouvoir héberger des applications Laravel, vous devez installer l’extension gratuite Laravel Toolkit sur le serveur Plesk :

• Si vous êtes l’administrateur de Plesk, installez l’extension depuis le Catalogue des extensions.
• Si vous n’êtes pas administrateur, contactez votre hébergeur et demandez-lui d’installer l’extension pour vous.

Une fois que l’extension est installée, vous pouvez commencer. Vous verrez le bouton Laravel dans le tiroir à gauche de l’écran et le bouton Installer l’application Laravel sur toutes les cartes de vos domaines.

Téléverser votre application

Avant de configurer et d’exécuter votre application, vous devez la téléverser sur le serveur Plesk et l’enregistrer dans Laravel Toolkit. Pour cela, utilisez l’une des trois méthodes suivantes :

• Créer un squelette Laravel. Si votre application est stockée dans un dossier ou un fichier compressé sur votre ordinateur ou si vous voulez créer votre application de A à Z, Laravel Toolkit doit créer la structure du répertoire nécessaire ainsi qu’un dépôt Git.
• Installer depuis un dépôt Git distant. Si votre application est stockée dans un dépôt distant, vous pouvez la déployer sur le serveur Plesk.
• Rechercher une application existante. Si vous avez déjà téléversé votre application sur Plesk, vous pouvez l’enregistrer dans Laravel Toolkit en utilisant l’analyse.

Créer un squelette Laravel

1. Connectez-vous à Plesk.
2. Allez dans Sites Web & Domaines. Cherchez le domaine qui hébergera votre application et cliquez sur Installer l’application Laravel.
3. Sélectionnez « Installer le squelette » et cliquez sur Installer l’application.
4. Lorsque le squelette est installé, vous devez téléverser les fichiers de votre application sur Plesk (par exemple via FTP ou via le Gestionnaire de fichiers) et remplacer les fichiers par défaut si nécessaire.

Installer depuis un dépôt Git distant

1. Connectez-vous à Plesk.
2. Allez dans Sites Web & Domaines. Cherchez le domaine qui hébergera votre application et cliquez sur Installer l’application Laravel.
3. Sélectionnez « Installer depuis un dépôt distant ».
4. Saisissez ou copiez l’URL du dépôt distant contenant les fichiers de votre application.
5. Si le dépôt distant requiert une authentification, ajoutez-y la clé publique que vous voyez sur cette page.
6. Cliquez sur Installer l’application.

Analyser pour trouver une application existante

1. Connectez-vous à Plesk.
2. Allez dans Sites Web & Domaines. Cherchez le domaine sur lequel vous hébergerez votre application, puis ouvrez l’onglet « Hébergement et DNS ».
3. Cliquez sur Paramètres d’hébergement.
4. Modifiez la valeur dans « Racine du document » pour que celle-ci corresponde au répertoire public de votre application (par défaut /httpdocs/public) et cliquez sur OK.
5. Cliquez sur Installer l’application Laravel. Cliquez sur Annuler, puis sur Analyser.

Une fois que vous avez téléversé ou déployé les fichiers de votre application et que celle-ci est enregistrée dans Laravel Toolkit, le bouton Installer l’application Laravel est remplacé par le bouton Gérer l’application Laravel pour le domaine qui héberge votre application.

Vous pouvez désormais passer à l’étape suivante.

Exécuter les commandes Artisan, Composer et Node.js

Pour gérer votre application Laravel, vous devrez sans doute exécuter les commandes Artisan, Composer et/ou Node.js. Laravel Toolkit permet de les exécuter facilement depuis l’interface Plesk sans accès shell.

Si vous ne savez pas si votre application a besoin d’exécuter les commandes Artisan, Composer et/ou Node.js pour fonctionner correctement, consultez la personne ou l’entreprise qui vous a fourni l’application.

Exécuter une commande Artisan, Composer ou Node.js

1. Connectez-vous à Plesk.

2. Allez dans Sites Web & Domaines. Cherchez le domaine qui héberge votre application et cliquez sur Gérer l’application Laravel.

3. Allez sur l’onglet correspondant, saisissez la commande que vous voulez exécuter ou choisissez-en une dans la liste et appuyez sur la touche Entrée ou cliquez sur le bouton .

   Note: Lorsque vous exécutez des commandes Node.js, vous devrez peut-être spécifier la version de Node.js et/ou le gestionnaire de pack pour que la commande ait l’effet voulu. Si vous ne savez pas si vous devez spécifier la version, consultez la personne ou l’entreprise qui vous a fourni l’application.

Voir les fichiers journaux de votre application

Pendant que Laravel fonctionne, les entrées sont consignées dans un fichier journal distinct. Vous pouvez voir le contenu de ce fichier depuis l’interface Laravel Toolkit afin de surveiller votre application et de résoudre plus facilement les problèmes lorsqu’il y en a.

Voir le journal de votre application

1. Connectez-vous à Plesk.
2. Allez dans Sites Web & Domaines. Cherchez le domaine qui héberge votre application et cliquez sur Gérer l’application Laravel.
3. Cliquez sur Journaux.

Cela ouvrira l”Explorateur de journaux du domaine. Seules les entrées du journal Laravel sont affichées.

Voir les tâches planifiées de votre application

Avec Laravel, vous pouvez planifier des tâches dans le code de l’application au lieu d’utiliser un planificateur externe comme cron. Laravel Toolkit vous permet de voir toutes les tâches configurées actuellement directement depuis l’interface de Laravel. Vous pouvez également activer et désactiver les tâches planifiées de Laravel.

Voir les tâches planifiées de votre application

1. Connectez-vous à Plesk.
2. Allez dans Sites Web & Domaines. Cherchez le domaine qui héberge votre application et cliquez sur Gérer l’application Laravel.
3. Allez dans l’onglet « Tâches planifiées » (cet onglet est visible uniquement lorsqu’une ou plusieurs tâches planifiées sont configurées).

Activer la gestion des tâches planifiées dans Plesk pour Linux

1. Connectez-vous à Plesk.
2. Allez dans Sites Web & Domaines et trouvez le domaine qui héberge votre application. Ensuite, allez sur l’onglet « Hébergement et DNS » et cliquez sur Accès à l’hébergement Web.
3. Dans « Accéder au serveur via SSH », sélectionnez une option différente de « Interdit » et cliquez sur OK.

Activer la gestion des tâches planifiées dans Plesk pour Windows

1. Connectez-vous à Plesk.
2. Allez dans Sites Web & Domaines et cherchez le domaine qui héberge votre application.
3. Dans « Compte », cliquez sur Personnaliser.
4. Allez sur l’onglet « Droits ». Cochez la case à côté de « Gestion du planificateur » et cliquez sur Mettre à jour & Verrouiller.

Vous pouvez désormais activer ou désactiver les tâches planifiées de votre application.

Activer les tâches planifiées de votre application

1. Connectez-vous à Plesk.
2. Allez dans Sites Web & Domaines. Cherchez le domaine qui héberge votre application et cliquez sur Gérer l’application Laravel.
3. Faites glissez le bouton Tâches planifiées pour qu’il indique « Activé ».

Les tâches planifiées sont désormais activées pour votre application Laravel.

Modifier les variables d’environnement

Votre application peut avoir besoin d’une ou plusieurs variables d’environnement pour fonctionner correctement ou encore fonctionner différemment selon les variables définies. Si vous ne savez pas quelles sont les variables d’environnement requises pour que votre application fonctionne correctement, consultez la personne ou l’entreprise qui vous a fourni l’application.

Modifier les variables d’environnement

1. Connectez-vous à Plesk.
2. Allez dans Sites Web & Domaines. Cherchez le domaine qui héberge votre application et cliquez sur Gérer l’application Laravel.
3. Cliquez sur le bouton Modifier à côté de « Variables d’environnement (.env) ».
4. Modifiez les variables d’environnement si nécessaire et cliquez sur Mettre à jour.

Les variables d’environnement mises à jour sont désormais en vigueur.

Mettre votre application en mode Maintenance

Pour éviter aux visiteurs de votre site web de voir des erreurs lorsque vous travaillez sur votre application ou lorsque vous la mettez à jour, vous pouvez utiliser le mode Maintenance. Quand votre application est en mode Maintenance, les visiteurs de votre site web voient une page avec l’erreur « 503 SERVICE NON DISPONIBLE ».

Mettre votre application en mode maintenance

1. Connectez-vous à Plesk.
2. Allez dans Sites Web & Domaines. Cherchez le domaine qui héberge votre application et cliquez sur Gérer l’application Laravel.
3. Cliquez sur le bouton Mode Maintenance pour le passer sur « Activé ».

Votre application Laravel est désormais en mode Maintenance.

Mettre à jour votre application

Vous devez vous assurer de propager les modifications du code de l’application sur le serveur Plesk, que les fichiers de votre application Laravel soient stockés dans un dépôt Git local ou distant. Vous pouvez déployer les modifications manuellement ou automatiquement.

Si vous avez besoin de contrôler précisément le moment de la mise à jour de votre application, nous vous recommandons d’opter pour la mise à jour manuelle. Ainsi, les modifications effectuées dans le code de l’application dans le dépôt sont propagées sur le serveur Plesk lorsque vous le décidez. L’inconvénient de cette approche est que vous devez effectuer des opérations manuelles à chaque fois que l’application nécessite une mise à jour.

Mettre à jour manuellement votre application

1. Connectez-vous à Plesk.
2. Allez dans Sites Web & Domaines. Cherchez le domaine qui héberge votre application et cliquez sur Gérer l’application Laravel.
3. Allez dans l’onglet « Déploiement ». Dans « Mode de déploiement », sélectionnez le bouton radio « Manuel ».
4. Dans « Scénario de déploiement », décochez les cases qui correspondent aux étapes que vous ne voulez pas exécuter pendant le déploiement et cliquez sur Déployer.

Une fois que Laravel Toolkit a exécuté toutes les étapes du déploiement, votre application et ses dépendances seront à jour.

Si vous voulez propager automatiquement sur le serveur Plesk les modifications apportées au code de l’application, la méthode diffère selon si le code de l’application est stocké dans un répertoire Git local ou distant.

Mettre à jour automatiquement votre application (dépôt local)

1. Connectez-vous à Plesk.
2. Allez dans Sites Web & Domaines. Cherchez le domaine qui héberge votre application et cliquez sur Gérer l’application Laravel.
3. Allez dans l’onglet « Déploiement ». Sous « Mode de déploiement », sélectionnez le bouton radio « Automatique ».
4. Sous « Scénario de déploiement », décochez les cases qui correspondent aux étapes que vous ne voulez pas exécuter pendant le déploiement.

À présent, à chaque fois qu’un commit est poussé vers la branche master du dépôt local qui stocke le code de votre application, celle-ci et ses dépendances seront mises à jour.

Mettre à jour automatiquement votre application (dépôt distant)

1. Connectez-vous à Plesk.
2. Allez dans Sites Web & Domaines. Cherchez le domaine qui héberge votre application et cliquez sur Gérer l’application Laravel.
3. Copiez l’URL webhook que vous voyez ici et ajoutez-la au dépôt distant. Pour en savoir plus, consultez la documentation du fournisseur de votre dépôt.
4. Allez dans l’onglet « Déploiement ». Sous « Mode de déploiement », sélectionnez le bouton radio « Automatique ».
5. Sous « Scénario de déploiement », décochez les cases qui correspondent aux étapes que vous ne voulez pas exécuter pendant le déploiement.

À présent, à chaque fois que l’événement qui déclenche votre webhook se produit dans le dépôt distant qui stocke le code de l’application, celle-ci et ses dépendances seront mises à jour.

Configurer un script de déploiement

Pour que votre application fonctionne correctement, vous devez exécuter certaines commandes sur le serveur pendant le déploiement. Vous pouvez développer un script pour éviter d’exécuter manuellement ces commandes. Ce script sera exécuté à chaque mise à jour de l’application.

Si vous ne savez pas si votre application a besoin d’exécuter des commandes lors du déploiement pour fonctionner correctement, consultez la personne ou l’entreprise qui vous a fourni l’application.

Activer la possibilité de modifier le script de déploiement dans Plesk pour Linux

1. Connectez-vous à Plesk.
2. Allez dans Sites Web & Domaines et trouvez le domaine qui héberge votre application. Ensuite, allez sur l’onglet « Hébergement et DNS » et cliquez sur Accès à l’hébergement Web.
3. Dans « Accéder au serveur via SSH », sélectionnez une option différente de « Interdit » et cliquez sur OK.

Vous pouvez désormais modifier le script de déploiement depuis l’interface Laravel Toolkit.

Modifier le script de déploiement

1. Connectez-vous à Plesk.
2. Allez dans Sites Web & Domaines. Cherchez le domaine qui héberge votre application et cliquez sur Gérer l’application Laravel.
3. Allez dans l’onglet « Déploiement » et cliquez sur Modifier le script.
4. Saisissez ou collez votre script de déploiement et cliquez sur Mettre à jour.

Le script de déploiement est désormais effectif et sera exécuté à chaque mise à jour de votre application.