错误图像 errorimage

错误响应图像。 图像服务通常会在发生错误时返回错误状态并显示文本消息。

attribute::ErrorImage 允许配置在发生错误时返回的图像、目录条目或模板。

可以配置图像服务模板，以便将错误消息文本渲染到响应图像。 以下预定义变量可包含在 $error.title 模板，替换为简短错误描述，以及 $error.message，替换为更详细的错误描述(详细级别配置为 attribute::ErrorDetail)。

如果可以成功处理错误图像/模板，则会返回HTTP状态200。 如果在此处理过程中出现错误，则会返回HTTP错误状态和文本消息。

属性 section-f460c6c2dd1f46b29f9a79b093575f45

文本字符串。 如果已指定，则必须是图像目录中的有效catalog：：Id值或相对(至 attribute::RootPath)或图像服务器可访问的图像文件的绝对路径。

默认 section-2885f289e5714ddca665a6aee401967f

继承自 default::ErrorImage 如果未定义。 如果已定义但为空，则会禁用错误图像行为，即使 default::ErrorImage 定义，并返回HTTP错误状态和文本消息。

示例 section-c92090abe1d247529542a8dd4960c2e6

要获取响应图像，并将错误消息渲染到图像中，我们必须首先在图像目录中定义模板。 在本例中，我们在图像目录中创建了一个名为 onError，包含以下内容 catalog::Modifier：

size=300,300&bgc=ffffff&text=$error.message$

模板已注册 attribute::ErrorImage：

ErrorImage=myCatalog/onError

在本例中，文本使用默认字体、字体颜色和字体大小进行渲染。

另请参阅 section-bbf1f85fc0a34033bdda1dd3e4e0bbb6

attribute：：RootPath ， catalog：：Id， attribute：：DefaultImage， attribute：：ErrorDetail