查看完整版本: kohana文档翻译(Controllers)

星期八 2008-7-16 15:21

kohana文档翻译(Controllers)

[b]控制器的命名和解析:[/b]
一个控制器基本上可以是任意文件名,控制器的类（class）名必须与文件名一致.
控制器的约定:
1.必须在controllers目录下.
2.控制器的文件名必须小写, e.g. articles.php
3.控制器的类名必须是控制器首字母大写的文件名附加上_Controller,比如Articles_Controller
4.必须继承Controller类
5.以”_”线开头的方法(如_do_something() )不能被URL的参数访问
我们创建一个简单的控制器在application/controllers/article.php,将会输出”hello world”.
现在你在浏览器键入[url]www.yoursite.com/article[/url] 你将会看到

[code=PHP]class Article_Controller extends Controller{
    public function index(){
        echo ‘Hello World!’;
    }
}[/code]


现在你在浏览器键入[url]www.yoursite.com/article[/url] 你将会看到:
[indent]Hello World
[/indent][b]更多高级控制器[/b]
在上面的示例中,index()方法被URL:[url]www.yoursite.com/article[/url]访问,如果URL的第二部分为空的话,index()方法会自动载入,上例也能被下例URL访问:[url]www.yoursite.com/article/index[/url]
如果URL的第二部分不为空.它决定控制器中哪一个访问被调用:application/controllers/article.php
[code=PHP]class Article_Controller extends Controller{
    public function index(){
        echo 'Hello World!';
    }
    public function overview() {
        echo 'Article list goes here!';
    }
}[/code]


现在你键入[url]www.yoursite.com/article/overview[/url] 将会显示
[indent]Article list goes here!
[/indent][b]控制器与URL片断[/b]
如果我们展现一篇特殊的文章,例如一篇标题为your-article-title,ID为1的文章,URL可能是[url]www.yoursite.com/article/view/your-article-title/1[/url],这个URL中的最后两部分将会传递到view()方法.
application/controllers/article.php
[code=PHP]class Article_Controller extends Controller{
    public function index(){
        echo 'Hello World!';
    }
    public function overview(){
        echo 'Article list goes here!';
    }
    public function view($title,$id){
        echo $id . ' - ' . $title;
        // you'd retrieve the article from the database here normally
    }
}[/code]

你访问[url]www.yoursite.com/article/view/your-article-title/1[/url]将会显示
[indent]1 - your-article-title
[/indent][b]控制器与子目录[/b]
如果你把一个控制器放到/controllers/下的一个子目录, Kohana 会根据控制器自动匹配,比如一个文件:application/controllers/admin/user.php对就URL:http://localhost/admin/user
[b]控制器路由[/b]
出于某种原因,你的URL不能与控制的方法对就,你可以使用URL路由,关于[url=http://docs.kohanaphp.com/general/routing][color=#63dbf5]URL路由[/color][/url]的更多信息
[b]特殊方法[/b]
[i]index[/i]
当ULR中没有别的方法时,index()方法会被自动载入.比如访问Welcome_Controller控制器,你的URL是[url]http://example.com/welcome[/url],index()方法会被自动载入
[i]_remap[/i]
如果你的控制器有此方法,那么你控制器的所有访问都会发到此方法.由原来URL决定的方法将会做为_remap方法的参数来处理.例如:
[code=PHP]class Article_Controller extends Controller{
    public function _remap( $method, $data ){
       // method is the first part of the uri.
       // it'll be index if there is no segment following the controller name
       // or the segment if there is

       // the $data param is an array of the remaining uri segments (if any)
       // otherwise it is an empty array
    }
}[/code]


[indent]www.domain.com/article中,method=index,data=none
[/indent][indent]www.domain.com/article/read中,method=read,data=none
[/indent][indent]domain.com/article/read/1中,method=read,data=array(’1′)
[/indent]在这个示例中你也可以不用_remap方法.关于此方法的更多信息
[url]http://learn.kohanaphp.com/2008/03/26/using-_remap/[/url]
[i]_default[/i]
_default()在控制器被访问的方法不存在的时候会被载入.例如在URL:[url]http://example.com/welcome/sthrandom90923[/url]中,sthrandom90923方法不存在,_default()会被调用.比如很容易的触发404页面.URL中的方法和参数将这样访问_default($method, $arguments)
[b]私有方法[/b]
有时候你希望你的方法不被展现在WEBSITE中,只让它们在控制器内部能被访问,你可以把方法申明为private或者在方法名前加’_'前缀.
application/controllers/home.php
[code=PHP]class Article_Controller extends Controller
{
    public function index()
    {
        echo 'Hello World!';
    }
    private function _article_form()
    {
        echo 'Article form';
    }
}[/code]


当你访问[url]www.yoursite.com/article/_article_form[/url] 时,将显示404页面
[b]构造函数[/b]
如果你要定义一个构造函数,你必须先调用父类的构造方法application/controllers/home.php
[code=PHP]class Article_Controller extends Controller
{
    protected $db;
    protected $session;

    public function __construct()
    {
        parent::__construct(); //this must be included

        $this->db = new Database;
        $this->session = new Session;
    }

    public function index()
    {
        $this->session->get('user_id');
    }

    public function view($article_id)
    {
        $article_id = (int) $article_id;
        $article = $this->db->getwhere('articles', array('id' => $article_id));
    }
}[/code]


在这个实例中.向我们展示了如何从数据库中检索出文章.如果你输入[url]www.yoursite.com/article/view/5[/url] ,它将会在数据库查找ID为5的文章
[b]特殊的控制器[/b]
[i]使用基控制器[/i]
在你的程序中使用基控制器非常有用处,你可以在任何页面执行,比如进行用户认证和授权,以及SESSION处理非常有用.
Example MY_Controller.php

[code=PHP]<?php
class Controller extends Controller_Core
{
    public function __construct()
    {
        parent::__construct();

        // authentication goes here for example
    }

    public function do_something()
    {
        // method available in all controllers
    }
}
?>[/code]
这个文件可以命名为MY_Controller.php,可以放到application/libraries下,这个类具有基类的所有方法加上你自己定义的方法
注意,MY_前缀可以在application/config/config.php文件中配置$config['extension_prefix'] 参数
页: [1]
查看完整版本: kohana文档翻译(Controllers)