# 文件
位于`/Application/Common/Common/function.php中`
## is_login()
说明: 检测用户是否已登陆
返回值: **integer** 0-未登录，大于0-当前登录用户ID
## is_administrator($uid = null)
说明：检测用户是否是**超级管理员**
返回值 **boolean** true-管理员，false-非管理员
## str2arr($str, $glue = ',')
说明：字符串转换为数组，与explode功能相同，只是参数顺序不同
参数 string $str 要分割的字符串
参数 string $glue 分割符
返回值 **array**
## arr2str($arr, $glue = ',')
说明：数组转换为字符串，与implode功能相同，只是参数顺序不同
参数 array $arr 要连接的数组
参数 string $glue 分割符
返回值 **string**
## think_encrypt($data, $key = '', $expire = 0)
说明：数据加密方法，将需要加密的数据串加密为字符串。
参数 string $data 要加密的字符串
参数 string $key 加密密钥
参数 int $expire 过期时间 单位 秒
返回值 **string**
## think_decrypt($data, $key = '')
说明：数据解密方法，将think_encrypt加密过的数据还原。
## list_sort_by($list,$field, $sortby='asc')
说明： 对查询结果集进行排序
参数 array $list 查询结果
参数 string $field 排序的字段名（单个）
参数 array $sortby 排序类型 asc正向排序 desc逆向排序 nat自然排序
返回值 array
## data_auth_sign($data)
说明：数据签名认证，用于验证提供的数据与存储的数据是否一致。
参数 array $data 被认证的数据
返回值 **string** 签名
## list_to_tree($list, $pk='id', $pid = 'pid', $child = '_child', $root = 0)
说明：把返回的查询数据集转换成多维数组的树状结构数据
参数 array $list 要转换的数据集
参数 string $pk 数据集的主键
参数 string $pid 父id数据字段
参数 string $child 用来保存子数据的键名
参数 int $root 根元素的父id
返回值 array
## tree_to_list($tree, $child = '_child', $order='id', &$list = array())
说明： 将list_to_tree生成的多维数组树状结构数据还原成普通的查询列表
参数 array $tree list_to_tree生成的多维数组树状结构数据
参数 string $child 保存子数据的键名
参数 string $order 排序显示的键，一般是主键 升序排列
参数 array $list 过渡用的中间数组
返回值 array 返回排过序的列表数组
## format_bytes($size, $delimiter = '')
说明：字节格式化 参数 number $size 字节数 参数 string $delimiter 数字和单位分隔符 返回值 string 格式化后的带单位的大小，例如：2KB
## get_addon_class($name)
说明：根据插件简单类名返回插件类的命名空间类名
参数 strng $name 插件名
返回值 string
## get_addon_config($name)
说明：获取插件类的配置数组
参数 string $name 插件名
## addons_url($url, $param = array())
说明：生成用于访问插件控制器的url
参数 string $url url 例如：'Attachment://Attachment/download'
参数 array $param 参数,例如'id=2'
返回值 string
## time_format($time = NULL,$format='Y-m-d H:i')
说明：时间戳格式化,与date函数功能相同，只是参数顺序不同
参数 int $time
## get_username($uid = 0)
说明：根据用户ID获取用户名。首先会尝试从session获取，其次尝试从缓存获取，如果没有获取到，从数据库获取并缓存。
参数 integer $uid 用户ID 返回值 string 用户名
## get_nickname($uid = 0)
说明：根据用户ID获取用户昵称。首先会尝试从session获取，其次尝试从缓存获取，如果没有获取到，从数据库获取并缓存。
根据用户ID获取用户昵称
参数 integer $uid 用户ID
返回值 string 用户昵称
## get_category($id, $field = null)
说明：获取某个分类的某个字段的值并缓存
参数 integer $id 分类ID
参数 string $field 要获取的字段名
返回值 string 字段的值
## get_category_name($id)
说明：根据ID获取分类标识
## get_category_title($id)
说明：根据ID获取分类名称
## get_document_model($model_id = null, $field = null)
说明：根据模型id获取文档模型的某个字段的值并缓存
参数 integer $model_id 模型ID
参数 string $field 模型字段
返回值 array
## action_log($action = null, $model = null, $record_id = null, $user_id = null)
说明：执行该行为的规则，并记录行为日志
参数 string $action 行为标识
参数 string $model 触发行为的模型名，例如：'document'
参数 int $record_id 触发行为的记录id
参数 int $user_id 执行行为的用户id
返回值 boolean
## parse_action($action = null, $self)
说明： 将一条行为定义文本解析为行为规则数组。
规则定义 table:$table|field:$field|condition:$condition|rule:$rule[|cycle:$cycle|max:$max][;......] 规则字段解释：table->要操作的数据表，不需要加表前缀； field->要操作的字段； condition->操作的条件，目前支持字符串，默认变量{$self}为执行行为的用户 rule->对字段进行的具体操作，目前支持四则混合运算，如：1+score*2/2-3 cycle->执行周期，单位（小时），表示$cycle小时内最多执行$max次 max->单个周期内的最大执行次数（$cycle和$max必须同时定义，否则无效） 单个行为后可加 ； 连接其他规则
参数 string $action 行为id或者name
参数 int $self 替换规则里的变量为执行用户的id
返回值 boolean|array: false解析出错 ， 成功返回规则数组
## execute_action($rules = false, $action_id = null, $user_id = null)
说明：执行行为
参数 array $rules parse_action解析后的行为规则数组
参数 int $action_id 行为id
参数 array $user_id 执行的用户id
返回值 boolean false 失败 ， true 成功
## create_dir_or_files($files)
说明：基于数组创建目录和文件，每个目录或文件作为数组的一个元素
## array_column(array $input, $columnKey, $indexKey = null)
说明：PHP5.5的自带函数兼容实现，来自PHP手册
## get_table_name($model_id = null)
说明：获取表名（不含表前缀）
参数 string $model_id
返回值 string 表名
## get_model_attribute($model_id, $group = true)
说明：获取模型属性信息并缓存
参数 integer $id 属性ID
参数 string $field 要获取的字段名
返回值 string 属性信息
## api($name,$vars=array())
说明：调用系统的API接口的静态方法，例如：`api('User/getName','id=5');// 调用公共模块的User接口的getName方法`
参数 string $name 格式 [模块名]/接口名/静态方法名
参数 array|string $vars 参数
## get_link($link_id = null, $field = 'url')
说明: 根据外链id(onethink_url表)，返回外链的其他字段值，默认返回url字段值
参数 int $link_id 主键值 参数 string $field 字段值
## get_cover($cover_id, $field = null)
说明：根据图片id(onethink_picture)返回图片的其他字段值，默认返回所有整行记录
参数 int $cover_id 主键值 参数 string $field 字段名 返回值： 完整的数据 或者 指定的$field字段值
## check_document_position($pos = 0, $contain = 0)
说明： 文档推荐位检测．检测文档推荐位是否含有含有某个推荐位设置．例如，文档推荐位的值为5，则`check_document_position(5, 1)`和｀check_document_position(5, 4)｀都返回true，而`check_document_position(5, 8)`返回false．实际上，该函数做的是位检测，所以也可以用于检测其通过位相加保存数据的情况．
参数 number $pos 推荐位的值（数据库保存的字段值） 参数 number $contain 推荐位值(推荐位定义) 返回 true 包含 ， false 不包含
