ErrorImage

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

attribute::ErrorImage 允許在發生錯誤時配置要返回的映像、目錄條目或模板。

可以設定「影像伺服」範本，將錯誤訊息文字轉譯至回應影像。 $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