5．Magento资源配置（Setup Resource）

对于任何一个更新频繁的项目来说，保持开发环境和生产环境的数据库同步是件很头疼的事情。Magento提供了一套系统，用版本化的资源迁移脚本来解决这个问题。

上一章，我们为 Helloworld Blogpost 创建了一个模型。我们直接通过SQL语句“CREATE TABLE”来创建数据表。在这一章，我们将为Helloworld模块创建一个资源配置（Setup Resource）用于创建数据表。我们也会创建一个模块升级脚本，用来升级已经安装的模块。
下面是我们要做的步骤：

1)  在配置文件中添加资源配置。
2)  创建资源类文件。
3)  创建安装脚本。
4)  创建升级脚本。
5)  添加资源配置。

5.1 配置资源，修改Helloworld模型的config.xml：

<resources><!-- ... --><helloworld_setup><setup><module>Infinity_Helloworld</module><class> Infinity_Helloworld_Model_Setup_Mysql4_Setup</class></setup><connection><use>core_setup</use></connection></helloworld_setup><!-- ... -->
</resources>

标签是用来唯一标识我们正在创建的资源配置。虽然不是强制要求，但是我们应该使用 “modelname_setup”来命名资源配置。标签的内容是“Packagename_Modulename”。最后，标签的内容就是我们将要创建的资源配置类的类名。虽然对于基本的配置来说，没有必要创建一个单独的资源配置类，但是为了更好的理解资源配置是如何工作的，我们的例子还是创建一个单独的类。

5.2 创建资源类文件：

File: app/code/local/Infinity/Helloworld/Model/Setup/Mysql4/Setup.php
class Infinity_Helloworld_Model_Setup_Mysql4_Setup extends Mage_Core_Model_Resource_Setup {}

5.3 创建安装脚本

下面我们将要创建一个安装脚本。这个安装脚本包含了“CREATE TABLE”等SQL语句。这个脚本将在模块初始化的被运行。首先我们来看一下模块的配置文件：

<modules><Infinity_helloworld><version>0.1.0</version></Infinity_helloworld>
</modules>

这一部分是所有config.xml都必须包含的。它包含了模块的名称，还有版本。我们的安装脚本的名字将基于这个版本号，“0.1.0”。创建以下文件：

File: app/code/local/Infinity/Helloworld/sql/helloworld_setup/mysql4-install-0.1.0.phpecho 'Running This Upgrade: '.get_class($this)."\n   \n";
die("Exit for now");

文件路径中的“helloworld_setup”应该和上文在config.xml中添加的一致。文件名中的“0.1.0”就是模块的版本号。清空Magento缓存，访问任何URL，你应该看到以下内容

Running This Upgrade: Infinity_Helloworld_Model_Setup_Mysql4_Setup
Exit for now
…

这说明我们的安装脚本已经被运行了。我们先不放SQL脚本在这里，先把创建一个资源配置的流程走完。移除“die()”语句，重新装载页面，你应该看到你的Upgrade语句在页面的顶部，再次刷新页面，页面应该正常显示了。

5.4 资源版本

Magento的资源配置系统允许你直接拷贝安装脚本和升级脚本到服务器上，Magento会根据当前模块的版本自动运行相应的脚本。这样你就只需要维护一份数据库迁移脚本。我们先来看看“core_resource”数据表

mysql> select code,version from core_resource; +————————-+————+ | code                    | version    | +————————-+————+ | adminnotification_setup | 1.0.0      | | admin_setup             | 0.7.2      | | alipay_setup            | 0.9.0      | | api_setup               | 0.8.1      | | backup_setup            | 0.7.0      | | bundle_setup            | 0.1.11     | | canonicalurl_setup      | 0.1.0      | | catalogindex_setup      | 0.7.10     | | cataloginventory_setup  | 0.7.5      | | catalogrule_setup       | 0.7.8      | | catalogsearch_setup     | 0.7.7      | | catalog_setup           | 1.4.0.0.21 | | checkout_setup          | 0.9.5      | | chronopay_setup         | 0.1.0      | | cms_setup               | 0.7.13     | | compiler_setup          | 0.1.0      | | contacts_setup          | 0.8.0      | | core_setup              | 0.8.26     | | cron_setup              | 0.7.1      | | customer_setup          | 1.4.0.0.6  | | cybermut_setup          | 0.1.0      | | cybersource_setup       | 0.7.0      | | dataflow_setup          | 0.7.4      | | directory_setup         | 0.8.10     | | downloadable_setup      | 0.1.16     | | eav_setup               | 0.7.15     | | eway_setup              | 0.1.0      | | flo2cash_setup          | 0.1.1      | | giftmessage_setup       | 0.7.2      | | googleanalytics_setup   | 0.1.0      | | googlebase_setup        | 0.1.1      | | googlecheckout_setup    | 0.7.3      | | googleoptimizer_setup   | 0.1.2      | | helloworld_setup        | 0.1.0      | | ideal_setup             | 0.1.0      | | index_setup             | 1.4.0.2    | | log_setup               | 0.7.7      | | moneybookers_setup      | 1.2        | | newsletter_setup        | 0.8.2      | | oscommerce_setup        | 0.8.10     | | paybox_setup            | 0.1.3      | | paygate_setup           | 0.7.1      | | payment_setup           | 0.7.0      | | paypaluk_setup          | 0.7.0      | | paypal_setup            | 0.7.4      | | poll_setup              | 0.7.2      | | productalert_setup      | 0.7.2      | | protx_setup             | 0.1.0      | | rating_setup            | 0.7.2      | | reports_setup           | 0.7.10     | | review_setup            | 0.7.6      | | salesrule_setup         | 0.7.12     | | sales_setup             | 0.9.56     | | sendfriend_setup        | 0.7.4      | | shipping_setup          | 0.7.0      | | sitemap_setup           | 0.7.2      | | strikeiron_setup        | 0.9.1      | | tag_setup               | 0.7.5      | | tax_setup               | 0.7.11     | | usa_setup               | 0.7.1      | | weee_setup              | 0.13       | | widget_setup            | 1.4.0.0.0  | | wishlist_setup          | 0.7.7      | +————————-+————+ 63 rows in set (0.00 sec)

这张表包含了系统中所有安装的模块和模块的版本。你可以看到我们的模块：
| helloworld_setup | 0.1.0 |

Magento就是根据这个版本来判断是否需要运行升级脚本的。这里“helloworld_setup”版本“0.1.0”，而我们的安装脚本也是“0.1.0”，所以Magento不会再运行该脚本。如果你需要重新运行安装脚本（在开发的时候常用到），只要删除表中相应模块的数据就行了。让我们来试试看：

DELETE from core_resource where code = 'helloworld_setup';

这次我们将通过安装脚本来创建数据表，所以我们也要删除之前创建的数据表：

DROP TABLE blog_posts;

添加以下代码到我们的安装脚本：

$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缓存，访问任何URL，你应该发现“blog_posts”表又被建立了，拥有一条数据。

5.5 解剖配置脚本

让我们来分析一下上面的代码，【配置脚本包含了安装脚本和升级脚本】。先看第一行；

$installer = $this;

这个“ $this”是什么呢？每一个配置脚本都是属于某个资源配置类（Setup Resource class），比如上面我们创建的“Infinity_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”方法中：

$installer->run(…);

这个方法的参数就是你要运行的SQL。你可以包含任意数量的SQL，用分号隔开。你可能注意到了以下语句

$installer->getTable('helloworld/blogpost')

【注：你的第一反应是什么？是不是联想到config.xml里面下面这段代码？

<helloworld_mysql4> <class>Infinity_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核心模块的资源配置类代码。

5.6 模块升级脚本

上面我们说过配置脚本包括安装脚本和升级脚本。讲完了安装脚本，我们来讲升级脚本。安装脚本是在第一次安装模块的时候使用的，而升级脚本顾名思义就是在升级模块的时候使用。Magento的资源配置系统使用了版本化的方式来升级模块。

首先要说明的是，在安装模块的时候Magento会执行一次安装脚本，然后Magento再也不会为该模块执行任何安装脚本了。如果你要更新模块的数据表就要通过升级脚本来执行。除了命名方式以外，升级脚本和安装脚本并没有太大的不同。

创建升级脚本如下：

File: app/code/local/Infinity/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> <Infinity_helloworld> <version>0.2.0</version> </Infinity_helloworld> </modules>

清空Magento缓存，重新请求页面，你会看到升级脚本的输出。【注：Magento升级的具体步骤

1）从数据表“core_resource”中获得当前模块的安装版本
2）从配置文件中获得当前模块的版本
3）如果两个版本一样，那么什么都不做
4）如果#2的版本号小于#1的版本号，我也不知道Magento会干什么，理论上是不可能出现的情况
5）如果#2的版本号大于#1的版本号，那么开始升级程序
6）在配置脚本文件夹内（在上面的例子中是“helloworld_setup”）把所有升级脚本加入队列
7）在队列内，按照升级脚本的起始版本排序，升序
8）循环队列
9）如果队列中当前脚本的起始版本不等于“core_resource”数据表中当前模块的版本号，那么跳过该脚本
10）如果队列中当前脚本的起始版本等于“core_resource”数据表中当前模块的
那么执行该脚本。
11）循环队列结束，升级结束

注意的是第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升级的步骤查找错误。

5.7 总结

这一章我们讲解了Magento是如何处理模块数据表的安装和升级的。Magento的资源配置系统使用版本化的升级脚本，这样就保证了不同版本的模块可以使用同一套的升级脚本，便于维护。我们后面的章节也会提到这种升级方式的优点，特别是对于使用EAV模型的模块来说，这个优点更为明显。

5．Magento资源配置（Setup Resource）相关推荐

第五章深入理解Magento – Magento资源配置
2019独角兽企业重金招聘Python工程师标准>>> 对于任何一个更新频繁的项目来说,保持开发环境和生产环境的数据库同步是件很头疼的事情.Magento提供了一套系统,用版本化的资 ...
深入理解Magento – 第五章 – Magento资源配置
深入理解Magento 作者:Alan Storm 翻译:Hailong Zhang 第五章 – Magento资源配置对于任何一个更新频繁的项目来说,保持开发环境和生产环境的数据库同步是件很头疼的 ...
magento 开发 -- 深入理解Magento第五章 – Magento资源配置
第五章 – Magento资源配置对于任何一个更新频繁的项目来说,保持开发环境和生产环境的数据库同步是件很头疼的事情.Magento提供了一套系统,用版本化的资源迁移脚本来解决这个问题. 上一章,我 ...
magento mysql4-install_MAGENTO与表,数据字段的对应关系
配置文件在数据库中的反应 CONFIG.xml与SETUP Setup 在数据库的处理流程 I'm going to stop right here to explain how/when the s ...
Magento开发文档(七):Magento EAV模型
在第一篇介绍Magento ORM的文章中,我们提到过Magento拥有两类模型.普通的模型及Entity Attribute Value(EAV)模型.这里首先搞清楚它们之前的一些关系. 所有的Ma ...
Oracle Resource Manager 概述
官网的链接说明 About Oracle Database Resource Manager http://docs.oracle.com/cd/E11882_01/server.112/e25494 ...
mysql upgrade 报错_mysql_upgrade
关于 mysql_upgrade的搜索结果问题 WDCP面板升级组件脚本及方法坛子里面安装WDCP面板的帖有很多,但WDCP的组件也是老了一些,今天哥就带大家飞. WDCP的Apache原则上是不 ...
Pacemaker详解、pcs命令详解和参数说明、centos8或bclinux8.2离线安装pcs以及搭建pcs、pcs的使用说明
文章目录 Pacemaker详解一.前言二. Pacemaker概述 1.Pacemaker介绍 2.pacemaker的服务模式. 3.Pacemaker的架构 4.Pacemake内部组件三 ...
php function chkinput($x_$y),exit语句php
关于 exit语句php的搜索结果回答 301 重定向是来自服务器端的响应,所以只有通过对服务器进行设置或者通过服务器的脚本语言来实现.以 apache 为例,可以通过配置 .htaccess 文件 ...
Centos7之pacemaker高可用安装配置
目录 1.配置防火墙端口及关闭selinux. 3 2.配置hostname:... 3 3.时间同步(可忽略):... 4 4.双机互信(本次实验发现,不配置双机互信似乎也不会出现问题):... 4 ...

5．Magento资源配置（Setup Resource）

5．Magento资源配置（Setup Resource）相关推荐

最新文章

热门文章