ecshop二次开发之常用函数汇总
<p>本文详细汇总了ecshop二次开发中常用的函数。分享给大家供大家参考。具体如下：</p>
<p>
最近进行ecshop的二次开发，整理了一部分的函数，另外在ecshop论坛上面也发现了很多函数说明，整理汇总如下，供大家参考。</p>
<p>
所有函数功能说明:</p>
<p>
lib_time.php</p>
<p>
gmtime()<br>
说明：获得当前格林威治时间的时间戳 <br>
server_timezone()<br>
说明：获得服务器的时区 <br>
local_mktime($hour = NULL , $minute= NULL, $second = NULL, $month = NULL, $day = NULL, $year = NULL)<br>
说明：生成一个用户自定义时区日期的GMT时间戳<br>
local_date($format, $time = NULL)<br>
说明：将GMT时间戳格式化为用户自定义时区日期<br>
gmstr2time($str)<br>
说明：转换字符串形式的时间表达式为GMT时间戳<br>
local_strtotime($str)<br>
说明：将一个用户自定义时区的日期转为GMT时间戳<br>
local_gettime($timestamp = NULL)<br>
说明：获得用户所在时区指定的时间戳<br>
local_getdate($timestamp = NULL)<br>
说明：获得用户所在时区指定的日期和时间信息<br>
lib_base.php<br>
sub_str($str, $length = 0, $append = true)<br>
说明：截取UTF-8编码下字符串的函数<br>
real_ip()<br>
说明：获得用户的真实IP地址<br>
str_len($str)<br>
说明：计算字符串的长度（汉字按照两个字符计算）<br>
get_crlf()<br>
说明：获得用户操作系统的换行符<br>
send_mail($name, $email, $subject, $content, $type = 0, $notification=false)<br>
说明：邮件发送<br>
gd_version()<br>
说明：获得服务器上的 GD 版本<br>
file_get_contents($file)<br>
说明：如果系统不存在file_get_contents函数则声明该函数<br>
file_put_contents($file, $data, $flags = '')<br>
说明：如果系统不存在file_put_contents函数则声明该函数<br>
floatval($n)<br>
说明：如果系统不存在 floatval 函数则声明该函数<br>
file_mode_info($file_path)<br>
说明：文件或目录权限检查函数<br>
log_write($arg, $file = '', $line = '')<br>
说明：写入日志内容<br>
make_dir($folder)<br>
说明：检查目标文件夹是否存在，如果不存在则自动创建该目录<br>
gzip_enabled()<br>
说明：获得系统是否启用了 gzip<br>
addslashes_deep($value)<br>
说明：递归方式的对变量中的特殊字符进行转义<br>
addslashes_deep_obj($obj)<br>
说明：将对象成员变量或者数组的特殊字符进行转义<br>
stripslashes_deep($value)<br>
说明：递归方式的对变量中的特殊字符去除转义<br>
make_semiangle($str)<br>
说明：将一个字串中含有全角的数字字符、字母、空格或'%+-()'字符转换为相应半角字符<br>
check_file_type($filename, $realname = '', $limit_ext_types = '')<br>
说明：检查文件类型 /文件名/真实文件名/允许的文件类型<br>
mysql_like_quote($str)<br>
说明：对 MYSQL LIKE 的内容进行转义 过滤掉_ %等字符.<br>
real_server_ip()<br>
说明：获取服务器的ip<br>
ecs_header($string, $replace = true, $http_response_code = 0)<br>
说明：自定义 header 函数，用于过滤可能出现的安全隐患<br>
ecs_iconv($source_lang, $target_lang, $source_string = '')<br>
说明：自定义的编码转换<br>
ecs_geoip($ip)<br>
说明：取得IP的地址,采用IP库<br>
trim_right($str)<br>
说明：去除字符串右侧可能出现的乱码<br>
move_upload_file($file_name, $target_name = '')<br>
说明：将上传文件转移到指定位置<br>
json_str_iconv($str)<br>
说明：将JSON传递的参数转码<br>
get_file_suffix($file_name, $allow_type = array())<br>
说明：获取文件后缀名,并判断是否合法<br>
read_static_cache($cache_name)<br>
说明：读结果缓存文件<br>
write_static_cache($cache_name, $caches)<br>
说明：写结果缓存文件<br>
lib_common.php (公用函数库)<br>
db_create_in($item_list, $field_name = '')<br>
说明：创建像这样的查询: “IN('a','b')” $item_list为数组<br>
is_email($user_email)<br>
说明：验证输入的邮件地址是否合法<br>
is_time($time)<br>
说明：检查是否为一个合法的时间格式<br>
assign_query_info()<br>
说明：获得查询时间和次数，并赋值给smarty<br>
region_result($parent, $sel_name, $type)<br>
说明：创建地区的返回信息<br>
get_regions($type = 0, $parent = 0)<br>
说明：获得指定国家的所有省份, 函数需要数据库支持.<br>
get_shipping_config($area_id)<br>
说明：获得配送区域中指定的配送方式的配送费用的计算参数 比如快捷公司不同.<br>
init_users()<br>
说明：初始化会员数据整合类<br>
cat_list($cat_id = 0, $selected = 0, $re_type = true, $level = 0, $is_show_all = true)<br>
说明：获得指定分类下的子分类的数组, $re_type控制返回类型<br>
cat_options($spec_cat_id, $arr)<br>
说明：过滤和排序所有分类，返回一个带有缩进级别的数组<br>
load_config()<br>
说明：载入配置信息<br>
get_brand_list()<br>
说明：取得品牌列表<br>
get_brands($cat = 0, $app = 'brand')<br>
说明：获得某个分类下的品牌列表<br>
get_promotion_info($goods_id = '')<br>
说明：所有的促销活动信息<br>
get_children($cat = 0)<br>
说明：获得指定分类下所有底层分类的ID<br>
get_article_children ($cat = 0)<br>
说明：获得指定文章分类下所有底层分类的ID<br>
get_mail_template($tpl_name)<br>
说明：获取邮件模板<br>
order_action($order_sn, $order_status, $shipping_status, $pay_status, $note = '', $username = null)<br>
说明：记录订单操作记录<br>
price_format($price, $change_price = true)<br>
说明：格式化商品价格<br>
get_virtual_goods($order_id, $shipping = false)<br>
说明：返回订单中的虚拟商品 记录是否发货.<br>
virtual_goods_ship(&$virtual_goods, &$msg, $order_sn, $return_result = false, $process = 'other')<br>
说明：虚拟商品发货<br>
virtual_card_shipping ($goods, $order_sn, &$msg, $process = 'other')<br>
说明：虚拟卡发货<br>
virtual_card_result($order_sn, $goods)<br>
说明：返回虚拟卡信息<br>
get_snatch_result($id)<br>
说明：获取指定 id snatch 活动的结果<br>
clear_tpl_files($is_cache = true, $ext = '')<br>
说明：清除指定后缀的模板缓存或编译文件<br>
clear_compiled_files($ext = '')<br>
说明：清除模版编译文件<br>
clear_cache_files($ext = '')<br>
说明：清除缓存文件<br>
clear_all_files($ext = '')<br>
说明：清除模版编译和缓存文件<br>
smarty_insert_scripts($args)<br>
说明：页面上调用的js文件,组合功能.<br>
smarty_create_pages($params)<br>
说明：创建分页的列表<br>
build_uri($app, $params, $append = '', $page = 0, $size = 0)<br>
说明：重写 URL 地址<br>
formated_weight($weight)<br>
说明：格式化重量<br>
log_account_change($user_id, $user_money = 0, $frozen_money = 0, $rank_points = 0, $pay_points = 0, $change_desc = '', $change_type = ACT_OTHER)<br>
说明：记录帐户变动<br>
article_cat_list($cat_id = 0, $selected = 0, $re_type = true, $level = 0)<br>
说明：获得指定分类下的子分类的数组/ 向下取数组.<br>
article_cat_options($spec_cat_id, $arr)<br>
说明：过滤和排序所有文章分类，返回一个带有缩进级别的数组<br>
uc_call($func, $params=null)<br>
说明：调用UCenter的函数<br>
exception_handler($errno, $errstr, $errfile, $errline)<br>
说明：error_handle回调函数未启用.<br>
get_image_path($goods_id, $image='', $thumb=false, $call='goods', $del=false)<br>
说明：重新获得商品图片与商品相册的地址<br>
user_uc_call($func, $params = null)<br>
说明：调用使用UCenter插件时的函数<br>
get_volume_price_list($goods_id, $price_type = '1')<br>
说明：取得商品优惠价格列表<br>
get_final_price($goods_id, $goods_num = '1', $is_spec_price = false, $spec = array())<br>
说明：取得商品最终使用价格<br>
get_package_info($id)<br>
说明：获取指定id package 的信息<br>
get_package_goods($package_id)<br>
说明：获得指定礼包的商品lib_main.php (前台公用函数库)<br>
update_user_info()<br>
说明：更新用户SESSION,COOKIE及登录时间、登录次数。<br>
get_user_info($id=0)<br>
说明：获取用户信息数组<br>
assign_ur_here($cat = 0, $str = '')<br>
说明：取得当前位置和页面标题<br>
get_parent_cats($cat)<br>
说明：获得指定分类的所有上级分类<br>
build_pagetitle($arr, $type = 'category')<br>
说明：根据提供的数组编译成页面标题<br>
build_urhere($arr, $type = 'category')<br>
说明：根据提供的数组编译成当前位置<br>
assign_dynamic($tmp)<br>
说明：获得指定页面的动态内容<br>
assign_articles($id, $num)<br>
说明：分配文章列表给smarty<br>
get_shop_help()<br>
说明：分配帮助信息<br>
assign_pager($app, $cat, $record_count, $size, $sort, $order, $page = 1,$keywords = '', $brand = 0, $price_min = 0, $price_max = 0, $display_type = 'list', $filter_attr='', $url_format='', $sch_array='')<br>
说明：创建分页信息.分页函数.<br>
get_pager($url, $param, $record_count, $page = 1, $size = 10)<br>
说明：生成给pager.lbi赋值的数组<br>
get_vote($id = '')<br>
说明：调用调查内容<br>
get_user_browser()<br>
说明：获得浏览器名称和版本<br>
is_spider($record = true)<br>
说明：判断是否为搜索引擎蜘蛛<br>
get_os()<br>
说明：获得客户端的操作系统<br>
visit_stats()<br>
说明：统计访问信息<br>
save_searchengine_keyword($domain, $path)<br>
说明：保存搜索引擎关键字<br>
get_tags($goods_id = 0, $user_id = 0)<br>
说明：获得指定用户、商品的所有标记<br>
get_dyna_libs($theme, $tmp)<br>
说明：获取指定主题某个模板的主题的动态模块<br>
dyna_libs_replace($matches)<br>
说明：换动态模块<br>
upload_file($upload, $type)<br>
说明：处理上传文件，并返回上传图片名(上传失败时返回图片名为空）<br>
show_message($content, $links = '', $hrefs = '', $type = 'info', $auto_redirect = true)<br>
说明：显示一个提示信息<br>
parse_rate_value($str, &$operate)<br>
说明：将一个形如+10, 10, -10, 10%的字串转换为相应数字，并返回操作符号<br>
recalculate_price()<br>
说明：重新计算购物车中的商品价格：目的是当用户登录时享受会员价格，当用户退出登录时不享受会员价格<br>
assign_comment($id, $type, $page = 1)<br>
说明：查询评论内容<br>
assign_template($ctype = '', $catlist = array())<br>
说明：默认的smarty赋值<br>
time2gmt($time)<br>
说明：将一个本地时间戳转成GMT时间戳<br>
get_user_bonus($user_id = 0)<br>
说明：查询会员的红包金额<br>
set_affiliate()<br>
说明：保存推荐uid<br>
get_affiliate()<br>
说明：获取推荐uid<br>
article_categories_tree($cat_id = 0)<br>
说明：获得指定分类同级的所有分类以及该分类下的子分类<br>
get_article_parent_cats($cat)<br>
说明：获得指定文章分类的所有上级分类<br>
get_library_number($library, $template = null)<br>
说明：取得某模板某库设置的数量<br>
get_navigator($ctype = '', $catlist = array())<br>
说明：取得自定义导航栏列表<br>
license_info()<br>
说明：授权信息内容<br>
lib_insert.php (动态内容函数库)<br>
insert_query_info()<br>
说明：获得查询次数以及查询时间<br>
insert_history()<br>
说明：调用浏览历史<br>
insert_cart_info()<br>
说明：调用购物车信息<br>
insert_ads($arr)<br>
说明：调用指定的广告位的广告<br>
insert_member_info()<br>
说明：调用会员信息<br>
insert_comments($arr)<br>
说明：调用评论信息<br>
insert_vote()<br>
说明：调用在线调查信息<br>
lib_goods.php (商品相关函数库)<br>
goods_sort($goods_a, $goods_b)<br>
说明：商品推荐usort用自定义排序行数<br>
get_categories_tree($cat_id = 0)<br>
说明：获得指定分类同级的所有分类以及该分类下的子分类<br>
get_child_tree($tree_id = 0)<br>
说明：取和指定分类ID下的分类树<br>
get_top10($cats = '')<br>
说明：调用当前分类的销售排行榜<br>
get_recommend_goods($type = '', $cats = '')<br>
说明：获得推荐商品<br>
get_promote_goods($cats = '')<br>
说明：获得促销商品<br>
get_category_recommend_goods($type = '', $cats = '', $brand = 0, $min =0, $max = 0, $ext='')<br>
说明：获得指定分类下的推荐商品<br>
get_goods_info($goods_id)<br>
说明：获得商品的详细信息<br>
get_goods_properties($goods_id)<br>
说明：获得商品的属性和规格<br>
get_same_attribute_goods($attr)<br>
说明：获得属性相同的商品<br>
get_goods_gallery($goods_id)<br>
说明：获得指定商品的相册<br>
assign_cat_goods($cat_id, $num = 0, $from = 'web')<br>
说明：获得指定分类下的商品<br>
assign_brand_goods($brand_id, $num = 0, $cat_id = 0)<br>
说明：获得指定的品牌下的商品<br>
get_extension_goods($cats)<br>
说明：获得所有扩展分类属于指定分类的所有商品ID<br>
bargain_price($price, $start, $end)<br>
说明：判断某个商品是否正在特价促销期<br>
spec_price($spec)<br>
说明：获得指定的规格的价格<br>
group_buy_info($group_buy_id, $current_num = 0)<br>
说明：取得团购活动信息<br>
group_buy_stat($group_buy_id, $deposit)<br>
说明：取得某团购活动统计信息<br>
group_buy_status($group_buy)<br>
说明：获得团购的状态<br>
auction_info($act_id, $config = false)<br>
说明：取得拍卖活动信息<br>
auction_log($act_id)<br>
说明：取得拍卖活动出价记录<br>
auction_status($auction)<br>
说明：计算拍卖活动状态（注意参数一定是原始信息）<br>
goods_info($goods_id)<br>
说明：取得商品信息<br>
favourable_info($act_id)<br>
说明：取得优惠活动信息<br>
wholesale_info($act_id)<br>
说明：批发信息<br>
add_style($goods_name, $style)<br>
说明：添加商品名样式<br>
get_goods_attr($goods_id)<br>
说明：取得商品属性<br>
get_goods_fittings($goods_list = array())<br>
说明：获得购物车中商品的配件<br>
lib_article.php (文章及文章分类相关函数库)<br>
get_cat_articles($cat_id, $page = 1, $size = 20 ,$requirement='')<br>
说明：获得文章分类下的文章列表<br>
get_article_count($cat_id ,$requirement='')<br>
说明：获得指定分类下的文章总数</p>
<p>
希望本文所述对大家的ecshop二次开发有所帮助。</p>
頁:
[1]