zoukankan      html  css  js  c++  java

  • CakePHP manual 中文翻译6

    第七章 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找到，并且文件内容为：

    1. class VideosController extends AppController
    2. {
    3.     function view($id)
    4.     {
    5.         //action logic goes here..
    6.     }
    7.     function rent($customer_id, $video_id)
    8.     {
    9.         //action logic goes here..
    10.     }
    11.     function search($query)
    12.     {
    13.         //action logic goes here..
    14.     }
    15. }

    你可以通过使用下面的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交互

    1. ●set($var,$value)

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

    1. ●validate()

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

    1. ●validateErrors()

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

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

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

    1.2 使用转向

    1. ●redirect($url)

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

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

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

    1.3 Controller的回调函数

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

    1. ●beforeFilter()

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

    1. ●afterFilter()

    ○在每个controlleraction之后调用

    1. ●beforeRender()

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

    1.4 其他有用的方法

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

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

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

    1. ●log($msg, $type = LOG_ERROR)

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

    2. Controller的变量

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

    1. ●$name

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

    1. ●$uses

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

    1. var $uses = array('Fraggle','Smurf');
    1. ●$helpers

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

    1. var $helpers = array('html','ajax','javascript');
    1. ●$layout

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

    1. ●$autoRender

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

    1. ●beforeFilter

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

    1. class ProductsController extends AppController
    2. {
    3.     var $beforeFilter = array('checkAccess');
    4.     function checkAccess()
    5.     {
    6.         //Logic to check user identity and access would go here.
    7.     }
    8.     function index()
    9.     {
    10.         //When this action is called, checkAccess() is called first.
    11.     }
    12. }
    1. ●$components

    ○和$helpers和$uses类似，这个变量用来装载你需要的components

    1. 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的例子

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

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

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

    1. 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

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

    例 8.2 Calling an Element passing a data array

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

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

    使用元素可以使得view更易读，同时可以在一个文件中重复使用元素。他们也可以帮助你在网站建设中复用部分内容。
  • 相关阅读:
    操作系统复习目录
    leetcode Trapping Rain Water
    leetcode First Missing Positive
    leetcode Combination Sum II
    leetcode Word Search 待解决？
    [HDU] 1074 Doing Homework (NP性质的DP，远没有过去的自己写得好了)
    [HDU] 4513 吉哥系列故事——完美队形II
    [HDU] 4512 吉哥系列故事——完美队形I（有点dp味道的递归模拟）
    [HDU] 4519 郑厂长系列故事——体检
    [HDU] 4527 小明系列故事——玩转十滴水
  • 原文地址：https://www.cnblogs.com/kuyuecs/p/1330416.html
Copyright © 2011-2022 走看看