admin 管理员组文章数量: 1086019
2024年4月18日发(作者：substring函数用法java)
Magento模块开发教程
第一章
Magento
强大的配置系统
Magento的配置系统就像是Magento的心脏，支撑着Magento的运行。这套
配置系统掌管着几乎所有“module/model/class/template/etc”。它把整个
Magento系统抽象出来，用一个配置文件来描述。这里的“配置文件”并不是一
个物理上存在的文件，而是Magento根据当前的系统状态动态生成的一段XML。
大多数的PHP开发者并不习惯于这样抽象层，因为它增加的编程的复杂性。但是
这样的抽象提供了无与伦比的灵活性，允许你覆盖几乎任何系统的默认行为。
首先，让我们写一个简单的插件来看看这个所谓的“配置文件”长什么样。虽然
我已经提供的现成的代码，但是还是建议你自己建立这个插件，把整个流程走一
遍有助于你的理解。
设置插件的目录结构
我们将要创建一个Magento的模块【注：Magento的插件不叫plug-in，叫
module，翻译成模块】。Magento的模块由php和xml文件组成，目的是扩展或
者覆盖系统的行为，比如为订单增加数据模型，更改一个类的方法，或者增加
一个全新的功能。【注：Magento自带的那些功能也都是基于模块的，比如用户
注册，商品展示，结账流程等等。Magento给我的感觉就是一切皆模块，和
Eclipse的插件体系结构有点像】
大多数Magento的系统模块的结构和我们将要构建的插件的结构是一样的。
Magento的系统模块在以下目录
app/code/core/Mage
每一个子目录都是一个单独的模块。这些模块是由Magento官方开发的。我们安
装完Magento以后，所使用的功能就是来自这些模块。我们自己创建的模块应该
放在如下目录
app/code/local/Packagename
“Packagename”应该是一个唯一的字符串，用来标识你的代码。通常人们使用
公司名字作为Packagename，比如
app/code/local/Microsoft
由于我在做我自己的Magento项目，我将使用我自己的域名
“Alanstormdotcom”。然后，我们要创建以下目录结构
app/code/local/Alanstormdotcom/Configviewer/Block
app/code/local/Alanstormdotcom/Configviewer/controllers
app/code/local/Alanstormdotcom/Configviewer/etc
app/code/local/Alanstormdotcom/Configviewer/Helper
app/code/local/Alanstormdotcom/Configviewer/Model
app/code/local/Alanstormdotcom/Configviewer/sql
你的插件并不一定需要包含以上所有的目录，但是为了以后开发方便，我们还是
在一开始就把目录创建好。接下来我们要创建两个文件，一个是，
放在etc目录下面
app/code/local/Alanstormdotcom/Configviewer/etc/
文件内容如下
第二个文件需要在如下位置创建
app/etc/modules/Alanstormdotcom_
第二个文件应该遵循如下命名规则“Packagename_”，文件内容
如下
我们先不管这些文件是干什么的，以后会解释。建立好这两个文件以后，你的模
块的骨架就已经完成了。Magento已经知道你的模块存在，但是现在你的模块不
会做任何事情。我们来确认一下Magento确实装载了你的模块
1.
2.
3.
4.
清空Magento缓存
在后台管理界面，进入System->Configuration->Advanced
展开“DisableModulesOutput”
确认“Alanstormdotcom_Configviewer”显示出来了
如果你看到“Alanstormdotcom_Configviewer”，那么恭喜你，你已经成功创建
了你第一个Magento模块！
创建模块逻辑
我们之前创建的模块不会做任何事情，下面我们来为这个模块加入逻辑
1.检查“showConfig”查询字符串是否存在
2.如果“showConfig”存在，那么检查“showConfigFormat”查询字符串是否存在
3.如果“showConfigFormat”存在，那么输出指定格式的配置信息，否则输出默认格式的配置
信息
4.终止执行流程
首先更改我们的文件
erver
然后创建如下文件
Alanstormdotcom/Configviewer/Model/
输入以下内容
classAlanstormdotcom_Configviewer_Model_Observer{
constFLAG_SHOW_CONFIG='showConfig';
constFLAG_SHOW_CONFIG_FORMAT='showConfigFormat';
private$request;
publicfunctioncheckForConfigRequest($observer){
$this->request=
$observer->getEvent()->getData('front')->getRequest();
if($this->request->{self::FLAG_SHOW_CONFIG}==='true'){
$this->setHeader();
$this->outputConfig();
}
}
privatefunctionsetHeader(){
$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");
}
}
privatefunctionoutputConfig(){
die(Mage::app()->getConfig()->getNode()->asXML());
}
}
?>
好了，代码编辑结束。清空你的Magento缓存，输入如下URL
/?showConfig=true
【注：根据文中的配置，不难看出任何指向Magento的URL加了“?showConfig=true”以后，
都会输出同样的内容，正常的执行流程会被终止。】
配置文件分析
打开上述URL，你应该看到一个巨大的XML文件。这个文件描述了当前
Magento系统的状态。它列出了所有的模块，数据模型，类，事件，监听器等等。
举个例子，如果你搜索如下字符串
Configviewer_Model_Observer
你会发现刚刚你创建的那个类被列出来了。Magento会解析每个模块的
，并把它们包含在这个全局配置中。
这个配置文件有啥用？
到目前为止，我们所作的事情似乎没什么意义，但是这个配置文件却是理
解Magento的关键因素。你创建的每一个模块都会被加到这个配置文件中，任何
时候，你需要调用一个系统功能的时候，Magento都会通过这个配置文件来查
询相应的模块和功能。举个简单的例子，如果你懂MVC的话，你应该和“helper
class”之类概念的打过交道
$helper_salesrule=newMage_SalesRule_Helper();
Magento抽象了PHP的类声明方式。在Magento系统中，上面的代码等同于
$helper_salesrule=Mage::helper('salesrule');
Magento将通过以下逻辑来处理这行代码
1.在配置文件中查找
2.在
3.在
4.实例化从#3找到的类（Mage_SalesRule_Helper）
Magento总是通过配置文件来获得类名，这个逻辑看起来有些复杂，但这样做的
优点也很明显，我们可以不需要更改Magento的代码就能更改Magento的核心功
能。
【注：在这个例子中，我们可以通过修改配置文件用我们自己的
SalesRule_Helper类来替换原来那个】这种高度抽象的编程方式在php中并不
常见，但是它可以让你清晰的扩展或者替换系统的某一部分。
第二章
Magento
请求分发与控制器
Model-View-Controller(MVC)，模型-视图-控制器，源于Smalltalk编程语言
和XeroxParc。现在有很多系统是基于MVC架构的，不同的系统MVC的实现也
略有不同，但都体现了MVC的精髓，分离数据，业务逻辑和显示逻辑。最常见的
PHPMVC框架是这样的
请求被一个PHP文件拦截，通常称为前端控制器（FrontController）
2.这个PHP文件分析这个URL，获得一个执行控制器（ActionController）
的名字和一个执行方法（ActionMethod）的名字，这个过程通常称为路
由（Routing）
3.实例化#2获得的执行控制器
4.调用执行控制器的执行方法
5.执行方法中处理业务逻辑，比如获取数据
6.执行控制器负责把数据传递给显示逻辑
7.显示逻辑生成HTML
这个架构相对于传统的“每个php都是一个页面”来讲已经是一个巨大的飞跃，
但还是有人抱怨【注：CodeIgniter就是这样一个MVC框架】
•
•
前端控制器仍然以全局的方式运行
基于配置的惯例导致了系统不够模块化
URLRouting不够灵活
o
控制器往往和视图绑定
o
更改默认设置往往导致大量的重构
o
Magento创造了一个更抽象的MVC来解决上述问题。
请求被一个PHP拦截
2.这个PHP文件实例化一个Magento对象
o对象实例化前端控制器
4.前端控制器实例化全局配置中指定的路由对象，可以是多个
5.路由对象会逐个与请求URL匹配
6.如果发现匹配，那么可以获得一个执行控制器和一个执行方法的名字
7.实例化#6获得的执行控制器，并调用相应的执行方法
8.执行方法中处理业务逻辑，模型数据
9.控制器实例化布局对象（Layout）
10.布局对象根据请求的参数，系统配置创建一个块对象（Block）列表，并
实例化
11.布局对象会调用块对象的output方法生成HTML。这是一个递归的过程，
因为块对象可以嵌套块对象
12.每一个块对象都和一个模板文件（TemplateFile）对应。块对象包含了
显示逻辑，模板文件包含了HTML和PHP输出代码
13.块对象直接从模型那里获得数据，换句话说，在Magento的MVC架构中，
控制器并不直接把数据传给视图
这里很复杂，我们以后会详细解释每一个部分。我们先关注“前端控制器->路由
对象->执行控制器”部分。
创建magento模块
HelloWorld示例
我们讲了太多理论，现在让我们来实践一下，通过实践来加深理解。下面是我们
将要做的事情
1.创建一个HelloWorld模块
2.为这个模块配置路由
3.为这个模块创建执行控制器
创建HelloWorld模块
首先，我们要创建一个模块的目录结构，这个我们以前已经做过了，就不再熬述
app/code/local/Alanstormdotcom/Helloworld/Block
app/code/local/Alanstormdotcom/Helloworld/controllers
app/code/local/Alanstormdotcom/Helloworld/etc
app/code/local/Alanstormdotcom/Helloworld/Helper
app/code/local/Alanstormdotcom/Helloworld/Model
app/code/local/Alanstormdotcom/Helloworld/sql
下面是的内容
PATH:app/code/local/Alanstormdotcom/Helloworld/etc/
然后我们要创建一个系统配置文件来激活这个模块
PATH:app/etc/modules/Alanstormdotcom_
最后，让我们检查一下模块是不是已经被激活
1.
2.
3.
4.
清空Magento缓存
在管理后台，进入System->Configuration->Advanced
展开“DisableModulesOutput”
确认Alanstormdotcom_Helloworld显示出来了
配置路由
下面，我们要配置一个路由。路由是用来把一个URL请求转换成一个执行控制器
和方法。和传统的PHPMVC不同的是，你需要在Magento的全局配置中显式的定
义你的路由。我们继续上面的例子，在中，添加如下代码
...
...
在这里，我们有很多新名词要解释。
什么是
的前台，“admin”是指网站的后台，“install”是指Magento的安装程序。
【注：这个有点像磁盘分区，区和区之间是相互独立的，但是都归操作系统能够
管理，在这里归Magento管理。默认的Magento安装没有“install”这个区，
frontend区接管了，全局配置中的以下代码可以解释这一点
...
...
】
什么是
PhilKarlton有一句很著名的话“在计算机领域只有两件事是困难的：缓存和
命名”。Magento引入了很多新概念，无疑存在很多命名问题，这里就是一个例
子。
义。路由对象是进行路由操作的实体，而路径仅仅是路由对象的一个参数。【注：
如果你仔细看过那个全局配置xml的话，你会发现有两处地方出现
一处是“
你再仔细看看会发现两处
象的定义，第二处包含的是路径的定义。】
什么是
？
这个标签的内容应该是一个模块的全名，Packagename_Modulename，在这里是
“Alanstormdotcom_Helloworld”。Magento用这个名字来定位你的模块文件。
什么是
当一个router解析一个URL的时候，它是按照如下规则进行的
/frontName/actionControllerName/actionMethod/
所以，当我们在
如下的URL请求交给我们的模块“Alanstormdotcom_Helloworld”来处理
/helloworld/*
有些人容易把
是两个不同的概念，
Magento的MVC流程，前端控制器是用来实例化所有路由的，而这里的
“frontName”只是路由过程中的一个参数】
什么是
？
这个标签的名字应该是模块名字的小写版本。我们的模块名字是
“Helloworld”，所以这里我们用“helloworld”。你应该也已经注意到我们
定义的“frontName”也是和我们的模块相匹配的。这是一个不成文的规定，但
不是强制要求。事实上，一个模块可以定义多个
“frontName”。
为路由创建执行控制器
还记得Magento的MVC流程吗？路由会把控制权交给执行控制器。上面我们定义
了路由，现在我们来定义我们的执行控制器。首先创建文件
app/code/local/Alanstormdotcom/Helloworld/controllers/IndexController.
php
模块的控制器应该放在模块的子目录“controllers”（小写c）里面。这是规
定，Magento会在这个目录寻找模块的控制器文件。我们的第一个控制器包含以
下内容
classAlanstormdotcom_Helloworld_IndexControllerextends
Mage_Core_Controller_Front_Action{
publicfunctionindexAction(){
echo'HelloWorld!';
}
}
清空Magento缓存，请求如下URL
/helloworld/index/index
如果你看到一个空白页面上面写着“HelloWorld”，那么恭喜你，你已经成功
创建了你的第一个Magento控制器！
如何命名执行控制器？
还记得的
执行控制的名字的构成如下
1.
2.
3.
4.
以
紧接一个下划线（Alanstormdotcom_Helloworld_）
加上我们给控制器取的名字“Index”(Alanstormdotcom_Helloworld_Index)
最后加上关键词“Controller”（Alanstormdotcom_Helloworld_IndexController）
我们自己定义的属于frontend区的执行控制器都应该继承
Mage_Core_Controller_Front_Action。
URL里面的index/index是什么意思？
正如前文所述，Magento默认的路由的规则如下
/frontName/actionControllerName/actionMethod/
所以在我们请求的URL
/helloworld/index/index
其中“helloworld”是“frontName”，第一个“index”是执行控制器（Action
Controller）的名字，第二个“index”是执行方法的名字。对比我们写的执行
控制器代码，我们不难发现执行方法的定义是执行方法名字加上“Action”关
键字
publicfunctionindexAction(){...}
Magento根据命名规则找到执行控制器文件并实例化，然后再根据命名规则调用
指定的执行方法。如果URL没有给出执行控制器名字或者执行方法，Magento会
用默认的“index”来替代，所以下面三个URL是等价的
/helloworld/index/index
/helloworld/index/
/helloworld/
我们再来看一个例子。如果URL如下
/checkout/cart/add
Magento的执行步骤如下
1.查询全局配置，找到frontName“checkout”对应的模块，Mage_Checkout
2.找到执行控制器“Mage_Checkout_CartController”
3.调用执行控制器的“addAction”方法
进一步理解执行控制器
下面我们来为我们的执行控制器添加一个执行方法。添加如下代码到
publicfunctiongoodbyeAction(){
echo'GoodbyeWorld!';
}
请求URL
/helloworld/index/goodbye
这次你应该看到“GoodbyeWorld!”。因为我们继承了
“Mage_Core_Controller_Front_Action”，我们可以使用一些父类已经定义好
的方法和变量。比如父类会把URL后面跟的参数转换成key/value的数组。添
加如下代码到我们的执行控制器
publicfunctionparamsAction(){
echo'
- ';
- Param:'.$key.' ';
foreach($this->getRequest()->getParams()as$key=>$value){
echo'
echo'
- Value:'.$value.'
}
echo'
}
请求如下URL
/helloworld/index/params?foo=bar&baz=eof
你应该看到如下输出
Param:foo
Value:bar
Param:baz
Value:eof
最后，让我们再写一个执行控制器，用来处理以下URL
/helloworld/messages/goodbye
这里的执行控制器名字是“messages”，所以我们要创建如下文件
app/code/local/Alanstormdotcom/Helloworld/controllers/MessagesControl
执行控制器的类名应该是
Alanstormdotcom_Helloworld_MessagesController
添加执行方法
publicfunctiongoodbyeAction()
{
echo'AnotherGoodbye';
}
好了，Magento的MVC架构大概就是这样了。它比传统的PHPMVC要复杂一点，
但是Magento的这个高度灵活的MVC架构能让你创造出几乎所有你能想到的URL
结构。
第三章布局、块和模板
我们接着研究Magento。根据我们第二章讲的MagentoMVC的架构，我
们接下来应该讲模型（Model），但是我们跳过模型先来看布局和块。和一些流
行的PHPMVC架构不同的是，Magento的执行控制器不直接将数据传给试图，相
反的视图将直接引用模型，从模型取数据。这样的设计就导致了视图被拆分成两
部分，块（Block）和模板（Template）。块是PHP对象，而模板是原始PHP
文件，混合了XHTML和PHP代码（也就是把PHP作为模板语言来使用了）。每
一个块都和一个唯一的模板文件绑定。在模板文件phtml中，“$this”就是指
该模板文件对应的快对象。
让我们来看一个例子
File:
app/design/frontend/base/default/template/catalog/product/
你将看到如下代码
getLoadedProductCollection()?>
count()):?>
theselection.')?>
这里“getLoadedProductCollection”方法可以在这个模板的块对象
“Mage_Catalog_Block_Product_List”中找到
File:app/code/core/Mage/Catalog/Block/Product/
...
publicfunctiongetLoadedProductCollection()
{
return$this->_getProductCollection();
}
...
块的“_getProductCollection”方法会实例化模型，并读取数据然后返回给模
板。
嵌套块
Magento把视图分离成块和模板的真正强大之处在于“getChildHtml”方法。这
个方法可以让你实现在块中嵌套块的功能。顶层的块调用第二层的块，然后是第
三层……这就是Magento如何输出HTML的。让我们来看一下单列的顶层模板
File:app/design/frontend/base/default/template/page/
"/TR/xhtml1/DTD/">
getChildHtml('head')?>
class="'.$this->getBodyClass().'"':''?>>
getChildHtml('after_body_start')?>
getChildHtml('global_notices')?>
getChildHtml('header')?>
getChildHtml('breadcrumbs')?>
$this->getChildHtml('global_messages')?>
getChildHtml('content')?>