错误图像 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