深入理解magento – 第三章 – magento的布局(layout),块(block)和模板(template).doc

el/2024/3/25 14:57:16

 

 

 

 

 

 

 

 

       深入理解magento – 第三章 – magento的布局(layout),块(block)和模板(template)

我们接着研究magento。根据我们第二章讲的magento mvc的架构,我们接下来应该讲模型(model),但是我们跳过模型先来看布局和块。和一些流行的php mvc架构不同的是,magento的执行控制器不直接将数据传给试图,相反的视图将直接引用模型,从模型取数据。这样的设计就导致了视图被拆分成两部分,块(block)和模板(template)。块是php对象,而模板是原始php文件,混合了xhtmlphp代码(也就是把php作为模板语言来使用了)。每一个块都和一个唯一的模板文件绑定。在模板文件phtml中,“$this”就是指该模板文件对应的快对象。

让我们来看一个例子

file: app/design/frontend/base/default/template/catalog/product/list.phtml

你将看到如下代码

$_productcollection=$this->getloadedproductcollection()?>
if(!$_productcollection->count()):?>

echo$this->__('there are no products matching the selection.')?>

else:?>

这里“getloadedproductcollection”方法可以在这个模板的块对象“mage_catalog_block_product_list”中找到

file: app/code/core/mage/catalog/block/product/list.php
...
publicfunction getloadedproductcollection()
{
    return$this->_getproductcollection();
}   
...

块的“_getproductcollection”方法会实例化模型,并读取数据然后返回给模板。

嵌套块

magento把视图分离成块和模板的真正强大之处在于“getchildhtml”方法。这个方法可以让你实现在块中嵌套块的功能。顶层的块调用第二层的块,然后是第三层……这就是magento如何输出html的。让我们来看一下单列的顶层模板

file: app/design/frontend/base/default/template/page/1column.phtm
/**
 * template for mage_page_block_html
 */
?>
 
echo$this->getlang()?>" lang="echo$this->getlang()?>">
 
echo$this->getchildhtml('head')?>
 
echo$this->getbodyclass()?' class="'.$this->getbodyclass().'"':''?>>
echo$this->getchildhtml('after_body_start')?>
    echo$this->getchildhtml('global_notices')?>
    
        echo$this->getchildhtml('header')?>
        
            
                echo$this->getchildhtml('breadcrumbs')?>
                
                    echo$this->getchildhtml('global_messages')?>
                    echo$this->getchildhtml('content')?>
                
            
        
        echo$this->getchildhtml('footer')?>
        echo$this->getchildhtml('before_body_end')?>
    
echo$this->getabsolutefooter()?>
 
 

我们可以看到这个模板里面很多地调用了“$this->getchildhtml(…)”。每次调用都会引入另外一个块的html内容,直到最底层的块。

布局对象

看到这里,你可能有这样的疑问
magento
怎么知道在一个页面上要用那些块?
magento
怎么知道哪一个块是顶层块?
“$this->getchildhtml(…)”
里面的参数是什么意思?块的名字吗?
magento
引入了布局对象(layout object)来解决上面的那些问题。布局对象(或者说布局文件)就是一个xml文件,定义了一个页面包含了哪些块,并且定义了哪个块是顶层块。

在第二章的时候我们在执行方法(action method)里面直接输出了html内容。现在我们要为我们的hello world模块创建一个简单的html模板。首先我们要创建如下文件

app/design/frontend/default/default/layout/local.xml

包含以下内容

version="1.0"encoding="utf-8"?>
version="0.1.0">
    
        name="root">
            type="page/html"name="root"output="tohtml"template="helloworld/simple_page.phtml"/>
        
    

再创建如下文件

app/design/frontend/default/default/template/helloworld/simple_page.phtml

包含以下内容

 
        "http://www.w3.org/tr/xhtml1/dtd/xhtml1-strict.dtd">
 
 
    untitled
    
 
 

links

echo$this->getchildhtml('top.links');?>
echo$this->getchildhtml('customer_form_register');?>
 
 

最后,我们要在执行控制器里面调用布局文件,开始输出html。修改执行方法如下

publicfunction indexaction(){
    //remove our previous echo
    //echo 'hello index!';
    $this->loadlayout();
    $this->renderlayout();
}

清空magento缓存,访问url “http://exmaple.com/helloworld/index/index”。你应该看到一个纯红色背景的页面。这个页面的源代码应该和我们创建的文件“simple_page.phtml”一模一样。

究竟是怎么回事呢?

也许你看到这里一头雾水,没关系,我们来慢慢解释。首先你得安装一个 layout viewer 模块,这和我们第一章讲的 config viewer 模块很相似,都是查看magento的内部信息。安装完这个模块之后【注:你需要参照第一章的内容,为这个模块创建“app/etc/modules/app_layoutviewer.xml”】,打开如下url

http://example.com/helloworld/index/index?showlayout=page

你看到的是你正在请求的页面的布局文件。它是由blockreferenceremove组成的。当你在执行方法中调用“loadlayout”时,magento会做如下处理
生成这个布局文件
为每一个blockreference标签实例化一个块对象。块对象的类名是通过标签的name属性来查找的。这些块对象被存储在布局对象的_blocks数组中
如果block标签包含了output属性,那么这个块的名字和output属性的值会被添加到布局对象的_output数组中
然后,当你在执行方法中调用“renderlayout”方法时,magento会遍历_output数组中所有的块名字,从_blocks数组中获得该名字的块,并调用块对象中使用output属性的值作为名字的函数。这个函数往往是“tohtml”。这个output属性也告诉magento这里就是输出html的起点,也就是顶层块。【注:直接阅读layout类的代码应该比较容易理解这里的逻辑

file: app/code/core/mage/core/model/layout.php
publicfunction getoutput()
{
    $out='';
    if(!empty($this->_output)){
        foreach($this->_output as$callback){
            $out.=$this->getblock($callback[0])->$callback[1]();
        }
    }
    return$out;
}

从这里我们也可以看出,一个页面的布局文件可以拥有多个顶层块。】

下面我们要讲解块对象是如何被实例化的,这个布局文件时如何被生成的,最后我们将动手做一个例子来实践这一章讲的内容。

实例化块对象

在布局文件中,blockreference标签有一个“type”属性,这个属性其实是一个uri

magento就是通过这个uri是用来查找块对应的类名。这个uri分为两部分,第一部分“page”是用来在全局配置中查找一个基本类名,第二部分“html”或者“template_link”将被添加到基本类名后面生成一个具体的将被实例化的类名。

我们以“page/html”为例。首先magento在全局配置中找到节点

/global/blocks/page

有以下内容

    
        mage_page_block
    
 

这里我们拿到了一个基本类名“mage_page_block”,然后添加uri的第二部分“html”到基本类名后面,我们就得到最终的块对象的类名“mage_page_block_html”。块的类名在magento中被称为分组类名grouped class names),这些类都用相似的方法被实例化。我们将在以后的章节中详细介绍这个概念。

blockreference的区别

我们上面提到blockreference都会实例化块对象,那么它们究竟有什么区别呢? reference在布局文件中是用来表示替换一个已经存在的块,举个例子

 
 
 
    
    
 

magento首先创建了一个名叫“root”的块。然后,它有发现了一个引用(reference)的名字也叫“root”magento会把原来那个“root”块替换成reference标签里面的那个快。

再来看看我们之前创建那个local.xml

version="0.1.0">
    
        name="root">
            type="page/html"name="root"output="tohtml"template="helloworld/simple_page.phtml"/>
        
    

在这里,块“root”被我们用reference替换了,指向了一个不同的模板文件。

布局文件是如何生成的

现在我们对布局文件已经有所了解了,但是这个布局文件是那里来的呢?要回答这个问题,我们得引入magento中的另外两个概念,操作(handle)和包布局(package layout)。

操作

magento会为每一个页面请求生成几个不同的操作。我们的layout view模块可以显示这些处理器

http://example.com/helloworld/index/index?showlayout=handles

你应该看到类似如下列表的列表(和你的配置有关)

handles for this request
   1. default
   2. store_default
   3. theme_frontend_default_gap
   4. helloworld_index_index
   5. customer_logged_out

它们每一个都是一个操作的名字。我们可以在magento系统的不同的地方配置操作。在这里我们需要关注两个操作 “default” “helloworld_index_index”“default”处理器是magento的默认处理器,参与每一个请求的处理。“helloworld_index_index”处理器的名字是frontname “helloworld”加上执行控制器的名字“index”再加上执行方法的名字“index”。这说明执行控制器的每一个执行方法都有一个相应的操作。

我们说过“index”magento默认的执行控制器和执行方法的名字,所以以下请求的操作名字也是“helloworld_index_index”

http://example.com/helloworld/?showlayout=handles
包布局

包布局和我们以前讲过的全局配置有些相似。它是一个巨大的xml文档包含了magento所有的布局配置。我们可以通过以layout view模块来查看包布局,请求一下url

http://example.com/helloworld/index/index?showlayout=package

你可能要等一会儿才能看到输出,因为文件很大。如果你的浏览器在渲染xml的时候卡死了,建议你换成text格式的

http://example.com/helloworld/index/index?showlayout=package&showlayoutformat=text

假设你选择的是xml格式输出,那么你应该看到一个巨大的xml文件,这就是包布局。这个文件是magento动态生成的,合并当前主题(theme)下面所有的布局文件。如果你用的是默认安装的话,这些布局文件在以下目录

app/design/frontend/base/default/layout/

其实在全局配置中,有一个updates节点下面定义了所有将被装载的布局文件

    
        
            core.xml
        
        
            page.xml
        
        ...
     
 

当这些文件被装载以后,magento还会装载最后一个布局文件,helloworld.xml,也就是我们之前新建的那个文件。我们可以通过这个文件来定制magento的布局。

结合操作和包布局

在包布局文件中,我们可以看到一些熟悉的标签blockreference等等,但是他们都包含在一下这些标签中

/>
/>
etc...

这些就是操作标签。对于每个特定的请求来说,针对这个请求的布局文件是由包布局中所有和这个请求相关的操作标签组成的。比如我们上面的例子,和请求相关的操作标签如下

所以,针对请求

http://example.com/helloworld/index/index

布局文件就是包布局中上面这些标签的内容组合。在包布局文件中,还有一个标签值得我们注意。我们可以通过这个标签引入另外一个操作标签。比如

    
    handle="customer_account"/>
     !-- ... -->

这段代码的意思是,如果一个请求包含了“customer_acount_index”操作,那么这个请求的布局文件也应该包含“customer_account”操作标签下面的blockreference

更新我们的例子

好了,理论讲完了,让我们来修改我们的例子,把这一章的内容实践一下。我们重新来看local.xml

    
        
                
        
    
 

我们用一个引用(reference)覆盖了名为“root”的块。然后定义了一个新的块,指向了一个不同的模板文件。我们把这个引用放在default操作标签下面,那就说明这个layout将对所有的请求有效。如果你访问magento自带的一些页面,你会发现它们要么是空白,要么就是和我们“hello world”例子的红色背景,但这并不是我们想要的效果。我们来修改一下local.xml,让我们的模板仅对“helloworld”的请求有效。

    
        
             
        
    
 

我们把操作标签换成了“helloworld_index_index”。清空magento缓存,重新访问magento的各个页面,你应该发现都恢复了正常,但是针对”hello world”模块的请求页面还是我们自定义的那个。

目前我们只实现了一个“index”执行函数,现在我们来实现“goodbye”执行函数。修改我们的执行控制器代码如下

publicfunction goodbyeaction(){
    $this->loadlayout();
    $this->renderlayout();          
}

但是你访问一下页面的时候你还是会看到magento的默认布局

http://example.com/helloworld/index/goodbye

那是因为我们没有为这个请求定义布局。我们需要在local.xml中添加“helloworld_index_goodbye”标签。由于“index”请求和“goodbye”请求我们要套用的布局是一样的,所以我们将用标签来重用已有的配置

version="0.1.0">
    
    
        handle="helloworld_index_index"/>
    

清空magento缓存,请求以下url

http://example.com/helloworld/index/index
http://example.com/helloworld/index/goodbye

你将会得到两个完全相同的页面。

开始输出和getchildhtml方法

magento默认的配置下,html输出是从名为“root”的块开始(其实是因为这个块拥有output属性【注:任何一个拥有output属性的块都是顶层块,在拥有多个顶层块的情况下magento将按照块定义的先后顺序输出html】)。我们覆盖了“root”块的模板

template="helloworld/simple_page.phtml"

模板文件的查找路径是当前主题(theme)的根目录,magento默认设置时这里

app/design/frontend/base/default
为页面加入内容

到目前为止,我们的页面都比较无聊,啥也没有。我们来为页面加点有意义的内容。修改local.xml如下

    name="root">
        type="page/html"name="root"template="helloworld/simple_page.phtml">
            type="customer/form_register"name="customer_form_register"template="customer/form/register.phtml"/>
        
    

我们在“root”块里面嵌套了一个块“customer_form_register”。这个块是magento本来就有的,包含了一张用户注册表单。我们把这个块嵌套进来,那么我们在模板文件里面就能用这个块的内容。使用方法如下,修改simple_page.phtml

 
    echo$this->getchildhtml('customer_form_register');?>
 

这里“getchildhtml”的参数就是要引入的块的名字,使用起来相当方便。清空magento缓存,刷新hello world页面,你应该在红色背景上看到用户注册表单。magento还有一个块,叫做“top.links”,让我们把它也加进来。修改simple_page.html

         
             

深入理解magento – 第三章 – magento的布局(layout),块(block)和模板(template).doc-尊龙官方平台

             < ?php echo $this->getchildhtml('top.links'); ?>
             < ?php echo $this->getchildhtml('customer_form_register'); ?>
         

刷新页面,你会发现links显示出来了,但是“top.links”什么都没有显示。那是因为我们并没有把这个块引入到local.xml,所以magento找不到这个块。“getchildhtml”的参数一定要是当前页面的布局文件中声明过的块。这样的话magento就可以只实例化需要用到的块,节省了资源,我们也可以根据需要为块设置不同的模板文件。

我们修改helloworld.xml文件如下

    
        
            
                   
                   
            
        
    
 

清空magento缓存,刷新页面,你会看到一排链接显示出来了。【注:如果你细心一点的话你会发现“top.links”块没有template属性,那是因为这个块的类中一定定义了默认的模板

protected function _construct()
{
    $this->settemplate('page/template/links.phtml');
}

总结

这一章我们讲解了布局的基础知识。你可能会觉得这个很复杂,但是你也不必过分担心,因为平常使用magento是不会用到这些知识的,magento提供的默认布局应该可以满足大部分需求。对于想要深入研究magento的开发者来说,理解magento的布局是至关重要的。布局,块和模板构成了magento mvc架构中的view,这也是magento的特色之一。

 


http://www.ngui.cc/el/5126627.html
尊龙官方平台-尊龙凯时官方

相关文章

深入理解magento – 第四章 – 模型和orm基础.doc

深入理解magento – 第四章 – 模型和orm基础 对于任何一个mvc架构,模型(model)层的实现都是占据了很大一部分。对于magento来说,模型占据了一个更加重要的位置,因为它常常包含了一部分商业逻辑代码(可以说…

深入理解magento – 第五章 – magento资源配置.doc

深入理解magento – 第五章 – magento资源配置 对于任何一个更新频繁的项目来说,保持开发环境和生产环境的数据库同步是件很头疼的事情。magento提供了一套系统,用版本化的资源迁移脚本来解决这个问题。 上一章,我们为 helloworld blogpos…

深入理解magento – 第六章 – 高级magento模型.doc

深入理解magento – 第六章 – 高级magento模型 我们讲过magento有两种模型,简单模型和eav(entity attribute value)模型。上一章我们讲过所有的magento模型都是继承自mage_core_model_abstract / varien_object。简单模型和eav模型的区别在…

model--resourcemodel---collection 初始化

model 不是eav模型的初始化。 1 class richardmason_profile_model_profile extends mage_core_model_abstract{ public function _construct() { parent::_construct(); $this->_init(profile/profile); } 1.1 parent::parent为空; 1.2 //abstract class m…

magento----设置图片背景颜色(按数值设定后缺的部分用背景色填充)

1. magento图片的底层处理是在:/lib/varien/image/adapter/abstract.php 函数: public function backgroundcolor($value null) /** * get/set keepbackgroundcolor * * param array $value * return array */ public f…

magento -- 用magento的方式读写xml

magento -- 用magento的方式读写xml i will be using varien_simplexml_element class to read write xml nodes. the path to this class file is lib/varien/simplexml/element.php here is a sample xml file which i am going to read through magento code. i will al…

模块-----向数据库里面建表,写入数据,在读取数据

1 首先建立模块等一系列的文件,文件 2 etc/config.xml文件: 1.10

magento----已经存在的图片地址,生成自定义尺寸的图片

根据已经存在的图片地址,生成自定义尺寸的图片。。 处理图片的类是:lib/varien/image.php。 public function getthumbnailresize($width, $height null) { // actual path of image $imageurl mage::getbasedir(media).ds.$this->…

权限----protect只能在派生的类中使用,不能派生对象和自己类的对象中使用

private:只允许自己类体内的函数使用,即使自己的派生类也不能使用。私用财产,儿子,孙子也不能动用,也就是说基类的私有成员是不能被继承的。(但允许友元函数访问,请查看相站关于友元函数的文章) protected…

serializable序列化 php

文章来源:http://www.phphubei.com/thread-104-1-3.html serialize()和unserialize()在php手册上的解释是: serialize — generates a storable representation of a value serialize — 产生一个可存储的值的表示 unserialize — creates a php value from a s…
网站地图