Laravel Toolkit est une extension gratuite de Plesk que vous pouvez utiliser pour simplifier les tâches routinières liées à l’hébergement d’applications Laravel.

Résumé: Dans cette section, vous découvrirez comment téléverser, configurer et exécuter des applications Laravel dans Plesk. Attention, cette section s’adresse à vous si votre application est prête ou si vous planifiez sa création. Toutefois, il ne s’agit pas d’un guide pour créer des applications Laravel.

Prérequis

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

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.

laravel drawer

laravel domain card install

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.

Note: Pour créer un squelette Laravel ou l’installer depuis un dépôt Git distant, l’extension Git doit être installée sur le serveur Plesk.

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.

#. Go to Websites & Domains, find the domain that will host your application, and then open the « Hosting & DNS » tab.

  1. Cliquez sur Paramètres d’hébergement.
  2. 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.
  3. 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.

laravel domain card manage

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.

Note: Pour pouvoir exécuter les commandes Node.js, vous devez installer l’extension Node.js gratuite sur le serveur Plesk.

laravel run commands

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 laravel run button.

    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.

laravel view logs

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. 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.

Note: Vous ne pouvez ni ajouter, ni supprimer, ni modifier de tâches planifiées Laravel depuis l’interface Laravel Toolkit. Découvrez comment planifier des tâches depuis le code de l’application

laravel view scheduled tasks

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).

Note: Pour activer ou désactiver les tâches planifiées de votre application, vous devez d’abord réaliser une opération spécifique, selon que vous utilisez Plesk pour Linux ou Plesk pour Windows. Vous devrez le faire pour chaque domaine qui héberge une application Laravel pour laquelle vous voulez exécuter une tâche planifiée.

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 à jour votre application

Si votre application Laravel est hébergée dans un dépôt Git distant, vous devez vous assurer que les changements effectués dans le code de l’application dans le dépôt distant sont bien propagés sur le serveur Plesk. Vous pouvez déployer les modifications manuellement ou automatiser la mise à jour de l’application en mettant en place un webhook.

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 sur l’onglet « Déploiement » et cliquez sur Mettre à jour.

Les modifications appliquées au code de l’application dans le dépôt distant seront récupérées sur le serveur Plesk. Par ailleurs, les dépendances Composer seront installées.

Si vous voulez que les modifications de code de l’application sur le dépôt distant soient automatiquement propagées sur le serveur Plesk, définissez un webhook.

Paramétrer un webhook

  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. Dans l’onglet « Déploiement », copiez l’URL webhook que vous voyez et ajoutez-la au dépôt distant.

Désormais, à chaque commit du dépôt Git dans lequel se trouve le code de l’application, les modifications seront récupérées par le serveur Plesk. Par ailleurs, les dépendances Composer seront installées.

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.

Note: Dans Plesk pour Linux, vous devez activer l’accès SSH avant de pouvoir modifier le script de déploiement depuis l’interface Laravel. Vous ne devrez le faire qu’une seule fois.

Activer l’édition du 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.