Guide d'installation (SSH / Ligne de commande)

Vue d'ensemble

Ce guide couvre l'installation de Larapen via la ligne de commande (SSH) sur un VPS, un serveur dédié ou tout environnement avec accès terminal. C'est la méthode recommandée pour les développeurs et les utilisateurs techniques.

Prérequis

• Accès SSH à votre serveur
• PHP 8.3+ avec les extensions requises installées
• Composer 2.x installé globalement
• Node.js 18+ (pour la compilation des assets via Vite)
• Serveur MySQL 8.0+ en cours d'exécution
• Un serveur web (Apache ou Nginx) configuré
• Le fichier ZIP Larapen depuis CodeCanyon

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

Connectez-vous à MySQL et créez la base de données et l'utilisateur :

mysql -u root -p

CREATE DATABASE larapen CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'larapen_user'@'localhost' IDENTIFIED BY 'votre_mot_de_passe_fort';
GRANT ALL PRIVILEGES ON larapen.* TO 'larapen_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Étape 2 : Téléverser et extraire les fichiers

Transférez le ZIP Larapen sur votre serveur et extrayez-le :

# Téléverser via SCP (depuis votre machine locale)
scp larapen.zip utilisateur@votreserveur:/tmp/

# Sur le serveur, extraire vers la racine web
cd /var/www
unzip /tmp/larapen.zip -d larapen
cd larapen

Étape 3 : Définir les permissions des répertoires

# Définir le propriétaire sur l'utilisateur du serveur web (www-data pour Apache/Nginx sur Ubuntu)
sudo chown -R www-data:www-data /var/www/larapen

# Définir les permissions des répertoires
sudo find /var/www/larapen -type d -exec chmod 755 {} \;
sudo find /var/www/larapen -type f -exec chmod 644 {} \;

# Rendre storage et cache inscriptibles
sudo chmod -R 775 storage bootstrap/cache

Étape 4 : Configurer le serveur web

Apache

Créez une configuration de virtual host :

sudo nano /etc/apache2/sites-available/larapen.conf

<VirtualHost *:80>
    ServerName votredomaine.com
    ServerAlias www.votredomaine.com
    DocumentRoot /var/www/larapen/public

    <Directory /var/www/larapen/public>
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/larapen-error.log
    CustomLog ${APACHE_LOG_DIR}/larapen-access.log combined
</VirtualHost>

# Activer le site et le module rewrite
sudo a2ensite larapen.conf
sudo a2enmod rewrite
sudo systemctl reload apache2

Nginx

Créez une configuration de bloc serveur :

sudo nano /etc/nginx/sites-available/larapen

server {
    listen 80;
    server_name votredomaine.com www.votredomaine.com;
    root /var/www/larapen/public;

    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-Content-Type-Options "nosniff";

    index index.php;
    charset utf-8;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location = /favicon.ico { access_log off; log_not_found off; }
    location = /robots.txt  { access_log off; log_not_found off; }

    error_page 404 /index.php;

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }
}

# Activer le site
sudo ln -s /etc/nginx/sites-available/larapen /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

Étape 5 : 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. Suivez les étapes de l'assistant : vérification des prérequis, vérification des permissions, configuration de la base de données, création du compte administrateur et paramètres du site.
4. Cliquez sur « Installer » et attendez la fin du processus.

Étape 6 : Configurer le SSL

# Installer Certbot (si pas déjà installé)
sudo apt install certbot python3-certbot-apache   # pour Apache
# OU
sudo apt install certbot python3-certbot-nginx     # pour Nginx

# Obtenir et installer le certificat SSL
sudo certbot --apache -d votredomaine.com -d www.votredomaine.com
# OU
sudo certbot --nginx -d votredomaine.com -d www.votredomaine.com

Mettez à jour APP_URL dans .env pour utiliser https://.

Étape 7 : Configurer la tâche cron

sudo crontab -e -u www-data

Ajoutez cette ligne :

* * * * * cd /var/www/larapen && php artisan schedule:run >> /dev/null 2>&1

Étape 8 : Optimiser pour la production

# Mettre en cache la configuration, les routes et les vues
php artisan config:cache
php artisan route:cache
php artisan view:cache

# Optionnel : configurer le worker de file d'attente (pour les tâches en arrière-plan)
php artisan queue:work --daemon

Étape 9 : Vérifier l'installation

• Visitez https://votredomaine.com — votre site web devrait s'afficher.
• Visitez https://votredomaine.com/admin — connectez-vous avec vos identifiants administrateur.