- <resources>
- <featuredcategories_setup>
- <setup>
- <module>SFC_FeaturedCategories</module>
- <class>Mage_Catalog_Model_Resource_Eav_Mysql4_Setup</class>
- </setup>
- <connection>
- <use>core_setup</use>
- </connection>
- </featuredcategories_setup>
- </resources>
- /global>
- <?php
- /* @var $installer Mage_Catalog_Model_Resource_Eav_Mysql4_Setup */
- $installer = $this;
- $installer->startSetup();
- $installer->addAttribute('catalog_category', 'is_featured_category', array(
- 'type' => 'int',
- 'backend' => '',
- 'frontend' => '',
- 'label' => 'Is Category Featured',
- 'input' => 'select',
- 'class' => '',
- 'source' => 'eav/entity_attribute_source_boolean',
- 'global' => Mage_Catalog_Model_Resource_Eav_Attribute::SCOPE_GLOBAL,
- 'visible' => true,
- 'required' => false,
- 'user_defined' => false,
- 'default' => '0',
- 'searchable' => false,
- 'filterable' => false,
- 'comparable' => false,
- 'visible_on_front' => true,
- 'unique' => false,
- ));
- $installer->endSetup();
删除属性rebate
- <?php
- $setup = new Mage_Eav_Model_Entity_Setup('core_setup');
- $setup->removeAttribute('1', 'rebate');
- ?>
创建安装脚本
修改Helloworld模型的config.xml
- <resources>
- <helloworld_setup>
- <setup>
- <module>Zhlmmc_Helloworld</module>
- <class>Zhlmmc_Helloworld_Model_Setup_Mysql4_Setup</class>
- </setup>
- <connection>
- <use>core_setup</use>
- </connection>
- </helloworld_setup>
- </resources>
- </global>
标签是用来唯一标识我们正在创建的资源配置。虽然不是强制要求,但是我们应该使用 “modelname_setup”来命名资源配置。标签的内容是“Packagename_Modulename”。最后,标签的内容就是我们将要创建 的资源配置类的类名。虽然对于基本的配置来说,没有必要创建一个单独的资源配置类,但是为了更好的理解资源配置是如何工作的,我们的例子还是创建一个单独的类
- class Zhlmmc_Helloworld_Model_Setup_Mysql4_Setup extends Mage_Core_Model_Resource_Setup {
- }
下面我们将要创建一个安装脚本。这个安装脚本包含了“CREATE TABLE”等SQL语句。这个脚本将在模块初始化的被运行。首先我们来看一下模块的配置文件
- <modules>
- <zhlmmc_helloworld>
- <version>0.1.0</version>
- </zhlmmc_helloworld>
- </modules>
这一部分是所有config.xml都必须包含的。它包含了模块的名称,还有版本。我们的安装脚本的名字将基于这个版本号,“0.1.0”。创建以下文件
app/code/local/Zhlmmc/Helloworld/sql/helloworld_setup/mysql4-install-0.1.0.php
文件路径中的“helloworld_setup”应该和上文在config.xml中添加的一致。文件名中的“0.1.0”就是模块的版本号
资源版本
Magento的资源配置系统允许你直接拷贝安装脚本和升级脚本到服务器上,Magento会根据当前模块的版本自动运行相应的脚本。这样你就只需要维护一份数据库迁移脚本。我们先来看看“core_resource”数据表
- mysql> select code,version from core_resource;
- +————————-+————+
- | code | version |
- +————————-+————+
- | adminnotification_setup | 1.0.0 |
- | admin_setup | 0.7.2 |
- | helloworld_setup | 0.1.0 |
- DELETE from core_resource where code = 'helloworld_setup';
- <?php
- //echo 'Running This Upgrade: '.get_class($this)."\n";
- //die("Exit for now");
- $installer = $this;
- $installer->startSetup();
- $installer->run("
- CREATE TABLE `{$installer->getTable('helloworld/blogpost')}` (
- `blogpost_id` int(11) NOT NULL auto_increment,
- `title` text,
- `post` text,
- `date` datetime default NULL,
- `timestamp` timestamp NOT NULL default CURRENT_TIMESTAMP,
- PRIMARY KEY (`blogpost_id`)
- ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
- INSERT INTO `{$installer->getTable('helloworld/blogpost')}` VALUES (1,'My New Title','This is a blog post','2009-07-01 00:00:00','2009-07-02 23:12:30');
- ");
- $installer->endSetup();
模块升级脚本
上面我们说过配置脚本包括安装脚本和升级脚本。讲完了安装脚本,我们来讲升级脚本。安装脚本是在第一次安装模块的时候使用的,而升级脚本顾名思义就是在升级模块的时候使用。Magento的资源配置系统使用了版本化的方式来升级模块。
首先要说明的是,在安装模块的时候Magento会执行一次安装脚本,然后Magento再也不会为该模块执行任何安装脚本了。如果你要更新模块的数据表就要通过升级脚本来执行。除了命名方式以外,升级脚本和安装脚本并没有太大的不同。
- app/code/local/Zhlmmc/Helloworld/sql/helloworld_setup/mysql4-upgrade-0.1.0-0.2.0.php
升级脚本和安装脚本是放在相同目录下面的,但是命名方式不同。首先是“upgrade”关键词。其次,你会发现这里我们有两个版本号,用“-”分开。第一 个版本号“0.1.0”是指从哪个版本升级(起始版本),第二个版本号“0.2.0”是指要升级到哪个版本(目标版本)。
清空Magento缓存,请求任何一个URL,你会发现没有任何配置脚本被运行。那是因为,第一,我们已经运行过安装脚本,第二,目前我们模块的版本是 “0.1.0”,所以Magento不会运行我们要升级到“0.2.0”的升级脚本。要让Magento运行这个升级脚本,我们得修改配置文件中的版本号
- <modules>
- <zhlmmc_helloworld>
- <version>0.2.0</version>
- </zhlmmc_helloworld>
- </modules>
清空Magento缓存,重新请求页面,你会看到升级脚本的输出。【译者注:作者在这里引入了第二个升级到“0.1.5”的升级脚本,我觉得并没有必要,我来直接总结一下Magento升级的步骤
- 从数据表“core_resource”中获得当前模块的安装版本
- 从配置文件中获得当前模块的版本
- 如果两个版本一样,那么什么都不做
- 如果#2的版本号小于#1的版本号,我也不知道Magento会干什么,理论上是不可能出现的情况
- 如果#2的版本号大于#1的版本号,那么开始升级程序
- 在配置脚本文件夹内(在上面的例子中是“helloworld_setup”)把所有升级脚本加入队列
- 在队列内,按照升级脚本的起始版本排序,升序
- 循环队列
- 如果队列中当前脚本的起始版本不等于“core_resource”数据表中当前模块的版本号,那么跳过该脚本
- 如果队列中当前脚本的起始版本等于“core_resource”数据表中当前模块的版本号并且目标版本小于等于#2的版本号,那么执行该脚本。
- 循环队列结束,升级结束
- <?php
- //echo 'Running This Upgrade: '.get_class($this)."\n \n";
- //die("Exit for now");
- $installer = $this;
- $installer->startSetup();
- $installer->run("
- ALTER TABLE `{$installer->getTable('helloworld/blogpost')}`
- CHANGE post post text not null;
- ");
- $installer->endSetup();