一般來說,ThinkPHP的控制器是一個類,而操作則是控制器類別的一個公共方法。下面我們就來詳細談談ThinkPHP的控制器
在上一課程中,你可能會對ThinkPHP的路由會有一絲疑惑,不過沒關係,學完本課程,很多事都會豁然開朗。
控制器檔案命名遵守IndexController.class.php的方式
#控制器的定義
在開始之前,我們還是需要明確一下控制器的定義:
<?php namespace Home\Controller; use Think\Controller; class IndexController extends Controller { public function read($id){ echo "read page with </br>" .$id; } public function top(){ echo "top page </br>"; } }
如所見,前面在路由篇中提到的控制器就是這麼定義的:
#使用對應的命名空間,預設是namespace Home\Controller
載入Think\Controller
新控制器繼承於Controller(或子類別)
採用駝峰命名法,注意首字母大寫
控制器內的公共方法可以看作一個操作,例如上面的read()和top()方法就可以看作操作,我們在路由篇的時候都驗證過了。
http://localhost:8999/index.php/Home/Index/top
就是造訪到top()方法,會在頁面上列印出top page ,再次明確Home代表的是Home模組
有時候可能會遇到有和系統的關鍵字衝突的方法,這時候就可以使用設定操作方法字尾來解決了。
前置和後置操作
前置和後置操作指的是執行某個操作方法之前和之後會自動呼叫的方法,不過僅對訪問控制器有效,如在IndexController中為top()方法添加前置後置方法:
#public function _before_top(){ echo "before top page </br>"; } public function top(){ echo "top page </br>"; } public function _after_top(){ echo "after top page </br>"; }##訪問:http://localhost:8999 /index.php/Home/Index/top就會看到列印出:
#
before top page top page after top page使用前置和後置操作要注意如下兩點:如果目前的操作並沒有定義操作方法,而是直接渲染模板文件,那麼如果定義了前置和後置方法的話,依然會生效。真正有模板輸出的可能只是目前的操作,前置和後置操作一般情況是沒有任何輸出的。 要注意的是,在有些方法裡面使用了exit或錯誤輸出之類的話 有可能不會再執行後置方法了。例如,如果在目前操作裡面呼叫了系統Action的error方法,那麼將不會再執行後置操作,但是不影響success方法的後置方法執行可以用於表單的過濾和驗證
參數綁定
參數綁定是透過直接綁定URL位址中的變數作為操作方法的參數,可以簡化方法的定義甚至路由的解析。'URL_PARAMS_BIND' => true參數綁定功能預設是開啟的,其原理是把URL中的參數(不包括模組、控制器和操作名)和操作方法中的參數綁定。
參數綁定有兩種方式:依照變數名稱綁定和依照變數順序綁定,預設使用的是依照變數名稱綁定,例如看下面的例子:
public function read($id){ echo "read page with </br>".$id; } public function archive($year, $month){ echo "$year </br>".$month; }
對,這就是上一條路由所涉及的內容,在先前路由的路由設定處
'blogs/:id' => array('Index/read' )
我們將:id直接映射給read()方法的參數$id,所以現在回頭再看,其實路由規則就是給了你一個自訂URL的功能。如果去掉上面的路由設置,我們正確的存取方式是:
http://localhost:8999/Home/index/read/id/3
上面的URl中id就是變數名,如果你寫成:
public function read($title){ echo "read page with </br>".$title; }
那麼存取位址就是:
http://localhost:8999/index.php/Home/ index/read/title/3
對於多個參數綁定的情況,只要將對應的變數名稱和值傳進來就可以了,不在乎順序,例如下面兩個會回傳相同的結果:
http://localhost:8999/index.php/Home/index/archive/year/2012/month/12
http://localhost:8999/index.php/Home/index /archive/month/12/year/2012
#要注意的是,不管那種情況之下,當你造訪
http://localhost:8999/index.php/Home /index/read/
是會報錯的:
參數錯誤或未定義:id
public function read($id=0){ echo "read page with </br>".$id; }
這樣再存取上面的URL,就會輸出:
read page with
0
tips :給綁定參數設定預設值是一個避免報錯的好方法
#http://localhost: 8999/index.php/Home/index/read/3
怎麼解決呢?這時候,我們其實可以用到第二種參數綁定:按照變數順序綁定。要使用這種參數綁定,需要先在設定項目中設定:
'URL_PARAMS_BIND_TYPE' => 1
一旦设置变量顺序绑定,这种情况下URL地址中的参数顺序非常重要,不能随意调整。这种情况下操作方法的定义不需要改变,只是访问的URL变了而已,现在用上面的方式访问就可以正确访问了。
如果在变量顺序绑定的情况下,我们访问:
http://localhost:8999/index.php/Home/index/archive/2012/12
http://localhost:8999/index.php/Home/index/archive/12/2012
这两个结果显然是不一样,后者并不是我们想要的。所以这种情况需要严格遵守顺序来传值。
伪静态
URL伪静态通常是为了满足更好的SEO效果,ThinkPHP支持伪静态URL设置,可以通过设置URL_HTML_SUFFIX参数随意在URL的最后增加你想要的静态后缀,而不会影响当前操作的正常执行,默认情况下,伪静态的设置为html。但我们可以自己设置,例如
'URL_HTML_SUFFIX'=>'shtml'
如果希望支持多个伪静态后缀,可以直接设置如下:
'URL_HTML_SUFFIX' => 'html|shtml|xml'
如果此项设置留空则表示可以支持所有的静态后缀。
也可以设置禁止访问的URL后缀通过URL_DENY_SUFFIX来设置,例如:
'URL_DENY_SUFFIX' => 'pdf|ico|png|gif|jpg',
注: URL_DENY_SUFFIX的优先级比URL_HTML_SUFFIX要高。
URL生成
为了配合所使用的URL模式,我们需要能够动态的根据当前的URL设置生成对应的URL地址,为此,ThinkPHP内置提供了U方法,用于URL的动态生成,可以确保项目在移植过程中不受环境的影响。
定义规则
U方法的定义规则如下(方括号内参数根据实际应用决定):
U('地址表达式',['参数'],['伪静态后缀'],['显示域名'])
地址表达式
地址表达式的格式定义如下:
[模块/控制器/操作#锚点@域名]?参数1=值1&参数2=值2...
如果不定义模块的话 就表示当前模块名称,下面是一些简单的例子:
U('User/add') // 生成User控制器的add操作的URL地址
U('Article/read?id=1') // 生成Article控制器的read操作 并且id为1的URL地址
U('Admin/User/select') // 生成Admin模块的User控制器的select操作的URL地址
参数
U方法的第二个参数支持数组和字符串两种定义方式,如果只是字符串方式的参数可以在第一个参数中定义,例如:
U('Article/cate',array('cate_id'=>1,'status'=>1)) U('Article/cate','cate_id=1&status=1') U('Article/cate?cate_id=1&status=1')
三种方式是等效的,都是生成Article控制器的cate()操作 并且cate_id为1 status为1的URL地址
但是不允许使用下面的定义方式来传参数:
U('Article/cate/cate_id/1/status/1');
生成路由地址
U方法还可以支持路由,如果我们定义了一个路由规则为:
'blogs/:id\d'=>'Index/read'
那么可以使用
U('/blogs/1');
最终生成的URL地址是:
http://localhost:8999/index.php/Home/blogs/1
跳转和重定向
这应该是在开发中最常用的功能之一。在应用开发中,经常会遇到一些带有提示信息的跳转页面,例如操作成功或者操作错误页面,并且自动跳转到另外一个目标页面。系统的\Think\Controller类内置了两个跳转方法success()和error(),用于页面跳转提示。
跳转
使用方法很简单,比如我们在Index控制器下新建一个方法user(),写上下面的内容:
public function user() { $User = M('User'); $data['username'] = 'Think'; $data['email'] = 'Think@gmail.com'; $result = $User->add($data); if($result){ $this->success('success', '/Home/User/addUser'); } else { $this->error('failed'); } }
M('User')表示实例化一个User对象,add()方法是向数据库添加一条纪录。然后我们需要新建一个UserController,在里面写上addUser()方法
<?php namespace Home\Controller; use Think\Controller; class UserController extends Controller { public function addUser() { echo 'add user done!'; } }
然后在浏览器中访问http://localhost:8999/Home/Index/user,就可以看到add user done!了,下面详细来说说这两个重定向方法。
success()和error()方法的第一个参数表示提示信息,第二个参数表示跳转地址,第三个参数是跳转时间(单位为秒),例如:
// redirect to /Article/index after 3 seconds when success $this->success('done','/Home/Article/index',3); // redirect to /Article/error after 5 seconds when failed $this->error('failed','/Home/Article/error',5);
如果不设置跳转时间,默认的等待时间success()方法是1秒,error()方法是3秒。看到上面的两个跳转地址前面都带上了/Home,如果你想简写为/Article/index,你需要在ThinkPHP的入口文件(项目目录下的index.php)中加上下面一行:
define('BIND_MODULE','Home');
而且这两个方法都有对应的模板,默认的设置是两个方法对应的模板都是:
'TMPL_ACTION_ERROR' => THINK_PATH . 'Tpl/dispatch_jump.tpl', 'TMPL_ACTION_SUCCESS' => THINK_PATH . 'Tpl/dispatch_jump.tpl',
你可以根据自己的需要来修改模版。
重定向
Controller类的redirect()方法可以实现页面的重定向功能。
redirect()方法的参数用法和U函数的用法一致(参考上一部分URL生成部分),例如:
$this->redirect('/Home/Article/show', array('id' => 2), 3, 'Redirecting...');
上面的用法是停留3秒后跳转到Article控制器的show()操作,并且显示页面跳转中字样Redirecting...,重定向后会改变当前的URL地址。
为了成功进行测试,我们在IndexController下添加redirectToArticle()方法并写上上面那行代码:
public function redirectToArticle() { $this->redirect('/Home/Article/show', array('id' => 2), 3, 'Redirecting...'); }
然后我们创建一个ArticleController,并且为他添加show()方法:
namespace Home\Controller; use Think\Controller; class ArticleController extends Controller { public function show($id) { echo 'This is an Article Page'; // $id 变量我们后续会用到,现在只是演示跳转 } }
然后在浏览器访问:http://localhost:8999/Home/Index/redirectToArticle,等待三秒,你就可以看到跳转之后的页面了。
如果你仅仅是想重定向要一个指定的URL地址,而不是到某个模块的操作方法,可以直接使用redirect()函数重定向,例如
$this->redirect('/Home/Article/show/id/3', 'Redirecting...',3);
注:控制器的redirect()方法和redirect()函数的区别在于前者是用URL规则定义跳转地址,后者是一个纯粹的URL地址
注:好像官方文档是这样写的
$this->redirect('/New/category/cate_id/2', 5, '页面跳转中...');
以上就是本文的全部内容,希望对大家的学习有所帮助,更多相关内容请关注PHP中文网!
相关推荐:
关于thinkphp3.2嵌入百度编辑器ueditor的解析
以上是關於ThinkPHP的控制器解析的詳細內容。更多資訊請關注PHP中文網其他相關文章!