Résumé: 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.

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.
  2. Go to Websites & Domains, find the domain that will host your application, and then open the « Hosting & DNS » tab.
  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.

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.

This will open the domain log browser showing only the log entries from the Laravel log.

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.

Putting Your Application in Maintenance Mode

To prevent website visitors from seeing errors while you are working on or updating your application, you can put it in maintenance mode. While your application is in maintenance mode, website visitors will see a page showing a « 503 SERVICE UNAVAILABLE » error.

Putting your application in maintenance mode

  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. Click the Maintenance mode toggle button so that it shows « Enabled ».

Your Laravel application is now in maintenance mode.

Note: Do not forget to take your application out of maintenance mode once you have finished working on or updating it.

Mettre à jour votre application

Whether your Laravel application’s files are stored in a local or a remote Git repository, you need to make sure that the changes made to the application’s code are propagated to the Plesk server. You can choose between deploying the changes manually or automatically.

If you need precise control over when your application is updated, we recommend updating it manually. This way, no changes made to the application’s code in the repository are propagated to the Plesk server until you are ready to do so. The downside of this approach is that you must perform manual actions every time the application needs to be updated.

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. Go to the « Deployment » tab and, under « Deployment mode », select the « Manual » radio button.
  4. Under « Deployment scenario », clear the checkboxes corresponding to the steps you do not want to run during deployment, and then click Deploy.

Once Laravel Toolkit has run through all the deployment steps, your application and its dependencies will be updated.

If you want the changes made to the application’s code to be automatically propagated to the Plesk server, the method differs depending on whether the application’s code is stored in a local or a remote Git repository.

Updating your application automatically (local repository)

  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. Go to the « Deployment » tab and under « Deployment mode » select the « Automatic » radio button.
  4. Under « Deployment scenario », clear the checkboxes corresponding to the steps you do not want to run during deployment.

Now, every time a commit is pushed to the master branch of the local repository storing the application’s code, your application and its dependencies will be updated.

Updating your application automatically (remote repository)

  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. Copy the webhook URL you see here, and then add it to the remote repository. For specific instructions, see your repository provider’s documentation.
  4. Go to the « Deployment » tab and under « Deployment mode » select the « Automatic » radio button.
  5. Under « Deployment scenario », clear the checkboxes corresponding to the steps you do not want to run during deployment.

Now, every time the event triggering the webhook takes place in the remote repository storing the application’s code, your application and its dependencies will be updated.

Configuring a Deployment Script

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.

Enabling the ability to edit the deployment script in Plesk for 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.