[{"data":1,"prerenderedAt":31},["ShallowReactive",2],{"doc-fr-heberger-laravel-plesk":3},{"path":4,"slug":5,"title":6,"description":7,"category":8,"subcategory":9,"icon":10,"date":11,"author":12,"order":13,"image":14,"tags":15,"keywords":21,"docGroup":28,"docGroupIcon":28,"link_en":29,"bodyHtml":30},"\u002Fdocs\u002Ffr\u002Fcloud\u002Fhebergement-web\u002Fheberger-laravel-plesk","heberger-laravel-plesk","Comment héberger un site Laravel sur Plesk ?","Hébergez votre application Laravel sur l'hébergement web Plesk Winheberg avec Laravel Toolkit, squelette ou dépôt Git, passage en production du .env, base MySQL, tâches planifiées et déploiement.","cloud","hebergement-web","tabler:file-text","2026-11-01","Winheberg",133,"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fhebergement-web\u002Fheberger-laravel-plesk.webp",[16,17,18,19,20],"Laravel","Plesk","PHP","Déploiement","Hébergement Web",[22,23,24,25,26,27],"héberger laravel","laravel plesk","laravel toolkit","déployer laravel","hébergement php laravel","laravel production","","\u002Fen\u002Fdocs\u002Fhebergement-web\u002Fhost-laravel-plesk","\u003Ch2>Contexte\u003C\u002Fh2>\n\u003Cp>Laravel est un framework PHP très répandu pour construire des sites et des applications web, de l&#39;API au back-office complet. Il s&#39;appuie sur Composer pour ses dépendances, sur Artisan pour ses commandes et sur un fichier \u003Ccode>.env\u003C\u002Fcode> pour sa configuration.\u003C\u002Fp>\n\u003Cp>Votre \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fcloud\u002Fhebergement-web\">hébergement web Winheberg\u003C\u002Fa> intègre Laravel Toolkit, une extension de Plesk dédiée à ce framework. Elle installe un projet neuf ou récupère le vôtre depuis un dépôt Git, installe les dépendances Composer et règle la racine du site sur le dossier \u003Ccode>public\u003C\u002Fcode>, pour que le code source et le fichier \u003Ccode>.env\u003C\u002Fcode> restent inaccessibles depuis le web.\u003C\u002Fp>\n\u003Cp>Ce guide couvre l&#39;installation, le passage en production, la base de données, les tâches planifiées et le déploiement des mises à jour.\u003C\u002Fp>\n\u003Ch2>Prérequis\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>Un hébergement web Winheberg avec accès au panel Plesk\u003C\u002Fli>\n\u003Cli>Un domaine ou un sous-domaine ajouté dans Plesk, voir notre guide \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fdocs\u002Fhebergement-web\u002Frelier-domaine-externe-plesk\">Comment relier un domaine externe à votre hébergement Plesk ?\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>Pour un projet existant, son dépôt Git sur GitHub, GitLab, Bitbucket ou votre propre serveur\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"markdown-alert markdown-alert-warning\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Cpath d=\"M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z\"\u002F>\u003Cline x1=\"12\" y1=\"9\" x2=\"12\" y2=\"13\"\u002F>\u003Cline x1=\"12\" y1=\"17\" x2=\"12.01\" y2=\"17\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Laravel Toolkit déplace la racine du site vers le dossier \u003Ccode>public\u003C\u002Fcode> de l&#39;application. Réservez un domaine ou un sous-domaine à votre application Laravel, par exemple \u003Ccode>app.exemple.fr\u003C\u002Fcode>, plutôt que d&#39;installer par-dessus un site existant.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>1. Ouvrir Laravel Toolkit\u003C\u002Fh2>\n\u003Cp>Dans \u003Cstrong>Sites Web &amp; Domaines\u003C\u002Fstrong>, ouvrez votre domaine, puis l&#39;onglet \u003Cstrong>Démarrer\u003C\u002Fstrong>. Cliquez sur \u003Cstrong>Laravel\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fhebergement-web\u002Fheberger-laravel-plesk-1793572336253-c6e3150d65f140eca311ab96.webp\" alt=\"Onglet Démarrer d'un domaine Plesk avec l'entrée Laravel\" width=\"540\" \u002F>\n\n\u003Cp>Vous arrivez aussi sur Laravel Toolkit par l&#39;entrée \u003Cstrong>Laravel\u003C\u002Fstrong> du menu latéral. Tant qu&#39;aucune application n&#39;existe, la page propose \u003Cstrong>Installer l&#39;application\u003C\u002Fstrong> et \u003Cstrong>Analyser\u003C\u002Fstrong>, ce second bouton servant à retrouver une application Laravel déjà présente sur vos domaines. Cliquez sur \u003Cstrong>Installer l&#39;application\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fhebergement-web\u002Fheberger-laravel-plesk-1793572336664-d39785b1bea2e2af797eb34f.webp\" alt=\"Page Laravel Toolkit de Plesk avec le bouton Installer l'application\" width=\"800\" \u002F>\n\n\u003Ch2>2. Choisir la source de l&#39;application\u003C\u002Fh2>\n\u003Cp>Dans la fenêtre \u003Cstrong>Installer l&#39;application\u003C\u002Fstrong>, sélectionnez votre domaine dans \u003Cstrong>Choisissez un domaine\u003C\u002Fstrong>, puis choisissez l&#39;une des deux sources proposées.\u003C\u002Fp>\n\u003Ch3>Partir d&#39;un projet neuf\u003C\u002Fh3>\n\u003Cp>\u003Cstrong>Installer le squelette\u003C\u002Fstrong> crée une application Laravel vierge, accompagnée d&#39;un dépôt Git local hébergé par Plesk. C&#39;est le bon choix pour démarrer un projet ou tester le framework.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fhebergement-web\u002Fheberger-laravel-plesk-1793572336968-33d603c7c90db6b2d3cecebd.webp\" alt=\"Choix du domaine et Installer le squelette dans Laravel Toolkit\" width=\"790\" \u002F>\n\n\u003Ch3>Déployer un projet existant\u003C\u002Fh3>\n\u003Cp>\u003Cstrong>Installer depuis un dépôt distant\u003C\u002Fstrong> récupère votre code depuis un service Git. Saisissez l&#39;adresse du dépôt dans le champ \u003Cstrong>Dépôt\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fhebergement-web\u002Fheberger-laravel-plesk-1793572337425-715eaf8849412644f92fc0ce.webp\" alt=\"Installation depuis un dépôt Git distant et clé publique SSH dans Laravel Toolkit\" width=\"790\" \u002F>\n\n\u003Cp>Pour un dépôt public, son adresse HTTPS suffit. Pour un dépôt privé, saisissez son adresse SSH, du type \u003Ccode>git@github.com:votre-compte\u002Fvotre-projet.git\u003C\u002Fcode>, puis ajoutez la clé affichée dans \u003Cstrong>Clé publique SSL\u003C\u002Fstrong> aux clés de déploiement du dépôt. Sur GitHub, elles se trouvent dans les \u003Cstrong>Settings\u003C\u002Fstrong> du dépôt, rubrique \u003Cstrong>Deploy keys\u003C\u002Fstrong>, et sur GitLab dans \u003Cstrong>Settings\u003C\u002Fstrong>, \u003Cstrong>Repository\u003C\u002Fstrong>, \u003Cstrong>Deploy keys\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Cdiv class=\"markdown-alert markdown-alert-tip\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cpath d=\"M12 16v-4\"\u002F>\u003Cpath d=\"M12 8h.01\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Une clé de déploiement donne accès à un seul dépôt, en lecture seule par défaut. C&#39;est plus sûr que d&#39;ajouter la clé à votre compte, qui ouvrirait tous vos dépôts.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>3. Suivre l&#39;installation\u003C\u002Fh2>\n\u003Cp>Validez la fenêtre. Laravel Toolkit affiche la progression dans \u003Cstrong>Déploiement du projet\u003C\u002Fstrong>, de la création du dépôt Git à l&#39;installation des dépendances Composer, puis à la configuration de l&#39;hébergement et de PHP. Comptez quelques minutes.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fhebergement-web\u002Fheberger-laravel-plesk-1793572337827-c9002e40d402a2d81f96cf27.webp\" alt=\"Fenêtre de déploiement du projet Laravel dans Plesk\" width=\"490\" \u002F>\n\n\u003Cdiv class=\"markdown-alert markdown-alert-note\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cline x1=\"12\" y1=\"16\" x2=\"12\" y2=\"12\"\u002F>\u003Cline x1=\"12\" y1=\"8\" x2=\"12.01\" y2=\"8\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Le squelette installe Laravel 13, qui demande PHP 8.3 ou plus. Pour un projet existant, vérifiez que la version PHP du domaine, visible dans \u003Cstrong>Paramètres PHP\u003C\u002Fstrong>, correspond à celle qu&#39;exige votre fichier \u003Ccode>composer.json\u003C\u002Fcode>.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>4. Découvrir le tableau de bord\u003C\u002Fh2>\n\u003Cp>Une fois l&#39;installation terminée, Laravel Toolkit ouvre la page \u003Cstrong>Application Laravel\u003C\u002Fstrong> de votre domaine. Le \u003Cstrong>Tableau de bord\u003C\u002Fstrong> rappelle l&#39;URL du site, l&#39;adresse du \u003Cstrong>Dépôt\u003C\u002Fstrong> et le \u003Cstrong>Dernier commit\u003C\u002Fstrong>. Les onglets \u003Cstrong>Artisan\u003C\u002Fstrong>, \u003Cstrong>Composer\u003C\u002Fstrong>, \u003Cstrong>Node.js\u003C\u002Fstrong>, \u003Cstrong>Déploiement\u003C\u002Fstrong> et \u003Cstrong>File d&#39;attente\u003C\u002Fstrong> regroupent les outils de l&#39;application.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fhebergement-web\u002Fheberger-laravel-plesk-1793572338234-94440a6403b8cbfec345b7a8.webp\" alt=\"Tableau de bord Laravel Toolkit avec les onglets et les paramètres\" width=\"790\" \u002F>\n\n\u003Cp>Pour une installation depuis le squelette, le champ \u003Cstrong>Dépôt\u003C\u002Fstrong> indique l&#39;adresse du dépôt Git local créé par Plesk, vers lequel vous pourrez pousser votre code. Le lien \u003Cstrong>Journaux\u003C\u002Fstrong>, à gauche, affiche les journaux de l&#39;application.\u003C\u002Fp>\n\u003Ch2>5. Passer l&#39;application en production\u003C\u002Fh2>\n\u003Cp>Le squelette démarre en mode développement. Ouvrez l&#39;onglet \u003Cstrong>Artisan\u003C\u002Fstrong>, saisissez \u003Ccode>about\u003C\u002Fcode> dans le champ \u003Cstrong>php artisan\u003C\u002Fstrong> et validez. La commande affiche l&#39;\u003Cstrong>Environment\u003C\u002Fstrong> \u003Ccode>local\u003C\u002Fcode>, le \u003Cstrong>Debug Mode\u003C\u002Fstrong> \u003Ccode>ENABLED\u003C\u002Fcode> et une \u003Cstrong>URL\u003C\u002Fstrong> en \u003Ccode>localhost\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fhebergement-web\u002Fheberger-laravel-plesk-1793572338623-66de936166162bbe5066a628.webp\" alt=\"Commande php artisan about dans l'onglet Artisan de Laravel Toolkit\" width=\"790\" \u002F>\n\n\u003Cdiv class=\"markdown-alert markdown-alert-caution\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cline x1=\"12\" y1=\"8\" x2=\"12\" y2=\"12\"\u002F>\u003Cline x1=\"12\" y1=\"16\" x2=\"12.01\" y2=\"16\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>En mode debug, la moindre erreur affiche aux visiteurs une page détaillée qui peut révéler votre code, vos chemins et vos réglages. Désactivez-le avant d&#39;ouvrir le site au public.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cp>Revenez au \u003Cstrong>Tableau de bord\u003C\u002Fstrong> et cliquez sur \u003Cstrong>Éditer\u003C\u002Fstrong> en face de \u003Cstrong>Variables d&#39;environnement (.env)\u003C\u002Fstrong>. L&#39;éditeur \u003Cstrong>Modifier .env\u003C\u002Fstrong> s&#39;ouvre.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fhebergement-web\u002Fheberger-laravel-plesk-1793572339031-44dbc700811e96f9ff273b74.webp\" alt=\"Fichier .env de Laravel réglé pour la production dans Plesk\" width=\"600\" \u002F>\n\n\u003Cdiv class=\"md-table md-table--info md-table--striped\">\u003Cdiv class=\"md-table__caption\">Valeurs à régler pour la production\u003C\u002Fdiv>\u003Cdiv class=\"md-table__scroll\">\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Variable\u003C\u002Fth>\n\u003Cth>Valeur\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>APP_ENV\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>production\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>APP_DEBUG\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>false\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>APP_URL\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>L&#39;adresse de votre site, par exemple \u003Ccode>https:\u002F\u002Fapp.exemple.fr\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003C\u002Fdiv>\u003Cdiv class=\"md-table__footer\">Ne modifiez jamais APP_KEY, générée à l'installation, sous peine de rendre illisibles les sessions et les données chiffrées.\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cp>Enregistrez, puis relancez \u003Ccode>about\u003C\u002Fcode> dans l&#39;onglet \u003Cstrong>Artisan\u003C\u002Fstrong> pour vérifier que l&#39;\u003Cstrong>Environment\u003C\u002Fstrong> affiche \u003Ccode>production\u003C\u002Fcode> et le \u003Cstrong>Debug Mode\u003C\u002Fstrong> \u003Ccode>OFF\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Ch2>6. Brancher une base de données\u003C\u002Fh2>\n\u003Cp>Le squelette utilise SQLite, une base stockée dans un simple fichier du projet, avec \u003Ccode>DB_CONNECTION=sqlite\u003C\u002Fcode>. Elle suffit pour un petit site. Pour MySQL ou MariaDB, créez d&#39;abord une base dans \u003Cstrong>Bases de données\u003C\u002Fstrong>, \u003Cstrong>Ajouter une base de données\u003C\u002Fstrong>, en notant son nom complet, son utilisateur et son mot de passe.\u003C\u002Fp>\n\u003Cp>Dans \u003Cstrong>Modifier .env\u003C\u002Fstrong>, remplacez la ligne \u003Ccode>DB_CONNECTION=sqlite\u003C\u002Fcode> par le bloc ci-dessous. Si les lignes \u003Ccode>DB_HOST\u003C\u002Fcode> à \u003Ccode>DB_PASSWORD\u003C\u002Fcode> sont déjà présentes en commentaire, précédées d&#39;un \u003Ccode>#\u003C\u002Fcode>, remplacez-les aussi pour ne pas les dupliquer.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-ini\">DB_CONNECTION=mysql\nDB_HOST=localhost\nDB_PORT=3306\nDB_DATABASE=nom_complet_de_la_base\nDB_USERNAME=utilisateur_de_la_base\nDB_PASSWORD=mot_de_passe_de_la_base\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Créez ensuite les tables depuis l&#39;onglet \u003Cstrong>Artisan\u003C\u002Fstrong> avec la commande suivante. L&#39;option \u003Ccode>--force\u003C\u002Fcode> est obligatoire en production, Laravel refuse sinon de lancer les migrations sans confirmation.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">migrate --force\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2>7. Planifier les tâches de Laravel\u003C\u002Fh2>\n\u003Cp>Si votre application utilise le planificateur de Laravel, défini dans \u003Ccode>routes\u002Fconsole.php\u003C\u002Fcode>, il doit être appelé chaque minute. Les interrupteurs \u003Cstrong>Tâches planifiées\u003C\u002Fstrong> et \u003Cstrong>File d&#39;attente\u003C\u002Fstrong> du tableau de bord demandent un accès SSH à l&#39;hébergement. Lorsqu&#39;il est interdit, ce qu&#39;indique la ligne \u003Cstrong>Accès SSH\u003C\u002Fstrong> des \u003Cstrong>Paramètres d&#39;hébergement\u003C\u002Fstrong>, ils restent grisés. Créez alors la tâche directement dans Plesk, elle fonctionne sans SSH.\u003C\u002Fp>\n\u003Cp>Depuis le \u003Cstrong>Tableau de bord\u003C\u002Fstrong> du domaine, section \u003Cstrong>Outils Dévelop.\u003C\u002Fstrong>, ouvrez \u003Cstrong>Tâches planifiées\u003C\u002Fstrong>, puis cliquez sur \u003Cstrong>Ajouter une tâche\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fhebergement-web\u002Fheberger-laravel-plesk-1793569975011-f2e0acca7249229cdf0e83b3.webp\" alt=\"Tâche planifiée Plesk exécutant artisan schedule:run chaque minute\" width=\"770\" \u002F>\n\n\u003Cdiv class=\"md-table md-table--info md-table--striped\">\u003Cdiv class=\"md-table__caption\">Réglages de la tâche planifiée\u003C\u002Fdiv>\u003Cdiv class=\"md-table__scroll\">\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Champ à l&#39;écran\u003C\u002Fth>\n\u003Cth>Valeur\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>Type de tâche\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Exécuter un script PHP\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Chemin d&#39;accès du script\u003C\u002Ftd>\n\u003Ctd>Le dossier de l&#39;application suivi de \u003Ccode>\u002Fartisan\u003C\u002Fcode>, par exemple \u003Ccode>app.exemple.fr\u002Fartisan\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>avec arguments\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>schedule:run\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Utiliser la version de PHP\u003C\u002Ftd>\n\u003Ctd>La même version que le site\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Exécuter\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Style Cron\u003C\u002Fstrong>, avec \u003Ccode>* * * * *\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cp>Le dossier de l&#39;application est celui de la \u003Cstrong>Racine du document\u003C\u002Fstrong>, sans le \u003Ccode>\u002Fpublic\u003C\u002Fcode> final. Vous le retrouvez dans l&#39;onglet \u003Cstrong>Hébergement et DNS\u003C\u002Fstrong>, entrée \u003Cstrong>Hébergement\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Cdiv class=\"markdown-alert markdown-alert-tip\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cpath d=\"M12 16v-4\"\u002F>\u003Cpath d=\"M12 8h.01\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Si votre application place des jobs en file d&#39;attente, ajoutez une seconde tâche identique avec l&#39;argument \u003Ccode>queue:work --stop-when-empty\u003C\u002Fcode>. Elle traite les jobs en attente chaque minute, puis s&#39;arrête.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>8. Déployer vos mises à jour\u003C\u002Fh2>\n\u003Cp>L&#39;onglet \u003Cstrong>Déploiement\u003C\u002Fstrong> règle la façon dont le nouveau code arrive en production. En mode \u003Cstrong>Manuel\u003C\u002Fstrong>, rien ne change sur le site tant que vous ne cliquez pas sur \u003Cstrong>Déployer\u003C\u002Fstrong>. En mode \u003Cstrong>Automatique\u003C\u002Fstrong>, le déploiement se lance de lui-même à chaque nouveau code poussé dans le dépôt local, ou à l&#39;appel du webhook pour un dépôt distant.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fhebergement-web\u002Fheberger-laravel-plesk-1793572339420-409e0496f5d205c0594685fe.webp\" alt=\"Onglet Déploiement de Laravel Toolkit avec le bouton Déployer\" width=\"790\" \u002F>\n\n\u003Cp>Les \u003Cstrong>Étapes du déploiement\u003C\u002Fstrong> s&#39;enchaînent dans l&#39;ordre affiché. Les étapes grisées sont obligatoires, les autres se cochent selon votre projet, par exemple \u003Cstrong>Installer les package.json dépendances\u003C\u002Fstrong> si votre site compile ses ressources avec npm. La modification du \u003Cstrong>Script de déploiement\u003C\u002Fstrong> demande, elle aussi, un accès SSH.\u003C\u002Fp>\n\u003Cp>Après un déploiement qui ajoute des migrations, lancez \u003Ccode>migrate --force\u003C\u002Fcode> depuis l&#39;onglet \u003Cstrong>Artisan\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Ch2>9. Ouvrir votre site\u003C\u002Fh2>\n\u003Cp>Ouvrez votre domaine dans un navigateur. Pour un squelette, la page d&#39;accueil de Laravel s&#39;affiche.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fhebergement-web\u002Fheberger-laravel-plesk-1793572339788-2916512069ce7eb268d673e9.webp\" alt=\"Page d'accueil par défaut de Laravel 13\" width=\"680\" \u002F>\n\n\u003Cp>Pour servir l&#39;application en HTTPS, installez le certificat gratuit avec notre guide \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fdocs\u002Fhebergement-web\u002Fcertificat-ssl-lets-encrypt-plesk\">Comment générer un certificat SSL Let&#39;s Encrypt pour votre site web ?\u003C\u002Fa>\u003C\u002Fp>\n\u003Ch2>En cas de problème\u003C\u002Fh2>\n\u003Ch3>❌ Le site affiche une erreur 500 sans détail\u003C\u002Fh3>\n\u003Cp>C&#39;est le comportement normal en production, le détail de l&#39;erreur part dans les journaux.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Ouvrez le lien \u003Cstrong>Journaux\u003C\u002Fstrong> de Laravel Toolkit, ou le fichier \u003Ccode>storage\u002Flogs\u002Flaravel.log\u003C\u002Fcode> dans le gestionnaire de fichiers\u003C\u002Fli>\n\u003Cli>Si le message indique \u003Ccode>No application encryption key has been specified.\u003C\u002Fcode>, lancez \u003Ccode>key:generate --force\u003C\u002Fcode> depuis l&#39;onglet \u003Cstrong>Artisan\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Si l&#39;erreur vient de la base de données, vérifiez les lignes \u003Ccode>DB_\u003C\u002Fcode> du fichier \u003Ccode>.env\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Une modification du .env n&#39;est pas prise en compte\u003C\u002Fh3>\n\u003Cp>La configuration a été mise en cache, Laravel ne relit plus le fichier \u003Ccode>.env\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Lancez \u003Ccode>config:clear\u003C\u002Fcode> depuis l&#39;onglet \u003Cstrong>Artisan\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Si vous utilisez \u003Ccode>optimize\u003C\u002Fcode> lors de vos déploiements, relancez-le après chaque modification du \u003Ccode>.env\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Le dépôt distant refuse la connexion\u003C\u002Fh3>\n\u003Cp>Laravel Toolkit n&#39;arrive pas à s&#39;authentifier auprès de votre service Git.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Pour un dépôt privé, vérifiez que vous avez saisi l&#39;adresse SSH, \u003Ccode>git@...\u003C\u002Fcode>, et non l&#39;adresse HTTPS\u003C\u002Fli>\n\u003Cli>Vérifiez que la clé affichée dans \u003Cstrong>Clé publique SSL\u003C\u002Fstrong> figure bien dans les clés de déploiement du dépôt\u003C\u002Fli>\n\u003Cli>Copiez la clé en entier, du \u003Ccode>ssh-rsa\u003C\u002Fcode> initial jusqu&#39;au dernier caractère\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Les migrations échouent\u003C\u002Fh3>\n\u003Cp>Laravel ne parvient pas à se connecter à la base ou refuse de lancer la commande.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Ajoutez l&#39;option \u003Ccode>--force\u003C\u002Fcode>, sans elle les migrations ne s&#39;exécutent pas en production\u003C\u002Fli>\n\u003Cli>Un message \u003Ccode>Access denied\u003C\u002Fcode> signale un nom d&#39;utilisateur ou un mot de passe erroné dans le \u003Ccode>.env\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Vérifiez que \u003Ccode>DB_DATABASE\u003C\u002Fcode> reprend le nom complet de la base, préfixe compris\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Bonnes pratiques\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>Gardez \u003Ccode>APP_DEBUG=false\u003C\u002Fcode> sur le site public, et testez vos changements sur un sous-domaine de préproduction\u003C\u002Fli>\n\u003Cli>Ne versionnez jamais le fichier \u003Ccode>.env\u003C\u002Fcode>, le \u003Ccode>.gitignore\u003C\u002Fcode> fourni par Laravel l&#39;exclut déjà\u003C\u002Fli>\n\u003Cli>Restez en mode de déploiement \u003Cstrong>Manuel\u003C\u002Fstrong> tant que vous n&#39;avez pas de tests automatisés\u003C\u002Fli>\n\u003Cli>Laissez cochée l&#39;étape \u003Cstrong>Activer le mode Maintenance\u003C\u002Fstrong>, vos visiteurs voient une page d&#39;attente plutôt qu&#39;un site à moitié mis à jour\u003C\u002Fli>\n\u003Cli>Exportez votre base de données avant toute migration importante\u003C\u002Fli>\n\u003Cli>Pour donner accès à un développeur sans partager votre compte, suivez notre guide \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fdocs\u002Fhebergement-web\u002Fcreer-utilisateur-plesk\">Comment créer un utilisateur dans Plesk ?\u003C\u002Fa>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Besoin d&#39;aide ?\u003C\u002Fh2>\n\u003Cp>Si l&#39;installation échoue ou si votre application ne démarre pas sur votre hébergement, ouvrez un ticket auprès de notre support depuis votre \u003Ca href=\"https:\u002F\u002Fbilling.winheberg.com\">espace client\u003C\u002Fa>, département \u003Cstrong>Technique\u003C\u002Fstrong>, en renseignant le champ \u003Cstrong>Produit lié\u003C\u002Fstrong> avec l&#39;hébergement web concerné. Pour les questions sur le framework lui-même, consultez la \u003Ca href=\"https:\u002F\u002Flaravel.com\u002Fdocs\">documentation officielle de Laravel\u003C\u002Fa>.\u003C\u002Fp>\n\u003Cp>Votre application Laravel tourne en production, prête à accueillir ses premiers utilisateurs 🚀\u003C\u002Fp>\n",1794526344330]