Développer une upgrade de module sous Prestashop 1.7 en PHP

La mise à niveau d'un module PrestaShop 1.7 peut s'avérer indispensable si vous avez besoin d'impacter la base de donnée d'un module déjà installé. Dans cet article, nous allons vous montrer comment effectuer cette mise à niveau de manière simple et efficace.

Créez un dossier "upgrade" :

Tout d'abord, à la racine de votre module, s'il n'existe pas déjà, créez un dossier appelé "upgrade". C'est ici que nous placerons le fichier de mise à niveau.

Créez un fichier "install-version.php" :

Dans le dossier "upgrade", créez un fichier portant le nom de la nouvelle version du module, par exemple, "install-1.1.0.php". C'est dans ce fichier que nous spécifierons les actions de mise à niveau.

Exemple de contenu de mise à niveau :

Voici un exemple de contenu pour votre fichier "install-1.1.0.php" :

<?php
if (!defined('_PS_VERSION_')) {    
    exit;
} 

function upgrade_module_1_1_0($module) {    
    $sql = [];   

    $sql[] = 'monSQL';

    foreach ($sql as $query) {         
        if (Db::getInstance()->execute($query) == false) {
            return false;
        }
    }
    return true; 
}

Ajoutez ici les actions nécessaires à la mise à jour de votre module.

Mettez à Jour la version du module :

Dans le fichier principal de votre module, mettez à jour la version du module en modifiant la ligne suivante :

$this->version = '1.1.0';

Mettez à jour le module dans le BO de Prestashop (Back Office) :

Après avoir mis à jour la version dans le fichier PHP, accédez au Back Office de PrestaShop. Vous devriez voir une notification de mise à niveau disponible pour votre module. Suivez les instructions pour appliquer la mise à niveau.

Conclusion :

En suivant ces étapes simples, vous pourrez mettre à jour efficacement votre module PrestaShop 1.7.
Si possible, testez votre montée de version sur un environnement local et sauvegardez votre base de donnée avant la montée de version !