## 内置函数
`FastAdmin`插件系统中有内置多个函数用于我们进行调用，除了以下插件系统中的内置函数可以调用外，我们还可以直接调用FastAdmin框架中的内置函数，如`cdnurl`图片补全、`addtion`附加关联数据、`check_cors_request`跨域检测、`xss_clean`清理XSS 等函数，请参考文档：https://doc.fastadmin.net/doc/1263.html
## addon\_url
用于生成插件控制器方法的url
### 参数列表
| 名称 | 描述 |
| --- | --- |
| $url | 插件标识/控制器名/方法名 |
| $vars | 变量参数，默认为空 |
| $suffix | 是否生成后缀，默认为true |
| $domain | 域名，默认不包含域名 |
### 调用方法
~~~bash
$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);
~~~
我们可以看到第二个参数数组中有`:name`和`id`两种写法，`:name`在`ThinkPHP5`中没有这种写法的，这是FastAdmin插件系统中特有的写法。这里`:name`是为了配合`插件管理`\->`配置`\->`伪静态`使用的，具体使用方法可以参考`伪静态`章节。
### 返回值
以下返回值都是在未使用伪静态时返回的URL，如果使用了伪静态则返回值会不同。
~~~bash
/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
获得插件列表，此函数将返回本地已安装的插件列表
### 调用方法
~~~bash
$addonList = get_addon_list();
~~~
### 返回值
二维数组
## get\_addon\_info
获得插件的基础信息
### 参数列表
| 名称 | 描述 |
| --- | --- |
| $name | 插件标识 |
### 调用方法
~~~bash
$addonInfo = get_addon_info('mydemo');
~~~
### 返回值
一维数组，示例
~~~javascript
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\_config
获取插件类的配置值，以键值数组的形式返回
### 参数列表
| 名称 | 描述 |
| --- | --- |
| $name | 插件标识 |
### 调用方法
~~~bash
$addonConfig = get_addon_config('mydemo');
~~~
### 返回值
~~~scss
Array
(
[usernmae] => test
[password] => 123456
)
~~~
## get\_addon\_fullconfig
获取插件类的配置数组，以二级数组的形式返回
### 参数列表
| 名称 | 描述 |
| --- | --- |
| $name | 插件标识 |
### 调用方法
~~~bash
$addonConfigList = get_addon_fullconfig('mydemo');
~~~
### 返回值
~~~sql
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\_instance
获取插件的单例
### 参数列表
| 名称 | 描述 |
| --- | --- |
| $name | 插件标识 |
### 调用方法
~~~bash
$addonInstance = get_addon_instance('mydemo');
~~~
### 返回值
~~~less
addons\mydemo\Mydemo Object
~~~
## set\_addon\_info
设置插件基础配置信息，将实时更新插件目录下的`info.ini`文件
### 参数列表
| 名称 | 描述 |
| --- | --- |
| $name | 插件标识 |
| $array | 配置数据 |
### 功能描述
### 调用方法
~~~sql
$result = set_addon_info('mydemo', ['title'=>'标题一']);
~~~
### 返回值
bool
## set\_addon\_config
设置插件配置信息，一般临时写入配置信息，第三个参数用于实时写入配置信息
### 参数列表
| 名称 | 描述 |
| --- | --- |
| $name | 插件标识 |
| $config | 配置数据 |
| $writefile | 是否写入配置文件,默认为true |
### 调用方法
~~~sql
$result = set_addon_config('mydemo', ['username'=>'testname']);
$result = set_addon_config('mydemo', ['username'=>'testname'], true);
~~~
### 返回值
bool
## set\_addon\_fullconfig
实时写入插件配置文件
### 参数列表
| 名称 | 描述 |
| --- | --- |
| $name | 插件标识 |
| $config | 配置数据，二维数组信息，一般框架内部使用，不建议调用 |
### 调用方法
~~~sql
$result = set_addon_fullconfig('mydemo', [['username'=>'testname', 'type'=>'string', ...]]);
~~~
### 返回值
bool
