Erreur 503 sur PrestaShop

Problème 1 : Cache Smarty corrompu

Le cache Smarty est la cause n°1 des 503 sur PrestaShop. Un fichier corrompu et tout le front-end plante.

Diagnostic

# Erreurs Smarty dans les logs
$ grep -i "smarty" /var/log/php8.2-fpm.log | tail -20

# Exemples d'erreurs
Smarty error: unable to write to $compile_dir '/var/www/prestashop/var/cache/prod/smarty/compile'
Fatal error: Uncaught SmartyCompilerException: Syntax error in template

Solutions

Solution 1 : Vider le cache en ligne de commande (recommandé)

# PrestaShop 1.7+ / 8.x
$ cd /var/www/prestashop

# Vider tout le cache
$ rm -rf var/cache/prod/* var/cache/dev/*

# Régénérer
$ php bin/console cache:clear --env=prod
$ php bin/console cache:warmup --env=prod

Solution 2 : Vider uniquement Smarty

# Cache Smarty spécifiquement
$ rm -rf var/cache/prod/smarty/cache/*
$ rm -rf var/cache/prod/smarty/compile/*

Solution 3 : Via le back-office (si accessible)

Paramètres avancés > Performances > Vider le cache

Solution 4 : Script de nettoyage automatique

#!/bin/bash
# Script de nettoyage cache PrestaShop

PRESTA_DIR="/var/www/prestashop"
cd $PRESTA_DIR

echo "🧹 Nettoyage du cache PrestaShop..."

# Supprimer les caches
rm -rf var/cache/prod/*
rm -rf var/cache/dev/*

# Régénérer (optionnel, se fait au premier accès)
# php bin/console cache:clear --env=prod --no-warmup

# Permissions
chown -R www-data:www-data var/cache/

echo "✅ Cache vidé !"

Configuration optimale du cache Smarty

Cache de template : Oui (Recompiler si les fichiers ont été mis à jour)
Cache : Système de fichiers (ou Memcached/Redis si disponible)
Ne jamais recompiler les fichiers de template : NON en dev, OUI en prod stable

Problème 3 : Surcharge au checkout

Le tunnel de commande est critique : c’est là que l’argent entre. C’est aussi la partie la plus complexe.

Diagnostic

# Requêtes vers le checkout dans les logs
$ grep -E "(cart|order|checkout)" /var/log/nginx/access.log | tail -50

# Temps de réponse des pages checkout
$ grep "POST /commande" /var/log/nginx/access.log | awk '{print $NF}' | sort -n | tail -20
# Le dernier champ est souvent le temps de réponse

# Erreurs spécifiques checkout
$ grep -i "carrier\|payment\|cart" /var/log/php8.2-fpm.log | tail -30

Causes et solutions

Cause 1 : Calcul des frais de port trop lent

Les modules de transporteurs font souvent des appels API en temps réel.

<?php
// Dans un override ou module custom
// Cacher les tarifs transporteurs pendant 1h

class Carrier extends CarrierCore
{
    public static function getDeliveryPriceByWeight($id_carrier, $total_weight, $id_zone)
    {
        $cache_key = 'carrier_price_' . $id_carrier . '_' . $total_weight . '_' . $id_zone;
        
        if (Cache::isStored($cache_key)) {
            return Cache::retrieve($cache_key);
        }
        
        $price = parent::getDeliveryPriceByWeight($id_carrier, $total_weight, $id_zone);
        Cache::store($cache_key, $price);
        
        return $price;
    }
}

Cause 2 : Module de paiement qui timeout

# Vérifier les timeouts dans les logs
$ grep -i "timeout\|timed out" /var/log/php8.2-fpm.log | tail -20

Solution : Augmenter les timeouts pour les appels de paiement :

<?php
// Dans le module de paiement, augmenter le timeout
curl_setopt($ch, CURLOPT_TIMEOUT, 30);  // 30 secondes au lieu de 10
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);

Cause 3 : Trop de hooks sur le checkout

$ mysql -u prestashop -p prestashop_db

# Voir les hooks les plus chargés
mysql> SELECT h.name, COUNT(hm.id_module) as nb_modules 
       FROM ps_hook h 
       JOIN ps_hook_module hm ON h.id_hook = hm.id_hook 
       GROUP BY h.id_hook 
       ORDER BY nb_modules DESC 
       LIMIT 20;

# Hooks critiques pour le checkout
# displayPayment, displayPaymentReturn, actionValidateOrder

Solution : Désactiver les modules non essentiels sur les hooks du checkout.

Cause 4 : Stock recalculé à chaque action

Sur les gros catalogues, le recalcul de stock peut être lourd.

Permettre la commande de produits hors stock : Selon votre business
Activer la gestion des stocks : Oui
Nombre de jours pour considérer un produit "nouveau" : 20 (pas trop élevé)

Problème 5 : Overrides en conflit

Le système d’overrides de PrestaShop est puissant mais dangereux : chaque module peut surcharger les classes core, créant des conflits.

Diagnostic

# Lister les overrides
$ ls -la /var/www/prestashop/override/classes/
$ ls -la /var/www/prestashop/override/controllers/

# Chercher les conflits dans les logs
$ grep -i "cannot redeclare\|already defined" /var/log/php8.2-fpm.log

# Voir quel module a installé quel override
$ grep -r "install.*override" /var/www/prestashop/modules/*/

Solutions

Solution 1 : Désactiver temporairement tous les overrides

# Renommer le dossier override
$ mv override override_backup

# Vider le cache
$ rm -rf var/cache/prod/*

# Régénérer le class index
$ php bin/console prestashop:cache:clear

Solution 2 : Identifier l’override problématique

# Comparer avec un PrestaShop propre
$ diff -r override/ /chemin/vers/prestashop-propre/override/

# Vérifier la date de modification des fichiers
$ ls -lat override/classes/*.php | head -10

Solution 3 : Régénérer le class index

# Supprimer le fichier d'index
$ rm var/cache/prod/class_index.php
$ rm var/cache/dev/class_index.php

# Il sera régénéré automatiquement

Solution 4 : Identifier les modules avec overrides

<?php
// Lister les modules qui utilisent des overrides
// Exécuter : php detect_overrides.php

$modules_dir = '/var/www/prestashop/modules/';

foreach (scandir($modules_dir) as $module) {
    if ($module == '.' || $module == '..') continue;
    
    $override_dir = $modules_dir . $module . '/override/';
    if (is_dir($override_dir)) {
        echo "Module: $module
";
        foreach (glob($override_dir . '*/*.php', GLOB_BRACE) as $file) {
            echo "  - " . str_replace($override_dir, '', $file) . "
";
        }
    }
}

Problème 7 : Limite mémoire PHP

Diagnostic

# Limite actuelle
$ php -i | grep memory_limit

# Erreurs mémoire
$ grep -i "memory" /var/log/php8.2-fpm.log | tail -20
PHP Fatal error: Allowed memory size of 134217728 bytes exhausted

Solutions

Solution 1 : Augmenter dans php.ini

; PrestaShop recommande 256M minimum, 512M pour gros catalogues
memory_limit = 512M
max_execution_time = 300
max_input_vars = 10000
post_max_size = 64M
upload_max_file_size = 64M

Solution 2 : Configuration dans PrestaShop

<?php
// Ajouter en haut du fichier
@ini_set('memory_limit', '512M');
@ini_set('max_execution_time', '300');

Solution 3 : Dans .htaccess (Apache)

# Après la section PrestaShop
php_value memory_limit 512M
php_value max_execution_time 300
php_value max_input_vars 10000

Optimiser la consommation mémoire

Combiner, Compresser et mettre en Cache (CCC) : Activer
Smart cache for CSS : Oui
Smart cache for JavaScript : Oui
Optimisation Apache : Oui

# Limiter le nombre de produits en listing
# Administration > Paramètres boutique > Produits
# "Nombre de produits affichés par page" : 12-20 (pas 100)

Commandes console PrestaShop essentielles

# === CACHE ===

# Vider tout le cache
$ php bin/console cache:clear --env=prod

# Préchauffer le cache
$ php bin/console cache:warmup --env=prod

# === DEBUG ===

# Activer le mode debug (temporairement)
$ php bin/console prestashop:debug:mode on

# Désactiver le mode debug
$ php bin/console prestashop:debug:mode off

# === BASE DE DONNÉES ===

# Vérifier l'intégrité
$ php bin/console prestashop:db:check

# Mettre à jour la base (après MAJ)
$ php bin/console prestashop:db:upgrade

# === MODULES ===

# Lister les modules
$ php bin/console prestashop:module:list

# Installer un module
$ php bin/console prestashop:module:install monmodule

# Désinstaller un module
$ php bin/console prestashop:module:uninstall monmodule

# === THÈME ===

# Réinitialiser le thème
$ php bin/console prestashop:theme:reset votre-theme

# === GÉNÉRATION ===

# Régénérer les miniatures
$ php bin/console prestashop:image:regenerate

# Réindexer les produits
$ php bin/console prestashop:index:all

# === MAINTENANCE ===

# Activer la maintenance
$ php bin/console prestashop:shop:maintain on

# Désactiver la maintenance
$ php bin/console prestashop:shop:maintain off