编辑“ThinkPHP-函数参考-系统函数库”

<span style="border:1px solid #000; float:right; text-align:center; padding:6px;"><strong>导航：</strong>[[ThinkPHP使用手册|返回上一页]]</span>
<div style="clear:both;"></div>

系统函数库的方法无需导入，可以直接使用，下面按照字母排序列出每个函数及其参数。

*A(name, app='@') 

实例化Action， name表示Actin名称 app表示项目名，默认是当前项目.返回实例化后的Action对象，如果对应的Action类不存在则返回false

*auto_charset(contents, from, to) 

编码转换，把contents从from转换到to，contents支持字符串和数组

*B(name) 

调用行为 name表示行为名称

*C(name=null,value=null) 

获取和设置配置定义，获取已有的配置值 C('name') 新增或者更改设置C('name','value') 如果name的值是数组，表示批量赋值

*cookie(name,value='',option=null) 

[[Cookie]] 设置、获取、清除 name

*D(name='',app='') 

实例化模型类，name表示模型的名称，如果留空，表示实例化空模型，app表示项目名 默认是当前项目。跨项目实例化的话，项目目录必须保证同级。返回实例化后的Model类，如果对应的模型类不存在，则抛出异常

*debug_start(label='') 

区间调试开始，label表示区间的标签名，例如 debug_start('read')

*debug_end(label='') 

区间调试结束，label表示区间的标签名，必须和debug_start对应才能输出正确

*dump(var, echo=true,label=null, strict=true) 

[[浏览器]]友好的变量输出，var支持任何变量，[[echo]]表示是否需要输出，如果为否，则返回要显示的字符串。Strict表示是否输出详细信息，如果为否，使用print_r输出，如果为是，使用var_dump输出。Dump函数还支持xdebug扩展

*F(name,value='',path=DATA_PATH) 

快速文件数据读取和保存 针对简单类型数据 字符串、数组，F方法不支持缓存有效期 name为缓存名称（也就是缓存文件名），value表示缓存值，如果为NULL表示删除缓存，留空表示获取缓存值，其他情况表示设置缓存，path表示缓存文件所在路径，默认是项目的数据目录

*file_exists_case(filename) 

区分大小写的文件存在判断，只在[[Windows]]环境下面有效，[[Linux]]环境本身就区分大小写

*get_instance_of(name,method='',args=array()) 

单例化某个类，同时可以传入类的方法和参数

*halt (error) 

输出错误并中止执行

*import(class,baseUrl = '',ext='.class.php') 

基类库或者应用类库导入，class表示要导入的类库，采用命名空间的方式，例如：import('Think.Util.Session') baseUrl表示导入的基础路径，留空的话系统有默认的规则，除了Think、ORG和Com类库包位于系统基类库目录外，其他方式都位于项目类库目录，ext表示类库后缀，默认是.class.php

*L(name=null,value=null) 

获取和设置语言定义 name表示语言变量名，value表示语言定义值，留空为获取语言定义

*M(name='',class='Model') 

快速实例化模型类，name表示模型名称，但无需创建具体模型类（需要有对应的数据表即可），class表示要实例化的类名，默认是Model类，也可以使用其他模型类，例如M('User', 'AdvModel') 实例化高级模型类的用户模型

*mk_dir(dir, mode = 0755) 

循环创建目录，如果dir参数中存在未创建的多级目录，会自动依次创建，mode表示目录的权限

*R(module,action,app='@') 

远程调用模块的操作方法，module是[[模块]]名，action是操作名，app是项目名，默认是当前项目

*require_cache(filename) 

优化的require，可以替代require和require_once函数

*redirect(url,time=0,msg='') 

[[URL]]重定向， url必须是一个完整的URL地址，time表示等待时间，单位为秒，msg表示等待的提示信息

*S(name,value='',expire='',type='') 

缓存设置或者读取 name表示缓存名称，value表示缓存的值，如果留空则表示获取缓存值，如果为NULL表示删除缓存，否则表示设置缓存，expire表示有效期，单位为秒，type是使用的缓存类型，包括File、APC、Db、Memcache、Shmop、Eaccelerator、Sqlite和Xcache

*tag(name,params=array()) 

执行某个标签的方法，用于应用扩展的标签执行

*throw_exception(msg,type='ThinkException',code=0) 

抛出异常，msg为错误信息，type为异常类型 code为异常代码

*to_guid_string(mix) 

根据[[PHP]]各种类型变量生成唯一标识号

U (url,params=array(),redirect=false,suffix=true) 

根据当前URL配置生成URL地址 并支持跳转url表示URL规则，支持'[项目://][路由@][分组名-模块/]操作'和 '[项目://][路由@][分组名-模块/]操作?参数1=值1&参数2=值2' ,params表示参数，必须使用数组传入,redirect表示是否需要跳转到生成的URL地址. suffix表示是否添加伪静态后缀，设置了伪静态后有效

*vendor(class,baseUrl = '',ext='.php') 

导入第三方类库，用法同import，只是baseUrl的默认值位于项目的第三方类库目录，ext后缀默认为.php

*W(name,data=array(),return=false) 

输出Widget，name为Widget名称 data表示传入的参数，必须使用数组，return表示是否需要返回结果，默认直接输出

*xml_encode(data,encoding='utf-8',root="think") 

把数组转换成[[XML]]，用于内置的[[AJAX]]返回XML格式的数据

==参考资料==
*[http://www.thinkphp.cn ThinkPHP官方]

[[category:ThinkPHP]]