1、作者： Alan Storm翻译：Hailo ng Zhang第一章 Magento 强大的配置系统Magento 的配置系统就像是Magento 的心脏，支撑着 Magento的运行。这套配置系统掌管着几乎所有“module/model /class/template/etc”。它把整个 Magento 系统抽象出来，用一个配置文件来描述。这里的“配置文件”并不是一个物理上存在的文 件，而是 Magento 根据当前的系统状态动态生成的一段XML。大多数的 PHP 开发者并不习惯于这样抽象层，因为它增加的编程的复杂性。但是这样的抽象 提供了无与伦比的灵活性，允许你覆盖几乎任何系统的默认行为。
2、首先，让我们写一个简单的插件来看看这个所谓的“配置文件”长什么样。虽然我已经提供的现成的代码，但是还是建 议你自己建立这个插件，把整个流程走一遍有助于你的理解。设置插件的目录结构我们将要创建一个 Magento的模块【译者注： Magento 的插件不叫 plug-in，叫 module，翻译成模块】。Magento 的模块由 php 和xml 文件组成，目的是扩展或者覆盖系统的行 为，比如为订单增加数据模型，更改一个类的方法，或者增加一个全新的功能。【译者注：Magento 自带的那些功能也都是基于模块的，比如用户注册，商品 展示，结账流程等等。Magento 给我的感觉就是一切皆模块，和
3、Eclipse 的插件体系结构有点像】大多数 Magento的系统模块的结构和我们将要构建的插件的结构是一样的。Magento 的系统模块在以下目录app/code/core/Mage每一个子目录都是一个单独的模块。这些模块是由 Magento 官方开发的。我们安装完Magento 以后，所使用的功能就是来自这些模块。我们自己创建的模块应该放在如下目录app/code/local/Packagename“Packagename”应该是一个唯一的字符串，用来标识你的代码。通常人们使用公司名字作为 Packagename，比如app/code/local/Microsoft由于我在做我自己的 Ma
4、gento 项目，我将使用我自己的域名“Ulovee”。 然后，我们要创建以下目录结构app/code/local/Ulovee/Testmode/Blockapp/code/local/Ulovee/Testmode/controllersapp/code/local/Ulovee/Testmode/etcapp/code/local/Ulovee/Testmode/Helperapp/code/local/Ulovee/Testmode/Modelapp/code/local/Ulovee/Testmode/sql你的插件并不一定需要包含以上所有的目录，但是为了以后开发方便，我们还是在一开
5、始就把目录创建好。接下来我们要创建两个文件，一个是 config.xml，放在 etc目录下面app/code/local/Ulovee/Testmode/etc/config.xml文件内容如下0.1.0第二个文件需要在如下位置创建app/etc/modules/Ulovee_Testmode.xml第二个文件应该遵循如下命名规则“Packagename_Modulename.xml”，文件内容如下truelocal我们先不管这些文件是干什么的，以后会解释。建立好这两个文件以后，你的模块的骨架就已经完成了。Magento 已经知道你的模块存在，但是现在你的模块不会做任何事情。我们来确认一下
6、Magento 确实装载了你的模块1. 清空 Magento 缓存2. 在后台管理界面，进入 System-Configuration-Advanced3. 展开“Disable Modules Output”4. 确认“Ulovee_Testmode”显示出来了如果你看到“Ulovee_Testmode”，那么恭喜你，你已经成功创建了你第一个 Magento 模块！创建模块逻辑我们之前创建的模块不会做任何事情，下面我们来为这个模块加入逻辑 ?1. 检查“showConfig”查询字符串是否存在2. 如果“showConfig”存在，那么检查“showConfigFormat”查询字符串是否存
7、在3. 如果“showConfigFormat”存在，那么输出指定格式的配置信息，否则输出默认格式的配置信息4. 终止执行流程首先更改我们的 config.xml 文件.singleton Ulovee_Testmode_Model_ObservercheckForConfigRequest然后创建如下文件Ulovee/Testmode/Model/Observer.php输入以下内容request = $observer-getEvent()-getData(front)-getRequest();if($this-request-self:FLAG_SHOW_CONFIG = true)$
8、this-setHeader();$this-outputConfig();private function setHeader() $format = isset($this-request-self:FLAG_SHOW_CONFIG_FORMAT) ? $this-request-self:FLAG_SHOW_CONFIG_FORMAT :xml;switch($format)case text:header(“Content-Type: text/plain“);break;default:header(“Content-Type: text/xml“); private functio
9、n outputConfig() die(Mage:app()-getConfig()-getNode()-asXML(); ?好了，代码编辑结束。清空你的 Magento 缓存，输入如下 URLhttp:/ 根据文中的配置，不难看出任何指向 Magento的 URL 加了“?showConfig=true”以后，都会输出同样的内容，正常的执行流程会被终止。】配置文件分析打开上述 URL，你应该看到一个巨大的XML 文件。这个文件描述了当前 Magento 系统的状态。它列出了所有的模块，数据模型，类，事件，监听器等等。举个例子，如果你搜索如下字符串Testmode_Model_Observe
10、r你会发现刚刚你创建的那个类被列出来了。Magento 会解析每个模块的config.xml，并把它们包含在这个全局配置中。这个配置文件有啥用？到目前为止，我们所作的事情似乎没什么意义，但是这个配置文件却是理解 Magento 的关键因素。你创建的每一个模块都会被加到这个配置文件中，任何时候，你需要调用一个系统功能的时候，Magento 都会通过这个配置文件来查询相应的模块和功能。举个简单的例子，如果你懂 MVC 的话，你应该和 “helper class”之类概念的打过交道$helper_salesrule = new Mage_SalesRule_Helper();Magento 抽象了P
11、HP 的类声明方式。在 Magento 系统中，上面的代码等同于$helper_salesrule = Mage:helper(salesrule);Magento 将通过以下逻辑来处理这行代码1. 在配置文件中查找标签2. 在里面查找 标签3. 在里面查找 标签4. 实例化从#3 找到的类（Mage_SalesRule_Helper）Magento 总是通过配置文件来获得类名，这个逻辑看起来有些复杂，但这样做的优点也很明显，我们可以不需要更改 Magento 的代码就能更改 Magento 的核心功能。【译者注： 在这个例子中，我们可以通过修改配置文件用我们自己的 SalesRule_Hel
12、per 类来替换原来那个】这种高度抽象的编程方式在 php中并不常见，但是它可以让你清晰的扩展或者替换系统的某一部分。第二章 Magento 请求分发与控制器Model-View-Controller (MVC) ，模型-视图-控制器，源于 Smalltalk 编程语言和 Xerox Parc。现在有很多系统是基于MVC 架构的，不同的系统MVC 的实现也略有不同，但都体现了MVC 的精髓，分离数据，业务逻辑和显示逻辑。最常见的 PHP MVC 框架是这样的1. URL 请求被一个 PHP 文件拦截，通常称为前端控制器（Front Controller）2. 这个 PHP文件分析这个 URL，
13、获得一个执行控制器（Action Controller）的名字和一个执行方法（Action Method）的名字，这个过程通常称为路由（Routing）3. 实例化#2 获得的执行控制器4. 调用执行控制器的执行方法5. 执行方法中处理业务逻辑，比如获取数据6. 执行控制器负责把数据传递给显示逻辑7. 显示逻辑生成 HTML这个架构相对于传统的“每个 php都是一个页面”来讲已经是一个巨大的飞跃，但还是有人抱怨【译者注： CodeIgniter 就是这样一个 MVC 框架】 前端控制器仍然以全局的方式运行 基于配置的惯例导致了系统不够模块化 o URL Routing 不够灵活o 控制器往往和
14、视图绑定o 更改默认设置往往导致大量的重构Magento 创造了一个更抽象的 MVC 来解决上述问题。1. URL 请求被一个 PHP 拦截2. 这个 PHP文件实例化一个 Magento 对象3. Magento 对象实例化前端控制器4. 前端控制器实例化全局配置中指定的路由对象，可以是多个5. 路由对象会逐个与请求URL 匹配6. 如果发现匹配，那么可以获得一个执行控制器和一个执行方法的名字7. 实例化#6 获得的执行控制器，并调用相应的执行方法8. 执行方法中处理业务逻辑，模型数据9. 控制器实例化布局对象（Layout）10.布局对象根据请求的参数，系统配置创建一个块对象（Block）
15、列表，并实例化11.布局对象会调用块对象的 output 方法生成 HTML。这是一个递归的过程，因为块对象可以嵌套块对象12.每一个块对象都和一个模板文件（Template File）对应。块对象包含了显示逻辑，模板文件包含了 HTML 和 PHP输出代码13.块对象直接从模型那里获得数据，换句话说，在 Magento 的 MVC 架构中，控制器并不直接把数据传给视图这里很复杂，我们以后会详细解释每一个部分。我们先关注“前端控制器-路由对象-执行控制器”部分。Testmode 示例我们讲了太多理论，现在让我们来实践一下，通过实践来加深理解。下面是我们将要做的事情1. 创建一个 Hello W
16、orld模块2. 为这个模块配置路由3. 为这个模块创建执行控制器创建 Testmode模块首先，我们要创建一个模块的目录结构，这个我们以前已经做过了，就不再熬述app/code/local/Ulovee/Testmode/Block app/code/local/Ulovee/Testmode/controllers app/code/local/Ulovee/Testmode/etc app/code/local/Ulovee/Testmode/Helper app/code/local/Ulovee/Testmode/Model app/code/local/Ulovee/Testmod
17、e/sql下面是 config.xml 的内容PATH: app/code/local/Ulovee/Testmode/etc/config.xml0.1.0然后我们要创建一个系统配置文件来激活这个模块PATH: app/etc/modules/Ulovee_Testmode.xmltruelocal最后，让我们检查一下模块是不是已经被激活1. 清空 Magento 缓存2. 在管理后台，进入 System-Configuration-Advanced3. 展开“Disable Modules Output”4. 确认 Ulovee_Testmode 显示出来了配置路由下面，我们要配置一个路由
18、。路由是用来把一个 URL 请求转换成一个执行控制器和方法。和传统的 PHP MVC 不同的是，你需要在Magento 的全局配置中显式的定义你的路由。我们继续上面的例子，在 config.xml 中，添加如下代码.standardUlovee_Testmodetestmode.在这里，我们有很多新名词要解释。什么是？标签指向一个 Magento 区（Area），比如“frontend”就是指网站的前台，“admin”是指网站的后台，“install”是指 Magento 的安装程序。【译者注：这个有点像磁盘分区，区和区之间是相互独立的，但是都归操作系统能够管理，在这里归Magento 管理。
19、默认的 Magento 安装没有“install”这个区，frontend 区接管了，全局配置中的以下代码可以解释这一点.standardMage_Installinstall.】什么是？Phil Karlton 有一句很著名的话“在计算机领域只有两件事是困难的：缓存和命名”。Magento 引入了很多新概念，无疑存在很多命名问题，这里就是一个例子。标签有时候包含的是路由对象的定义，有时候包含的是路径的定义。路由对象是进行路由操作的实体，而路径仅仅是路由对象的一个参数。【译者注： 如果你仔细看过那个全局配置 xml 的话，你会发现有两处地方出现，一处是“ - ”，另外一处是“ - ”。你再仔细
20、看看会发现两处包含的内容不一样。第一处包含的是路由对象的定义，第二处包含 的是路径的定义。】什么是？这个标签的内容应该是一个模块的全名，Packagename_Modulename，在这里是“Ulovee_Testmode”。Magento 用这个名字来定位你的模块文件。什么是？当一个 router 解析一个 URL 的时候，它是按照如下规则进行的http:/ 会把如下的 URL请求交给我们的模块“Ulovee_Testmode”来处理http:/ Controller）混淆起来。它们是两个不同的概念，只跟路由相关。【译者注： 根据我们前面讲过的 Magento 的 MVC流程，前端控制器是用
21、来实例化所有路由的，而这里的“frontName”只是路由过程中的一个参数】什么是 ？这个标签的名字应该是模块名字的小写版本。我们的模块名字是“Testmode”，所以这里我们用“Testmode”。你应该也已经注意 到我们定义的“frontName”也是和我们的模块相匹配的。这是一个不成文的规定，但不是强制要求。事实上，一个模块可以定义多 个，也就是可以有多个“frontName”。为路由创建执行控制器还记得 Magento的 MVC 流程吗？路由会把控制权交给执行控制器。上面我们定义了路由，现在我们来定义我们的执行控制器。首先创建文件app/code/local/Ulovee/Testmo
22、de/controllers/IndexController.php模块的控制器应该放在模块的子目录“controllers”（小写 c）里面。这是规定，Magento 会在这个目录寻找模块的控制器文件。我们的第一个控制器包含以下内容class Ulovee_Testmode_IndexController extends Mage_Core_Controller_Front_Action public function indexAction() echo Hello World!;清空 Magento 缓存，请求如下 URLhttp:/ World”，那么恭喜你，你已经成功创建了你的第一个
23、 Magento控制器！如何命名执行控制器？还记得 config.xml 的标签吗？Ulovee_Testmode执行控制的名字的构成如下1. 以标签的内容开始 （Ulovee_Testmode）2. 紧接一个下划线 （Ulovee_Testmode_）3. 加上我们给控制器取的名字“Index”(Ulovee_Testmode_Index)4. 最后加上关键词“Controller” （Ulovee_Testmode_IndexController）我们自己定义的属于 frontend 区的执行控制器都应该继承 Mage_Core_Controller_Front_Action。URL 里面
24、的 index/index是什么意思？正如前文所述，Magento 默认的路由的规则如下http:/ URLhttp:/ Controller）的名字，第二个“index”是执行方法的名字。对比我们写的执行控制器代码，我们不难发现执行方法的定义是执行方法名字加上 “Action”关键字public function indexAction().Magento 根据命名规则找到执行控制器文件并实例化，然后再根据命名规则调用指定的执行方法。如果 URL没有给出执行控制器名字或者执行方法，Magento 会用默认的“index”来替代，所以下面三个 URL 是等价的http:/ URL如下http:
25、/ 的执行步骤如下1. 查询全局配置，找到 frontName “checkout”对应的模块，Mage_Checkout2. 找到执行控制器 “Mage_Checkout_CartController”3. 调用执行控制器的“addAction”方法进一步理解执行控制器下面我们来为我们的执行控制器添加一个执行方法。添加如下代码到 IndexController.phppublic function goodbyeAction() echo Goodbye World!; 请求 URLhttp:/ World!”。因为我们继承了“Mage_Core_Controller_Front_Actio
26、n”，我们可以使用一些父类已经定义好的方法和变 量。比如父类会把 URL 后面跟的参数转换成 key/value的数组。添加如下代码到我们的执行控制器public function paramsAction() echo ; foreach($this-getRequest()-getParams() as $key=$value) echo Param: .$key.;echo Value: .$value.;echo ;请求如下 URLhttp:/ 的 MVC 架构大概就是这样了。它比传统的PHP MVC 要复杂一点，但是 Magento 的这个高度灵活的 MVC架构能让你创造出几乎所有你
27、能想到的 URL结构。第三章 布局，块和模板我们接着研究 Magento。根据我们第二章讲的 Magento MVC 的架构，我们接下来应该讲模型（Model），但是我们跳过模型先来看布局和块。和一些流行的 PHP MVC 架构不同的是，Magento 的执行控制器不直接将数据传给视图，相反的视图将直接引用模型，从模型取数据。这样的设计就导致了视图被拆分成两部分，块（Block）和模板（Template）。块是 PHP对象，而模板是原始 PHP 文件，混合了 XHTML 和 PHP 代码（也就是把 PHP 作为模板语言 来使用了）。每一个块都和一个唯一的模板文件绑定。在模板文件phtml中，“
28、$this”就是指该模板文件对应块对象。让我们来看一个例子File: app/design/frontend/base/default/template/catalog/product/list.phtml你将看到如下代码getLoadedProductCollection() ?count(): ?_(There are no products matching the selection.) ?这里“getLoadedProductCollection”方法可以在这个模板的块对象“Mage_Catalog_Block_Product_List”中找到File: app/code/core/
29、Mage/Catalog/Block/Product/List.php.public function getLoadedProductCollection()return $this-_getProductCollection(); .块的“_getProductCollection”方法会实例化模型，并读取数据然后返回给模板。嵌套块Magento 把视图分离成块和模板的真正强大之处在于“getChildHtml”方法。这个方法可以让你实现在块中嵌套块的功能。顶层的块调用第二层的块，然后是第三层这就是 Magento如何输出 HTML 的。让我们来看一下单列的顶层模板File: app/de
30、sign/frontend/base/default/template/page/1column.phtmlgetLang() ?“ lang=“getLang() ?“getChildHtml(head) ?getBodyClass()? class=“.$this-getBodyClass().“: ?getChildHtml(after_body_start) ?getChildHtml(global_notices) ?getChildHtml(header) ?getChildHtml(breadcrumbs) ?getChildHtml(global_messages) ?getC
31、hildHtml(content) ?getChildHtml(footer) ?getChildHtml(before_body_end) ?getAbsoluteFooter() ?我们可以看到这个模板里面很多地调用了“$this-getChildHtml()”。每次调用都会引入另外一个块的 HTML 内容，直到最底层的块。布局对象看到这里，你可能有这样的疑问Magento 怎么知道在一个页面上要用那些块？Magento 怎么知道哪一个块是顶层块？“$this-getChildHtml()”里面的参数是什么意思？块的名字吗？Magento 引入了布局对象（Layout Object）来解决上面的那些问题。布局对象（或者说布局文件）就是一个 XML 文件，定义了一个页面包含了哪些块，并且定义了哪个块是顶层块。在第二章的时候我们在执行方法（Action Method）里面直接输出了 HTML 内容。现在我们要为我们的 Testmode 模块创建一个简单的HTML模板。首先我们要创建如下文件app/design/frontend/default/ulovee/layout/local.xml包含以下内容
