# 辅助函数

Blessing Skin 中包含了一些的全局可用「辅助」PHP 函数,Blessing Skin 本身也使用了这些功能;如果您觉得方便,您可以在您的插件中自由地使用它们。

# json

返回一个 JSON 响应。注意,您需要在控制器中手动返回此函数的返回值,也就是需要在控制器方法中进行 return json();

json(['a' => 1, 'b' => 2]);  // {"a":1,"b":2}

json('Hello.', 0, ['a' => 1]);  // {"code":0,"message":"Hello.","data":{"a":1}}

json('Success', 0);  // {"code":0,"message":"Success"}

json('Failed');  // {"code":1,"message":"Failed"}

# option

返回或设置存储在数据库中的配置项。

$value = option('my_custom_option');  // 获取选项 `my_custom_option` 的值

$value = option('my_custom_option', 'default');  // 若选项不存在,则将 `'default'` 作为默认值来返回

option(['my_custom_option' => 'Yeah']);  // 将选项 `my_custom_option` 的值设为 `'Yeah'`

# option_localized

功能与 option 函数相同,但返回的值可根据当前的语言环境的不同而不同。通过这个函数来设置不同的语言对应不同的值时,需要先将页面切换到目标语言。

// 假定 `greeting` 选项在中文环境为「你好」,英文环境下为 "hello"

// en
option_localized('greeting');  // hello

// zh_CN
option_localized('greeting');  // 你好

# plugin

返回指定插件的实例。

$plugin = plugin('example-plugin');

# plugin_assets

返回插件资源文件的 URL。

$url = plugin_assets('example-plugin', 'assets/js/example1.js');