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.
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
phpde votre fichiercomposer.json. - Les extensions PHP requises par Laravel : Ctype, cURL, DOM, Fileinfo, Filter, Hash, Mbstring, OpenSSL, PCRE, PDO, Session, Tokenizer et XML, ainsi que
pdo_mysqlpour 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
- Allez dans Sites Web & Domaines et repérez votre domaine.
- Ouvrez PHP (ou Paramètres PHP, selon votre version de Plesk).
- 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 :
- Dans Hébergement et DNS > Hébergement, réglez Racine du document sur
/httpdocs/public, puis cliquez sur Enregistrer. - Revenez à l'onglet Tableau de bord, cliquez sur Créer un site web > Laravel, puis sur Annuler.
- 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 :
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_baseLancer les commandes Artisan
Dans l'onglet Artisan, saisissez chaque commande sans le préfixe php artisan, puis exécutez-la :
key:generate --force
migrate --force
storage:link
optimizekey:generate --forcecré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 --forcecrée les tables. Par défaut, Laravel y stocke aussi les sessions, le cache et les files d'attente.storage:linkrend accessibles les fichiers du disquepublic.optimizemet en cache la configuration, les routes, les événements et les vues.
Déployer les mises à jour
Dans l'onglet Déploiement :
- Choisissez le Mode de déploiement : Manuel ou Automatique.
- Dans Scénario de déploiement, décochez les étapes inutiles.
- 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.
-
Ajoutez le paquet d'intégration de Plesk à la section
requiredecomposer.json, en vérifiant sa compatibilité avec votre version de Laravel :JSON"plesk/ext-laravel-integration": "^7.0" -
Déployez, puis commitez le fichier
composer.lockmis à jour et déployez à nouveau. -
Vérifiez la présence de
QUEUE_CONNECTION=databasedans le fichier.env. -
Activez le Mode Maintenance.
-
Dans Artisan, lancez
migrate --force. Si votre projet ne contient pas de migration pour la tablejobs, lancez d'abordqueue:table. -
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 :
composer install --no-dev --optimize-autoloader
npm ci
npm run build
php artisan key:generate --showConservez 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
-
Créez une archive
.zipdu projet, avec les dossiersvendoretpublic/build, mais sansnode_modulesni votre fichier.envlocal. -
Dans Fichiers, ouvrez
httpdocs, téléversez l'archive, cochez-la, cliquez sur Extraire les fichiers, puis supprimez-la. -
Créez dans
httpdocsun fichier.envreprenant l'exemple de la méthode 1, et ajoutez-y votre clé :ConfigurationAPP_KEY=base64:VOTRE_CLE_GENEREE
Vous pouvez aussi utiliser un compte FTP pour envoyer les fichiers.
Définir la racine du document
- Dans Sites Web & Domaines, ouvrez Hébergement et DNS > Hébergement pour votre domaine.
- Réglez Racine du document sur
/httpdocs/public. - 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 :
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 optimizeSans accès SSH, passez par les tâches planifiées :
- Ouvrez Tâches planifiées, puis cliquez sur Ajouter une tâche.
- Choisissez Exécuter un script PHP.
- Sélectionnez le fichier
httpdocs/artisanavec l'icône de dossier. - Dans le champ des arguments (with arguments), saisissez
migrate --force. - Sélectionnez la version de PHP utilisée par le site.
- 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 :
* * * * *Vérifier le résultat
-
Ouvrez
https://votre-domaine.com/: votre application doit s'afficher. -
Testez la route de contrôle de Laravel, présente par défaut dans les projets récents :
Terminalcurl -i https://votre-domaine.com/upLe code
200signifie que l'application a démarré sans erreur. -
Vérifiez qu'un fichier sensible n'est pas exposé :
https://votre-domaine.com/.envne doit jamais afficher votre configuration. -
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.