S方法
在ThinkPHP中进行缓存操作,一般情况下并不需要直接操作缓存类,因为系统内置对缓存操作进行了封装,直接采用S方法即可,例如:
缓存初始化
// 缓存初始化
S(array('type'=>'xcache','expire'=>60));
缓存初始化可以支持的参数根据不同的缓存方式有所区别,常用的参数是:
参数 | 描述 |
---|---|
expire | 缓存有效期(时间为秒) |
prefix | 缓存标识前缀 |
type | 缓存类型 |
系统目前已经支持的缓存类型包括:Apachenote、Apc、Db、Eaccelerator、File、Memcache、Redis、Shmop、Sqlite、Wincache和Xcache
。
如果S方法不传入type参数初始化的话,则读取配置文件中设置的DATA_CACHE_TYPE
参数值作为默认类型。同样的道理,prefix参数如果没有传入会读取配置文件的DATA_CACHE_PREFIX
参数值,expire参数没有传入则读取DATA_CACHE_TIME
配置值作为默认。
有些缓存方式会有一些自身特殊的参数,例如Memcache缓存,还需要配置其他的参数:
S(array(
'type'=>'memcache',
'host'=>'192.168.1.10',
'port'=>'11211',
'prefix'=>'think',
'expire'=>60)
);
对于全局的缓存方式,一般我们建议添加prefix(缓存前缀)参数用以区分不同的应用,以免混淆。
缓存设置
// 设置缓存
S('name',$value);
会按照缓存初始化时候的参数进行缓存数据,也可以在缓存设置的时候改变参数,例如:
// 缓存数据300秒
S('name',$value,300);
甚至改变之前的缓存方式或者更多的参数:
// 采用文件方式缓存数据300秒
S('name',$value,array('type'=>'file','expire'=>300));
如果你在缓存设置的时候采用上面的数组方式传入参数的话,会影响到后面的缓存存取。
缓存读取
// 读取缓存
$value = S('name');
缓存读取的是前面缓存设置的值,这个值会受缓存初始化或者缓存设置的时候传入的参数影响。 如果缓存标识不存在或者已经过期,则返回false,否则返回缓存值。
缓存删除
// 删除缓存
S('name',null);
删除缓存标识为name的缓存数据。
对象方式操作缓存
我们可以采用对象方式操作缓存,例如:
// 初始化缓存
$cache = S(array('type'=>'xcache','prefix'=>'think','expire'=>600));
$cache->name = 'value'; // 设置缓存
$value = $cache->name; // 获取缓存
unset($cache->name); // 删除缓存
如果你设置了缓存前缀的话,对应的缓存操作只是对应该缓存前缀标识的,不会影响其他的缓存。
关于文件缓存方式的安全机制
如果你使用的是文件方式的缓存机制,那么可以设置DATA_CACHE_KEY参数,避免缓存文件名被猜测到,例如:
'DATA_CACHE_KEY'=>'think'
缓存队列
数据缓存可以支持缓存队列,简单的说就是可以限制缓存的数量,只需要在初始化的时候指定length
参数:
S(array('type'=>'xcache','length'=>100,'expire'=>60));
设置了length
参数后,系统只会缓存最近的100条缓存数据。
F方法
如果你的存储数据没有有效期的需求,那么系统还提供了一个快速缓存方法F可以用来更快的操作。
F方法可以支持不同的存储类型,如果是文件类型的话,默认保存在DATA_PATH目录下面。
快速缓存Data数据
F('data',$Data);
快速缓存Data数据,保存到指定的目录
F('data',$Data,TEMP_PATH);
获取缓存数据
$Data = F('data');
删除缓存数据
F('data',NULL);
F方法支持自动创建缓存子目录,在DATA_PATH
目录下面缓存data数据,如果User子目录不存在,则自动创建:
F('User/data',$Data);
系统内置的数据字段信息缓存就是用了快速缓存机制。
Thinkphp单字母函数使用指南
A方法
A方法用于在内部实例化控制器,调用格式:A(‘[项目://][分组/]模块','控制器层名称')
最简单的用法:
- $User = A('User');
- $User = A('Admin/User');
- $User = A('Admin://User');
.1版本增加了分层控制器的支持,所以还可以用A方法实例化其他的控制器,例如:
- $User = A('User','Event);
实例化控制器后,就可以调用该控制器中的方法,不过需要注意的情况是,在跨项目调用的情况下,如果你的操作方法 有针对当前控制器的特殊变量操作,会有一些未知的问题,所以,一般来说,官方建议需要公共调用的控制器层单独开发,不要有太多的依赖关系。
B方法
这是随着行为应运而生的新生函数,可以执行某个行为,例如
- B('app_begin');
- B('app_begin',array("name"=& gt;"tdweb","time"=>time()));
C方法是Think用于设置、获取,以及保存配置参数的方法,使用频率较高。
了解C方法需要首先了解下Think的配置,因为C方法的所有操作都是围绕配置相关的。Think的配置文件采用数组格式定义。
由于采用了函数重载设计,所以用法较多,我们来一一说明下。
设置参数
- C('DB_NAME','think');
- C('db_name','think');
项目的所有参数在未生效之前都可以通过该方法动态改变配置,最后设置的值会覆盖前面设置或者惯例配置里面的定义,也可以使用参数配置方法添加新的配置。
支持二级配置参数的设置,例如:
- C('USER.USER_ID',8);
如果要设置多个参数,可以使用批量设置,例如:
- $config['user_id'] = 1;
- $config['user_type'] = 1;
- C($config);
- C('USER_ID',1);
- C('USER_TYPE',1);
要获取设置的参数,可以用:
- $userId = C('USER_ID');
- $userType = C('USER_TYPE');
也可以支持获取二级配置参数,例如:
- $userId = C('USER.USER_ID');
- $config = C();
.1版本增加了一个永久保存设置参数的功能,仅针对批量赋值的情况,例如:
- $config['user_id'] = 1;
- $config['user_type'] = 1;
- C($config,'name');
保存之后,如果要取回保存的参数,可以用
- $config = C('','name');
D方法
D方法应该是用的比较多的方法了,用于实例化自定义模型类,是Think框架对Model类实例化的一种封装,并实现了单例模式,支持跨项目和分组调用,调用格式如下:
D(‘[项目://][分组/]模型','模型层名称')
方法的返回值是实例化的模型对象。
D方法可以自动检测模型类,如果存在自定义的模型类,则实例化自定义模型类,如果不存在,则会实例化Model基类,同时对于已实例化过的模型,不会重复去实例化。
D方法最常用的用法就是实例化当前项目的某个自定义模型,例如:
- // 实例化User模型
- $User = D('User');
- import('@.Model.UserModel');
- $User = new UserModel();
- new Model('User');
D方法可以支持跨分组和项目实例化模型,例如:
- //实例化Admin项目的User模型
- D('Admin://User')
- //实例化Admin分组的User模型
- D('Admin/User')
.1版本开始,由于增加了分层模型的支持,所以D方法也可以实例化其他的模型,例如:
- // 实例化UserService类
- $User = D('User','Service');
- // 实例化UserLogic类
- $User = D('User','Logic');
- D('User','Service');
- import('@.Service.UserService');
- $User = new UserSerivce();
F方法其实是S方法的一个子集功能,仅用于简单数据缓存,并且只能支持文件形式,不支持缓存有效期,因为采用的是返回方式,所以其效率较S方法较高,因此我们也称之为快速缓存方法。
F方法的特点是:
简单数据缓存;
文件形式保存;
采用返回数据方式加载缓存;
支持子目录缓存以及自动创建;
支持删除缓存和批量删除;
写入和读取缓存
- F('data','test data');
注意:确保你的缓存标识的唯一,避免数据覆盖和冲突。
下次读取缓存数据的时候,使用:
- $Data = F('data');
- F('user/data',$data); // 缓存写入
- F('user/data'); // 读取缓存
- F('level1/level2/data',$data);
- F('data',$data,TEMP_PATH);
- F('data','',TEMP_PATH);
删除缓存也很简单,使用:
- F('data',NULL);
支持批量删除功能,尤其是针对子目录缓存的情况,假设我们要删除user子目录下面的所有缓存数据,可以使用:
- F('user/*',NULL);
- F('user/[^a]*',NULL);
Thinkphp长期以来需要通过debug_start、debug_end方法甚至Debug类才能完成的功能,3.1版本中被一个简单的G方法取代了,不可不谓是一次华丽升级。
G方法的作用包括标记位置和区间统计两个功能,下面来看下具体用法:
标记位置
G方法的第一个用法就是标记位置,例如:
- G('begin');
运行时间统计
标记位置后,我们就可以再次调用G方法进行区间统计了,例如:
- G('begin');
- // ...其他代码段
- G('end');
- // ...也许这里还有其他代码
- // 进行统计区间
- echo G('begin','end').'s';
- 0.0056s
- G('begin','end',6).'s';
- 0.005587s
如果你的环境支持内存占用统计的话,还可以使用G方法进行区间内存开销统计(单位为kb),例如:
- echo G('begin','end','m').'kb';
- 625kb
如果环境不支持内存统计,则该参数无效,仍然会进行区间运行时间统计。
忘掉debug_start、debug_end吧,大道至简,你懂的~
I方法
Thinkphp的I方法是3.1.3版本新增的,如果你是之前的3.*版本的话,可以直接参考使用3.1快速入门教程系列的变量部分。
概述
正如你所见到的一样,I方法是Thinkphp众多单字母函数中的新成员,其命名来自于英文Input(输入),主要用于更加方便和安全的获取系统输入变量,可以用于任何地方,用法格式如下:
I(‘变量类型.变量名',[‘默认值'],[‘过滤方法'])
变量类型是指请求方式或者输入类型,包括:
get 获取GET参数
post 获取POST参数
param 自动判断请求类型获取GET、POST或者PUT参数
request 获取REQUEST 参数
put 获取PUT 参数
session 获取 $_SESSION 参数
cookie 获取 $_COOKIE 参数
server 获取 $_SERVER 参数
globals 获取 $GLOBALS参数
注意:变量类型不区分大小写。
变量名则严格区分大小写。
默认值和过滤方法均属于可选参数。
用法
我们以GET变量类型为例,说明下I方法的使用:
- echo I('get.id'); // 相当于 $_GET['id']
- echo I('get.name'); // 相当于 $_GET['name']
- echo I('get.id',0); // 如果不存在$_GET['id'] 则返回0
- echo I('get.name',''); // 如果不存在$_GET['name'] 则返回空字符串
- echo I('get.name','','htmlspecialchars'); // 采用htmlspecialchars方法对$_GET['name'] 进行过滤,如果不存在则返回空字符串
- I('get.'); // 获取整个$_GET 数组
- 1.I('post.name','','htmlspecialchars'); // 采用htmlspecialchars方法对$_POST['name'] 进行过滤,如果不存在则返回空字符串
- I('session.user_id',0); // 获取$_SESSION['user_id'] 如果不存在则默认为0
- I('cookie.'); // 获取整个 $_COOKIE 数组
- I('server.REQUEST_METHOD'); // 获取 $_SERVER['REQUEST_METHOD']
- echo I('param.id');
并且param类型变量还可以用数字索引的方式获取URL参数(必须是PATHINFO模式参数有效,无论是GET还是POST方式都有效),例如:
当前访问URL地址是
- http://serverName/index./New/2013/06/01
- echo I('param.1'); // 输出2013
- echo I('param.2'); // 输出06
- echo I('param.3'); // 输出01
- I('id'); // 等同于 I('param.id')
- I('name'); // 等同于 I('param.name')
使用I方法的时候 变量其实经过了两道过滤,首先是全局的过滤,全局过滤是通过配置VAR_FILTERS参数,这里一定要注意,3.1版本之后,VAR_FILTERS参数的过滤机制已经更改为采用array_walk_recursive方法递归过滤了,主要对过滤方法的要求是必须引用返回,所以这里设置htmlspecialchars是无效的,你可以自定义一个方法,例如:
- function filter_default(&$value){
- $value = htmlspecialchars($value);
- }
- 'VAR_FILTERS'=>'filter_default'
- 'VAR_FILTERS'=>'filter_default,filter_exp'
因为VAR_FILTERS参数设置的是全局过滤机制,而且采用的是递归过滤,对效率有所影响,所以,我们更建议直接对获取变量过滤的方式,除了在I方法的第三个参数设置过滤方法外,还可以采用配置DEFAULT_FILTER参数的方式设置过滤,事实上,该参数的默认设置是:
- 'DEFAULT_FILTER' => 'htmlspecialchars'
- I('get.name'); // 等同于 htmlspecialchars($_GET['name'])
- 'DEFAULT_FILTER' => 'strip_tags,htmlspecialchars'
- I('get.name'); // 等同于 htmlspecialchars(strip_tags($_GET['name']))
- echo I('get.name','','strip_tags'); // 等同于 strip_tags($_GET['name'])
- I('post.email','',FILTER_VALIDATE_EMAIL);
(关于更多的验证格式,可以参考 官方手册的filter_var用法。)
或者可以用下面的字符标识方式:
- I('post.email','','email');
- int
- boolean
- float
- validate_regexp
- validate_url
- validate_email
- validate_ip
- string
- stripped
- encoded
- special_chars
- unsafe_raw
- url
- number_int
- number_float
- magic_quotes
- callback
- I('get.name','',NULL);
L方法
L方法用于启用多语言的情况下,设置和获取当前的语言定义。
调用格式:L(‘语言变量',[‘语言值'])
设置语言变量
除了使用语言包定义语言变量之外,我们可以用L方法动态设置语言变量,例如:
- L('LANG_VAR','语言定义');
- L('lang_var','语言定义');
L方法支持批量设置语言变量,例如:
- $lang['lang_var1'] = '语言定义1';
- $lang['lang_var2'] = '语言定义2';
- $lang['lang_var3'] = '语言定义3';
- L($lang);
[-more-]
获取语言变量
- $langVar = L('LANG_VAR');
- $langVar = L('lang_var');
- $lang = L();
- {$Think.lang.lang_var}
M方法
M方法用于实例化一个基础模型类,和D方法的区别在于:
、不需要自定义模型类,减少IO加载,性能较好;
、实例化后只能调用基础模型类(默认是Model类)中的方法;
、可以在实例化的时候指定表前缀、数据库和数据库的连接信息;
D方法的强大则体现在你封装的自定义模型类有多强,不过随着新版Think框架的基础模型类的功能越来越强大,M方法也比D方法越来越实用了。
M方法的调用格式:
M(‘[基础模型名:]模型名','数据表前缀','数据库连接信息')
我们来看下M方法具体有哪些用法:
、实例化基础模型(Model) 类
在没有定义任何模型的时候,我们可以使用下面的方法实例化一个模型类来进行操作:
- //实例化User模型
- $User = M('User');
- //执行其他的数据操作
- $User->select();
- $User = M('User');
- $User = new Model('User');
、实例化其他公共模型类
第一种方式实例化因为没有模型类的定义,因此很难封装一些额外的逻辑方法,不过大多数情况下,也许只是需要扩展一些通用的逻辑,那么就可以尝试下面一种方法。
- $User = M('CommonModel:User');
- $User = new CommonModel('User');
、传入表前缀、数据库和其他信息
M方法有三个参数,第一个参数是模型名称(可以包括基础模型类和数据库),第二个参数用于设置数据表的前缀(留空则取当前项目配置的表前缀),第三个参数用于设置当前使用的数据库连接信息(留空则取当前项目配置的数据库连接信息),例如:
- $User = M('db2.User','think_');
如果第二个参数留空或者不传,表示使用当前项目配置中的数据表前缀,如果操作的数据表没有表前缀,那么可以使用:
- $User = M('db1.User',null);
如果你操作的数据库需要不同的用户账号,可以传入数据库的连接信息,例如:
- $User = M('User','think_','mysql://user_a:1234@localhost:3306/think');
第三个连接信息参数可以使用DSN配置或者数组配置,甚至可以支持配置参数。
例如,在项目配置文件中配置了:
- 'DB_CONFIG'=>'mysql://user_a:1234@localhost:3306/think';
- $User = M('User','think_','DB_CONFIG');
- $User = M('CommonModel:db2.User','think_');
- M('UserLogic:User');
- D('User','Logic');
R方法
R方法用于调用某个控制器的操作方法,是A方法的进一步增强和补充。关于A方法的用法见这里。
R方法的调用格式:
R(‘[项目://][分组/]模块/操作','参数','控制器层名称')
例如,我们定义了一个操作方法为:
- class UserAction extends Action {
- public function detail($id){
- return M('User')->find($id);
- }
- }
- $data = R('User/detail',array('5'));
- $data = R('User/detail');
- R('Admin/User/detail',array('5'));
- R('Admin://User/detail',array('5'));
官方的建议是不要在同一层多太多调用,会引起逻辑的混乱,被公共调用的部分应该封装成单独的接口,可以借助3.1的新特性多层控制器,单独添加一个控制器层用于接口调用,例如,我们增加一个Api控制器层,
- class UserApi extends Action {
- public function detail($id){
- return M('User')->find($id);
- }
- }
- $data = R('User/detail',array('5'),'Api');
同时,R方法调用操作方法的时候可以支持操作后缀设置C(‘ACTION_SUFFIX'),如果你设置了操作方法后缀,仍然不需要更改R方法的调用方式。
S方法
S方法还支持对当前的缓存方式传入缓存参数,例如:
- S('data',$Data,3600,'File',array('length'=>10,'temp'=>RUNTIME_PATH.'temp/'));
- { 'File',array('length'=>10,'temp'=>RUNTIME_PATH.'temp/')}
- S('data1',$list,array('prefix'=>aaa','expire'=>'3600','temp'=>RUNTIME_PATH.'temp/1236'));
- $sdata = S('data1','',array('prefix'=>'aaa','temp'=>RUNTIME_PATH.'temp/1236'));
为了更方便的输出模板文件,新版封装了一个T函数用于生成模板文件名。
用法:
T([资源://][模块@][主题/][控制器/]操作,[视图分层])
T函数的返回值是一个完整的模板文件名,可以直接用于display和fetch方法进行渲染输出。
例如:
- T('Public/menu');
- // 返回 当前模块/View/Public/menu.html
- T('blue/Public/menu');
- // 返回 当前模块/View/blue/Public/menu.html
- T('Public/menu','Tpl');
- // 返回 当前模块/Tpl/Public/menu.html
- T('Public/menu');
- // 如果TMPL_FILE_DEPR 为 _ 返回 当前模块/Tpl/Public_menu.html
- T('Public/menu');
- // 如果TMPL_TEMPLATE_SUFFIX 为.tpl 返回 当前模块/Tpl/Public/menu.tpl
- T('Admin@Public/menu');
- // 返回 Admin/View/Public/menu.html
- T('Extend://Admin@Public/menu');
- // 返回 Extend/Admin/View/Public/menu.html (Extend目录取决于AUTOLOAD_NAMESPACE中的配置)
- // 使用T函数输出模板
- $this->display(T('Admin@Public/menu'));
U方法
U方法用于完成对URL地址的组装,特点在于可以自动根据当前的URL模式和设置生成对应的URL地址,格式为:
U(‘地址','参数','伪静态','是否跳转','显示域名');
在模板中使用U方法而不是固定写死URL地址的好处在于,一旦你的环境变化或者参数设置改变,你不需要更改模板中的任何代码。
在模板中的调用格式需要采用 {:U('地址', '参数'…)} 的方式
U方法的用法示例:
- U('User/add') // 生成User模块的add操作地址
- U('Home/User/add') // 生成Home分组的User模块的add操作地址
- U('add') // 生成当前访问模块的add操作地址
- U('Blog/readid=1') // 生成Blog模块的read操作 并且id为1的URL地址
- U('Blog/cate',array('cate_id'=>1,'status'=>1))
- U('Blog/cate','cate_id=1&status=1')
- U('Blog/catecate_id=1&status=1')
- U('Blog/cate/cate_id/1/status/1')
- U('Blog/readid=1')
如果当前URL设置为普通模式的话,最后生成的URL地址是:
如果当前URL设置为REWRITE模式的话,同样的方法最后生成的URL地址是: http://serverName/Blog/read/id/1
如果你同时还设置了PATHINFO分隔符的话:
- 'URL_PATHINFO_DEPR'=>'_'
- U('Blog/read','id=1','xml')
- 'news/:id\d'=>'News/read'
- U('/news/1')
此外,U方法的第5个参数如果设置为true,表示自动识别当前的域名,并且会自动根据子域名部署设置APP_SUB_DOMAIN_DEPLOY和APP_SUB_DOMAIN_RULES自动匹配生成当前地址的子域名。
如果开启了URL_CASE_INSENSITIVE,则会统一生成小写的URL地址。
字母函数