Pas encore de site web à héberger ? Nous créons aussi votre site ou votre application. Voir les packs

KENN HOSTING
Tous les articles
Tutoriels

Déployer une application Laravel ou Symfony sur cPanel

Aurel KENNE4 septembre 20267 min de lecture

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.