系统函数

---恢复内容开始---

 

4.2.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 需要忽略的目录或文件

示例：

$file_list = array();

//罗列出商城cache目录内的所有文件全路径，adv、session和index目录以及~shopnc.php文件除外

readFileList(BasePath.'/cache/',$file_list,array('adv','session','index','~shopnc.php'));

print_r($file_list);

//输出

Array

(

       [0] => D:/root/ShopNC/trunk/cache/adv_change/index.html

       [1] => D:/root/ShopNC/trunk/cache/area/index.html

       [2] => D:/root/ShopNC/trunk/cache/brand/index.html

       [3] => D:/root/ShopNC/trunk/cache/category/index.html

       [4] => D:/root/ShopNC/trunk/cache/class_tag.php

       [5] => D:/root/ShopNC/trunk/cache/fields/_pk.php

       [6] => D:/root/ShopNC/trunk/cache/goods_class.php

       [7] => D:/root/ShopNC/trunk/cache/link.php

       [8] => D:/root/ShopNC/trunk/cache/index.html

)

ncPriceFormat 方法

作用：价格格式化，返回两位小数位数的价格

语法：string ncPriceFormat($price)

参数：

$price 待处理的价格

示例：

       echo ncPriceFormat(100.256); // 输出100.26

echo ncPriceFormat(100.2); // 输出100.20

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 文件扩展名

       示例：

F('setting');    //取得setting缓存

F('setting',$data);    //将$data数组生成到setting文件缓存

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 语言包对于的键名

---恢复内容结束---