Download the PHP package rocareer/webman-status-code without Composer

rocareer/webman-status-code

Webman 统一错误码/状态码插件：一套与 rocareer/radmin 3.2+ 完全对齐的状态码定义（含中文消息与 getMessage()），随插件复制安装到宿主项目 support/，并提供 scode:run 命令扫描代码库自动重生成状态码类。

• 统一状态码：support\StatusCode 常量 + MESSAGES 中文消息表 + getStatusCode/getMessage 用法；与 radmin 内置 support\StatusCode diff 一致（v1.0.3 起同步 radmin 3.2 安全加固新增码）
• 复制安装：webman 标准插件（Install::WEBMAN_PLUGIN），安装时把 support/StatusCode 与插件配置复制到宿主项目，卸载可还原
• 代码规范：Code::getSystemCode() 提供 8 位错误码编号规范（3 位系统标识 + 中间 2 位服务标识 + 后 3 位错误码，负数）
• 自动重生成：php webman scode:run 扫描 status_scan_path 下所有 PHP 文件，收集 StatusCode::XXX 使用点 / const 定义 / throw XxxException('消息', StatusCode::XXX) 三处信息，重新生成整个状态码类文件（常量按值排序 + MESSAGES + getMessage）

安装

dev 全家桶（dev/full、dev/luoling）已通过 path 仓库钉版 v1.0.3 接入。

使用

常用码段（完整列表见 src/support/StatusCode.php）：

代码生成命令

• 扫描 status_scan_path（默认 app_path()）下全部 PHP 文件，识别：
  • StatusCode::XXX 引用（描述默认 '未知错误'）
  • const NAME = N; // 中文注释 形式的定义（注释作为描述）
  • throw XxxException('消息', StatusCode::XXX)（消息作为描述，覆盖默认）
• 重生成状态码类文件：保留已有常量原值、为新增引用自动分配下一个码值（起始 start_min_number），按常量值排序输出，附 MESSAGES 表与 getMessage()
• 输出新增常量清单，便于 code review 后提交

注意：命令直接覆写状态码类源文件，生成结果需人工 review 后再提交；已发布的码值只增不改，避免前端/客户端依赖旧值。

配置（config/plugin/rocareer/webman-status-code/app.php）

类参考

历史遗留（只读，勿引用）

• src/StatusRun.php（teamones\responseCodeMsg\Generate，类名 Generate）与根目录 error_code.php：早期"负 8 位错误码 shell 扫描"实现，命名空间/类名均为迁移遗留；现行路径为 scode:run（StatusCodeCommand）
• src/StatusCode.php：早期重复定义文件（namespace 误写为 support），现行定义以 src/support/StatusCode.php 为准

与 radmin 的同步约定

src/support/StatusCode.php 必须与 rocareer/radmin 内置 support\StatusCode 保持 diff 一致（radmin 升级新增状态码时同步本包，参考 v1.0.3 变更记录）。

卸载

仅移除插件复制的 support/StatusCode.php 与 config/plugin/rocareer/webman-status-code/；宿主项目已改写的业务代码需自行处理。