Guide d'installation (cPanel / Hébergement mutualisé)

Vue d'ensemble

Ce guide vous accompagne dans l'installation de Larapen sur un hébergement mutualisé utilisant cPanel (ou des panneaux similaires comme Plesk, DirectAdmin, etc.). Aucune connaissance de la ligne de commande n'est requise.

Ce dont vous avez besoin

• Un compte d'hébergement avec accès cPanel (ou équivalent)
• Un nom de domaine pointé vers votre serveur d'hébergement
• Le fichier ZIP de Larapen téléchargé depuis CodeCanyon
• Votre code d'achat CodeCanyon (disponible dans Téléchargements → Certificat de licence)

Étape 1 : Créer une base de données

1. Connectez-vous à votre cPanel.
2. Allez dans Bases de données → Bases de données MySQL.
3. Dans « Créer une nouvelle base de données », entrez un nom (par ex. larapen) et cliquez sur Créer.
4. Dans « Utilisateurs MySQL → Ajouter un utilisateur », créez un utilisateur avec un mot de passe fort. Notez le nom d'utilisateur et le mot de passe.
5. Dans « Ajouter un utilisateur à une base de données », sélectionnez l'utilisateur et la base de données que vous venez de créer, puis cliquez sur Ajouter.
6. Sur l'écran des privilèges, cochez « TOUS LES PRIVILÈGES » et cliquez sur Enregistrer les modifications.

Étape 2 : Téléverser les fichiers

1. Décompressez le fichier téléchargé depuis CodeCanyon sur votre ordinateur.
2. Téléversez le contenu du dossier Larapen vers la racine de votre serveur, généralement public_html/ pour votre domaine principal.

Configuration de la racine documentaire

Larapen, comme toutes les applications Laravel, sert les fichiers depuis le répertoire public/. Deux approches sont possibles :

Option A : Définir la racine documentaire sur public/ (recommandé)

Dans cPanel → Domaines (ou Domaines additionnels / Sous-domaines), définissez la racine documentaire sur public_html/public. C'est l'option la plus sécurisée.

Option B : Utiliser le index.php de la racine

Si vous ne pouvez pas modifier la racine documentaire, Larapen inclut un fichier index.php à la racine qui redirige les requêtes vers le répertoire public/. Assurez-vous simplement que votre domaine pointe vers public_html/ et cela fonctionnera automatiquement.

Étape 3 : Lancer l'installateur web

1. Ouvrez votre navigateur et allez à : https://votredomaine.com/install
2. L'assistant d'installation web de Larapen se lancera automatiquement.
3. L'installateur vous guidera à travers :
   • Vérification des prérequis — Vérifie la version PHP et les extensions. Corrigez les éléments en rouge avant de continuer.
   • Vérification des permissions — Vérifie les répertoires inscriptibles. Corrigez les problèmes de permissions via le Gestionnaire de fichiers (clic droit → Modifier les permissions → 775 pour storage/ et bootstrap/cache/).
   • Configuration de la base de données — Entrez vos informations de base de données (hôte, nom, utilisateur, mot de passe).
   • Compte administrateur — Créez votre nom d'utilisateur, email et mot de passe administrateur.
   • Paramètres du site — Définissez le nom de votre site, la langue par défaut et la configuration de base.
4. Cliquez sur « Installer » et attendez la fin du processus.
5. Une fois terminé, vous verrez un message de succès avec un lien vers votre panneau d'administration.

Étape 4 : Vérifier l'installation

• Visitez https://votredomaine.com — la page d'accueil de votre site devrait s'afficher.
• Visitez https://votredomaine.com/admin — connectez-vous avec les identifiants administrateur créés pendant l'installation.
• Allez dans Paramètres → Informations système pour confirmer que toutes les exigences sont satisfaites.

Étape 5 : Configurer le SSL (si ce n'est pas déjà fait)

Si votre site n'a pas encore le HTTPS :

1. Dans cPanel, allez dans Sécurité → SSL/TLS ou Let's Encrypt SSL.
2. Émettez un certificat gratuit pour votre domaine.
3. Mettez à jour APP_URL dans votre fichier .env pour utiliser https://.

Étape 6 : Configurer la tâche cron

Larapen nécessite une tâche planifiée (cron job) pour les tâches en arrière-plan comme l'envoi d'emails en file d'attente et le nettoyage des fichiers temporaires.

1. Dans cPanel, allez dans Avancé → Tâches Cron.
2. Définissez l'intervalle sur « Une fois par minute » (* * * * *).
3. Entrez cette commande :

cd /home/votrecompte/public_html && php artisan schedule:run >> /dev/null 2>&1

Remplacez /home/votrecompte/public_html par le chemin réel vers votre installation Larapen.

Problèmes courants lors de l'installation

Page blanche ou erreur 500

• Vérifiez que le fichier .env existe et est correctement configuré.
• Assurez-vous que storage/ et bootstrap/cache/ sont inscriptibles (permissions 775).
• Consultez le journal d'erreurs dans storage/logs/laravel.log.

« SQLSTATE[HY000] [1045] Access denied »

• Vérifiez vos identifiants de base de données dans l'installateur.
• Assurez-vous que l'utilisateur de la base de données a les privilèges sur la base de données (étape 1).
• N'oubliez pas d'utiliser le nom complet avec le préfixe cPanel (par ex. moncompte_larapen).

L'installateur n'apparaît pas

• Naviguez directement vers https://votredomaine.com/install.
• Videz le cache de votre navigateur et réessayez.
• Si le site se charge mais affiche une autre page, la racine documentaire ne pointe peut-être pas vers le bon répertoire.