J'ai téléversé le module, mais PrestaShop affiche « Unable to install module. »

L'installation d'un module échoue généralement parce que PrestaShop ne peut pas lire l'archive, ne peut pas écrire les fichiers du module, ou parce que le module ne peut pas fonctionner sur le serveur actuel.

Vérifiez d'abord la structure du ZIP. L'archive doit contenir un seul dossier de module au premier niveau, avec le fichier PHP principal du module à l'intérieur, par exemple mymodule/mymodule.php. Une erreur courante consiste à envoyer un ZIP de type GitHub contenant un dossier enveloppe supplémentaire, un dossier de documentation, ou un dossier de module imbriqué au lieu du vrai répertoire installable du module.

zip=module.zip
unzip -Z1 "$zip" | sed -n '1,20p'
unzip -Z1 "$zip" | awk -F/ 'NF{print $1}' | sort -u
find modules -maxdepth 0 -writable -print
php -v
php -m | grep -Ei '^(zip|curl|dom|fileinfo|json|mbstring|openssl|intl)$'
ls -lt var/logs/* 2>/dev/null | head

• Vérifiez les limites d'upload : la limite effective est contrôlée par upload_max_filesize et post_max_size. Si le ZIP dépasse l'une de ces valeurs, l'upload depuis le back-office peut échouer avant même que PrestaShop n'installe le module.
• Vérifiez les permissions : le répertoire modules/ doit être accessible en écriture par l'utilisateur du serveur web, et les répertoires de cache/logs doivent aussi être inscriptibles.
• Vérifiez la compatibilité PHP : une mauvaise version de PHP ou des extensions PHP manquantes comme zip, curl, dom, fileinfo, json, mbstring, openssl ou intl peuvent casser l'installation ou les écrans de configuration.
• Vérifiez les logs PrestaShop : regardez dans var/logs/, sur la page d'erreur du back-office et dans le log d'erreurs du serveur web/PHP-FPM pour trouver la vraie exception.
• Videz le cache après avoir corrigé une installation échouée, car PrestaShop peut avoir mis en cache une classe de module partiellement chargée.

Si le module apparaît dans la liste des modules mais refuse de s'installer, l'archive a probablement été extraite correctement et l'échec se situe dans la routine d'installation du module. S'il n'apparaît jamais, concentrez-vous d'abord sur la structure du ZIP, les limites d'upload et les permissions du système de fichiers.

Si la routine d'installation échoue après que le dossier a déjà été extrait, supprimez d'abord le module partiellement installé depuis le Module Manager s'il est visible, puis videz var/cache/ avant de réessayer. Si la ligne du module existe dans la base de données mais que le back-office ne peut pas charger la page du module, ne relancez pas l'opération à l'aveugle ; restaurez la sauvegarde des fichiers/de la base de données ou demandez au support de vérifier l'étape install() qui a échoué.

Lorsque vous contactez le support, envoyez le nom et la version du ZIP du module, votre version de PrestaShop, la version de PHP, le texte exact de l'erreur, les dernières lignes de var/logs/prod.log ou var/logs/dev.log, ainsi que l'information indiquant si le dossier du module existe désormais sous modules/. Cela permet au support de savoir si l'échec s'est produit pendant l'envoi/l'extraction ou dans l'installateur propre au module.