⛔ 错误码 - APIPHP开源框架

>i 本文档的最新修订日期是： > **2024-02-27** # 错误码释义错误码由 `.` 分隔，第一部分为类别代码，第二部分为定位代码，第三部分数字为错误详情代码。 * 类别代码C：模块之外的报错。 * 类别代码M：模块的报错。 >d 在错误码后，可能会跟随多个以 `@` 开头的信息，在错误码的解释中，以 `@[*]` 代表这些信息，其中 `*` 代表出现的顺序。 # C.0.x `全局` * **`0.0`** 页面不存在（HTTP 404）。 * **`0.1`** 服务器出现了HTTP错误（HTTP xxx）。 * **`0.2`** 出现了PHP代码级别的错误，详细的出错信息是： `@[0]` 。 * **`0.3`** 调用模块方法 `@[0]` 时，缺失必要的参数 `@[1]` 。 * **`0.4`** 调用的模块方法 `@[0]` 不存在。 * **`0.5`** 调用的模块 `@[0]` 不存在，请检查模块文件是否存在，名称大小写是否一致。 # M.0.x `Dir模块` * **`0.0`** 目录或文件不存在，也可能是权限不足。 * **`0.1`** 目录或文件打开失败，也有可能是权限不足或文件被占用。 # M.1.x `Redis_模块` * **`1.0`** 指定的Redis连接信息 `@[0]` 不存在，请检查配置文件中的连接信息是否存在，名称大小写是否一致。 * **`1.1`** 连接Redis数据库失败，请检查网络是否通畅、端口是否正确。 * **`1.2`** 连接Redis数据库成功，但身份认证失败，请检查密码是否正确。 * **`1.3`** 选择指定的Redis数据库失败，请检查数据库序号是否正确。 # M.2.x `Img模块` * **`2.0`** 文件的MIME类型不正确。可能其并不是图片文件。 * **`2.1`** 文件不存在，也有可能是权限不足或文件被占用。 * **`2.2`** 打开指定的图像失败，或者它已经损坏。 * **`2.3`** 生成图片失败。 * **`2.4`** 创建图片失败，请检查是否开启了GD库。 * **`2.5`** 添加文字失败，请检查字体文件是否损坏。 # M.3.x `Ip模块` * **`3.0`** Ip名单文件创建失败，可能是权限不足或文件被占用。 * **`3.1`** Ip名单文件无法读取，可能是权限不足或内容格式损坏。 * **`3.2`** Ip名单文件写入失败，可能是权限不足或文件被占用。 # M.4.x `Load模块` * **`4.0`** 字段 `@[0]` 缺失或指定的表单字段中没有文件。请检查表单中文件域的 `name` 属性是否正确，或表单是否设置了 `enctype="multipart/form-data"` 。 * **`4.1`** 没有为字段 `@[0]` 指定上传路径，可以仅传入一个字符串，为所有的字段指定上传路径。 * **`4.2`** 没有为字段 `@[0]` 指定上传类型。 * **`4.3`** 上传的文件超过了php.ini中 `upload_max_filesize` 选项限制的值。 * **`4.4`** 上传文件的大小超过了 HTML 表单中 `MAX_FILE_SIZE` 选项规定的值。 * **`4.5`** 文件只有部分被上传（网络不稳定，或者用户中断了传输）。 * **`4.6`** 没有文件被上传。 * **`4.7`** 上传遇到了未知错误。 * **`4.8`** 上传文件的后缀名不在被允许的列表中。 * **`4.9`** 上传文件的大小超过了限制。 * **`4.10`** 文件不是通过HTTP POST方式上传的，或者在将上传的文件移动到指定位置时发生错误。 * **`4.11`** cURL拓展未启用。 * **`4.12`** 创建文件句柄失败，可能是权限不足或文件被占用。 * **`4.13`** 操作出现错误，cURL拓展返回的错误信息是：`@[0]` 。 # M.5.x `Hook模块` * **`5.0`** 钩子 `@[0]` 将要执行的方法 `@[1]` 不是一个可供执行的模块方法，请检查命名空间、模块名/方法名拼写是否正确，或结尾是否存在多余的括号。 # M.6.x `Tool模块` * **`6.0`** cURL拓展未启用。 * **`6.1`** 操作出现错误，cURL拓展返回的错误码是：`@[0]` 。 # M.7.x `Filter模块` * **`7.0`** Mode参数的值必须是空字符串或 `GET/POST/HEADER/COOKIE` 中的一个。 * **`7.1`** 指定校验的数据类型 `@[0]` 不存在。 # M.8.x `Db模块` * **`8.0`** 配置文件中不存在选指定的数据库组，或者是配置文件中不存在名为 `default` 的数据库组。 * **`8.1`** 连接数据库失败，请检查网络是否通畅、端口、用户名、密码、数据库名称等连接要素是否正确。详细的信息是：`@[0]` 。 * **`8.2`** 操作执行失败，请检查数据表、字段、索引是否存在。详细的信息是：`@[0]` 。 * **`8.3`** 开启事务失败，可能数据库不支持事务操作。详细的信息是：`@[0]` 。 * **`8.4`** 当前操作可能会改动/删除全表数据，请解锁或检查代码。 * **`8.5`** 字段 `@[0]` 对应的值缺失，请检查参数 `field` 与参数 `value` 的元素数量是否一致。 * **`8.6`** 由于指定了调试模式，当前SQL语句： `@[0]` 将不会被执行。 # M.9.x `Setting模块` * **`9.0`** 无法打开模块配置文件，可能是由于文件权限不足。 * **`9.1`** `Config` 目录下的配置文件为空或不存在。 * **`9.2`** 配置项不存在。 * **`9.3`** 配置项的数据类型不正确。 * **`9.4`** 欲修改的模块的配置文件尚未被加载。 # M.10.x `Vcode模块` * **`10.0`** 字体文件不存在，也有可能是权限不足或文件被占用。 # M.11.x `Cache模块` * **`11.0`** 模板文件或者其目录没有操作权限。 * **`11.2`** 打开缓存文件失败，可能是权限不足或文件被占用。 * **`11.3`** 写入缓存文件失败,可能是权限不足，也可能是磁盘已满。 * **`11.4`** 模板文件或者其目录没有操作权限。 * **`11.5`** 创建缓存目录 `@[0]` 失败，可能是权限不足（需要0777）。 # M.12.x `Data模块` * **`12.0`** 写入缓存文件失败，可能是磁盘空间不足。 * **`12.1`** 无法打开数据缓存文件，请检查数据缓存目录的权限。 # M.13.x `Api模块` * **`13.0`** 出现了错误，并且错误的详细信息不允许被展现，请打开 `调试模式` 查看。 # M.14.x `Upload模块` * **`14.0`** 指定的规则 `@[0]` 不存在或不可用。 * **`14.0`** 规则 `@[0]` 中指定的文件类型范围超出了配置文件中所允许的文件类型范围。