naisi_output_ext_license_error

生成框架启动前可安全输出的许可错误内容，不依赖项目类。

JSON 格式保持 {"code":code,"resource":{},"error":message}；TEXT 格式为 code:message；HTML 返回完整 HTML5 文档，h1 为 code，h3 为经过实体转义的 message。 code、message 和 type 都必须与声明的 PHP 类型一致；类型不一致不会弱转换，而是抛出 TypeError。

函数签名

function naisi_output_ext_license_error(int $code, string $message, int $type = NAISI_LICENSE_ERROR_TYPE_JSON): string

调用前提

此诊断或许可错误接口不要求许可证明。

参数

$code

• 类型：int
• 必填：是
• 默认值：无
• 方向：输入参数。

需要判断或转换的业务代码。

$message

• 类型：string
• 必填：是
• 默认值：无
• 方向：输入参数。

需要输出的非敏感许可错误信息，必须是实际的 PHP string。任何非字符串值（包括 null、false、整数和可字符串化对象）都不会被弱类型转换，而是直接抛出 TypeError；空字符串允许。

$type

• 类型：int
• 必填：否
• 默认值：NAISI_LICENSE_ERROR_TYPE_JSON
• 方向：输入参数。

字符集、过滤、脱敏或许可错误输出类型，应使用对应的 NAISI_* 常量。

返回值

类型：string

成功时按 type 返回 JSON、HTML 或文本；type 值无效时返回空字符串。任一参数的 PHP 类型与声明不一致时直接抛出 TypeError，不走业务失败返回值。

关联常量

• NAISI_LICENSE_ERROR_TYPE_JSON = 0 — JSON 许可错误输出。 返回包含 code、空 resource 和 error 的 JSON 字符串。
• NAISI_LICENSE_ERROR_TYPE_HTML = 1 — HTML 许可错误输出。 返回完整 HTML5 文档，h1 显示 code，h3 显示已转义的 message。
• NAISI_LICENSE_ERROR_TYPE_TEXT = 2 — 纯文本许可错误输出。 按 code:message 格式返回纯文本。

调用示例

当前请求须满足上方调用前提；请检查实际返回值和引用输出，随机结果及数据包内容以运行环境为准。

$code = 51603;
$message = '';
$type = 0;

$result = naisi_output_ext_license_error($code, $message, $type);
var_export($result);

版本信息

• 自版本：1.0.6
• 实现模块：license
• 授权类别：UNRESTRICTED / NONE
• 失败回退：空字符串 ""
• 文档同步：2026-10-18