Wrong
<br/>
>i 本文档的最新修订日期是:
> **2021-07-09**
# Wrong
## 模块简述
输出预定义的报错信息。
## 依赖
本模块依赖于基础模块 <font color="#c7254e">`Log`</font> 。
## 模块配置
配置文件位于 <font color="#c7254e">`/Config/Wrong.php`</font> 。
* **<font color="#ff6600">`Log`</font>** <font color="#0099ff">`(Bool)`</font> <font color="#bbbbbb">`FALSE`</font> :
用以指定是否将报错信息写入日志。
<font color="#c7254e">`TRUE`</font> 代表写入日志、<font color="#c7254e">`FALSE`</font> 代表不写入日志,默认不写入日志。
* **<font color="#ff6600">`Style`</font>** <font color="#0099ff">`(String)`</font> <font color="#bbbbbb">`'AUTO'`</font> :
用以指定报错内容的展现样式。
<font color="#c7254e">`AUTO`</font> 代表由系统自动判断,浏览器访问时展现友好的HTML样式的报错信息,Ajax访问时展现JSON风格的报错信息。
<font color="#c7254e">`JSON`</font> 代表仅展示JSON风格的报错信息。
<font color="#c7254e">`HTML`</font> 代表仅展示HTML风格的报错信息。
>w 在 <font color="#c7254e">`AUTO`</font> 模式下,如需展示 <font color="#c7254e">`JSON`</font> 形式的报错信息,则访问请求中必须存在 <font color="#c7254e">`X_REQUESTED_WITH = xmlhttprequest`</font> 请求头,或将请求头中 <font color="#c7254e">`Content-Type`</font> 项设置为 <font color="#c7254e">`application/json`</font> 。
* **<font color="#ff6600">`CodeReplace`</font>** <font color="#0099ff">`(Array)`</font> <font color="#bbbbbb">`[]`</font> :
用以将代码中已定义的错误码替换为新的错误码。
值为一个一维数组,数组的<font color="#c7254e">`键`</font> 为需要被替换的代码,<font color="#c7254e">`值`</font> 为替换后的错误代码。
## :: Report()方法
### 语法
**<font color="#0099ff"><font color="#ff6600">Wrong</font> :: <font color="#ff6600">Report</font> ( <kbd>传参数组</kbd> )</font>**
### 说明
清除已输出的内容并输出报错,同时中断代码运行。
此方法 <font color="#c7254e">`支持`</font> 中文参数名。
### 参数
* **<font color="#ff6600">`detail(详情)`</font>** <font color="#0099ff">`(String)`</font> <font color="#BBBBBB">`<必须>`</font>:
报错的详细信息。
* **<font color="#ff6600">`code(状态码)`</font>** <font color="#0099ff">`(Int)`</font> <font color="#BBBBBB">`500`</font>:
状态码,默认为 <font color="#c7254e">`500`</font> 。此状态码并不会影响页面的HTTP响应码,即使报错,服务器端的响应码仍然为 <font color="#c7254e">`HTTP 200`</font> 。
* **<font color="#ff6600">`hide(隐藏)`</font>** <font color="#0099ff">`(Bool)`</font> <font color="#BBBBBB">`TRUE`</font>:
用以指定是否在调试模式未开启时,隐藏详细的报错信息。
* **<font color="#ff6600">`log(日志)`</font>** <font color="#0099ff">`(Bool)`</font> <font color="#BBBBBB">`TRUE`</font>:
用以指定是否将报错写入日志,<font color="#c7254e">`TRUE`</font> 代表写入、<font color="#c7254e">`FALSE`</font> 代表不写入,默认写入。
当配置项中关闭了日志写入时,此参数 <font color="#c7254e">`无效`</font> 。
### 返回
无。
### 示例
进行报错,且调试模式关闭时仍然展现错误详情:
```php
Wrong::Report(['detail'=>'用户尚未登录','code'=>'401','hide'=>FALSE]);
```