1.基本概念:
在程序中实现特定功能的代码段。
封装函数,可以提高代码的复用率。
2.声明语法:
1).语法
function函数名([参数列表]){
函数体
[return]
}
3.五要素
function关键字
函数名
参数列表
函数体
返回值
4.调用语法
1).语法
函数名([参数1,参数2,...]);
5.函数名
1) 命名规则
同标识符命名(字母数字下滑线组成,不能以数字开头)。
cookie 方法
作用:自动加上系统cookie前缀并返回cookie值
语法:string cookie($name= '')
参数:$name 需要得到的cookie名称(不含前缀)
示例:
cookie('uid');
encrypt 方法
作用:加密字符串并返回加密结果
语法:string encrypt($txt, $key = '')
参数: $txt 待加密的字符串
$key 密钥
示例:
encrypt('password','cb8d4e597fc751a56dc30258c4db1226'); // 输出KHEZ1IzRZpLV9Bg
decrypt 方法
作用:解密字符串
语法:string decrypt($txt, $key = '')
参数: $txt 待解密的字符串
$key 密钥
示例:
decrypt('KHEZ1IzRZpLV9Bg','cb8d4e597fc751a56dc30258c4db1226'); // 输出password
getIp 方法
作用:取得IP地址
语法:getIp()
getReferer 方法
作用:取得上一步来源地址
语法:string geReferer()
Model 方法
作用:实例化模型
语法:object Model($model = null)
参数:$model 待实例的模型,$model也可以为空,这样会实例化一个空模型
示例:
$model = Model();
//或
$model = Model('member');
redirect 方法
作用:页面重定向
语法:redirect ($url= '')
参数:$url 需要重定向的地址,若为空,系统定向到上一页地址
示例:
redirect('http://www.shopnc.net')
readDirList 方法
作用:读取同目录下的文件夹并返回数组
语法:array readDirList($path)
参数:$path 需要读取的目录
示例:
readDirList('/var/www/shopnc');
//输出
Array
(
[0] => admin
[1] => cache
[2] => control
[3] => framework
[4] => upload
)
replaceSpecialChar 方法
作用:转换特殊字符,将里面的 \r\n,\t,\n去除
语法:string replaceSpecialChar ($string)
参数:$string 需要转换的字符
setNcCookie 方法
作用:保存cookie
语法:setNcCookie($name, $value, $expire='3600', $path='', $domain='', $secure=false)
参数: $name cookie名称
$value cookie值
$expire cookie有效期,单位秒,默认3600
$path cookie 的服务器路径 默认为 /
$domain cookie 的域名
$secure 是否通过安全的 HTTPS 连接来传输 cookie,默认为false
示例:
setNcCookie('uid',1000,2*3600); // 保存2小时
setNcCookie('uid','',time()-3600); // 过期
showMessage 方法
作用:输出提示信息
语法:
showMessage($msg,$url='',$show_type='html',$msg_type='succ',$is_show=1,$time=2000)
参数:
$msg 待输出的信息
$url 跳转地址 当$url为数组时,结构为 array('msg'=>'跳转连接文字','url'=>'跳转连接')
$show_type 输出格式 默认为html
$msg_type 信息类型 succ 为成功,error为失败/错误
$is_show 是否显示跳转链接,默认是为1,显示
$time 跳转时间,默认为2秒
示例:
showMessage('保存成功');
showMessage('保存失败','index.php?act=brand','html','error');
showDialog 方法
作用:消息提示,只适用于页面AJAX提交的情况
语法:showDialog($message = '', $url = '', $alert_type = 'error', $extrajs = '', $time = 2)
参数:
$message 消息内容
$url 提示完后的URL去向
$alert_type 提示类型 error/succ/notice 分别为错误/成功/警示
$extrajs 扩展JS脚本
$time 消息停留时间,默认为2秒
示例:
showDialog('保存成功','index.php?act=voucher&op=list');
setTimeZone 方法
作用:设置时区
语法:showDialog($message = '', $url = '', $alert_type = 'error', $extrajs = '', $time = 2)
参数: $time_zone 时区键值
示例:
setTimeZone(8); //设置东8区
showEditor 方法
作用:输出编辑器
语法:
showEditor($id, $value='', $width='700px', $height='300px',
$style='visibility:hidden;',$upload_state="true", $media_open=false)
参数:
$id 编辑器id名称,与name同名
$value 编辑器内容
$width 宽 带单位px
$height 高 带单位px
$style 样式内容
$upload_state 上传状态,默认开启
示例:
showEditor('content','这是内容','600px','400px','visibility:hidden;','false','false');
getDirSize 方法
作用:获取目录大小
语法:numeric getDirSize($path, $size=0)
参数:
$path 目录
$size 目录大小
示例:
$size = getDirSize('d:/root/ssi')/1024;
echo number_format($size,2).' KB'; //输出24.02KB
delCacheFile 方法
作用:删除缓存目录下的文件或子目录文件,但不会删除默认的index.html文件
语法:bool delCacheFile($dir)
参数:
$dir 目录名或文件名
示例:
//删除cache/fields目录除index.html外的文件
delCacheFile('fields');
readFileList 方法
作用:获取文件列表(所有子目录文件)
语法:array readFileList($path,&$file_list,$ignore_dir=array())
参数:
$path 目录
$file_list 存放所有子文件的数组
$ignore_dir 需要忽略的目录或文件
ncShop 方法
作用:组成url地址
语法:string urlShop($act,$op,$args,$store_domain)
参数: $act control文件名
$op op方法名
$args url其它参数
$store_domain 店铺二级域名
subdomain 方法
作用:二级域名解析
语法:int subdomain()
ncReplaceText 方法
作用:通知邮件/通知消息 内容转换函数
语法: string ncReplaceText($message,$param)
参数: $message 内容模板
$param 内容参数数组
str_cut 方法
作用:字符串切割函数,一个字母算一个位置,一个字算2个位置
语法: str_cut($string, $length, $dot = '')
参数: $string 待切割的字符串
$length 切割长度
$dot 尾缀
request_uri 方法
作用:重写 $_SERVER['REQUREST_URI'] 方法
get_image_type 方法
作用:获取图片类型
语法:string get_image_type($str)
C 方法
作用:取得系统配置信息
语法: C($key)
参数: string $key 取得下标值
示例:
C('site_url') 取得 $config['site_url'] 值
C('cache.type') 取得 $config['cache']['type'] 值
defaultGoodsImage 方法
作用:取得商品默认大小图片
语法: defaultGoodsImage($key)
参数: $key 图片大小 small/tiny
import 方法
作用:加载文件,只适用于加载框架内类库文件,如果文件名中包含"_"使用"#"代替,默认加载libraties目录内的类库
语法: import($libname,$file_ext='.php')
参数: $libname 要加载的文件
$file_ext 文件扩展名
示例:
import('cache');
//相当于 require_once(BasePath.'/framework/libraries/cache.php');
import('libraries.cache');
//相当于 require_once(BasePath.'/framework/libraries/cache.php');
import('function.core');
//相当于 require_once(BasePath.'/framework/function/core.php');
random 方法
作用:取得随机数
语法: random($length, $numeric = 0)
参数: $length 生成随机数的长度
$numeric 是否只产生数字随机数 1是0否
template 方法
作用:返回模板文件所在完整目录
语法: template($tplpath,$project='')
参数: $tplpath 模板文件名(不含扩展名)
$project 项目名称
chksubmit 方法
作用:检测FORM表单是否是合法提交
语法: chksubmit()
lazypage 方法
作用:延时加载分页功能,判断是否有更多连接和limitstart值和经过验证修改的$delay_eachnum值
语法:array lazypage($delay_eachnum,$delay_page,
$count,$ispage=false,$page_nowpage=1,$page_eachnum=1,$page_limitstart=1)
参数: $delay_eachnum 延时分页每页显示的条数
$delay_page 延时分页当前页数
$count 总记录数
$ispage 是否在分页模式中实现延时分页(前台显示的两种不同效果)
$page_nowpage 分页当前页数
$page_eachnum 分页每页显示条数
$page_limitstart 分页初始limit值
F 方法
作用:文件数据读取和保存 字符串、数组
语法:F($name, $value='', $path = 'cache',$ext = '.php')
参数: $name 文件名称(不含扩展名)
$value 待写入文件的内容
$path 写入cache的目录
$ext 文件扩展名write_file 方法
作用:写入文件操作
语法:boolean write_file($filepath, $data, $mode = null)
参数: $filepath 待写入内容的文件路径
$data 待写入的内容
$mode 写入模式,如果是追加,可传入“append”
mk_dir 方法
作用:循环创建目录
语法:boolean mk_dir($dir, $mode = '0777')
参数: $dir 待创建的目录
$mode 权限
pagecmd 方法
作用:封装分页操作的函数,方便调用
语法:pagecmd($cmd ='', $arg = '')
参数: $cmd 命令类型
$arg 参数
$cmd命令类型允许的值如下:
seteachnum 设置每页数量
settotalnum 设置记录总数
setstyle 设置分页样式
show 返回分页链接
obj 返回分页对象本身
gettotalnum 取得记录总数
gettotalpage 取得总页数
throw_exception 方法
作用:抛出异常
语法:throw_exception($error)
参数: $error 异常信息
halt 方法
作用:输出错误信息
语法:halt($error)
参数: $error 错误信息
compress_code 方法
作用:去除代码中的空白和注释
语法:compress_code($content)
参数:$content 待压缩的内容
H 方法
作用:读/写 缓存方法
语法:H($key, $value='', $cache_type='', $expire=null, $args=null)
参数: $key 缓存名称
$value 缓存内容
$type 缓存类型,允许值为 file,memcache,xcache,apc,eaccelerator,可以为空,默认为file缓存
$expire 缓存周期
$args 扩展参数
示例:
H('setting'); // 取得缓存
H('setting',true); // 生成setting缓存并返回缓存结果
H('setting',null); // 清空setting缓存
H('setting',true,'file'); // 生成setting文件缓存
H('setting',true,'memcache'); // 生成setting缓存到memcache
rcache 方法
作用:读取缓存信息(只适用于内存缓存)
语法:rcache($key = null, $prefix = '', $unserialize = true)
参数: $key 要取得缓存 键
$prefix 键值前缀
$unserialize 是否需要反序列化
wcache 方法
作用:写入缓存(只适用于内存缓存)
语法:boolean wcache($key = null, $data = array(), $prefix = '', $ttl = 0, $prefix = '', $serialize = true)
参数: $key 缓存键值
$data 缓存数据
$ttl 缓存周期
$perfix 存入的键值前缀
$serialize 是否序列化后保存
rec 方法
作用:调用推荐位
语法:string rec($rec_id = null)
参数:$rec_id 推荐位ID
L 方法
作用:快速调用语言包
语法:string L($key = '')
参数:$key 语言包对于的键名