控制器类（Action）

描述 Description

ThinkPHP Action控制器基类 抽象类
位置：ThinkPHP/Lib/Core/Action.class.php

声明：

  1. abstract class Action {}
 

常量 Constants

无

 

属性 Properties

属性名 类型 访问 描述
view View protected 视图实例对象 默认为NULL
name string private 当前Action名称 默认为空字符串
 

方法 Methods

方法名 返回值类型 描述
__construct() void 架构方法
getActionName() string 获取当前Action名称
isAjax() bool 是否是ajax方式提交
display() void 页面输出
fetch() string 获取页面输出内容
buildHtml() string 创建静态Html页面
assign() void 模板变量赋值
error() void 操作错误跳转
success() void 操作成功跳转
ajaxReturn() void ajax返回数据
redirect() void Action跳转(URL重定向）
__destruct() void 析构方法
 

__construct()

说明：
public void __construct()
架构方法
参数：
无
返回值：
无

源码：

  1. public function __construct() {
  2. tag('action_begin');
  3. //实例化视图类
  4. $this->view       = Think::instance('View');
  5. //控制器初始化
  6. if(method_exists($this,'_initialize'))
  7. $this->_initialize();
  8. }
 

getActionName()

说明：
获取当前控制器名称
protected string getActionName()

参数：
无

返回值：
string

源码：

  1. protected function getActionName() {
  2. if(empty($this->name)) {
  3. // 获取Action名称
  4. $this->name     =   substr(get_class($this),0,-6);
  5. }
  6. return $this->name;
  7. }
 

isAjax()

说明：
protected bool isAjax()
判断是否是Ajax提交 首先判断是否存在HTTP_X_REQUESTED_WITH系统变量，如果不存在则判断VAR_AJAX_SUBMIT配置定义的提交变量
参数：
无
返回值：
如果是ajax方式提交返回true，否则返回false。

源码：

  1. protected function isAjax() {
  2. if(isset($_SERVER['HTTP_X_REQUESTED_WITH']) ) {
  3. if('xmlhttprequest' == strtolower($_SERVER['HTTP_X_REQUESTED_WITH']))
  4. return true;
  5. }
  6. if(!empty($_POST[C('VAR_AJAX_SUBMIT')]) || !empty($_GET[C('VAR_AJAX_SUBMIT')]))
  7. // 判断Ajax方式提交
  8. return true;
  9. return false;
  10. }

示例：

  1. if($this->isAjax()){
  2. echo 'ajax方式提交';
  3. }else{
  4. echo '不是ajax方式提交';
  5. }
 

display()

说明：
protected void display($templateFile='',$charset='',$contentType='')
模板显示 调用视图类的display方法
参数：

参数 类型 说明
$templateFile string 指定要调用的模板文件，默认为空 由系统自动定位模板文件
$charset string 输出编码
$contentType string 输出类型

返回值：
无
源码：

  1. protected function display($templateFile='',$charset='',$contentType='') {
  2. $this->view->display($templateFile,$charset,$contentType);
  3. }

示例：

  1. $this->display('edit');
 

fetch()

说明：
protected string fetch($templateFile='')
获取输出页面内容，调用视图类的fetch方法
参数：

参数 类型 说明
$templateFile string 指定要调用的模板文件 默认为空 由系统自动定位模板文件

返回值：
返回获取的内容
源码：

  1. protected function buildHtml($htmlfile='',$htmlpath='',$templateFile='') {
  2. $content = $this->fetch($templateFile);
  3. $htmlpath   = !empty($htmlpath)?$htmlpath:HTML_PATH;
  4. $htmlfile =  $htmlpath.$htmlfile.C('HTML_FILE_SUFFIX');
  5. if(!is_dir(dirname($htmlfile)))
  6. // 如果静态目录不存在 则创建
  7. mk_dir(dirname($htmlfile));
  8. if(false === file_put_contents($htmlfile,$content))
  9. throw_exception(L('_CACHE_WRITE_ERROR_').':'.$htmlfile);
  10. return $content;
  11. }
 

buildHtml()

说明：
创建静态页面
protected string buildHtml($htmlfile='',$htmlpath='',$templateFile='')
参数：

参数 类型 说明
$htmlfile string 生成的静态文件名称
$htmlpath string 生成的静态文件路径
$templateFile string 指定要调用的模板文件 默认为空 由系统自动定位模板文件

返回值：
无
源码：

  1. protected function buildHtml($htmlfile='',$htmlpath='',$templateFile='') {
  2. $content = $this->fetch($templateFile);
  3. $htmlpath   = !empty($htmlpath)?$htmlpath:HTML_PATH;
  4. $htmlfile =  $htmlpath.$htmlfile.C('HTML_FILE_SUFFIX');
  5. if(!is_dir(dirname($htmlfile)))
  6. // 如果静态目录不存在 则创建
  7. mk_dir(dirname($htmlfile));
  8. if(false === file_put_contents($htmlfile,$content))
  9. throw_exception(L('_CACHE_WRITE_ERROR_').':'.$htmlfile);
  10. return $content;
  11. }
 

assign()

说明：
模板变量赋值
protected void assign($name,$value='')
参数：

参数 类型 说明
$name mixed 要显示的模板变量 如果是字符串表示单个变量赋值，如果是数组表示批量赋值
$value mixed 变量的值

返回值：
无
源码：

  1. protected function assign($name,$value='') {
  2. $this->view->assign($name,$value);
  3. }

示例：
action中进行模板变量赋值

  1. //单个变量赋值
  2. $this->assign('title','ThinkPHP-PHP最佳实践框架');
  3. $this->assign('author','liu21st@gmail.com');
  4. // 可以用下面的方式替代
  5. $this->title = 'ThinkPHP-PHP最佳实践框架';
  6. $this->author = 'liu21st@gmail.com';
  7. //变量批量赋值
  8. $var['title']='ThinkPHP-PHP最佳实践框架';
  9. $var['author']='liu21st@gmail.com';
  10. $this->assign($var);

模板输出

  1. <HTML>
  2. <HEAD>
  3. <TITLE>{$title}</TITLE>
  4. <META name="Author" content="{$author}">
  5. </HEAD>
  6. <BODY>
  7. </BODY>
  8. </HTML>
 

error()

说明：
操作错误跳转的快捷方法
protected void error($message,$jumpUrl='',$ajax=false)
参数：

参数 类型 说明
$message string 错误信息
$jumpUrl string 是否为Ajax方式
$ajax bool 页面跳转地址

返回值：
void

源码：

  1. protected function error($message,$jumpUrl='',$ajax=false) {
  2. $this->dispatchJump($message,0,$jumpUrl,$ajax);
  3. }
 

isGet()

说明：
判断是否为get方式提交，魔术方法__call 中定义
protected bool isGet()
参数：
无
返回值：
如果是get方式提交返回true，否则返回false。

 

isPost()

说明：
判断是否为post方式提交，魔术方法__call中定义
protected bool isPost()
参数：
无
返回值：
如果是post方式提交返回true，否则返回false。

 

isPut()

说明：
判断是否为Put方式提交，魔术方法__call中定义
protected bool isPut()
参数：
无
返回值：
如果是put方式提交返回true，否则返回false。

 

isDelete()

说明：
判断是否为delete方式提交，魔术方法__call中定义
protected bool isDelete()
参数：
无
返回值：
如果是delete方式提交返回true，否则返回false。

 

isHead()

说明：
判断是否为head提交，魔术方法__call中定义
protected bool isHead()
参数：
无
返回值：
如果是head提交返回true，否则返回false。

 

ajaxReturn()

说明：
Ajax方式返回数据到客户端
protected void ajaxReturn($data,$info='',$status=1,$type='')
参数：

$data mixed 要返回的数据
$info string 提示信息
$status integer 返回状态
$type string ajax返回类型 支持JSON XML EVAL

返回值：
无
源码：

  1. protected function ajaxReturn($data,$info='',$status=1,$type='') {
  2. $result  =  array();
  3. $result['status']  =  $status;
  4. $result['info'] =  $info;
  5. $result['data'] = $data;
  6. //扩展ajax返回数据, 在Action中定义function ajaxAssign(&$result){} 方法 扩展ajax返回数据。
  7. if(method_exists($this,'ajaxAssign'))
  8. $this->ajaxAssign($result);
  9. if(empty($type)) $type  =   C('DEFAULT_AJAX_RETURN');
  10. if(strtoupper($type)=='JSON') {
  11. // 返回JSON数据格式到客户端 包含状态信息
  12. header('Content-Type:text/html; charset=utf-8');
  13. exit(json_encode($result));
  14. }elseif(strtoupper($type)=='XML'){
  15. // 返回xml格式数据
  16. header('Content-Type:text/xml; charset=utf-8');
  17. exit(xml_encode($result));
  18. }elseif(strtoupper($type)=='EVAL'){
  19. // 返回可执行的js脚本
  20. header('Content-Type:text/html; charset=utf-8');
  21. exit($data);
  22. }else{
  23. // TODO 增加其它格式
  24. }
  25. }
 

redirect()

说明：
Action跳转(URL重定向） 支持指定模块和延时跳转
protected function redirect($url,$params=array(),$delay=0,$msg='')
源码：

  1. protected function redirect($url,$params=array(),$delay=0,$msg='') {
  2. $url    =   U($url,$params);
  3. redirect($url,$delay,$msg);
  4. }
 

dispatchJump()

说明：
默认跳转操作 支持错误导向和正确跳转
private function dispatchJump($message,$status=1,$jumpUrl='',$ajax=false)
源码：

  1. private function dispatchJump($message,$status=1,$jumpUrl='',$ajax=false) {
  2. // 判断是否为AJAX返回
  3. if($ajax || $this->isAjax()) $this->ajaxReturn($ajax,$message,$status);
  4. if(!empty($jumpUrl)) $this->assign('jumpUrl',$jumpUrl);
  5. // 提示标题
  6. $this->assign('msgTitle',$status? L('_OPERATION_SUCCESS_') : L('_OPERATION_FAIL_'));
  7. //如果设置了关闭窗口，则提示完毕后自动关闭窗口
  8. if($this->view->get('closeWin'))    $this->assign('jumpUrl','javascript:window.close();');
  9. $this->assign('status',$status);   // 状态
  10. //保证输出不受静态缓存影响
  11. C('HTML_CACHE_ON',false);
  12. if($status) { //发送成功信息
  13. $this->assign('message',$message);// 提示信息
  14. // 成功操作后默认停留1秒
  15. if(!$this->view->get('waitSecond'))    $this->assign('waitSecond','1');
  16. // 默认操作成功自动返回操作前页面
  17. if(!$this->view->get('jumpUrl')) $this->assign("jumpUrl",$_SERVER["HTTP_REFERER"]);
  18. $this->display(C('TMPL_ACTION_SUCCESS'));
  19. }else{
  20. $this->assign('error',$message);// 提示信息
  21. //发生错误时候默认停留3秒
  22. if(!$this->view->get('waitSecond'))    $this->assign('waitSecond','3');
  23. // 默认发生错误的话自动返回上页
  24. if(!$this->view->get('jumpUrl')) $this->assign('jumpUrl',"javascript:history.back(-1);");
  25. $this->display(C('TMPL_ACTION_ERROR'));
  26. // 中止执行  避免出错后继续执行
  27. exit ;
  28. }
  29. }
 

__destruct()

说明：
析构方法
public function __destruct()
源码：

  1. public function __destruct() {
  2. // 保存日志
  3. if(C('LOG_RECORD')) Log::save();
  4. // 执行后续操作
  5. tag('action_end');
  6. }
  7. }

thinkphp action.class.php 学习的更多相关文章

  1. 根据ThinkPHP官方文档学习opensns框架

    根据ThinkPHP官方文档学习opensns框架 1.解读Application下各个Controller文件夹下的作用 控制器类的命名方式是:控制器名(驼峰法,首字母大写)+Controller ...

  2. Redis in Action : Redis 实战学习笔记

    1 1 1 Redis in Action : Redis  实战学习笔记 1 http://redis.io/ https://github.com/antirez/redis https://ww ...

  3. thinkphp快速入门（学习php框架及代码审计）

    之前想学习php代码审计,但是没有坚持下去,记得当时看到了很多CMS框架采用MVC架构,就嘎然而止了. 为了深入学习下框架,一边看着thinkphp官方文档,一边写个简单的登陆注册页面以加深理解. 官 ...

  4. Machine Learning In Action 第二章学习笔记: kNN算法

    本文主要记录<Machine Learning In Action>中第二章的内容.书中以两个具体实例来介绍kNN(k nearest neighbors),分别是: 约会对象预测 手写数 ...

  5. thinkphp action参数绑定

    参数绑定是通过直接绑定URL地址中的变量作为操作方法的参数,可以简化方法的定义甚至路由的解析. 参数绑定功能默认是开启的,其原理是把URL中的参数(不包括模块.控制器和操作名)和操作方法中的参数进行绑 ...

  6. opensns学习

    根据ThinkPHP官方文档学习opensns框架 主要看了下opensns所用的单一入口模式的意义. 基础 opensns目录结构 index.php 入口文件 Application 应用目录(含 ...

  7. Jqgrid学习API

    JQGrid是一个在jquery基础上做的一个表格控件,以ajax的方式和服务器端通信. JQGrid Demo 是一个在线的演示项目.在这里,可以知道jqgrid可以做什么事情. 下面是转自其他人b ...

  8. Action<>和Func<> 委托【代理】

    C#中的Action<>和Func<> 其实他们两个都是委托[代理]的简写形式. 一.[action<>]指定那些只有输入参数,没有返回值的委托 Delegate的 ...

  9. 一步一步学习C++

    根据<C++ primer>第五版 总结学习心得. 在实践中,不必全面地使用C++语言的各种特性,而应根据工程的实际情况,适当取舍(譬如动态类型信息,虚拟继承.异常等特性的使用,很值得商榷 ...

随机推荐

  1. CodeForces 593A

    题目链接: http://codeforces.com/problemset/problem/593/A 题意: 给你n个字符串,字符串只包含小写字母,从中选取任意个字符串,拼成一封信,这封信中至多有 ...

  2. floyd详解

    就不在来回搬了 请看 http://note.youdao.com/groupshare/?token=6422E952998F4381A1534B71359EFA57&gid=1579165 ...

  3. Oracle数据库操作常见异常总结

    1.非法的sql语句结束符\n,抛 java.sql.SQLSyntaxErrorException: ORA-00911: 无效字符 实际就是在sql语句的结尾多了标点符号. 2.无效的序列 通常都 ...

  4. 谈JSON在Ajax中的使用

    JSON是一种轻量级的数据交换格式.易于人阅读和编写,同时也易于机器解析和生成.AJAX是一种用于创建更好更快以及交互性更强的 Web 应用程序的技术.之前也曾介绍过在PHP语言中使用JSON的文章, ...

  5. CFBundleVersion与CFBundleShortVersionString，版本上架注意事项

    CFBundleVersion,标识(发布或未发布)的内部版本号.这是一个单调增加的字符串,包括一个或多个时期分隔的整数. CFBundleShortVersionString  标识应用程序的发布版 ...

  6. 设计模式----代理模式（Proxy）

    为还有一个对象提供一个替身或占位符以控制对这个对象的訪问. 代理模式的组成: 主题接口(Subject):提取真正主题与代理的公共方法,让使用真正主题的地方也能用代理取代. 真正主题(RealSubj ...

  7. rsyslog 报 WARNING: rsyslogd is running in compatibility mode.

      [root@localhost log]# uname -a Linux localhost.localdomain 2.6.32 #1 SMP Sun Sep 20 18:58:21 PDT 2 ...

  8. 黑白图像（DFS）

    输入一个n*n的黑白图像(1表示黑色,0表示白色),任务是统计其中八连块的个数.如果两个黑格子有公共边或者公共顶点,就说它们属于同一个八连块.如图6-11所示的图形有3个八连块. 图6-11  拥有3 ...

  9. Entity Framework CodeFirst------数据迁移（二）

    众所周知当我们的项目涉及到数据库时,随着需求或大或小的 变更后,我们之前设计好的数据模型会发生部分的更改,导致数据表.或者数据字段的增加.修改等,这个时候我们就需要对数据库结构进行修改,如果我们之前采 ...

  10. Python下载漫画

    上午起来提不起劲,于是就用电脑看漫画,但是在线看漫画好烦,就想下下来看.一个一个点太麻烦,于是花了点时间用python写了个demo,把爱漫画的漫画下载下来,这样就可以随时随地看了.这也是我首次尝试用 ...