Vue d'ensemble
Avant d'installer Larapen, assurez-vous que votre serveur répond aux exigences suivantes. Celles-ci s'appliquent à tous les environnements d'hébergement — hébergement mutualisé, VPS et serveurs dédiés.
Exigences du serveur
| Exigence | Minimum | Recommandé |
|---|---|---|
| PHP | 8.3 | 8.3 ou 8.4 |
| MySQL | 8.0 | 8.0+ |
| Node.js | 18 | 18+ (pour la compilation des assets via Vite) |
| Composer | 2.0 | 2.0+ |
| Serveur Web | Apache 2.4 ou Nginx 1.18 | Apache 2.4+ ou Nginx 1.22+ |
| Espace disque | 200 Mo (application seule) | 1 Go+ (avec les médias téléversés) |
| RAM | 512 Mo | 1 Go+ |
Extensions PHP requises
Les extensions PHP suivantes doivent être activées sur votre serveur :
| Extension | Utilité |
|---|---|
BCMath | Mathématiques de précision arbitraire |
Ctype | Vérification du type de caractères |
cURL | Requêtes HTTP (appels API, GeoIP, etc.) |
DOM | Analyse XML/HTML |
Fileinfo | Détection du type MIME des fichiers |
GD ou Imagick | Traitement d'images (miniatures, redimensionnement) |
JSON | Encodage/décodage JSON |
Mbstring | Gestion des chaînes multi-octets (UTF-8) |
OpenSSL | Chiffrement et connexions sécurisées |
PDO | Abstraction d'accès à la base de données |
PDO_MySQL | Pilote de base de données MySQL |
Tokenizer | Tokenisation PHP (templates Blade) |
XML | Analyse XML |
Zip | Gestion des archives ZIP |
Extensions PHP optionnelles
| Extension | Utilité |
|---|---|
Intl | Support d'internationalisation (recommandé pour le multilingue) |
Redis | Pilote de cache Redis (meilleures performances) |
Exif | Lecture des métadonnées d'images (orientation des photos) |
Configuration PHP
Assurez-vous que ces paramètres PHP atteignent les valeurs minimales dans votre php.ini :
| Paramètre | Valeur minimale |
|---|---|
memory_limit | 256M |
upload_max_filesize | 64M |
post_max_size | 64M |
max_execution_time | 300 |
max_input_vars | 5000 |
Permissions des répertoires
Le processus du serveur web doit avoir un accès en écriture aux répertoires suivants :
storage/— Journaux de l'application, cache, sessions et stockage de fichiersbootstrap/cache/— Cache du frameworkpublic/— Assets publics (liens symboliques pour les médias et les thèmes)
Permissions recommandées :
- Répertoires :
755 - Fichiers :
644 storage/etbootstrap/cache/:775(inscriptible par le serveur web)
Exigences de la base de données
- MySQL 8.0+ est requis (MariaDB 10.6+ est également supporté).
- Jeu de caractères :
utf8mb4 - Collation :
utf8mb4_unicode_ci - L'utilisateur de la base de données doit avoir tous les privilèges (SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, DROP, INDEX) sur la base de données.
Configuration du serveur web
Apache
Larapen est livré avec un fichier .htaccess dans le répertoire public/. Assurez-vous que :
mod_rewriteest activé.AllowOverride Allest défini pour votre racine documentaire.
Nginx
Définissez la racine documentaire vers le répertoire public et ajoutez ceci à la configuration Nginx de votre site :
root "/path/to/www/public";
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
include fastcgi_params;
}Certificat SSL
Un certificat SSL (HTTPS) est fortement recommandé et requis pour :
- Le traitement des paiements (Stripe et autres passerelles)
- L'accès sécurisé au panneau d'administration
- Un meilleur classement SEO
- La prévention des avertissements de sécurité du navigateur
La plupart des hébergeurs proposent un SSL gratuit via Let's Encrypt.
Vérifier votre serveur
Après l'installation, vous pouvez vérifier que toutes les exigences sont satisfaites depuis le panneau d'administration dans Paramètres → Informations système, qui affiche votre version PHP, les extensions chargées et les permissions des répertoires.