CakePHP manual 中文翻译

互联网 2006年12月14日 13:36 查看48931次 作者: helloliuchen  【
文章分类:PHP5研究[新]

第七章 Controllers

1.Controller 方法

       1.1 和你的Views交互

       1.2 使用Redirection

       1.3 Controller的回调函数

       1.4 其他有用的方法

2. Controller的变量

       一个Controller是用来管理你应用某个方面的逻辑。大多数来说,controllers用来管理一个model的逻辑。比如,你正在建设一个站点来管理一个video的collection,你可能有一个VideoController以及一个RentalControlle来管理你的视频和租金。分别的,cake中每个controller的名字通常是复数。

程序的Controllers都是从AppController类继承来的类,AppController又是从核心的类Controller继承来的。Controller类可以包含任意数量的action:各种显示Views的方法

AppController类可以在/app/app_controller.php中第一,它里面包含了许多可以被更多controllers共享的方法,它本身是从核心类Controller继承来的。

一个Action是controller中的一个单独的方法,这个方法可以被Dispatcher自动的运行,运行的根据是从routes配置解析的页面请求。回到我们的 video collection的例子,VideoController类可以包含actions比如view(), rent(), search()等等,这个controller可以在/app/controllers/video_controller.php找到,并且文件内容为:


class VideosController extends AppController
{
    function view($id)
    {
        //action logic goes here..
    }
    function rent($customer_id, $video_id)
    {
        //action logic goes here..
    }
    function search($query)
    {
        //action logic goes here..
    }
}

你可以通过使用下面的URLs来调用这些方法:

http://www.example.com/videos/view/253
http://www.example.com/videos/rent/5124/0-235253
http://www.example.com/videos/search/hudsucker+proxy

 


但是这些页面将如何显示?你需要为每个action定义一个view,你可以在下一章查看具体内容。但是本章中,你会掌握Cake的controller,并且能够更好的使用。具体的说,你将学到如何用controller将你的数据传递给view,使用户转向以及其他更多功能。

 

1. Controller Functions

    重要: 

    尽管本章中介绍了许多Cake中常用的方法,更多的手册内容请参考http://api.cake.org

 

1.1 和views交互

●set($var,$value)

     ○这个方法是将controller中的数据传递给view的主要方法。你可以使用这个方法控制任何值:single values, 整个数组等等。一旦你使用了set(),view中也可以使用这个变量:在controller中使用set(‘color’,’blue’)可以使得$color变量在view中使用

●validate()

    ○通过收集错误的保存,返回错误的个数

●validateErrors()

○根据model中第一的正确性规则,检查一个model的数据是否正确,更多信息参考第十章

●render($action=null, $layout=null, $file=null)

○你并非时刻需要这个方法,因为在每个controller方法的最后,render都被自动调用,并且调用后定义(或者使用)相应的view

 

1.2 使用转向

●redirect($url)

    ○使用这个方法告诉用户将跳转到哪里。这里的URL可以使Cake规则的URL或者使一个完整定义的URL(http://...)

●flash($message, $url, $pause=1)

○这个方法在你的flash layout(app/views/layouts/flash.thtml)中显示$message信息$pause秒钟,之后跳转到指定的URL

 

1.3 Controller的回调函数

    Cake Controller定义了一系列回调函数,你可以使用他们在重要的controller function之前或者之后插入功能逻辑。实现这些功能,适用下面介绍的参数和返回值声明这些方法

●beforeFilter()

○在每个controller action之前调用,非常有用的地方去检查sessions是否有效,并检查相应的权限

●afterFilter()

    ○在每个controlleraction之后调用

●beforeRender()

    ○在controller逻辑之后,view显示之前调用

 

1.4 其他有用的方法

尽管这些方法是在Cake的Object类中,他们在Controller中也可以使用

●requestAction($url, $extra=array())

○这个方法根据任何地方(location)调用controller的action,然后返回已经显示的view.$url是Cake规范的URL(/controllername/actionname/params),如果$extra数组包含了一个键‘render’,controller action将自动设置AutoRender

●log($msg, $type = LOG_ERROR)

○你可以使用这个方法在你的程序应中记录发生的任何事件。记录文件Logs放在/tmp文件目录下

 

2. Controller的变量

    数量使用controller中定义的变量可以使你更好的使用cake的某些附加功能

●$name

○PHP4 并不能以驼峰表示法将当前类的名称提供给我们。如果你遇到问题,使用这个变量将你的类名设置成正确的驼峰表示法

●$uses

○你的controller是否使用了很多的model?比如你的Fragglescontroller会自动调用$this->fraggle,但是你也想同时能够调用$this->smurf,那就将下面的语句加入到你的controller中


var $uses = array('Fraggle','Smurf');

●$helpers

○使用这个变量使得你的controller装在helpers到它的views. 这个HTML helper会自动装载,但是你可以使用这个变量来指定其他的


var $helpers = array('html','ajax','javascript');

 

●$layout

○将这个变量设置成为你在这个controller中想使用的layout

●$autoRender

    ○将这个变量设置成为false将会使得actions停止自动显示(rendering)

●beforeFilter

○如果你需要在某一个或者任何一个action调用之前都要运行一小段代码,使用$beforefilter.这个函数处理access control十分有用,你可以在任何action处理之前检查用户的权限。你需要做的就是将这个变量设置成为一个数组,数组中包含了你想运行的controller的action,如下所示


class ProductsController extends AppController
{
    var $beforeFilter = array('checkAccess');
    function checkAccess()
    {
        //Logic to check user identity and access would go here.
    }
    function index()
    {
        //When this action is called, checkAccess() is called first.
    }
}

●$components

    ○和$helpers和$uses类似,这个变量用来装载你需要的components
var $components = array('acl');

第八章 Views

1.Views

       一个View就是一个页面的模版,经常以action的名字来命名。举例来说,Postscontroller::add()方法的view存放在/app/views/posts/add.thtml。Cake的views文件都是简单的PHP文件,所以你可以在里面使用任何PHP代码,几乎所有的view文件都包含HTML,一个view可以使特定数据集的任何体现,包括XML,图片等等

       在view的模版文件中,你可以从对应的Model中使用数据,这个数据以数组$data的形式传递过来,你在controller中使用set()传递过来的任何数据在view中都可以使用

 

              注意

       HTML helper默认情况下在任何一个view都是可用的。而且是views中使用最多的。它创建forms包括scripts和media、链接以及数据正确性检查中都非常有用。参考第九章第1.1节可以了解HTML helper更多的内容

 

       views中许多可用的发放都是Helpers提供的。Cake提供了很多的helpers(参考第九章),你也可以引用自己定义的。因为views不应该包含过多的逻辑,所以views类中并没有很多public的方法。其中一个有用的方法就是renderElement(),这个方法我们在1.2节中讨论

 

1.1 Layouts

       一个布局(layout)包括了围绕view的所有代码。你想在view中见到的所有东西都应该被放在你的layout中。       布局文件位于/app/views/layouts。

Cake的默认layout可以在/app/views/layouts/default.thtml被新的默认layout重写。一旦一个新的默认layout创建,controller view的代码将在页面被显示的时候替换到默认的layout

当你常见一个layout的时候,你需要告诉Cake你的controller view的代码位置:为了
达到这个目的,一定要确保layout包含$content_for_layout(有$title_for_layout更好)下面是一 个默认的layout的例子

 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title><?php echo $title_for_layout?></title>
<link rel="shortcut icon" href="favicon.ico" type="image/x-icon">
<body>
<!-- IF you'd like some sort of menu to show up on all of your views, include it here -->
<div id="header">
    <div id="menu"></div>
</div>
<!-- Here's where I want my views to be displayed -->
<?php echo $content_for_layout ?>
<!-- Add a footer to each displayed page -->
<div id="footer"></div>
</body>
</html>

 

 

       你可以为你的cake站点创建任意多的layout,你所要做的就是把他们放到app/views/layouts这个目录下,并在使用controller actions的时候使用controllers的$layout
变量或者是setLayout()方法

       举例来说,如果站点的一部分需要包含一个小的广告banner空间。可以创建一个新的带有小的广告空间的layout,并将这个layout设置成为controller actions将要使用的layout.方法如下:


var $layout = 'default_small_ad';

1.2 Elements

       很多应用都有一些很多页面都会重复的代码段,有时候在layout中的位置不相同。Cake可以帮助你重现这些需要复用的部分。这些复用的部分叫做元素(Elements)。广告,帮助框,导航控制条,额外的菜单,插图编号在cake中就被实现为元素。一个元素就是其他views可以引用的小型view(a mini-view)

       元素位于 /app/views/elements文件夹,并且都有.thtml的文件扩展名

例8.1 Calling an Element without parameters


<?php echo $this->renderElement('helpbox'); ?>

例 8.2 Calling an Element passing a data array


<?php echo
$this->renderElement('helpbox', array("helptext" => "Oh, this text is very helpful."));
?>

在一个元素文件中,所有传递的变量名称都是以通过传递过来数组的keys名获得(和controller中的set()在views中起到的作用很类似)。上面举的这个例子中 /app/views/elements/helpbox.thtml文件就会使用$helptext变量。当然,传递一个数组到元素文件会更有用的多。

       使用元素可以使得view更易读,同时可以在一个文件中重复使用元素。他们也可以帮助你在网站建设中复用部分内容。

责任编辑:抽烟的蚊子

给文章打分...

平均分:0.3(75 次)

-5 -4 -3 -2 -1 0 1 2 3 4 5
12

顶一下

发表我的见解...

  • 您的大名: 留空为匿名
  • 您的主页:
  • 您的邮箱: