Déployer une application Laravel ou Symfony sur cPanel
Le point à comprendre avant de commencer
Laravel et Symfony partagent la même particularité : votre projet contient un dossier public/ qui doit être la seule chose exposée au navigateur. Tout le reste (le code source, les fichiers de configuration, le fichier .env avec vos mots de passe) doit rester hors d'atteinte du web.
Sur un hébergement cPanel classique, le domaine principal sert directement le contenu de public_html. Si vous y déposez tout votre projet Laravel ou Symfony tel quel, n'importe qui pourrait accéder à votre .env ou à votre code source en tapant la bonne URL. Il faut donc organiser les dossiers correctement avant de commencer.
Deux façons de faire, selon votre situation :
Option A, recommandée : vous déposez l'ensemble du projet dans un dossier hors public_html (par exemple monapp à la racine de votre compte), puis vous faites pointer un sous-domaine ou un domaine additionnel vers monapp/public comme racine (document root). C'est la configuration la plus propre, celle que nous vous conseillons si vous le pouvez.
Option B : vous voulez que l'application réponde directement sur votre domaine principal, sans sous-domaine. Dans ce cas, le contenu du dossier public/ va dans public_html, et le reste du projet un niveau au-dessus, hors public_html. Il faudra alors ajuster deux chemins dans le fichier public/index.php pour qu'il continue de retrouver le reste de l'application. On détaille ça plus bas.
Étape 1 : préparer l'emplacement
Option A : sous-domaine ou domaine additionnel
Dans cPanel, section Domaines, créez un sous-domaine (par exemple app.votredomaine.com) ou un domaine additionnel. Au moment de la création, cPanel vous demande un dossier racine : indiquez monapp/public (le dossier monapp sera créé automatiquement à la racine de votre compte si besoin).
Votre arborescence finale ressemblera à ça :
/home/votrecompte/
├── monapp/
│ ├── app/
│ ├── bootstrap/
│ ├── config/
│ ├── public/ ← racine servie par le sous-domaine
│ ├── storage/
│ ├── vendor/
│ └── .env
└── public_html/ ← votre site principal, inchangé
Option B : rester sur le domaine principal
Uploadez tout le projet dans un dossier hors public_html, par exemple /home/votrecompte/monapp. Puis déplacez (ou copiez) uniquement le CONTENU du dossier public/ dans public_html :
cp -R /home/votrecompte/monapp/public/* /home/votrecompte/public_html/
Ensuite, ouvrez public_html/index.php (la copie que vous venez de déplacer) et corrigez les deux chemins qui pointent vers vendor/autoload.php et vers bootstrap/app.php (Laravel) ou vers le kernel (Symfony), puisqu'ils ne sont plus au même niveau relatif :
// Avant (dans le public/ d'origine, à côté du reste du projet)
require __DIR__.'/../vendor/autoload.php';
$app = require_once __DIR__.'/../bootstrap/app.php';
// Après (public_html séparé de monapp d'un niveau de plus)
require __DIR__.'/../monapp/vendor/autoload.php';
$app = require_once __DIR__.'/../monapp/bootstrap/app.php';
Adaptez le nombre de ../ et le nom du dossier (monapp) à votre propre arborescence. C'est la seule partie un peu délicate de l'option B : si vous avez un doute, l'option A évite complètement ce bricolage.
Étape 2 : uploader le code du projet
N'uploadez jamais le dossier vendor/ (dépendances PHP) ni node_modules/ (si vous avez des assets front à compiler) : ils seront régénérés côté serveur à l'étape suivante, et représentent souvent l'essentiel du poids du projet.
Avec Git (si vous êtes à l'aise en SSH) : connectez-vous en terminal depuis cPanel ou en SSH, placez-vous dans le dossier cible, et clonez votre dépôt :
cd /home/votrecompte
git clone https://github.com/votre-compte/votre-projet.git monapp
Sans Git : compressez votre projet en .zip sur votre machine (en excluant vendor/ et node_modules/ pour gagner du temps), puis dans cPanel, Gestionnaire de fichiers → naviguez jusqu'au dossier cible → Charger → sélectionnez votre .zip → une fois l'upload terminé, clic droit sur le fichier → Extraire.
Étape 3 : choisir la bonne version PHP
Laravel et Symfony récents demandent PHP 8.1 ou supérieur. Dans cPanel, ouvrez MultiPHP Manager, sélectionnez votre domaine ou sous-domaine dans la liste, et choisissez une version PHP 8.4. Cliquez sur Appliquer.
Étape 4 : installer les dépendances avec Composer
Ouvrez le Terminal depuis cPanel (ou connectez-vous en SSH), placez-vous dans le dossier du projet, puis lancez :
cd /home/votrecompte/monapp
composer install --no-dev --optimize-autoloader
Le drapeau --no-dev exclut les paquets réservés au développement (outils de test, débogueurs) : ils ne servent à rien en production et alourdiraient inutilement votre application. --optimize-autoloader génère une table de correspondance des classes optimisée, ce qui accélère le chargement de chaque requête.
Étape 5 : configurer le fichier .env
Copiez le fichier d'exemple fourni avec votre projet et éditez-le :
cp .env.example .env
Ouvrez .env (depuis le Terminal avec un éditeur comme nano, ou directement depuis le Gestionnaire de fichiers de cPanel) et renseignez au minimum :
APP_ENV=production
APP_DEBUG=false
APP_URL=https://app.votredomaine.com
DB_CONNECTION=mysql
DB_HOST=localhost
DB_DATABASE=votrecompte_nomdelabase
DB_USERNAME=votrecompte_utilisateur
DB_PASSWORD=votre_mot_de_passe
La base de données MySQL (nom, utilisateur, mot de passe) doit avoir été créée au préalable depuis cPanel. Si ce n'est pas encore fait, suivez notre article sur la création d'une base de données dans cPanel avant de continuer ici.
APP_DEBUG=false est important : en production, afficher les erreurs détaillées à vos visiteurs expose des informations sensibles sur votre code et votre configuration.
Étape 6 : spécifique à Laravel
Générez la clé de chiffrement de l'application, utilisée pour sécuriser les sessions et les données chiffrées :
php artisan key:generate
Donnez les droits d'écriture nécessaires aux deux dossiers que Laravel utilise pour écrire des fichiers en permanence (logs, cache de vues, sessions, fichiers uploadés) :
chmod -R 775 storage bootstrap/cache
Sans ça, Laravel renverra une erreur dès qu'il tentera d'écrire un log ou de compiler une vue.
Lancez les migrations pour créer les tables de votre base de données :
php artisan migrate --force
Le drapeau --force est nécessaire car Laravel bloque par défaut les migrations en environnement de production sans confirmation explicite, puisque c'est une opération qui modifie votre base de données réelle.
Enfin, mettez en cache la configuration et les routes pour accélérer chaque requête :
php artisan config:cache
php artisan route:cache
Pensez à relancer ces deux commandes à chaque fois que vous modifiez .env ou vos fichiers de routes, sinon Laravel continuera de servir l'ancienne version mise en cache.
Étape 7 : spécifique à Symfony
Générez le fichier d'environnement optimisé pour la production à partir de votre .env :
composer dump-env prod
Cette commande compile vos variables d'environnement dans un fichier .env.local.php, plus rapide à lire pour PHP qu'un .env classique analysé à chaque requête.
Videz et reconstruisez le cache pour l'environnement de production :
php bin/console cache:clear --env=prod
Donnez les droits d'écriture aux dossiers que Symfony utilise pour le cache et les journaux :
chmod -R 775 var/cache var/log
Étape 8 : mettre à jour votre application plus tard
Une précision importante : ce déploiement manuel ne se met pas à jour automatiquement à chaque fois que vous poussez du code sur votre dépôt Git. Il n'y a pas de webhook branché ici. À chaque mise à jour de votre application, vous devrez repasser par les mêmes étapes :
cd /home/votrecompte/monapp
git pull origin main
composer install --no-dev --optimize-autoloader
php artisan migrate --force
php artisan config:cache
php artisan route:cache
(Remplacez les trois dernières lignes par les commandes Symfony si c'est votre cas.) Vous pouvez regrouper ces commandes dans un petit script shell que vous exécutez en une seule fois à chaque mise à jour, pour éviter d'oublier une étape.
En résumé
Le déploiement de Laravel ou Symfony sur cPanel demande un peu plus de rigueur qu'un simple upload de fichiers, principalement à cause du dossier public/ à isoler correctement. Une fois la structure en place et Composer configuré, les mises à jour suivantes ne demandent que quelques commandes à relancer. Si vous bloquez sur une étape, notre équipe peut vous accompagner directement.
Articles liés
Déployer une API Node.js/Express sur cPanel
Guide complet pour déployer une API Node.js/Express sur votre hébergement cPanel, avec l'outil Setup Node.js App : création de l'application, installation des dépendances, variables d'environnement et redémarrage.
Déployer une application React sur cPanel
Build statique, upload dans public_html, routage côté client avec .htaccess : le guide complet pour mettre votre application React en ligne sur votre hébergement cPanel.
Déployer une application Python (Django ou Flask) sur cPanel
Guide complet pour déployer une application Python (Django ou Flask) sur votre hébergement cPanel, avec Setup Python App, virtualenv et configuration WSGI.
Déployer React + Express.js + MySQL sur cPanel (Guide Complet)
Guide complet pour déployer une application React, Express.js et MySQL sur cPanel.
