FR

Hébergement web

Héberger un site Laravel sur Plesk

Mettez en ligne une application Laravel sur Plesk, avec ou sans Laravel Toolkit : version de PHP, base de données, fichier .env, migrations, tâches planifiées et erreurs courantes.

10 min de lecture, mis à jour le 18 novembre 2026

Sur cette page

Vos valeurs

Renseignez-les une fois, les commandes du guide se mettent à jour.

Ce guide explique comment publier une application Laravel sur votre hébergement Plesk. Deux méthodes sont décrites : avec Laravel Toolkit, l'outil de Plesk dédié à Laravel, ou manuellement si cet outil n'est pas disponible.

Prérequis

  • Un accès à votre panneau Plesk (voir Connexion à l'interface Plesk).
  • Un domaine rattaché à votre hébergement et pointant vers celui-ci.
  • Une version de PHP compatible avec votre application. Laravel 13 exige PHP 8.3 ou supérieur. Pour une autre version de Laravel, consultez la ligne php de votre fichier composer.json.
  • Les extensions PHP requises par Laravel : Ctype, cURL, DOM, Fileinfo, Filter, Hash, Mbstring, OpenSSL, PCRE, PDO, Session, Tokenizer et XML, ainsi que pdo_mysql pour MySQL ou MariaDB.
  • Votre projet, dans un dépôt Git ou sur votre ordinateur.

Ce guide utilise httpdocs, le dossier habituel du domaine principal. Pour un domaine supplémentaire, le dossier peut être différent : reportez-vous à la Racine du document dans Hébergement et DNS > Hébergement.

Un point essentiel : le dossier public

Seul le dossier public de Laravel doit être accessible depuis le web. Le reste du projet contient notamment le fichier .env, avec vos mots de passe et votre clé de chiffrement. Ne déplacez jamais index.php à la racine du projet : la racine du document du domaine doit pointer vers public.

Avec un projet placé dans httpdocs, la valeur à utiliser est /httpdocs/public.

Étape 1 : choisir la version de PHP

  1. Allez dans Sites Web & Domaines et repérez votre domaine.
  2. Ouvrez PHP (ou Paramètres PHP, selon votre version de Plesk).
  3. Sélectionnez une version compatible, puis enregistrez.

Étape 2 : créer la base de données

Créez une base et un utilisateur dédié en suivant le guide Création d'une base de données. Notez le nom de la base, l'utilisateur, le mot de passe et l'hôte indiqué par Plesk dans les informations de connexion de la base.

Méthode 1 : avec Laravel Toolkit

Installer l'application

Dans Sites Web & Domaines, sur votre domaine, cliquez sur Créer un site web > Laravel, puis choisissez :

  • Installer depuis un dépôt distant : saisissez l'URL de votre dépôt. S'il est privé, ajoutez la clé publique affichée par Plesk à votre dépôt (la démarche est détaillée dans Déployer depuis GitHub ou GitLab). Cliquez ensuite sur Installer l'application.
  • Installer le squelette : Plesk installe une application Laravel vierge. Cliquez sur Installer l'application, puis remplacez les fichiers par les vôtres en FTP ou avec le gestionnaire de fichiers si vous avez déjà un projet.

Si votre application est déjà présente sur l'hébergement :

  1. Dans Hébergement et DNS > Hébergement, réglez Racine du document sur /httpdocs/public, puis cliquez sur Enregistrer.
  2. Revenez à l'onglet Tableau de bord, cliquez sur Créer un site web > Laravel, puis sur Annuler.
  3. Cliquez sur Analyser pour que Plesk détecte l'application.

Configurer le fichier .env

Ouvrez Laravel depuis votre domaine. Dans Variables d'environnement (.env), cliquez sur Modifier, adaptez les valeurs suivantes, puis cliquez sur Mettre à jour :

Configuration
APP_NAME="Mon application"
APP_ENV=production
APP_DEBUG=false
APP_URL=https://votre-domaine.com

DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=nom_de_la_base
DB_USERNAME=utilisateur_de_la_base
DB_PASSWORD=mot_de_passe_de_la_base

Lancer les commandes Artisan

Dans l'onglet Artisan, saisissez chaque commande sans le préfixe php artisan, puis exécutez-la :

Texte
key:generate --force
migrate --force
storage:link
optimize
  • key:generate --force crée la clé APP_KEY. Lancez-la uniquement si cette valeur est vide : changer la clé d'un site en service rend illisibles les données chiffrées et déconnecte les utilisateurs.
  • migrate --force crée les tables. Par défaut, Laravel y stocke aussi les sessions, le cache et les files d'attente.
  • storage:link rend accessibles les fichiers du disque public.
  • optimize met en cache la configuration, les routes, les événements et les vues.

Déployer les mises à jour

Dans l'onglet Déploiement :

  1. Choisissez le Mode de déploiement : Manuel ou Automatique.
  2. Dans Scénario de déploiement, décochez les étapes inutiles.
  3. Cliquez sur Déployer.

Le bouton Modifier le script permet de personnaliser le déploiement, à condition que l'accès SSH soit autorisé pour le domaine.

Activer les tâches planifiées

Les tâches se définissent dans le code de l'application, généralement dans routes/console.php. Elles ne peuvent pas être créées depuis Plesk. Lorsqu'au moins une tâche existe, l'onglet Tâches planifiées apparaît : réglez son interrupteur sur Activé.

Activer les files d'attente

Le fonctionnement des files d'attente dans Laravel Toolkit repose sur la base de données et sur les tâches planifiées, qui doivent donc être actives.

  1. Ajoutez le paquet d'intégration de Plesk à la section require de composer.json, en vérifiant sa compatibilité avec votre version de Laravel :

    JSON
    "plesk/ext-laravel-integration": "^7.0"
  2. Déployez, puis commitez le fichier composer.lock mis à jour et déployez à nouveau.

  3. Vérifiez la présence de QUEUE_CONNECTION=database dans le fichier .env.

  4. Activez le Mode Maintenance.

  5. Dans Artisan, lancez migrate --force. Si votre projet ne contient pas de migration pour la table jobs, lancez d'abord queue:table.

  6. Désactivez le Mode Maintenance, puis réglez l'interrupteur File d'attente sur Activé.

Méthode 2 : sans Laravel Toolkit

Préparer le projet sur votre ordinateur

Depuis le dossier du projet, installez les dépendances de production et compilez les fichiers front-end :

Terminal
composer install --no-dev --optimize-autoloader
npm ci
npm run build
php artisan key:generate --show

Conservez la clé affichée par la dernière commande : elle commence par base64:. Si votre site est déjà en service, réutilisez plutôt sa clé actuelle.

Envoyer les fichiers

  1. Créez une archive .zip du projet, avec les dossiers vendor et public/build, mais sans node_modules ni votre fichier .env local.

  2. Dans Fichiers, ouvrez httpdocs, téléversez l'archive, cochez-la, cliquez sur Extraire les fichiers, puis supprimez-la.

  3. Créez dans httpdocs un fichier .env reprenant l'exemple de la méthode 1, et ajoutez-y votre clé :

    Configuration
    APP_KEY=base64:VOTRE_CLE_GENEREE

Vous pouvez aussi utiliser un compte FTP pour envoyer les fichiers.

Définir la racine du document

  1. Dans Sites Web & Domaines, ouvrez Hébergement et DNS > Hébergement pour votre domaine.
  2. Réglez Racine du document sur /httpdocs/public.
  3. Cliquez sur Enregistrer.

Exécuter les commandes Artisan

Avec un accès SSH, utilisez le binaire PHP correspondant à la version choisie pour le site. La commande php seule peut pointer vers une autre version :

Terminal
cd httpdocs
/opt/plesk/php/8.3/bin/php artisan migrate --force
/opt/plesk/php/8.3/bin/php artisan storage:link
/opt/plesk/php/8.3/bin/php artisan optimize

Sans accès SSH, passez par les tâches planifiées :

  1. Ouvrez Tâches planifiées, puis cliquez sur Ajouter une tâche.
  2. Choisissez Exécuter un script PHP.
  3. Sélectionnez le fichier httpdocs/artisan avec l'icône de dossier.
  4. Dans le champ des arguments (with arguments), saisissez migrate --force.
  5. Sélectionnez la version de PHP utilisée par le site.
  6. Cliquez sur Exécuter maintenant et attendez le résultat.

Répétez l'opération avec storage:link, puis optimize. Vous pouvez ensuite annuler sans enregistrer la tâche.

Planifier les tâches Laravel

Si votre application utilise le planificateur, créez une tâche Exécuter un script PHP comme ci-dessus, avec l'argument schedule:run et la fréquence suivante, en style Cron :

Texte
* * * * *

Vérifier le résultat

  1. Ouvrez https://votre-domaine.com/ : votre application doit s'afficher.

  2. Testez la route de contrôle de Laravel, présente par défaut dans les projets récents :

    Terminal
    curl -i https://votre-domaine.com/up

    Le code 200 signifie que l'application a démarré sans erreur.

  3. Vérifiez qu'un fichier sensible n'est pas exposé : https://votre-domaine.com/.env ne doit jamais afficher votre configuration.

  4. Testez une page qui utilise la base de données, par exemple la connexion.

Dépannage

Erreur 500 sans détail

Consultez storage/logs/laravel.log depuis le gestionnaire de fichiers, ou le bouton Journaux de Laravel Toolkit. N'activez APP_DEBUG=true que brièvement si le journal ne suffit pas.

No application encryption key has been specified.

La variable APP_KEY est vide ou absente. Générez-la avec key:generate --force, ou collez la clé créée sur votre ordinateur, puis exécutez config:clear.

Vos modifications du .env sont ignorées

La configuration est en cache. Exécutez optimize:clear, puis optimize une fois le problème réglé.

Erreur 403, 404 ou liste de fichiers sur la page d'accueil

La racine du document ne pointe probablement pas vers public. Vérifiez qu'elle vaut /httpdocs/public. Si les pages intérieures seules renvoient une erreur 404, vérifiez que le fichier public/.htaccess a bien été envoyé.

Vite manifest not found at: .../public/build/manifest.json

Les fichiers front-end n'ont pas été compilés ou envoyés. Lancez npm run build, puis envoyez le dossier public/build.

SQLSTATE[HY000] [1045] Access denied

L'utilisateur ou le mot de passe de la base est incorrect, ou l'utilisateur n'est pas associé à cette base. Corrigez le .env, puis exécutez config:clear. Si le mot de passe contient des espaces ou le caractère #, placez-le entre guillemets.

SQLSTATE[HY000] [2002]

Laravel n'arrive pas à joindre le serveur de base de données. Vérifiez DB_HOST et DB_PORT dans les informations de connexion de la base. Si le message indique No such file or directory avec localhost, essayez DB_HOST=127.0.0.1.

SQLSTATE[42S02] : table sessions ou cache introuvable

Les migrations n'ont pas été exécutées sur cette base. Lancez migrate --force.

Failed to open stream: Permission denied dans storage

Laravel doit pouvoir écrire dans storage et bootstrap/cache. Vérifiez les droits de ces dossiers dans le gestionnaire de fichiers. Si vous ne pouvez pas les corriger, contactez le support.

Your Composer dependencies require a PHP version ">= 8.3.0"

Le site ou la ligne de commande utilise une version de PHP trop ancienne. Sélectionnez la bonne version dans Plesk et, en SSH, appelez le binaire complet, par exemple /opt/plesk/php/8.3/bin/php.

Les images envoyées renvoient une erreur 404

Le lien vers le stockage public manque ou a été perdu lors d'un déploiement. Relancez storage:link.

L'onglet Tâches planifiées n'apparaît pas

Il ne s'affiche que si l'application définit au moins une tâche. Vérifiez routes/console.php, puis relancez un déploiement.