每个数据表会生成8个FVE文件和1个HTML文件,例用户表“user_user”会生成下列9个文件:
文件名 说明
ffm_user_user_add.fve 新增用户数据
ffm_user_user_db.fve 获得一条用户数据
ffm_user_user_del.fve 删除用户数据
ffm_user_user_edit.fve 编辑用户数据
ffm_user_user_init.html 用户数据初始化
ffm_user_user_kws_pg_list.fve 获得关键字搜索分布列表
ffm_user_user_list.fve 获得用户列表
ffm_user_user_pg_list.fve 获得用户分布列表
ffm_user_user_rand_list.fve 获得随机用户列表
FVE文件参数与返回值详解:
ffm_xxxxx_add.fve : 新增一条记录数据
特殊要求:
$post = 必须,所有要增加的字段都放在POST中,如果与提交的POST不同,可以把提交的POST保存为变量,再清空POST并重组POST数据
参数: 多个参数时用|分隔,例:'pid=2|top=8'
json = 可选,是否返回JSON格式字符串:1=是,其它=否,否返回MAP数组,不定义时默认返回MAP数组
返回值:
成功:
{
"id" = "456789", // 新增加的记录号
"msg" = "Record added successfully." // 记录增加成功
}
失败:
{
"id" = "0", // 新增加的记录号,如果=0则新增失败
"msg" = "Error adding record." // 增加记录出错
}
注释:
新增时尽量引用ffm_xxxxx_init.html进行记录初始化
范例:
<!--{$v=$post/*保存提交的POST*/}-->
<!--{$post=""/*清空POST,为重组做准备*/}-->
<!--{include "/funcs/ffm_xxxxx_init.html"/*引入初始化默认数组,以保证不出现NULL值*/}-->
<!--{$post=$fields_xxxxx/*把初始化值给POST*/}-->
<!--{$post["pid"]=$v["pid"]/*从保存的提交POST中取值*/}-->
<!--{$post["sno"]=$sno/*用户处理好这个值*/}-->
<!--{$post["atype"]=$v["atype"]/*从保存的提交POST中取值*/}-->
<!--{$post["aname"]=$v["aname"]/*从保存的提交POST中取值*/}-->
<!--{$post["lastdate"]=""/*如果字段类型为当前日期时间,这里给空值即可*/}-->
<!--{$post["ifyn"]=$v["ifyn"]/*从保存的提交POST中取值*/}-->
<!--{ffwbms ffm_xxxxx_add,re_add,""/*增加数据*/}-->
<!--{ffwbms_see $re_add/*输出显示返回值*/}-->
ffm_xxxxx_edit.fve : 编辑用户数据
特殊要求:
$post = 必须,所有要编辑的字段都放在POST中,如果与提交的POST不同,可以把提交的POST保存为变量,再清空POST并重组POST数据
参数: 多个参数时用|分隔,例:'pid=2|top=8'
sqlstr = 可选,自定义SQL语句串,用三个等号表示,三个等号后为语句串,例:"sqlstr===((a=1)or(b=".$ccc["0"]["1"]["val"]."))"
json = 可选,是否返回JSON格式字符串:1=是,其它=否,否返回MAP数组,不定义时默认返回MAP数组
字段相关其它参数 = 可选,例: "pid=4567|sno=9"
注:如果使用ID,那么除JSON以外,其它都会无效
返回值:
成功:
{
"num" = "1", // 记录被更新的数量,如果=0则没有符合条件的记录被更新
"msg" = "Record update succeeded." // 更新记录成功
}
失败:
{
"num" = "0", // 记录被更新的数量,如果=0则更新失败
"msg" = "Error updating record." // 增加记录出错
}
范例:
<!--{$v=$post/*保存提交的POST*/}-->
<!--{$post=""/*清空POST,为重组做准备*/}-->
<!--{$post["aname"]=$v["aname"]/*从保存的提交POST中取值*/}-->
<!--{$post["lastdate"]=""/*如果字段类型为当前日期时间,这里给空值即可*/}-->
<!--{$post["ifyn"]=$v["ifyn"]/*从保存的提交POST中取值*/}-->
<!--{ffwbms ffm_xxxxx_edit,re_edit,"id=5678"/*编辑数据*/}-->
<!--{ffwbms_see $re_edit/*输出显示返回值*/}-->
ffm_xxxxx_del.fve : 删除用户数据
特殊要求:
无
参数: 多个参数时用|分隔,例:'pid=2|top=8'
id = 必填,记录ID号,为空或为0时,返回空,也就是每次只能删除一条记录,尽量减少用户程序错误后的影响,删除多条记录用获得列表,再循环删除
json = 可选,是否返回JSON格式字符串:1=是,其它=否,否返回MAP数组,不定义时默认返回MAP数组
返回值:
成功:
{
"num" = "1", // 记录被删除数量,如果=0则没有符合条件的记录被删除
"msg" = "Record update succeeded." // 删除记录成功
}
失败:
{
"num" = "0", // 记录被删除数量
"msg" = "Failed to delete data." // 删除记录失败
}
失败:
{
"num" = "0", // 记录被删除数量
"msg" = "Parameter ID is empty or does not exist, data deletion failed." // 参数id为空或不存在,删除数据失败
}
范例:
<!--{ffwbms ffm_xxxxx_del,re_del,"id=5678"/*删除数据*/}-->
<!--{ffwbms_see $re_del/*输出显示返回值*/}-->
ffm_xxxxx_db.fve : 获得一条记录数据
特殊要求:
无
参数: 多个参数时用|分隔,例:'pid=2|top=8'
fields = 可选,要返回的字段集,多个字段用英文逗号分隔,例:"fields=id,pid,title"
sqlstr = 可选,自定义SQL语句串,用三个等号表示,三个等号后为语句串,例:"sqlstr===((a=1)or(b=".$ccc["0"]["1"]["val"]."))"
json = 可选,是否返回JSON格式字符串:1=是,其它=否,否返回MAP数组,不定义时默认返回MAP数组,例: "json=1"
字段相关其它参数 = 可选,例: "pid=4567|sno=9"
返回值:
记录数组或记录数组的JSON字符串
范例:
<!--{ffwbms ffm_xxxxx_db,vtemp,'id='.$get["id"]}-->
<!--{ffwbms_see $vtemp/*输出显示返回值*/}-->
ffm_xxxxx_list.fve : 获得列表
特殊要求:
无
参数: 多个参数时用|分隔,例:'pid=2|top=8'
top = 可选,,前X条记录,为空或为0时,列100条记录
ob = 可选,排序语句,例: ob=ORDER BY sno DESC
fields = 可选,要返回的字段集,多个字段用英文逗号分隔,例:"fields=id,pid,title"
sqlstr = 可选,自定义SQL语句串,用三个等号表示,三个等号后为语句串,例:"sqlstr===((a=1)or(b=".$ccc["0"]["1"]["val"]."))"
json = 可选,是否返回JSON格式字符串:1=是,其它=否,否返回MAP数组,不定义时默认返回MAP数组,例: "json=1"
字段相关其它参数 = 可选,例: "pid=4567|sno=9"
返回值:
列表数组或列表数组的JSON字符串
范例:
<!--{ffwbms ffm_xxxxx_list,vtemp,'pid='.$get["pid"]}-->
<!--{ffwbms_see $vtemp/*输出显示返回值*/}-->
ffm_xxxxx_rand_list.fve : 获得随机列表
特殊要求:
参数中不可有排序条件
参数: 多个参数时用|分隔,例:'pid=2|top=8'
top = 可选,,前X条记录,为空或为0时,列100条记录
fields = 可选,要返回的字段集,多个字段用英文逗号分隔,例:"fields=id,pid,title"
sqlstr = 可选,自定义SQL语句串,用三个等号表示,三个等号后为语句串,例:"sqlstr===((a=1)or(b=".$ccc["0"]["1"]["val"]."))"
json = 可选,是否返回JSON格式字符串:1=是,其它=否,否返回MAP数组,不定义时默认返回MAP数组,例: "json=1"
字段相关其它参数 = 可选,例: "pid=4567|sno=9"
返回值:
列表数组或列表数组的JSON字符串
范例:
<!--{ffwbms ffm_xxxxx_rand_list,vtemp,'pid='.$get["pid"]}-->
<!--{ffwbms_see $vtemp/*输出显示返回值*/}-->
ffm_xxxxx_pg_list.fve : 获得分页列表
特殊要求:
无
参数: 多个参数时用|分隔,例:'pid=2|top=8'
fields = 可选,要返回的字段集,多个字段用英文逗号分隔,例:"fields=id,pid,title"
sqlstr = 可选,自定义SQL语句串,用三个等号表示,三个等号后为语句串,例:"sqlstr===((a=1)or(b=".$ccc["0"]["1"]["val"]."))"
pg = 可选,要显示的页数,为空或为0时,显示第一页
ps = 可选,每页要显示的记录数,为空或为0时,记录数为20
os = 可选,多页时分页选项前后可选数,为空或为0时,可选数为5
ob = 可选,排序语句,例: ORDER BY dt DESC
json = 可选,是否返回JSON格式字符串:1=是,其它=否,否返回MAP数组,不定义时默认返回MAP数组,例: "json=1"
字段相关其它参数 = 可选,例: "pid=4567|sno=9"
返回值:
数组或数组的JSON字符串
数组[0]: = 数据列表
数组[1]: = 分页数据
p_list=上列表数组,n_list=下列表数组,previous=上一页号,current=当前页号,next=下一页号,pages=总页数,total=总记录数
范例:
<!--{ffwbms ffm_xxxxx_pg_list,vtemp,'pid='.$get["pid"]}-->
<!--{ffwbms_see $vtemp/*输出显示返回值*/}-->
ffm_xxxxx_kws_pg_list.fve : 获得关键字搜索分页列表
特殊要求:
无
参数: 多个参数时用|分隔,例:'pid=2|top=8'
fields = 可选,要返回的字段集,多个字段用英文逗号分隔,例:"fields=id,pid,title"
sqlstr = 可选,自定义SQL语句串,用三个等号表示,三个等号后为语句串,例:"sqlstr===((a=1)or(b=".$ccc["0"]["1"]["val"]."))"
kwkstr = 可选,要搜索关键字的字段名组合,多个字段名使用英文空格分隔,用三个等号表示,三个等号后为语句串,例:kwkstr===aa ss dd ff
kwvstr = 可选,要搜索关键字的字符串组合,多个字符串使用英文空格分隔,用三个等号表示,三个等号后为语句串,例:kwvstr===zz xx cc vv
pg = 可选,要显示的页数,为空或为0时,显示第一页
ps = 可选,每页要显示的记录数,为空或为0时,记录数为20
os = 可选,多页时分页选项前后可选数,为空或为0时,可选数为5
ob = 可选,排序语句,例: ORDER BY dt DESC
json = 可选,是否返回JSON格式字符串:1=是,其它=否,否返回MAP数组,不定义时默认返回MAP数组,例: "json=1"
字段相关其它参数 = 可选,例: "pid=4567|sno=9"
返回值:
数组或数组的JSON字符串
数组[0]: = 数据列表
数组[1]: = 分页数据
p_list=上列表数组,n_list=下列表数组,previous=上一页号,current=当前页号,next=下一页号,pages=总页数,total=总记录数
范例:
<!--{ffwbms ffm_xxxxx_kws_pg_list,vtemp,'pid='.$get["pid"]}-->
<!--{ffwbms_see $vtemp/*输出显示返回值*/}-->