HtmlArmor je malá užitková třída pro situace, kdy chcete přijmout parametr textu, který je normálně escapován, ale v některých případech potřebuje přijmout nezpracovaný HTML kód.

Použití

/**
 * @param string|HtmlArmor $text
 * @return string
 */
function fooBar( $text ) {
	$html = HtmlArmor::getHtml( $text );
	return "<stuff>$html</stuff>";
}

Ve výše uvedeném příkladu může být parametr $text buď řetězec, který má být escapován, nebo objekt HtmlArmor, který by měl zůstat stejný. Funkce HtmlArmor::getHtml() se postará o escapování za vás a poskytne vám obsah, o kterém víte, že je bezpečný HTML.

fooBar( "this will be <b>escaped!</b>" );
// <stuff>this will be &lt;b&gt;escaped!&lt;/b&gt;</stuff>

fooBar( new HtmlArmor( "this will <i>not</i> be <b>escaped!</b>" ) );
// <stuff>this will <i>not</i> be <b>escaped!</b></stuff>"