PHP工具类 - 全局函数

modstart_version MSCore版本

获取MSCore版本

modstart_version( )

• 返回：string 版本号

modstart_admin_url Admin路径

生成Admin的路径，自动加前缀

modstart_admin_url( string, array )

• 参数：string $url 路径
• 参数：array $param 参数
• 返回：string

代码示例

// 返回 /admin/aaa/bbb
modstart_admin_url('aaa/bbb')
// 返回 /admin/aaa/bbb?x=y
modstart_admin_url('aaa/bbb',['x'=>'y'])

modstart_web_full_url 生成完整的Web路径

modstart_web_full_url( string, array )

• 参数：string $url 路径
• 参数：array $param 参数
• 返回：string 地址

代码示例

// 返回 http://www.example.com/aaa/bbb
modstart_web_full_url('aaa/bbb')
// 返回 http://www.example.com/aaa/bbb?x=y
modstart_web_full_url('aaa/bbb',['x'=>'y'])

modstart_web_url Web路径

生成Web的路径，自动加前缀

modstart_web_url( string, array )

• 参数：string $url 路径
• 参数：array $param 参数
• 返回：string 地址

代码示例

// 返回 /aaa/bbb
modstart_web_url('aaa/bbb')
// 返回 /aaa/bbb?x=y
modstart_web_url('aaa/bbb',['x'=>'y'])

modstart_api_url Api路径

生成Api的路径，自动加前缀

modstart_api_url( string, array )

• 参数：string $url 路径
• 参数：array $param 参数
• 返回：string

代码示例

// 返回 /api/aaa/bbb
modstart_api_url('aaa/bbb')
// 返回 /api/aaa/bbb?x=y
modstart_api_url('aaa/bbb',['x'=>'y'])

modstart_configs 获取多个配置中第一个非空值

modstart_configs( $keys, $default )

• 参数：$keys array 多个配置名
• 参数：$default string 默认值
• 返回：void array|bool|int|mixed|\ModStart\Core\Config\MConfig|string

modstart_config 获取配置

用于获取表 config 中的配置选项

modstart_config( $key, $default, $useCache )

• 参数：$key string 配置名称
• 参数：$default string|array|boolean|integer 默认值，不能为 null
• 参数：$useCache boolean 启用缓存，默认为true
• 返回：string|array|boolean|integer|\ModStart\Core\Config\MConfig 返回配置值或配置对象

代码示例

// 网站名称
modstart_config('siteName','[默认名称]');
// 获取一个配置数组，数组需存储成 json 格式
modstart_config()->getArray('xxx')
// 设置配置项
modstart_config()->set('xxx','aaa')

modstart_config_asset_url 获取配置资源路径

modstart_config_asset_url( $key, $default )

• 参数：$key string 配置名称
• 参数：$default string 默认值
• 返回：string

modstart_module_enabled 模块判断

判断模块是否已安装并启用

modstart_module_enabled( $module, $version )

• 参数：$module string 模块名称，如 Member
• 参数：$version string 模块版本要求，如 1.0.0， >=1.0.0
• 返回：boolean 模块是否安装并启用

代码示例

// 模块Member是否安装并启用
modstart_module_enabled('Member')
// 模块Member是否安装了 >=1.2.0 的版本
modstart_module_enabled('Member','>=1.2.0')

LM 多语言（模块）

LM( $module, $name, ...$params )

• 参数：$module string 模块名称
• 参数：$name string 多语言
• 参数：...$params string|int 多语言参数
• 返回：string 多语言翻译

代码示例

// 获取模块Member的多语言
LM('Member','Message')
// 获取模块Member的多语言，带参数
LM('Member','File Size Limit %s','10M')

L 多语言

获取多语言翻译

L( $name, ...$params )

• 参数：$name string 多语言
• 参数：...$params string|int 多语言参数
• 返回：string 多语言翻译

代码示例

// 返回 消息
L('Message');
// 返回 文件最大为10M
L('File Size Limit %s','10M');

L_locale 设置/获取当前语言环境

L_locale( $locale )

• 参数：$locale string|null 语言环境，如 zh、en
• 返回：string 当前语言环境

代码示例

// 获取当前语言环境
$locale = L_locale();
// 设置当前语言环境
L_locale('en');

L_locale_title 获取当前语言名称

L_locale_title( $locale )

• 参数：$locale string 语言环境
• 返回：string 语言名称

modstart_open_api_url OpenApi路径

生成 OpenApi 的路径，自动加前缀

modstart_open_api_url( $url )

• 参数：$url string 路径
• 返回：string

代码示例

// 返回 /open_api/aaa/bbb
modstart_open_api_url('aaa/bbb')

modstart_baseurl_active 判断当前URL是否匹配

用于菜单高亮等场景，判断当前 URL 是否匹配并返回激活样式类名

modstart_baseurl_active( $match, $output )

• 参数：$match string 匹配 URL
• 参数：$output string 匹配成功返回的内容，默认为 active
• 返回：string

代码示例

// 当前URL为 /admin/blog 时返回 active
modstart_baseurl_active('/admin/blog')

modstart_module_config 获取模块配置

获取指定模块的配置项

modstart_module_config( $module, $key, $default )

• 参数：$module string 模块名称
• 参数：$key string 配置键名
• 参数：$default mixed 默认值
• 返回：mixed