ErrorImage errorimage
錯誤回應影像。 「影像伺服」一般會在發生錯誤時傳回錯誤狀態並顯示文字訊息。
attribute::ErrorImage
允許設定在發生錯誤時傳回的影像、目錄專案或範本。
attribute::DefaultImage
處理。您可以設定「影像伺服」範本,將錯誤訊息文字轉譯為回應影像。 下列預先定義的變數可包含在$error.title
範本中(以簡短的錯誤說明取代)和$error.message
中(以更詳細的錯誤說明取代) (詳細資訊層級設定為attribute::ErrorDetail
)。
如果可以成功處理錯誤影像/範本,則會傳回HTTP狀態200。 如果在此處理期間發生錯誤,則會傳回HTTP錯誤狀態和文字訊息。
屬性 section-f460c6c2dd1f46b29f9a79b093575f45
文字字串。 如果已指定,則必須是影像目錄中的有效目錄::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