PHP 函数库
本篇主要介绍常用的PHP函数，此类函数既可以在控制器中使用也可以在模板中使用，但在前台模板中使用PHP语法必须用标签 {cscmsphp}{/cscmsphp} 包裹起来；举例：获取任意字段函数getzd，在模板中需写成{cscmsphp}getzd('user','name',1024,'id');{/cscmsphp}；在后台模板中使用PHP语法可用标签 包裹起来；举例：获取任意字段函数getzd，写成
链接生成函数：get_link($uri)
通用链接生成函数，该函数根据uri生成链接，地址不会根据静态规则改变，所以最好用于非静态页面的URL，如会员中心；若站点为动态、伪静态，则无影响
| 参数 | 属性值 | 备注 |
|---|---|---|
| $uri | 链接uri参数 | 如获取歌曲id=1024的播放页，其uri为dance/play/id/1024；则地址为get_link('dance/play/id/1024') |
版块连接地址解析：cscmslink($dir)
该函数用于解析板块的链接，链接地址为板块首页，如跳转到音乐板块:cscmslink('dance')
| 参数 | 属性值 | 备注 |
|---|---|---|
| $dir | 板块名称 | 如获取音乐板块链接：cscmslink('dance')；如获取视频板块链接：cscmslink('vod')； |
版块人气地址解析：hitslink($path,$dir)
该函数用于生成访问增加人气的链接地址，如：歌曲板块的增加人气的地址为hits控制器中ids方法，则给id=1024的歌曲增加人气的地址为：hitslink('hits/ids/1024','dance');
| 参数 | 属性值 | 备注 |
|---|---|---|
| $path | uri路径 | 控制器/方法/参数1/参数2...；如：hits/ids/1024 |
| $dir | 板块名称 | 如音乐板块:dance；视频板块：vod；新闻板块：news等 |
连接地址解析函数：linkurl($fid,$sort,$id,$pid,$dir)
该函数用于解析链接地址，站点静态模式时可解析静态链接规则，推荐使用
| 参数 | 属性值 | 备注 |
|---|---|---|
| $fid | 控制器 | 板块控制器，如：音乐播放为play |
| $sort | 排序或方法 | 如音乐播放为id； |
| $id | 数据id | 如：音乐id，视频id |
| $pid | 分页页数 | 默认值为1 |
| $dir | 板块名称 | 如：音乐板块dance，视频板块vod |
函数示例
- //生成id=1024的音乐的播放页面
- linkurl('play','id',1024,'dance');
- //生成id=1024的视频的简介
- linkurl('show','index',1024,'vod');
会员主页相关链接：userlink($Classid,$Uid,$Name,$ID,$Pages)
该函数用于解析会员主页相关链接地址
| 参数 | 属性值 | 备注 |
|---|---|---|
| $Classid | 板块名称 | 板块名称：如index：会员主页的首页;dance：音乐板块，vod：视频板块 |
| $Uid | 会员id | 纯数字，不要留空 |
| $Name | 会员名称 | 不能留空 |
| $ID | 板块分类ID | 板块下某分类的ID，如dance分类流行歌曲的id，可以留空，留空代表所以分类 |
| $Pages | 分页数 | 可以留空，留空代表第一页 |
函数示例
- //会员cscms，id=1024的会员主页的首页
- userlink('index',1024,'cscms');
- //会员cscms，id=1024的会员主页的音乐板块地址
- userlink('dance',1024,'cscms');
- //会员cscms，id=1024的会员主页的音乐板块，流行歌曲(id=2)的列表
- userlink('dance',1024,'cscms',2);
- //会员cscms，id=1024的会员主页的音乐板块，流行歌曲(id=2)的第三页列表
- userlink('dance',1024,'cscms',2,3);
会员中心相关链接：spacelink($url,$dir)
该函数用于解析会员中心相关链接地址
| 参数 | 属性值 | 备注 |
|---|---|---|
| $url | 链接路径 | 控制器/方法/参数1/参数2...；如：fav/index/1 |
| $dir | 板块名称 | 主板块：sys；音乐：dance;等等... |
函数示例
- //会员中心首页
- spacelink('space');
- spacelink('space','sys');
- //会员中心会员分享的歌曲
- spacelink('dance','dance');
- //会员中心会员收藏的歌曲
- spacelink('fav','dance');
- spacelink('fav/index/1','dance');
图片链接解析：piclink($Table,$Url,$dx)
该函数用于解析会员主页相关链接地址
| 参数 | 属性值 | 备注 |
|---|---|---|
| $Table | 存储标识 | 会员头像：logo；音乐板块：dance；专辑：dancetopic等等... |
| $Url | 图片地址 | 地址等于空时，为系统默认图片 |
| $dx | 1或者空 | 当存储标识等于logo，$dx=1时，获取系统女性头像；可以留空 |
函数示例
- //会员cscms的会员的图片,图片地址为/2017/01/01/22.jpg
- piclink('logo','/2017/01/01/22.jpg');
- //获取音乐专辑图片的真实地址,图片地址为/2017/01/01/abc123dd.jpg
- piclink('dancetopic','/2017/01/01/abc123dd.jpg');
获取附件真实连接地址：annexlink($url)
该函数用于解析附件的真实连接地址
| 参数 | 属性值 | 备注 |
|---|---|---|
| $url | 附件地址 | 可解析网盘和FTP中的附件 |
会员中心分页解析：userpage($sqlstr,$nums,$pagesize,$pagenum,$url,$pages,$dir)
该函数用于解析会员中心分页
| 参数 | 属性值 | 备注 |
|---|---|---|
| $sqlstr | sql语句 | 获取数据的mysql语句 |
| $nums | 数据总数量 | 数据条数统计值 |
| $pagesize | 每页数据条数 | |
| $url | 页数跳转的链接地址 | 链接与页数是拼接起来的，如第一页：$url.'1' |
| $pages | 当前页数 | 该页有class="on"，可用来调整样式 |
| $dir | 板块名称 | 如：音乐板块dance |
会员主页分页解析：homepage($sqlstr,$nums,$pagesize,$pagenum,$op,$uid,$user,$id,$pages)
该函数用于解析会员主页分页
| 参数 | 属性值 | 备注 |
|---|---|---|
| $sqlstr | sql语句 | 获取数据的mysql语句 |
| $nums | 数据总数量 | 数据条数统计值 |
| $pagesize | 每页数据条数 | |
| $op | 板块名称 | 板块名称：如index：会员主页的首页;dance：音乐板块，vod：视频板块 |
| $uid | 会员id | 纯数字，不要留空 |
| $user | 会员名称 | 不能留空 |
| $id | 板块分类id | 板块下某分类的id，如dance分类流行歌曲的id，可以留空，留空代表所以分类 |
| $pages | 分页数 | 可以留空，留空代表第一页 |
后台分页解析：admin_page($url,$page,$pages)
该函数用于解析后台数据列表的分页
| 参数 | 属性值 | 备注 |
|---|---|---|
| $url | 链接地址 | 分页实际地址为：$url拼接页数，如：$url.$i；$i为页数 |
| $page | 当前数据的页码 | |
| $pages | 数据的总页数 |