解剖配置脚本
让我们来分析一下上面的代码。【译者注:作者在文中混用了“install script”,“upgrade script”和“setup script”。我在翻译的时候尽量分清。配置脚本包含了安装脚本和升级脚本。】先看第一行
这个“$this”是什么呢?每一个配置脚本都是属于某个资源配置类(Setup Resource class),比如上面我们创建的“Zhlmmc_Helloworld_Model_Setup_Mysql4_Setup”。这些脚本都是在这个资源 配置类的上下文环境中运行的。所以“$this”就是指资源配置类的实例。虽然不是强制的,但是大多数核心模块的资源配置类都用“$installer” 来代替“$this”,就和我们这里做的一样。虽然我们说不是强制的,但是我们最好还是遵守这个约定,除非你有一个很好的理由。
接下来看下面两个调用
$installer->startSetup();
//…
$installer->endSetup();
如果你打开“Mage_Core_Model_Resource_Setup”类(也就是我们创建的资源配置类的父类)的源码,你将会看到这两个方法做了一些SQL准备工作
public function startSetup()
{
$this->_conn->multi_query("SET SQL_MODE='';
SET @OLD_FOREIGN_KEY_CHECKS=@@FOREIGN_KEY_CHECKS, FOREIGN_KEY_CHECKS=0;
SET @OLD_SQL_MODE=@@SQL_MODE, SQL_MODE='NO_AUTO_VALUE_ON_ZERO';
");
return $this;
}
public function endSetup()
{
$this->_conn->multi_query("
SET SQL_MODE=IFNULL(@OLD_SQL_MODE,'');
SET FOREIGN_KEY_CHECKS=IFNULL(@OLD_FOREIGN_KEY_CHECKS,0);
");
return $this;
}
真正的配置逻辑是在“run”方法中
这个方法的参数就是你要运行的SQL。你可以包含任意数量的SQL,用分号隔开。你可能注意到了以下语句
$installer->getTable('helloworld/blogpost')
【译者注:你的第一反应是什么?是不是联想到config.xml里面下面这段代码?
<helloworld_mysql4>
<class>Zhlmmc_Helloworld_Model_Resource_Mysql4</class>
<entities>
<blogpost>
<table>blog_posts</table>
</blogpost>
</entities>
</helloworld_mysql4>
这里“helloworld/blogpost”就是我们要创建的数据表的URI。Magento先用“helloworld”找到模块,得到资源模块 “helloworld_mysql4”,然后在资源模块下面通过“blogpost”找到类名“blog_posts”。】很显然,你可以用常量 “blog_posts”来代替调用“getTable”,但是调用这个方法可以保证即使用户更改了配置文件中的数据表名字,你的配置脚本依然能运行。 “Mage_Core_Model_Resource_Setup”类有很多类似这样的帮助函数。学习这些函数最好的方法就是阅读Magento核心模块 的资源配置类代码。
模块升级脚本
上面我们说过配置脚本包括安装脚本和升级脚本。讲完了安装脚本,我们来讲升级脚本。安装脚本是在第一次安装模块的时候使用的,而升级脚本顾名思义就是在升级模块的时候使用。Magento的资源配置系统使用了版本化的方式来升级模块。
首先要说明的是,在安装模块的时候Magento会执行一次安装脚本,然后Magento再也不会为该模块执行任何安装脚本了。如果你要更新模块的数据表就要通过升级脚本来执行。除了命名方式以外,升级脚本和安装脚本并没有太大的不同。
创建升级脚本如下
File: app/code/local/Zhlmmc/Helloworld/sql/helloworld_setup/mysql4-upgrade-0.1.0-0.2.0.php
echo 'Testing our upgrade script (mysql4-upgrade-0.1.0-0.2.0.php) and halting execution to avoid updating the system version number ';
die();
升级脚本和安装脚本是放在相同目录下面的,但是命名方式不同。首先是“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的版本号,那么执行该脚本。
- 循环队列结束,升级结束
值得注意的是第10步,每次执行一个升级脚本,“core_resource”数据表中的版本号都会被更新。所以如果我们有两个升级文件“0.1.0-0.1.5”和“0.1.0-0.2.0”,只有一个升级文件会被执行。
】
下面我们来为升级脚本添加实质内容
$installer = $this;
$installer->startSetup();
$installer->run("
ALTER TABLE `{$installer->getTable('helloworld/blogpost')}`
CHANGE post post text not null;
");
$installer->endSetup();
清空Magento缓存,刷新页面,你应该看到升级脚本的输出。如果没有,请你对照上面讲的Magento升级的步骤查找错误。
总结
这一章我们讲解了Magento是如何处理模块数据表的安装和升级的。Magento的资源配置系统使用版本化的升级脚本,这样就保证了不同版本的 模块可以使用同一套的升级脚本,便于维护。我们后面的章节也会提到这种升级方式的优点,特别是对于使用EAV模型的模块来说,这个优点更为明显。