约定:
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,array('score>80')) // 返回符合条件的第 2 条记录
$User->getN(-2,array('score>80')) //还可以获取最后第二条记录
$User->first(array('score>80','score desc')) //如果要查询第一条记录,还可以使用
$User->last(array('score>80','score desc')) // 获取最后一条记录
$User->top(5,array('score desc')) // 获取积分最高的前 5 条记录
$User->getBy('name','liu21st') //跟据字段的字段值来查询记录
$Model = new Model() // 实例化一个 model 对象 没有对应任何数据表
$Model->query("select * from think_user where status=1")//直接使用原生的sql语句
$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() // 输出模版文件
批量赋值,assign的单参数使用
$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,### } 或者 {:function(参数1,参数2)}
说明:
{ 和 $ 符号之间不能有空格 ,后面参数的空格就没有问题
###表示模板变量本身的参数位置
系统变量
{$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 } //现在时间
快捷输出(3.0及以后版本已去掉)
{:function(…)} //执行方法并输出返回值
{~function} //执行方法不输出
{@var} //输出 Session 变量
{&var} //输出配置参数
{%var} //输出语言变量
{.var} //输出 GET 变量
{^var} //输出 POST 变量
{*var} //输出常量
包含外部文件
<include file="$tplName" /> // 用变量控制要导入的模版
<include file="/Apps/home/Tpl/simple/Public/header.html" /> // 使用一个完整的文件名包含
注意:不能变量与字符串混用,如:<include file="User/$tplName" /> //这样是错误的
循环输出
volist 还有别名 iterate
模版赋值:
$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">
<iterate name="vo['sub']" id="sub">
{$sub.name}
</iterate>
</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);
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__ // 网站根目录地址
__APP__ // 当前项目(入口文件)地址
__URL__ // 当前模块地址
__ACTION__ // 当前操作地址
__SELF__ // 当前 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_VAILIDATE = 0 // 表单存在字段则验证
MUST_VALIDATE = 1 // 必须验证
VALUE_VAILIDATE = 2 // 表单值不为空则验证
add方法返回主键(id)的值
在往数据表中添加数据时调用add方法,默认返回值就是刚添加的id值,就不用再去查询了.
save方法返回值的判断
在修改数据时,如果修改成功返回的是被修改的记录数0,1,2,3......
注意:以下几种情况返回 false,所以判断更新失败应使用 if(false === $this->save())
(1)更新的数据为空
(2)_before_update()方法返回false
(3)没有任何更新条件(没有定义where()里的条件,或者保存的数据里没有主键的值)
查询后置方法详解
如_after_select,_after_insert,_after_update,_after_delete,_after_find等
巧妙地利用这些方法可以简化开发
用_after_select(&$result,$options)举例:
参数:$result,这是select出的结果数组。注意这里是一个引用传参,也就是说我们可以直接改变传递过来的值而不需要返回
$options,这是查询的条件,也就是where()里面的条件
假如你查询出的数据有time这一字段,并且是以int型保存的,那么可以在这个方法里进行时间格式化的操作
protected function _after_select(&$result,$options)
foreach($result as $key=>$value){
$result[$key]['time'] = date('Y-m-d H:i:s', $value['time']);
}
}
复制代码
这样就不需要每次在模板上显示的时候,再用函数来处理了
同样地,可以用_after_insert来代替关联操作,在新增完一条数据后再根据参数更新一些关联的数据
当然,除了后置方法,还有前置方法。可以用来代替一些复杂的数据验证或者进行数据的预处理,类似于自动完成和自动验证
protected function _before_insert(&$data,$options) {
//对新增前的数据进行处理
foreach ($data as $key=>$value){
$value['status'] = 1;//类似于自动完成
if($value['age'] > 100){//类似于自动验证
return false;
}
}
}
复制代码
最后,有几点需要注意的:1,这些方法都是必须写在model里面的
2,这些方法所接收的参数,有些是引用传参,有些是传值,得注意区分。具体可参考手册
3,在后置方法里不需要返回值。而前置方法里可以返回 false 来阻止进行下一步的操作
打印sql语句
$User = D('User');
$User->select();
echo $User->getLastSql();或者echo $User->_sql();
获取最后执行的sql语句,方便查看调试
跨模板主题调用模板
假如Tpl下有new主题,该主题下有User文件夹,文件夹下有index.html
你当前的模板主题是Tpl下的default,那么可以用$this->display('new:User:index');
或者用全路径输出$this->display('./Tpl/new/User/index.html');
路由规则^符号的使用
这个符号在手册中没有提及,但是作用却不可忽视。
用法:'user/^getlist|tag' => 'user/index'
作用:在user模块中,除了getlist和tag方法,其他存在的方法全部指向index方法。参数之间用|间隔
这样可以屏蔽一些不想让用户访问到但是又必须定义成public的方法
1、不定义方法,直接渲染模板。
对于没有任何实际逻辑的操作方法,我们只需要直接定义对应的模板文件就行了,比如表单页面,这个页面一般不会有变量向模板中输出,所以,我们没有必要再去写一个对应的空方法然后$this->display()了。
2、简介create方法。
假设我们实例化的模型为$model,那么ThinkPHP可以直接通过$model->add()的方式向数据库中添加数据,那么如果我们在$model->add()之前调用$model->create()方法,这样有什么意义呢?create()方法的意义只有一个“确保写入数据库的数据安全和有效”。
其中,数据的自动验证便是借助create方法来实现的。值得一提的是,用create方法实现自动验证,需要我们定义模型**Model.class.php,然后在实例化的时候使用D()方法进行实例化。
3、使用对象的方法插入数据。
可能你常常用下面的方式(数组方式)插入数据
$Form = D('Form');
$data['title'] = 'ThinkPHP';
$data['content'] = '表单内容';
$Form->add($data);
其实ThinkPHP还支持对象的方式直接向数据库插入数据,如下:
$Form = D('Form');
$Form->title = 'ThinkPHP';
$Form->content = '表单内容';
$Form->add();
4、不指定条件对数据更新。
$Form = M("Form"); // 要修改的数据对象属性赋值
$data['id'] = 5;
$data['title'] = 'ThinkPHP';
$data['content'] = 'ThinkPHP3.1版本发布';
$Form->save($data); // 根据条件保存修改的数据
save方法会自动识别数据对象中的主键字段,并作为更新条件。当然,你也可以显式的传入更新条件,也就是我们最常用的方法:
$Form = M("Form");
// 要修改的数据对象属性赋值
$data['title'] = 'ThinkPHP';
$data['content'] = 'ThinkPHP3.1版本发布';
$Form->where('id=5')->save($data); // 根据条件保存修改的数据
其实还有对象的方式,就像上面提到的,插入数据,用对象的方式一样:
$Form = M("Form");
// 要修改的数据对象属性赋值
$Form->title = 'ThinkPHP';
$Form->content = 'ThinkPHP3.1版本发布';
$Form->where('id=5')->save(); // 根据条件保存修改的数据
并且,可以将主键字段包含在要保存的数据里,这样就可以不需要写where了
$Form = M("Form");
// 要修改的数据对象属性赋值
$Form->id = 5;
$Form->title = 'ThinkPHP';
$Form->content = 'ThinkPHP3.1版本发布';
$Form->save(); // 根据数据对象中的主键保存修改的数据
5、单个字段值的修改。
有些时候,我们只需要修改某个字段的值,就可以使用setField方法,而不需要每次都调用save方法。
$Form = M("Form"); // 更改title值
$Form->where('id=5')->setField('title','ThinkPHP');
6、强大的增减字段值运算。
ThinkPHP中,可以对某个字段的数据直接执行增减操作。
对于统计字段,系统还提供了更加方便的setInc和setDec方法。
$User = M("User"); // 实例化User对象
$User->where('id=5')->setInc('score',3); // 用户的积分加3
$User->where('id=5')->setInc('score'); // 用户的积分加1
$User->where('id=5')->setDec('score',5); // 用户的积分减5
$User->where('id=5')->setDec('score'); // 用户的积分减1
7、不使用where来执行删除。
$User->delete('1,2,5'); // 删除主键为1,2和5的用户数据。
这种用法可以用在类似于签到时候,用户积分自动增加的例子上。
8、$this->assign()方法之单参数的使用
在ThinkPHP的手册中,有关于assign()方法的使用,这里对其作用不再叙述。而我们要讨论的是,assign方法如果只有一个参数的使用情况。
IndexAction.class.php
<?php
class IndexAction extends Action {
public function index(){
$var_array = array("color" => "blue",
"size" => "medium",
"shape" => "sphere");
$this->assign($var_array);
$this->display();
}
}
复制代码
?>
index.html
<html>
{$color} <!--这里输出blue-->
</html>
复制代码
由上面的例子可以看出,框架是将参数数组中的每一个键值对当成“参数”=>“值”的形式赋值到模板里了
所以,如果需要赋值到模板上的值很多的话,不妨用这种方式
注意:
由于这是隐式地赋值,要注意参数重名哦!特别是id、name这一类数据库常用的字段