Magento模块开发手册（六）Magento模型启动资源



在所有快节奏开发部署的项目里，保持开发环境与生产环境的数据库同步是一件非常头疼的事情。Magento内置了版本资源移植脚本，能够帮助开发团队在开发过程中很好的解决这个问题。

在Magento模型与ORM基础一 文中，我们为Weblog模块创建了一个模型，因为演示目的，当时手动创建的数据库。这次，我们为模型创建一个启动资源(Setup Resource)，让Magento自动创建表。接下来，我们还会创建一个升级安装资源脚本，从而实现模型的自动升级。本节介绍的内容大概分为以下几 步。

1. 添加启动资源配置文件
2. 创建启动资源类文件
3. 创建安装脚本
4. 创建升级脚本

添加启动资源

继续使用上一篇教程中创建的weblog模块。在<resources />节点中，添加下列配置文件

<global> <!-- ... --> <resources> <weblog_setup> <setup> <module>Magentotutorial_Weblog</module> <class>Magentotutorial_Weblog_Model_Resource_Setup</class> </setup> </weblog_setup> </resources> <!-- ... --> </global>

1 2 3 4 5 6 7 8 9 10 11 12

< global >      < ! -- . . . -- >      < resources >          < weblog_setup >              < setup >                  < module > Magentotutorial_Weblog < / module >                  < class > Magentotutorial_Weblog_Model_Resource_Setup < / class >              < / setup >          < / weblog_setup >      < / resources >      < ! -- . . . -- > < / global >

 

<weblog_setup>标签将被用来唯一标识此安装程序资源。这是一种模式，并不是必需的 。Magento建议该命名使用”modelname_setup”的格式。 <module>Magentotutorial_Weblog</module> 标签应该包含你的模块的Packagename_Modulename。 最后,<class>Magentotutorial_Weblog_Model_Resource_Setup</class>指定我们为该模块创建的启动资源类名。对于简单的启动资源脚本，我们不需要创建自定义的类文件，当然应用自定义的启动资源脚本，更灵活，更易于扩展。

将上述部分的配置后，清空Magento缓存，并尝试加载你的Magento网站的任何页面。你会看到一个异常类似

Fatal error: Class 'Magentotutorial_Weblog_Model_Resource_Setup' not found in

1	Fatal error : Class 'Magentotutorial_Weblog_Model_Resource_Setup' not found in

Magento试图实例化我们刚刚在配置文件中指定的启动资源类，系统提示无法找到该类。我们在如下路径创建该文件。

文件: app/code/local/Magentotutorial/Weblog/Model/Resource/Setup.php

class Magentotutorial_Weblog_Model_Resource_Mysql4_Setup extends Mage_Core_Model_Resource_Setup { }

1 2	class Magentotutorial_Weblog_Model_Resource_Mysql4_Setup extends Mage_Core_Model_Resource_Setup { }

完成之后，重新刷新页面，页面就能够正常显示了。到这里，启动资源配置文件初步完成。

创建安装脚本

接下来，开始创建安装脚本。该脚本会包含CREATE TABLE或其他SQL代码，用来初始化该模块。

首先，回忆下config.xml文件

<modules> <Magentotutorial_Weblog> <version>0.1.0</version> </Magentotutorial_Weblog> </modules>

1 2 3 4 5

< modules >      < Magentotutorial_Weblog >          < version > 0.1.0 < / version >      < / Magentotutorial_Weblog > < / modules >

这部分是所有配置文件必须的，用来识别一个模块的版本号。安装脚本的命名就需要依据此版本号。我们假设当前weblog模块的版本号为0.1.0。

在以下位置创建以下文件

文件: app/code/local/Magentotutorial/Weblog/sql/weblog_setup/mysql4-install-0.1.0.php

echo 'Running This Upgrade: '.get_class($this)."\n <br /> \n"; die("Exit for now");

1 2	echo 'Running This Upgrade: ' . get_class ( $ this ) . "\n <br /> \n" ; die ( "Exit for now" ) ;

上述路径的weblog_setup部分必须匹配在配置文件中设置的<weblog_setup>标签。0.1.0匹配的是在模块中填写的<version>版本号。清空Magento缓存，访问任意页面，会看到如下内容

Running This Upgrade: Magentotutorial_Weblog_Model_Resource_Setup Exit for now ...

1 2 3

Running This Upgrade : Magentotutorial_Weblog_Model_Resource_Setup Exit for now . . .

这意味着安装脚本正常运行了。这里为了演示目的，没有加入SQL代码，我们只专注于安装机制本身。现在移除die()语句，保留以下部分。

echo 'Running This Upgrade: '.get_class($this)."\n <br /> \n";

1	echo 'Running This Upgrade: ' . get_class ( $ this ) . "\n <br /> \n" ;

刷新页面，页面会显示升级成功的消息。再次刷新，就会显示正常页面了。