Back-office PrestaShop inaccessible : diagnostic et solutions complètes

Introduction

Un back-office PrestaShop qui refuse de s'afficher est l'un des problèmes les plus stressants pour un marchand. Page blanche, formulaire de connexion absent, redirection en boucle… les causes sont multiples et le diagnostic peut sembler complexe. Fort de plus de 10 ans d'interventions sur des boutiques PrestaShop, je vous propose une méthodologie structurée pour identifier et résoudre ce problème, quelle que soit votre version.

Étape 1 : Activer le mode debug

Avant toute manipulation, la première chose à faire est d'activer le mode debug pour obtenir des messages d'erreur exploitables. Sans cela, vous travaillez à l'aveugle.

Sur PrestaShop 1.6

Éditez le fichier config/defines.inc.php et modifiez la ligne suivante :

/* Debug only */
define('_PS_MODE_DEV_', true);

Sur PrestaShop 1.7 et 8.x

Le fichier à modifier est le même, mais vous pouvez également agir sur le fichier .env à la racine (si présent) :

# .env
APP_ENV=dev
APP_DEBUG=1

Ou via config/defines.inc.php :

define('_PS_MODE_DEV_', true);

Une fois le mode debug activé, rechargez la page du back-office. Si une erreur PHP apparaît, elle vous orientera directement vers la cause. Notez le message exact avant de poursuivre.

Important : Désactivez impérativement le mode debug une fois le problème résolu. Laisser _PS_MODE_DEV_ à true en production expose des informations sensibles et dégrade les performances.

Étape 2 : Vider le cache navigateur et PrestaShop

Un cache corrompu est une cause fréquente et sous-estimée de back-office inaccessible.

Cache navigateur

Effectuez un rechargement forcé avec Ctrl + F5 (Windows/Linux) ou Cmd + Shift + R (macOS). Mieux encore, testez en navigation privée pour éliminer toute interférence du cache ou des extensions.

Cache PrestaShop

Supprimez manuellement le contenu des dossiers de cache via FTP ou SSH :

# PrestaShop 1.6
rm -rf var/cache/*
rm -rf cache/smarty/compile/*
rm -rf cache/smarty/cache/*

# PrestaShop 1.7 / 8.x
rm -rf var/cache/prod/*
rm -rf var/cache/dev/*

Ne supprimez pas les dossiers eux-mêmes, uniquement leur contenu. Préservez également les fichiers .htaccess et index.php présents dans ces répertoires.

Étape 3 : Vérifier les permissions des fichiers

Des permissions incorrectes sur le dossier d'administration empêchent le serveur web de lire les fichiers nécessaires.

Diagnostic

Connectez-vous en FTP ou SSH et vérifiez les permissions du dossier admin (celui que vous avez renommé lors de l'installation) :

ls -la /chemin/vers/votre/dossier_admin/

Correction des permissions

Les permissions recommandées pour PrestaShop sont :

# Dossiers : 755
find /chemin/vers/prestashop/dossier_admin/ -type d -exec chmod 755 {} \;

# Fichiers : 644
find /chemin/vers/prestashop/dossier_admin/ -type f -exec chmod 644 {} \;

Note de sécurité : Évitez de mettre les permissions en 777 (lecture, écriture, exécution pour tous). C'est une solution de dépannage temporaire parfois suggérée, mais elle représente une faille de sécurité majeure en production. Si le 755/644 ne fonctionne pas, le problème est ailleurs.

Vérifiez également que le propriétaire des fichiers correspond bien à l'utilisateur du serveur web :

# Apache
chown -R www-data:www-data /chemin/vers/prestashop/dossier_admin/

# Nginx
chown -R nginx:nginx /chemin/vers/prestashop/dossier_admin/

Étape 4 : Problèmes de redirection et d'URL

Si le formulaire de connexion ne s'affiche pas ou si vous êtes redirigé en boucle, le problème vient souvent de la configuration SSL ou des URL enregistrées en base.

Forcer le protocole HTTPS

Si votre boutique utilise un certificat SSL, assurez-vous d'accéder au back-office en HTTPS :

https://votre-boutique.fr/votre_dossier_admin/

Un accès en HTTP alors que SSL est activé provoquera une redirection en boucle ou une page blanche.

Vérifier la configuration en base de données

Si les redirections persistent, vérifiez les URL enregistrées dans la table ps_configuration :

SELECT name, value FROM ps_configuration 
WHERE name IN ('PS_SSL_ENABLED', 'PS_SSL_ENABLED_EVERYWHERE', 'PS_SHOP_DOMAIN', 'PS_SHOP_DOMAIN_SSL');

Corrigez si nécessaire :

UPDATE ps_configuration SET value = '1' WHERE name = 'PS_SSL_ENABLED';
UPDATE ps_configuration SET value = '1' WHERE name = 'PS_SSL_ENABLED_EVERYWHERE';
UPDATE ps_configuration SET value = 'votre-boutique.fr' WHERE name = 'PS_SHOP_DOMAIN';
UPDATE ps_configuration SET value = 'votre-boutique.fr' WHERE name = 'PS_SHOP_DOMAIN_SSL';

Accès direct via token

Si la redirection JavaScript du back-office dysfonctionne, vous pouvez contourner le problème en accédant directement au contrôleur du tableau de bord. Récupérez votre token d'employé en base :

SELECT id_employee, firstname, lastname 
FROM ps_employee WHERE active = 1;

Puis construisez l'URL manuellement :

https://votre-boutique.fr/votre_dossier_admin/index.php?controller=AdminDashboard&token=VOTRE_TOKEN

Le token se trouve dans la table ps_tab croisée avec ps_access pour l'employé concerné.

Étape 5 : Réinstaller les fichiers du back-office

Si aucune des solutions précédentes ne fonctionne, les fichiers du back-office sont peut-être corrompus (mise à jour interrompue, transfert FTP incomplet, module défaillant).

Procédure de réinstallation propre

1. **Sauvegardez** votre dossier admin actuel en le renommant :

mv dossier_admin/ dossier_admin_backup/

1. **Téléchargez** la version exacte de PrestaShop correspondant à votre installation depuis les archives officielles.
1. **Extrayez** uniquement le dossier `admin/` de l'archive téléchargée.
1. **Uploadez** ce dossier sur votre serveur et renommez-le avec votre nom de dossier admin personnalisé.
1. **Testez** l'accès. Si le back-office fonctionne, le problème venait bien de fichiers corrompus.

Attention : Ne remplacez jamais les fichiers config/ ou la base de données. Seul le dossier admin doit être remplacé dans cette procédure. Vos données, modules et thème restent intacts.

Trouver votre version exacte

Si vous ne connaissez plus votre version de PrestaShop :

// Dans config/settings.inc.php (PS 1.6)
define('_PS_VERSION_', '1.6.1.24');

// Dans app/AppKernel.php (PS 1.7+/8.x)
const VERSION = '8.1.3';

Étape 6 : Diagnostics avancés

Inspecter le code source

Utilisez les outils de développement du navigateur (F12 ou clic droit > Inspecter) pour analyser :

• **Onglet Console** : erreurs JavaScript bloquant le rendu de la page de connexion
• **Onglet Réseau** : requêtes en échec (404, 500, redirections 301/302 en boucle)
• **Onglet Éléments** : vérifier que le formulaire HTML est bien présent dans le DOM

Un formulaire de connexion présent dans le code mais invisible peut indiquer un conflit CSS ou JavaScript (souvent causé par un module d'administration tiers).

Vérifier les logs serveur

# Apache
tail -f /var/log/apache2/error.log

# Nginx
tail -f /var/log/nginx/error.log

# PHP-FPM
tail -f /var/log/php-fpm/error.log

Vérifier le fichier .htaccess

Un .htaccess corrompu dans le dossier admin peut bloquer l'accès. Renommez-le temporairement pour tester :

mv dossier_admin/.htaccess dossier_admin/.htaccess.bak

Si le back-office redevient accessible, régénérez un .htaccess propre depuis les paramètres SEO du back-office.

Récapitulatif de la méthodologie

ÉtapeActionTemps estimé 1Activer le mode debug1 min 2Vider les caches2 min 3Vérifier les permissions5 min 4Vérifier URL et SSL5 min 5Réinstaller le dossier admin15 min 6Diagnostics avancésVariable

Suivez ces étapes dans l'ordre : la plupart des problèmes de back-office inaccessible se résolvent aux étapes 1 à 4. La réinstallation du dossier admin est un dernier recours efficace qui n'impacte ni vos données ni votre configuration.