苹果CMS插件开发常用内置函数详解
2025-02-27
共人阅读
addon_url
专门用来生成插件控制器方法的访问链接,支持携带参数、后缀以及完整域名。
参数说明
$url:地址格式,插件标识/控制器名/方法名
$vars:传入参数数组,默认空
$suffix:是否带上html后缀,默认true
$domain:是否输出完整域名,默认不开启
参数数组里的:name是苹果CMS插件独有的写法,适配插件伪静态配置,原生ThinkPHP5并不支持该写法。
$url1 = addon_url('mydemo/index/index');
$url2 = addon_url('mydemo/index/index', [':name'=>'myname','id'=>123]);
$url3 = addon_url('mydemo/index/index', [':name'=>'myname','id'=>123], true, true);未开启伪静态时的返回示例:
/addons/mydemo/index/index /addons/mydemo/index/index.html?id=123&name=myname http://www.fa.com/addons/mydemo/index/index.html?id=123&name=myname
get_addon_list
读取本地已经安装的全部插件,返回二维数组。
$addonList = get_addon_list();
get_addon_info
根据插件标识获取插件基础信息,返回一维数组。
$addonInfo = get_addon_info('mydemo');返回数据示例:
Array ( [name] => mydemo [title] => 插件名称mydemo [intro] => FastAdmin插件 [author] => yourname [website] => https://www.fastadmin.net [version] => 1.0.0 [state] => 1 [url] => /addons/mydemo.html )
get_addon_fullconfig
读取插件完整配置结构,返回带表单类型、校验规则的二级数组。
$addonConfigList = get_addon_fullconfig('mydemo');Array ( [0] => Array ( [name] => usernmae [title] => 用户名 [type] => string [content] => Array ( ) [value] => test [rule] => required [msg] => [tip] => [ok] => [extend] => ) [1] => Array ( [name] => password [title] => 密码 [type] => string [content] => Array ( ) [value] => 123456 [rule] => required [msg] => [tip] => [ok] => [extend] => ) )
get_addon_config
只读取插件配置项的键与值,返回扁平化一维数组,适合业务读取参数。
$addonConfigList = get_addon_config('mydemo');Array ( [usernmae] => test [password] => 123456 )
get_addon_instance
获取插件类的单例对象,拿到对象后可以直接调用插件内部方法。
$addonInstance = get_addon_instance('mydemo');addons\mydemo\Mydemo Object
set_addon_info
修改插件基础信息,调用后会同步更新插件目录内的info.ini文件,返回布尔值。
$result = set_addon_info('mydemo', ['title'=>'标题一']);set_addon_config
写入插件配置参数,第三个参数控制是否持久化保存到配置文件,默认true。
$result = set_addon_config('mydemo', ['username'=>'testname']);
$result = set_addon_config('mydemo', ['username'=>'testname'], true);set_addon_fullconfig
写入完整的二维表单配置结构,多用于框架底层操作,业务开发不推荐直接调用。返回布尔值。
$result = set_addon_fullconfig('mydemo', [['username'=>'testname','type'=>'string',...]]); 