Comment déployer un site Laravel ou Symfony ?

Deux méthodes, selon que vous souhaitez déployer depuis un dépôt Git ou installer l'application à la main sur votre hébergement.

Méthode recommandée : déployer avec Hodifly

Hodifly déploie votre application Laravel ou Symfony directement depuis GitHub ou GitLab, à chaque git push. Il n'y a ni SSH, ni lien symbolique, ni composer install à lancer : tout se fait sur le serveur, à chaque déploiement.

Hodifly fonctionne sur tous les hébergements web, y compris les moins chers : une application PHP est servie par le serveur web lui-même, elle n'a donc pas besoin de l'option « applications » nécessaire à Node, Python ou Ruby.

Ce que Hodifly fait pour vous

• La racine du site pointe automatiquement vers le dossier du contrôleur frontal de la version déployée : public/ pour Laravel et Symfony. Le reste de l'application (.env, vendor/, app/, config/, storage/) n'est jamais accessible en HTTP. C'est exactement le problème que la méthode manuelle ci-dessous résout avec un lien symbolique : ici, il n'y a rien à faire.
• Composer est exécuté à chaque déploiement (install --no-dev --prefer-dist --optimize-autoloader). Versionnez votre composer.lock.
• Le fichier .env est généré à partir des variables d'environnement du projet. Ne versionnez pas de .env. APP_KEY (Laravel) et APP_SECRET (Symfony) sont générés une fois et conservés hors des versions, pour que les sessions survivent aux déploiements.
• Les migrations sont jouées avant la mise en ligne. Une migration en échec laisse la version précédente en place : le site ne casse pas.
• Les assets front-end (Vite, Laravel Mix, Webpack Encore) sont construits automatiquement si votre package.json contient un script build.
• Les tâches planifiées Laravel sont câblées toutes seules dans le crontab du compte.
• Le retour arrière est instantané depuis cPanel, sans reconstruction.

Mise en route

1. Ouvrez cPanel > Hodifly et connectez votre dépôt GitHub ou GitLab.
2. Choisissez la branche et le domaine (ou le sous-dossier) à déployer.
3. Laissez la commande de build vide : Composer et les assets sont gérés automatiquement.
4. Renseignez vos variables d'environnement (base de données, clés d'API), puis déployez.

Les détails complets (runtimes, monorepos, files d'attente, données persistantes) sont dans Que puis-je déployer sur Hodifly ?.

Méthode manuelle : installer l'application vous-même

Si vous n'utilisez pas Hodifly et que vous installez l'application à la main, il reste le problème du dossier : votre hébergement sert public_html, alors que Laravel et Symfony imposent de servir leur dossier public.

Il existe une méthode simple pour pouvoir utiliser Symfony ou Laravel avec votre hébergement :

• Connectez-vous en SSH ou allez dans le Terminal sur cPanel
• Vérifiez que vous êtes à la racine de votre hébergement :

cd ~

• Renommez le répertoire public_html via la commande suivante :

mv public_html public_html_bak

• Créez un lien symbolique entre votre répertoire public et public_html via la commande suivante (adaptez /home/monuser/monappli/public selon votre installation) :

ln -s /home/monuser/monappli/public public_html

• Enfin, pour exécuter composer, vous devez spécifier la version de PHP à utiliser si vous avez changé la version de PHP de votre hébergement, par exemple pour utiliser PHP 8.2 avec composer :

ea-php82 /usr/local/bin/composer install
Vous pouvez aussi créer un alias dans votre shell si vous désirez appeler composer avec uniquement la commande composer.
Astuce : si vous êtes sur une offre où l'accès SSH n'est pas inclus, notre support technique fera la manipulation pour vous. Indiquez-nous simplement le chemin de votre répertoire public.

Mis à jour le : 15/08/2026