ErrorImage

錯誤回應影像。 當發生錯誤時,影像伺服通常會傳回錯誤狀態及文字訊息。

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

本頁內容