Assistant de configuration du site
Suivez les quatre étapes de l’assistant pour connecter un dépôt Git, renseigner .env, créer une base de données et lancer le premier déploiement.
Pour les applications prises en charge, Sites → Applications → Installation rapide est plus rapide. Utilisez l’assistant pour connecter votre propre dépôt et gérer manuellement le déploiement, l’environnement, la base de données et le premier déploiement.
Exemple de site Laravel
Pour créer un site et déployer un dépôt Laravel comme git@github.com:example/example.com.git, l’assistant de configuration est la solution la plus rapide.
Avant de commencer
- Créez le site d'abord à partir de Sites → Nouveau site.
- Pour Laravel, gardez la racine du document initial sous
web_root/public. - Choisissez le bon domaine et la version PHP avant d'ouvrir l'assistant.
- Si le domaine est un domaine apex, vous pouvez en option activer l'alias
wwwlors de la création du site.
Étape 1 — Déploiement
Renseignez les paramètres du dépôt et du déploiement :
- URL du dépôt :
git@github.com:example/example.com.git - Branche : généralement
main, sauf si le dépôt utilise une autre branche - Chemin de déploiement : laissez le suffixe vide pour cloner le projet directement dans
web_root.
Options de construction recommandées pour un projet Laravel :
composer install: activénpm build: activez-le uniquement si le projet nécessite une compilation de son interface avec Node. Herne Panel ne requiert pas npm.php artisan migrate: activez-le si vous créez la base de données à l’étape 3 et inscrivez les mêmes identifiants dans.env.optimize / cache clear: activé
Le dépôt SSH URLs déclenche automatiquement la génération de clé de déploiement lorsque c'est possible. Vous pouvez également générer la clé plus tard à partir de la page Déploiement.
Étape 2 — .env
Collez ou modifiez les valeurs de production de .env pour l’application. Vérifiez au minimum les entrées ci-dessous.
APP_NAMEAPP_ENV=productionAPP_URL=https://your-domainDB_DATABASE,DB_USERNAME,DB_PASSWORD- Mail, file d'attente, cache et tout paramètre tiers API requis par l'application
Si l'application utilise Redis pour le cache, les sessions ou les files d'attente, utilisez l'action Appliquer les paramètres Redis par défaut intégrée avant d'enregistrer.
Sur un site tout juste créé, le dépôt n’a pas encore été cloné. .env.example peut donc manquer à cette étape de l’assistant. Préparez les valeurs à coller manuellement.
Étape 3 — Base de données
Créez la base de données MySQL si l’application Laravel en a besoin.
- Saisissez le nom de la base de données.
- Saisissez le nom de l’utilisateur de la base.
- Définissez un mot de passe fort.
- Reportez les mêmes valeurs dans
.env.
Si le projet n’utilise pas de base de données, vous pouvez ignorer cette étape.
Si la base de données existe déjà sur le serveur, vous pouvez terminer l'assistant d'abord et plus tard utiliser Sites → Bases de données → Joindre pour le lier au site.
Étape 4 — Premier déploiement
Si le dépôt est privé et que l'assistant affiche une clé de déploiement publique :
- Copiez la clé publique affichée dans l’assistant.
- Ouvrez le dépôt sur GitHub.
- Accédez à Settings → Deploy keys → Add deploy key.
- Collez la clé et laissez-la en lecture seule, sauf si vous avez besoin d’un accès en écriture.
Ensuite, cliquez sur Déployez-vous pour cloner le dépôt et exécuter les étapes sélectionnées.
Après le premier déploiement
Les projets Laravel ont souvent besoin de quelques vérifications de suivi après le déploiement initial :
- Exécutez
php artisan key:generatesiAPP_KEYest vide. - Exécutez
php artisan storage:linksi le projet attend le lien symbolique vers le stockage public. - Consultez Sites → Journaux si le déploiement signale des erreurs.
- Consultez Sites → Journaux → Journaux du serveur si Nginx ou PHP-FPM signale des erreurs après le déploiement.
- En cas de problème de configuration au démarrage, consultez Sites → Environnement et Sites → Artisan.
Installation rapide Alternative
Utilisez Sites → Applications → Installation rapide pour WebBlocks CMS ou un squelette Laravel App vierge. WebBlocks CMS génère les identifiants de base de données et configure le CMS ; Laravel App installe uniquement le squelette Laravel pour que des paquets comme QuizTem puissent être installés ensuite via Composer ou le terminal. Les deux parcours écrivent des valeurs sûres dans .env, protègent APP_KEY, vérifient les droits d’écriture en exécution et permettent de relancer une installation échouée après un nettoyage partiel.