thinkphp框架的相关总结

参考链接地址：http://gongwen.sinaapp.com/article-205.html

1. 模板中不能使用的标签
{$content} {$i}
2. If标签
如: <if condition="$name eq 1 ">
试验后总是有想不到的错误, 这样,还不如直接用<?php if(...){ ...?>来得快些呢.

约定:
1.所有类库文件必须使用.class.php作为文件后缀,并且类名和文件名保持一致
2.控制器的类名以Action为后 缀
3.模型的类名以Model为后缀,类名第一个字母须大写
4.数据库表名全部采用小写,

如:
数据表名: 前缀_表名
模型类名: 表名Model 注:这里的表名第一个字母要大写
创建对象: D('表名') 注:这里的表名第一个字母要大写

定义控制器类
class IndexAction extends Action{
public function show(){
echo '这是新的 show 操作';
}
}
然后在浏览器里面输入
http://localhost/myApp/index.php/Index/show/

定义模型类:
class 表名Model extends Model{
[//手动定义字段[可选]
protected $fields = array(
'id',
'username',
'email',
'age',
'_pk'=>'id', //主键
'_autoInc'=>true //是否自增
)
]
}

记录的修改:
$User = D("User") // 实例化 User 对象
$User->find(1) // 查找 id 为 1 的记录
$User->name = 'ThinkPHP' // 把查找到的记录的名称字段修改为 ThinkPHP
$User->save() // 保存修改的数据
更新特定字段的值
$User->setField('name','TopThink','id=1')
同 样可以支持对字段的操作
$User->setField('score','(score+1)','id=1')

新建记录,方法1:
$User = new UserModel() //实例化 User 对象
$User->字 段名 = 字段值 //给字段赋值
$User->add() //添加记录
新建记录,方法2:
$data['字段名'] = 字段值; //给字段赋值
$User = D('User'); //实例化 User 对象
$User->add($data); //$insertId,Add 方法的返回值就是最新插入的主键值，可以直接获取。
新增多条记录:
$User = new UserModel()
$data[0]['name'] = 'ThinkPHP'
$data[0]['email'] = 'sjolzy@chen.com'
$data[1]['name'] = '流年'
$data[1]['email'] = 'chen@sjolzy.cn'
$User>addAll($data)

删除记录
$User->find(2)
$User->delete() // 删除查找到的记录
$User->delete('5,6') // 删除主键为 5、6 的数据
$User->deleteAll() // 删除查询出来的所有数据

记录查询

$User->getDbFields() //获取当前数据字段
$User->findAll(); //查找所有记录
$User->findAll('1,3,8') //查询主键为1,3,8的记录集
$User->count() // 获取记录数
$User->max('score') // 获取用户的最大积分
$User->min('score','score>0') // 获取积分大于 0 的用户的最小积分
$User->avg('字段名') // 获取所有记录的字段值的平均值
$User->sum('字段名 ') // 统计字段值
$User->getN(2,'score>80','score desc') // 返回符合条件的第 2 条记录
$User->getN(2,'score>80','score desc') //还可以获取最后第二条记录
$User->first('score>80','score desc') //如果要查询第一条记录，还可以使用
$User->last('score>80','score desc') // 获取最后一条记录
$User->top(5,'','score desc') // 获取积分最高的前 5 条记录
$User->getBy('name','liu21st') //跟据字段的字段值来查询记录

$Model = new Model() // 实例化一个 model 对象 没有对应任何数据表
$Model->query("select * from think_user where status=1")

$objrs = $Model->query("select * from think_user where status=1") //自定义查询
$Model->execute("update think_user set name='thinkPHP' where status=1") //用于更新和写入数据的 sql 操作，返回影响的记录数

$User->startTrans() // 启动事务
$User->commit() // 提交事务
$User->rollback() // 事务回滚

模板:

$this->assign('name',$value); //在 Action 类里面使用 assign 方法对模板变量赋值，无论何种变量类型都统一使用 assign 赋值

$this->display() // 输出模版文件

批量赋值
$array['name'] = 'thinkphp'
$array['email'] = 'chen@sjolzy.cn'
$array['phone'] = '12335678'
$this->assign($array)

$this->display() // 调用 User 模块的 read 操作模版
$this->display('edit') // 调用 User 模块的 edit 操作模版
$this->display('Member:read') // 调用 Member 模块的 read 操作模版
$this->display('Xp@User:edit') // 调用 Xp 主题的 User 模块的 edit 操作模版
$this->display('../Member/read.html') // 直接指定模版文件的全名

模板标签:

{ } 或 {// 注释内容 } //模板注释
{$user['name']} //输出数组变量
{$user:name} //输出对象的属性

为了方便模板定义，无论输出的模板变量是数组还是对象，都可以用下列统一方式输出：
{$user.name}
如果是多维数组或者多 层对象属性的输出，请使用下面的定义方式：
{$user['sub']['name']}
{$user:sub:name}

使用函数:
格式：{$varname|function1|function2=arg1,arg2,### }
说明：
{ 和 $ 符号之间不能有空格 ，后面参数的空格就没有问题
###表示模板变量本身的参数位置

系统变量
{$Think.server.script_name } //取得$_SERVER 变量
{$Think.session.session_id|md5 } // 获取$_SESSION 变量
{$Think.get.pageNumber } //获取$_GET 变量
{$Think.cookie.name } //获取$_COOKIE 变量
系统常量
{$Think.const.__FILE__ }
{$Think.const.MODULE_NAME }
特殊变量 ，由 ThinkPHP 系统定义的常量
{$Think.version } //版本
{$Think.now } //现在时间

快捷输出
{:function(…)} //执行方法并输出返回值
{~function} //执行方法不输出
{@var} //输出 Session 变量
{&var} //输出配置参数
{%var} //输出语言变量
{.var} //输出 GET 变量
{^var} //输出 POST 变量
{*var} //输出常量

包含外部文件
<include file="$tplName" /> // 用变量控制要导入的模版
<include file="/Root/Tpl/Public/header.html" /> // 使用一个完整的文件名包含

循环输出
iterate 还有其它的别名，包括 volist,resultset,sublist

模版赋值:
$User = D('User')
$list = $User->findAll()
$this->assign('list',$list)

模版定义:
<iterate name="list" id="vo">
{$vo.name}
</iterate>

注意 name 和 id 表示的含义
// 输出 list 的第 5～15 条记录
<iterate name="list" id="vo" offset="5" length='10'>
{$vo.name}
</iterate>

// 输出偶数记录
<iterate name="list" id="vo" mod="2" >
<eq name="mod" value="1">
{$vo.name}
</eq>
</iterate>

// 输出 key
<iterate name="list" id="vo" key="k" >
{$k}.{$vo.name}
</iterate>

//子循环输出
<volist name="list" id="vo">
<sublist name="vo['sub']" id="sub">
{$sub.name}
</sublist>
</volist>

Switch 标签
<switch name="name">
<case value="1">value1</case>
<case value="2">value2</case>
<default />default
</switch>
其 中 name 属性可以使用函数以及系统变量，例如：
<switch name="Think.get.userId|abs">
<case value="1">admin</case>
<default />default
</switch>
也 可以对 case 的 value 属性使用变量，例如：
<switch name="userId">
<case value="$adminId">admin</case>
<case value="$memberId">member</case>
<default />default
</switch>

比较标签
<eq name="name" value="value">value</eq> // name 变量的值等于 value 就输出
<neq name="name" value="value">value</neq> // name 变量的值不等于 value 就输出
<gt name="name" value="5">value</gt> // name 变量的值大于 5 就输出
<egt name="name" value="5">value</egt> // name 变量的值大于等于 5 就输出
<lt name="name" value="5">value</lt> // name 变量的值小于 5 就输出
<elt name="name" value="5">value</elt> // name 变量的值小于等于 5 就输出

//其实上面的所有标签都是 compare 标签的别名
// 其中 type 属性的值就是上面列出的判断标签名称
<compare name="name" value="5" type="eq">value</compare> // name 变量的值等于 5 就输出

If标签
<if condition="$name eq 1 "> value1
<elseif condition="$name eq 2" />value2
<else /> value3
</if>

C操作
操作(动态)配置: 主要用于Action方法里面
获取:
C('配置参数')
设置:
C('配置参数 ',新值)

A操作
快速创建Action对象:
$action = A('User');
等效于
$action = new UserAction();

D操作
快速创建模型数据对象:
$model = D('User');
等效于
$model = new UserModel();

S操作
快速操作缓存方法
获取:
S('name')
设置:
S('name','value');
删 除:
S('name',NULL);

F操作
快速文件数据保存方法
使用方法与S操作一样

L操作
快速操作语言变量
获取:
L('语言变量');
设置:
L('语言变量','值');
如: L('USER_INFO','用户信息'); //设置名称为USER_INFO的语言变量
批量赋值:
$arr['语言变量1'] = '值1';
$arr['语言变量2'] = '值2';
L($arr);

Create PROCEDURE procedure1

(IN parameter1 INTEGER)

BEGIN

DECLARE variable1 CHAR(10);

IF parameter1 = 17 THEN

SET variable1 = 'birds';

ELSE

SET variable1 = 'beasts';

END IF;

Insert INTO table1 VALUES (variable1);

END

ThinkPHP系统常量

THINK_PATH   // ThinkPHP 系统目录
APP_PATH   // 当前项目目录
APP_NAME   // 当前项目名称
MODULE_NAME   //当前模块名称
ACTION_NAME   // 当前操作名称
TMPL_PATH   // 项目模版目录
LIB_PATH   // 项目类库目录
CACHE_PATH   // 项目模版缓存目录

CONFIG_PATH   //项目配置文件目录
LOG_PATH   // 项目日志文件目录
LANG_PATH   // 项目语言文件目录
TEMP_PATH   //项目临时文件目录
PLUGIN_PATH   // 项目插件文件目录
VENDOR_PATH   // 第三方类库目录
DATA_PATH   // 项目数据文件目录
IS_APACHE   // 是否属于 Apache
IS_IIS    //是否属于 IIS
IS_WIN    //是否属于Windows 环境
IS_LINUX   //是否属于 Linux 环境
IS_FREEBSD   //是否属于 FreeBsd 环境
NOW_TIME   // 当前时间戳
MEMORY_LIMIT_ON // 是否有内存使用限制

MEMORY_LIMIT_ON // 是否有内存使用限制
OUTPUT_GZIP_ON   // 是否开启输出压缩
MAGIC_QUOTES_GPC // MAGIC_QUOTES_GPC
THINK_VERSION   //ThinkPHP 版本号
LANG_SET   // 浏览器语言
TEMPLATE_NAME   //当前模版名称
TEMPLATE_PATH   //当前模版路径
  // 网站根目录地址
/root.php   // 当前项目（入口文件）地址
/root.php/Article   // 当前模块地址
/root.php/Article/modifyArticle   // 当前操作地址
/root.php/Article/modifyArticle/id/205.html   // 当前 URL 地址
TMPL_FILE_NAME   //当前操作的默认模版名（含路径）
WEB_PUBLIC_URL   //网站公共目录
APP_PUBLIC_URL   //项目公共模版目录

预定义常量
WEB_LOG_ERROR=0     // 错误日志类型
WEB_LOG_DEBUG=1 // 调试日志类型
SQL_LOG_DEBUG=2   // SQL 日志类型
SYSTEM_LOG=0   // 系统方式记录日志
MAIL_LOG=1   // 邮件方式记录日志
TCP_LOG=2   // TCP 方式记录日志
FILE_LOG=3   // 文件方式记录日志
DATA_TYPE_OBJ=1 // 对象方式返回
DATA_TYPE_ARRAY=0 // 数组方式返回
URL_COMMON=0   // 普通模式 URL
URL_PATHINFO=1   // PATHINFO URL
URL_REWRITE=2   // REWRITE URL
HAS_ONE=1   // HAS_ONE 关联定义
BELONGS_TO=2   // BELONGS_TO 关联定义
HAS_MANY=3   // HAS_MANY 关联定义
MANY_TO_MANY=4   // MANY_TO_MANY 关联定义
EXISTS_TO_VAILIDATE = 0 // 表单存在字段则验证
MUST_TO_VALIDATE = 1 // 必须验证
VALUE_TO_VAILIDATE = 2 // 表单值不为空则验证

上传概述
上传类使用ORG类库包中的Net.UpdateFile类，ThinkPHP内置的Action操作里面（主要是insert和update操作，其他操作可以相应实现）实现了自动识别是否存在文件上传，如果存在会自动进行处理。

而上传类要做的仅仅是文件上传的过程，其他功能需要依赖系统类库或者相应类库。系统对文件上传设置了很多灵活的参数以便进行更细致的控制。下面我们通过几
种常用的例子分别来描述下如何使用UploadFile类。目前ThinkPHP0.9.5版本的上传类包含的功能如下（有些功能需要结合
ThinkPHP系统其他类库）：
1、基本上传功能
2、批量上传
3、Ajax方式上传
4、自动生成图片缩略图
5、自定义参数上传

基本上传功能

基本上，在ThinkPHP中简单的上传功能无需进行特别处理，而全部有内置操作实现了。要做的仅仅是在表单中添加文件上传框和设置
enctype="multipart/form-data"属性即可。当然，这和框架的架构和数据结构有关，因为ThinkPHP的上传数据表是单独
的，上传文件数据表中有两个关键的用于记录对应数据的字段：module和recordId，其实module也就是某个数据表，而recordId也就
是该数据表对应的数据ID。在其他任何需要上传的数据表中可以方便地查询到属于自己的附件列表，就是采用这种机制和结构，令得ThinkPHP的上传变得
简化了。
下面就是实现代码：

<form METHOD=POST action="/root.php/Article/action/" enctype="multipart/form-data" > 
<INPUT TYPE="text" NAME="name" > INPUT TYPE="text" NAME="email" > 
<INPUT TYPE="file" name="photo" > INPUT TYPE="submit" value="保 存" > 
</form>
复制代码

上面的表单，在保存用户数据的同时包括了一个照片文件上传，使用普通方式提交到后台后，系统自动会把用户数据保存在用户数据表中，而把上传的文件保存到附件数据表，并记录了对应的用户数据表的名称和编号。下次取得数据的时候，使用下面的方式获取属于该记录的附件列表：

//读取附件信息 
$attachDao = D('AttachDao'); 
$attachs = $attachDao->findAll("module='User' and recordId='$id'");
//模板变量赋值
$this->assign("attach",$attachs);
复制代码

批量上传
ThinkPHP上传类支持多文件上传，而这些仅仅是在客户端增加多个文件上传框而已，后台会自动获取所有的文件上传，并一一进行上传和保存数据操作，并且过滤无效的上传。批量上传的一个例子：
假设用户往自己的图片库里面添加多个图片

<form METHOD=POST action="/root.php/Article/action/" enctype="multipart/form-data" > 
<INPUT TYPE="file" name="photo1" > INPUT TYPE="file" name="photo2" > 
<INPUT TYPE="file" name="photo3" > INPUT TYPE="submit" value="上传图片" > 
</form>
复制代码
需要注意，UploadFile上传类对多文件上传并不是采用 
<INPUT TYPE="file" name="photo[]" >
方式，注意区别两种方式的不同。
上传文件的个数并无限制，ThinkPHP管理后台还实现了一个动态增加文件上传的功能。通过该方式可以方便地进行多文件批量上传。

Ajax文件上传
通过简单的参数设置就可以把文件上传改装成AJAX方式（Iframe实现方式），而你要做的仅仅是添加下面代码：

<iframe name="ajaxUpload" src="" frameborder="0" SCROLLING="no" style="display:none"></iframe> 
<INPUT TYPE="hidden" name="_AJAX_SUBMIT_" value="1">
< INPUT TYPE="hidden" name="_uploadFormId" value="upload"> 
<INPUT TYPE="hidden" name="_uploadFileResult" value="result">
< INPUT TYPE="hidden" name="_uploadResponse" value="uploadComplete">
复制代码

_uploadFormId用于设置上传表单id，用于在上传成功后重置表单，避免重复上传。在_uploadFileResult变量中设置返回提示的
层id，在_uploadResponse参数中设置文件上传返回数据的处理方法。该方法返回两个参数：id和name，如果有多文件上传，使用逗号分割
多个返回值。ThinkPHP框架的Action类中的ajaxUploadResult方法对Ajax文件上传的信息返回提供支持。
例如，第一个例子上传后希望更新照片，使用下面的方法定义：

function uploadComplete(id,name){ 
         
 $('photo').innerHTML = '<IMG SRC="/Public/Images/user/' + name + '"
class="shadow" BORDER="0" ALT="" align="left">'; 
}
复制代码

下面的示例是AJAX文件上传的实现画面，左边图片会上传成功后自动更新。

自动生成缩略图
如果希望在上传过程自动为图片文件生成缩略图，ThinkPHP的UploadFile类也可以轻松实现，而且不需要你多特殊添加缩略图处理代码。要做的也仅仅是在客户端添加如下参数：

// 设置是否需要生成图片缩略图，仅对图片上传有效 
<INPUT TYPE="hidden" name="_uploadImgThumb" value="1"> // 生成缩略图的最大宽度 
<INPUT TYPE="hidden" name="_uploadThumbMaxWidth" value="45"> // 生成缩略图的最大高度 
<INPUT TYPE="hidden" name="_uploadThumbMaxHeight" value="45">
复制代码

设置后系统在上传后会自动生成相同格式的缩略图。系统默认的缩略图路径是上传文件所在目录，并且在文件中后面添加_thumb以标识缩略图文件。缩略图路径可以在项目配置文件中配置。

生成多缩略图
ThinkPHP支持对上传的图片生成多缩略图，TOPThink社区的头像功能就是多缩略图功能的例子，使用起来也非常简单。下面的代码是TOPThink社区上传头像的部分缩略图代码：

<INPUT TYPE="hidden" name="_uploadImgThumb" value="1"> 
<INPUT TYPE="hidden" name="_uploadThumbSuffix" value="_big,_small,_min"> 
<INPUT TYPE="hidden" name="_uploadThumbMaxWidth" value="75,32,16"> 
<INPUT TYPE="hidden" name="_uploadThumbMaxHeight" value="75,32,16">
复制代码

上面的例子表示生成三个大小的缩略图，并规定了缩略图文件名后面添加的后缀，和三种缩略图的宽高尺寸。

更多上传设置
ThinkPHP在Action来中还提供了和UploadFile类的上传设置接口，方便在客户端进行更多的参数设置进行上传控制。
下面列举下主要的参数，更多的参数可以参考框架的Action类中的_upload方法。

// 设置覆盖方式上传 
<INPUT TYPE="hidden" name="_uploadReplace" value="1"> // 设置允许上传文件类型 
<INPUT TYPE="hidden" name="_uploadFileType" value="jpg,gif,png,swf" > // 上传文件保存目录，要注意设置可写权限 
<INPUT
TYPE="hidden" name="_uploadSavePath" value="/Public/Images/user/" >
// 上传文件名命名规则，支持函数，例如time uniqid com_create_guid
系统默认设置为uniqid保证上传文件名不会重复，如果不存在设置函数，则使用规则字符串作为上传文件名 
<INPUT TYPE="hidden" name="_uploadSaveRule" value="time"> // 设置上传文件大小 
<INPUT
TYPE="hidden" name="_uploadFileSize" value="20480" > //
设置上传数据表，默认的上传数据记录在当前模块表中 <INPUT TYPE="hidden" name="_uploadFileTable"
value="user"> // 设置上传文件对应的数据编号，通常不用设置，除非特别需要
<INPUT TYPE="hidden" name="_uploadRecordId" value=""> // 设置上传用户id，通常不用设置，系统自动获取当前登录用户编号 
<INPUT TYPE="hidden" name="_uploadUserId" value="{$user.id}">