Tool


>i 本文档的最新修订日期是: > **2021-07-23** # Tool ## 模块简述 一些实用的小功能。 ## 模块配置 配置文件位于 `/Config/Tool.php` 。 * **`HtmlTag`** `(String)` `...` : 用于指定哪些HTML标签可以被还原。 标签之间用竖线 `|` 分隔,默认有这些标签可以被还原:`br``p``span``i``b``u``strong``h1``h2``h3``h4``h5``h6``hr``table``thead``tbody``tfoot``caption``colgroup``col``ul``ol``li``em``sup``sub``tr``td``th``dt``dd``dl``pre` 。 ## :: Random()方法 ### 语法 **Tool :: Random ( 传参数组 )** ### 说明 生成一个随机字符串。 此方法 `支持` 中文参数名。 ### 参数 * **`mode(模式)`** `(String)` `'AaN'`: 用以指定所生成字符串的字符 `构成方式` 。 1. 此参数值中含有 `A` 时,生成的字符串将含有 `大写` 字母A-Z; 2. 此参数值中含有 `a` 时,生成的字符串将含有 `小写` 字母a-z; 2. 此参数值中含有 `N` 时,生成的字符串将含有 `数字` 0-9。 * **`length(长度)`** `(Int)` `32`: 用以指定随机字符串的 `长度` 。 ### 返回 `(String)` 类型。 返回生成的随机字符串。 >d 虽然字符串为随机生成,但仍有 `极小概率重复` ,因此 `不要` 直接使用本方法生成UUID。 ## :: Uuid()方法 ### 语法 **Tool :: Uuid ( 传参数组 )** ### 说明 生成一个几乎不可能会重复的Uuid。 此方法 `支持` 中文参数名。 ### 参数 * **`md5(md5)`** `(Bool)` `FALSE`: 用以指定是否返回符合MD5加密结果格式的字符串。 ## :: GetHeader()方法 ### 语法 **Tool :: GetHeader ( 传参数组 )** ### 说明 获得Header中指定字段的值。 此方法 `支持` 中文参数名。 ### 参数 * **`field(字段)`** `(Array)` `必须`: 用以指定需要获取Header中哪些字段的值。 数组键无需定义,每一个元素的值代表一个需要获取字段的字段名。 ### 返回 `(Array)` 类型。 由Header中指定字段的值组成的数组,键为字段名,值为Header中对应字段的值。 如果Header中不存在某个指定的字段,那么它 `不会` 出现在返回的数组中。 ## :: Html()方法 >d 此方法即将计划废弃,将在6.x版本中删除,且不再增添新功能。 ### 语法 **Tool :: Html ( 传参数组 )** ### 说明 还原经过 `Receive` 模块中 `SafeCheck()` 方法转换的字符串。 此方法 `支持` 中文参数名。 ### 参数 * **`string(字符串)`** `(String)` `'AaN'`: 用以指定待还原的字符串。 * **`tag_other(其它标记)`** `(String)` `NULL`: 用以指定其它需要被还原的HTML标签。 标签之间用竖线 `|` 分隔。 * **`event(事件)`** `(Bool)` `FALSE`: 用以指定是否允许HTML中的 `js事件` 。 ### 返回 `(String)` 类型。 将返回经过还原后的字符串。