Magento Installer et mettre à niveau les scripts de données expliqués

Scripts d'installation et de mise à niveau dans le développement du module Magento: Assurez-vous que la base de données est correcte

Les scripts d'installation et de mise à niveau Magento sont un composant clé du développement des modules, en particulier pour les modules qui interagissent avec les bases de données. Ces scripts s'exécutent lorsque vous accédez à une URL spécifique et se trouvent dans le répertoire de code du module. Cet article plongera sur la façon d'écrire des scripts d'installation et de mise à niveau de Magento fiables pour éviter les conventions de dénomination courantes, les numéros de version ou les erreurs de syntaxe.

Connaissances préalables: Avant de lire cet article, il est recommandé d'avoir des connaissances de base sur le développement des modules Magento. Lorsque vous installez ou créez un nouveau module qui interagit avec la base de données, vous trouverez des scripts d'installation et de mise à niveau dans le répertoire de code du module qui s'exécute lorsque vous accédez à l'URL. Les modules principaux de Magento suivent également la même structure d'installation et de mise à niveau.

script d'installation:

Afin d'exécuter le script d'installation, nous devons créer un module personnalisé (cet article suppose que vous avez créé un module personnalisé nommé Sitepoint_Articles pour enregistrer tous les articles écrits dans la base de données). Les composants de base d'un module comprennent: blocs, modèles, modèles de ressources, contrôleurs, etc répertoires (y compris les configurations liées au module), les classes auxiliaires et les répertoires sql (y compris la mise à niveau de la base de données et les scripts d'installation).

La structure du répertoire des modules est la suivante:

<code>app
 --code
 ---local
 ----Sitepoint
 ------Articles
 --------Block
  --------controllers
   --------etc
    --------Model
     --------sql</code>

Ouvrez le fichier app/code/local/Sitepoint/Articles/etc dans le répertoire config.xml. Nous devons ajouter une configuration liée à l'emplacement du script d'installation dans ce fichier. Ajoutez les sous-étiquettes suivantes sous la balise <global></global>:

<global>
    <models>
        <sitepoint_articles>
            <class>Sitepoint_Articles_Model</class>
            <resourceModel>articles_mysql4</resourceModel>
        </sitepoint_articles>
        <sitepoint_articles_mysql4>
            <class>Sitepoint_Articles_Model_Mysql4</class>
            <entities>
                <articles>
                    <table>articles</table>
                </articles>
            </entities>
        </sitepoint_articles_mysql4>
    </models>
    <resources>
        <setup>
            <module>Sitepoint_Articles</module>
        </setup>
        <connection>
            <use>core_setup</use>
        </connection>
        <connection>
            <use>core_write</use>
        </connection>
        <connection>
            <use>core_read</use>
        </connection>
    </resources>
</global>

La balise

sous la balise <resources> <setup> indique Magento que notre fichier de paramètres de base de données est situé dans le répertoire articles_setup.

Créez le script d'installation dans le répertoire Articles/sql/articles_setup mysql4-install-0.1.0.php:

<?php
$installer = $this;
$installer->startSetup();
$table = $installer->getConnection()->newTable($installer->getTable('articles'))
    ->addColumn('articles_id', Varien_Db_Ddl_Table::TYPE_INTEGER, 11, array(
        'unsigned' => true,
        'nullable' => false,
        'primary' => true,
        'identity' => true,
        ), 'Article ID')
    // ... 其他列定义 ...
    ->setComment('Articles table');
$installer->getConnection()->createTable($table);
$installer->endSetup();
?>

Le numéro de version

(0.1.0) est le même que le numéro de version défini dans le fichier config.xml. Dans config.xml:

<sitepoint_articles>
    <version>0.1.0</version>
</sitepoint_articles>

Après la configuration du script d'installation, actualisez l'URL Magento et affichez la base de données. Si le script d'installation s'exécute avec succès, votre table doit être créée. Magento vérifie si des scripts d'installation ou de mise à niveau doivent être exécutés en fonction du numéro de version dans le fichier de configuration et la table de base de données. Lorsque la version ne correspond pas, elle recherchera le fichier de version correspondant à exécuter. core_resource

Script de mise à niveau:

Vous pouvez utiliser des scripts de mise à niveau lorsque vous devez mettre à jour des modules (tels que l'ajout de nouveaux champs de base de données ou la modification des schémas de base de données). Le script de mise à niveau est similaire au script d'installation, sauf que le nom et le numéro de version sont différents.

Supposons que nous voulons ajouter une colonne et modifier une autre colonne, créer un script de mise à niveau dans le répertoire

: Articles/sql/articles_setup mysql4-upgrade-0.1.0-0.1.1.php

Mettez à jour le numéro de version dans le fichier

<?php
$installer = $this;
$installer->startSetup();
$installer->getConnection()
    ->changeColumn($installer->getTable('articles'), 'long_desc', 'long_desc', array(
        'type' => Varien_Db_Ddl_Table::TYPE_TEXT,
        'nullable' => true,
    ))
    ->addColumn($installer->getTable('articles'), 'sub_title', array(
        'type' => Varien_Db_Ddl_Table::TYPE_VARCHAR,
        'nullable' => false,
        'comment' => 'Sub title'
    ));
$installer->endSetup();
?>

est 0.1.1:

<code>app
 --code
 ---local
 ----Sitepoint
 ------Articles
 --------Block
  --------controllers
   --------etc
    --------Model
     --------sql</code>

Après avoir rafraîchi l'URL, Magento exécutera le script de mise à niveau et mettra à jour le schéma de base de données.

Résumé:

C'est ainsi que fonctionnent les scripts d'installation et de mise à niveau de Magento. Vous pouvez essayer de créer un nouveau module et d'exécuter ces scripts. Si vous avez des questions, n'hésitez pas à vous demander.

(La partie FAQ du texte d'origine est omise ici parce que la partie FAQ n'a pas grand-chose à voir avec la façon d'écrire le script d'installation et de mise à niveau lui-même, et est un sujet plus large de la mise à niveau de Magento.)

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!