錯誤回應影像。 當發生錯誤時,影像伺服通常會傳回錯誤狀態及文字訊息。
attribute::ErrorImage
允許在發生錯誤時配置要返回的映像、目錄條目或模板。
也可以使用attribute::DefaultImage
處理遺失的影像。
可以設定「影像伺服」範本,將錯誤訊息文字轉譯至回應影像。 $error.title
範本中可包含下列預先定義的變數,以簡短錯誤說明取代;$error.message
則以更詳細的錯誤說明取代(詳細程度設定為attribute::ErrorDetail
)。
如果錯誤影像/範本可以成功處理,則會傳回HTTP狀態200。 如果在此處理期間發生錯誤,則會傳回HTTP錯誤狀態和文字訊息。
文字字串。 如果指定,則必須是影像目錄中的有效目錄::Id值,或是影像伺服器可存取之影像檔案的相對路徑(attribute::RootPath
)或絕對路徑。
如果未定義,則繼承自default::ErrorImage
。 如果已定義但空白,則會停用錯誤影像行為,即使已定義default::ErrorImage
,並傳回HTTP錯誤狀態和文字訊息。
為了獲得包含錯誤資訊的響應影像,必須首先在影像目錄中定義模板。 在這種情況下,我們會在影像目錄中建立名為onError
的項目,其中包含下列項目:catalog::Modifier
size=300,300&bgc=ffffff&text=$error.message$
範本已註冊至attribute::ErrorImage
:
ErrorImage=myCatalog/onError
在此範例中,文字會使用預設字型、字型色彩和字型大小來轉換。
attribute::RootPath , catalog::Id, attribute::DefaultImage , attribute::ErrorDetail