01
Avant de commencer : quelle version de PHP votre version de Laravel exige-t-elle ?
Dans le fichier composer.json de votre projet, les lignes php et laravel/framework indiquent la version de PHP dont vous avez besoin. Le tableau de support issu des notes de version officielles de Laravel figure ci-dessous.
Vous pouvez choisir la version de PHP dans cPanel jusqu'à 8.5 ; Laravel 12 et 13 fonctionnent dans cette plage. Si vous utilisez une version qui n'est plus supportée, planifiez la mise à niveau.
- Laravel 13 (mars 2026) : PHP 8.3 – 8.5, correctifs de sécurité jusqu'au 17 mars 2028
- Laravel 12 (février 2025) : PHP 8.2 – 8.5, corrections de bugs terminées en août 2026, correctifs de sécurité jusqu'au 24 février 2027
- Laravel 11 : PHP 8.2 – 8.4, support terminé le 12 mars 2026
- Laravel 10 : PHP 8.1 – 8.3, support terminé
02
Ligne de commande : le Terminal de cPanel et les premières vérifications
L'accès shell est activé sur les offres pour développeurs (HAN-DEV-1…4). Vous exécutez les commandes composer, php artisan et git de ce guide dans l'écran « Terminal » de cPanel, depuis votre navigateur. Si vous souhaitez établir une connexion SSH directe depuis votre propre ordinateur, adressez-vous à l'équipe d'assistance.
La session Terminal s'ouvre dans la cage CloudLinux CageFS : vous ne voyez pas les fichiers des autres comptes, et vous n'avez ni droits root ni sudo. Pour les projets qui nécessitent des paquets système, un serveur VDS est plus adapté.
Commencez par exécuter php -v : le PHP de la ligne de commande doit être de la même version que celle choisie pour le web, car Composer vérifie la compatibilité des paquets par rapport à cette version. S'il diffère, adressez-vous à l'équipe d'assistance.
03
Transférer le projet sur le serveur : Git ou envoi de fichiers
Placez le projet non pas dans public_html, mais dans un dossier distinct de votre répertoire personnel ; ainsi, .env et le code source ne sont pas accessibles depuis le navigateur.
Git est préinstallé sur les offres ; dans le Terminal, vous pouvez récupérer le dépôt dans ce dossier avec git clone (les dépôts privés nécessitent une clé d'accès ou un jeton fourni par votre hébergeur de dépôts). Si vous n'utilisez pas Git, envoyez le projet sous forme de zip dans le gestionnaire de fichiers de cPanel (« File Manager ») et décompressez-le.
N'envoyez pas les dossiers vendor et node_modules. La sortie de Vite, public/build, figure dans le .gitignore par défaut de Laravel et n'arrive donc pas avec le dépôt ; exécutez la commande npm run build sur votre propre ordinateur et envoyez ce dossier séparément.
04
Hébergement compatible Composer : installer les dépendances sur le serveur
Composer 2 est installé sur les offres pour développeurs. Dans le Terminal, placez-vous dans le dossier du projet et exécutez composer install --no-dev --optimize-autoloader : --no-dev laisse de côté les paquets de test et de débogage, --optimize-autoloader génère la classmap à l'avance.
Cette commande installe exactement les versions du fichier composer.lock. N'exécutez pas composer update sur le serveur ; faites la mise à jour sur votre propre ordinateur et envoyez le fichier de verrouillage. Si l'installation s'arrête à cause d'une extension ou d'une version, composer check-platform-reqs indique l'exigence manquante.
Selon la documentation officielle de Laravel, les extensions PHP requises sont : Ctype, cURL, DOM, Fileinfo, Filter, Hash, Mbstring, OpenSSL, PCRE, PDO, Session, Tokenizer, XML. Si l'une d'elles semble manquer, signalez-le à l'équipe d'assistance.
05
Fichier .env, APP_KEY et paramètres de base de données
Dans l'écran « MySQL Databases » de cPanel, créez une base de données et un utilisateur, puis ajoutez l'utilisateur à la base avec tous les privilèges. cPanel ajoute généralement votre nom de compte au début des noms (par ex. utilisateur_laravel) ; inscrivez ce nom complet dans le fichier .env.
Créez le fichier avec cp .env.example .env ; si APP_KEY est vide, générez-la avec php artisan key:generate. Ne régénérez pas la clé d'une application en production : les données chiffrées ne pourraient plus être déchiffrées et les sessions seraient perdues. Lignes à vérifier :
APP_ENV=production et APP_DEBUG=false : le détail des erreurs n'est pas affiché aux visiteursAPP_URL : l'adresse du site, commençant par httpsDB_CONNECTION=mysql : depuis Laravel 11, les nouveaux projets sont livrés avec SQLiteDB_HOST, DB_DATABASE, DB_USERNAME, DB_PASSWORD : les informations créées dans cPanel
06
Commandes Artisan : migrate, storage:link et caches
php artisan migrate --force crée les tables ; en production, Laravel demande une confirmation, que --force permet de sauter. Depuis Laravel 11, les tables par défaut des sessions, du cache et de la file d'attente sont également créées à cette étape.
Si vous stockez les fichiers envoyés sur le disque public, exécutez php artisan storage:link pour créer le lien public/storage.
Exécutez ensuite php artisan optimize ; la commande prépare ensemble les caches de configuration, de routes, d'événements et de vues (config:cache, route:cache, event:cache, view:cache). Une fois la configuration en cache, .env n'est plus lu : quand vous modifiez une valeur, relancez la commande, et n'utilisez l'appel env() que dans les fichiers de config.
07
Installation de Laravel sur cPanel : faire pointer la racine du document vers le dossier public
Selon la documentation officielle de déploiement de Laravel, toutes les requêtes doivent aboutir au fichier public/index.php ; exposer la racine du projet rend des fichiers sensibles visibles sur Internet. LiteSpeed lit aussi les règles de réécriture de public/.htaccess : ne supprimez pas ce fichier.
Les méthodes générales dans cPanel figurent ci-dessous ; si vous n'êtes pas sûr de celle qui convient à votre compte, adressez-vous à l'équipe d'assistance.
- Domaine supplémentaire ou sous-domaine : lorsque vous ajoutez le domaine dans l'écran « Domains » de cPanel, indiquez
application/public comme racine du document (« Document Root »). - Domaine principal (public_html) : sauvegardez le dossier
public_html et remplacez-le par un lien symbolique vers le dossier public du projet (ln -s), ou copiez le contenu de public dans public_html puis, dans index.php, corrigez les chemins __DIR__.'/../' en fonction du dossier du projet. - Ne placez pas l'ensemble du projet dans
public_html en le redirigeant avec .htaccess : si une règle est oubliée, .env peut se retrouver exposé.
08
Permissions de storage et bootstrap/cache
Laravel écrit dans les dossiers storage (journaux, sessions, cache, fichiers envoyés) et bootstrap/cache. Sur un hébergement mutualisé, PHP s'exécutant généralement sous l'utilisateur de votre compte, les permissions 755 pour les dossiers et 644 pour les fichiers suffisent dans la plupart des cas ; ne donnez pas 777.
Si vous voyez « Permission denied » ou une page blanche, lisez d'abord le fichier storage/logs/laravel.log ; si d'anciens caches posent problème, php artisan optimize:clear les vide tous.
09
Tâches planifiées : schedule:run avec les Cron Jobs de cPanel
Une seule ligne cron suffit pour le planificateur ; les tâches sont définies dans routes/console.php depuis Laravel 11, et dans app/Console/Kernel.php auparavant. Dans l'écran « Cron Jobs » de cPanel, choisissez la fréquence « Once Per Minute » et saisissez ceci dans le champ de commande :
cd /home/utilisateur/application && php artisan schedule:run >> /dev/null 2>&1
Assurez-vous que la version de PHP utilisée par le cron est la même que celle de votre projet ; pour voir les erreurs, vous pouvez rediriger la sortie vers un fichier. Avec des tâches espacées de quelques secondes, schedule:run reste actif jusqu'à la fin de la minute et consomme une part des limites de l'offre ; sur un hébergement, privilégiez des tâches à la minute ou moins fréquentes.
10
Files d'attente Laravel (queue) : ce qui est possible sur un hébergement, et où est la limite
La documentation officielle des files d'attente de Laravel recommande un gestionnaire de processus comme Supervisor pour maintenir le processus queue:work actif. Sur un hébergement mutualisé, les processus d'arrière-plan qui restent actifs en permanence ne sont pas pris en charge ; vous ne pouvez pas exécuter de worker de file d'attente permanent.
Pour des tâches courtes et peu fréquentes, deux solutions existent. Avec QUEUE_CONNECTION=sync, les tâches s'exécutent immédiatement pendant la requête. Ou bien, dans le fichier routes/console.php, ajoutez Schedule::command('queue:work --stop-when-empty')->everyMinute()->withoutOverlapping(); : le worker termine les tâches en attente puis s'arrête, et redémarre la minute suivante.
Les e-mails de notification ou les petits rapports fonctionnent ainsi. Pour des files d'attente chargées et des composants qui tournent en continu comme Horizon, Reverb ou Octane, passez à un serveur VDS avec accès root et gérez les workers avec Supervisor.
11
Quelle offre pour développeurs choisir, et quand passer à l'offre supérieure ?
Les valeurs du tableau sont les limites appliquées sur le serveur. Pour une seule application, HAN-DEV-1 (2 Go de RAM, limite CPU de 200 %, 5 bases de données) est un point de départ ; pour plusieurs projets, regardez HAN-DEV-2 ou HAN-DEV-3, qui offrent davantage de sites supplémentaires. Les tâches cron et les files d'attente partagent la même limite que les requêtes web.
Si les ressources ne suffisent plus, vous passez depuis l'Espace client à une offre d'hébergement supérieure ; la différence est facturée, et le retour à une offre inférieure n'est pas possible. Vous pouvez faire migrer votre site hébergé ailleurs grâce au formulaire de migration d'hébergement gratuite.
Les offres comprennent LiteSpeed, CloudLinux, Imunify360 et le SSL gratuit (détails : hébergement Linux). Les comptes sont sauvegardés chaque nuit et les sauvegardes des 3 derniers jours sont conservées. C'est une facilité ; conservez aussi votre dump de base de données et votre fichier .env dans votre propre espace, par exemple un espace de sauvegarde cloud.