编辑“EZ Publish/EZ Publish模块与视图”

{{EZ Publish top}}

模块提供了一种[[HTTP]] 接口可以用于在[[WEB]] 上与[[eZ Publish]] 互动。某些模块提供了调用内核功能的接口，其余的模块在不同程度上独立于内核存在。系统内建的一套模块可以满足典型的日常事务的需求。例如：

内容模块提供了通过WEB [[浏览器]]管理内容的接口。通过开发自定义的模块，可以扩展系统来满足特定的业务需求。自定义的模块必须用[[PHP]] 开发。下表列出了一些常用的内建模块。

[[Image:MKYST.jpg|center]]

== 模块扩展 ==

每次通过WEB 浏览器访问eZ Publish，[[客户端]]其实是在间接地与系统中的模个模块互动。请求的[[URL]] 告诉eZ Publish 应该执行哪个模块来处理客户端的请求。URL 的第一部分表明模块的名称。这通常是URL中"index.php"后面的第一部分（URI 访问方法除外）。下例演示了典型的eZ Publish URL：<nowiki>http://www.example.com/index.php/content/edit/13/03</nowiki> 这个URL 表明请求会调用[[content]] 模块。另外一个典型的eZ Publish URL 如下：<nowiki>http://www.example.com/index.php/user/login</nowiki> 这个URL 表明eZ Publish 会调用user 模块。显然，这两个URL 还包含附加的信息。在第一个例子中，模块名的后面追加了"/edit/13/03"。在第二个例子中，模块名的后面追加了"/login"。这些附加的信息控制被请求的模块的行为，将在下面解释。

== 模块视图 ==

模块由一系列视图构成。视图可以被想象成为一种与模块的接口。通过使用视图，可以调用模块提供的各种功能。例如：除其它视图外，content 模块提供了用于显示，编辑，检索和翻译内容对象的视图。视图的名称在URL 中紧跟在模块名后面（由"/"分割）。在第一个例子中，eZ Publish 被要求访问content模块的"edit"视图。在第二个例子中，eZ Publish 被要求访问"user"模块的"login"视图。

当视图被调用时，eZ Publish 启动与那个视图相关的代码。执行结束后，视图把返回结果返回给模块，模块再把结果返回给系统的其余部分。结果被设置到一个模板变量中，变量名为$module_result.content。在主模板（pagelayout）中可以访问这个变量。另请参阅“[[EZ Publish/EZ Publish的使用|EZ Publish的使用]]”中有关模板的使用介绍。

== 视图参数 ==

某些视图支持一到多个参数。视图参数允许用户向视图传送信息从而通过URL 来控制视图。视图参数在URL 中被追加到视图名之后。在第一个例子中，以下的参数被传输给视图："13"和"03"。这些参数会要求content 模块的edit 视图提供一个界面用来编辑对象13 的版本3。第二个例子中的URL 并没有使用视图参数。视图机制支持两种类型的参数：

#有序参数
#无序参数

有序参数在URL 中必须用"/"分割且必须紧跟视图名之后。此外，他们的顺序必须与模块定义中的顺序相同。例如：如果第一个例子中的参数顺序对调，eZ Publish 会尝试去编辑对象3 的版本13（而不是对象13 的版本3）。

如同名字的含义，无序参数可以以任何参数提供。如果模块支持有序参数，无序参数必须排在有序参数之后。如果视图不支持有序参数，无序参数会跟随在视图名之后。无序参数必须成对出现。一个无序参数对有参数名和参数值构成（由"/"分割）。下例演示了如何在eZ Publish URL 中使用无序参数：<nowiki>http://www.example.com/index.php/video/dvd/button/play</nowiki> 上例中的地址告诉eZ Publish 运行"video"模块并且执行"dvd"视图。无序参数的名称为"button"，参数值为"play"。如何处理这些参数由"dvd"视图的PHP 代码决定。

== POST 变量 ==

某些视图会用到通过表单以HTTP POST 方式提交到服务器的参数。例如："content"模块的"action"视图支持可扩展的POST 变量。

== GET 变量 ==

视图也可以支持GET 变量。例如：content 模块的treemenu 视图的参数是通过GET 变量传输的。

== 默认的请求 ==

为了生成合适的输出，eZ Publish 必须知道应该运行哪个模块与执行哪个视图。换言之，每个URL 都至少要包含模块名和视图名。如果输入了不完整的或错误的URL，eZ Publish 会显示一个出错页面表明错误的内容（缺失/错误的模块或视图）。如果在URL 中"index.php"后不包含任何内容（或许除了"/"），默认的模块/视图组合会被执行。默认的模块/视图组合可以在"site.ini"的重设文件中配置。配置的位置为："[SiteSettings]"下的"IndexPage"。默认的设置是"/content/view/full/2"。它要求eZ Publish 显示节点2（内容顶极节点）的全视图。换言之，如果请求以下URL：

<nowiki>http://www.example.com/index.php</nowiki>

与请求如下URL 的效果相同。

<nowiki>http://www.example.com/index.php/content/view/full/2</nowiki>

eZ Publish 不会重定向或是重载页面，这意味着浏览器的地址栏中的内容不会改变。

==参考来源==
*http://wenku.baidu.com/view/8cf795b665ce05087632138a.html
*http://ez.no/eZPublish/New-Release

[[category:EZ Publish|E]]

{{EZ Publish}}