# HtmlEntities

Gibt den String `$value` zurück, wobei Zeichen in Ihre HTML Entity Äquivalente konvertiert werden wenn diese existieren.

## Unterstützte Optionen für Zend_Filter_HtmlEntities

Die folgenden Optionen werden für `Zend_Filter_HtmlEntities` unterstützt:

- quotestyle: Äquivalent zum Parameter quote_style der nativen PHP Funktion htmlentities. Er erlaubt es zu definieren wass mit 'einfachen' und "doppelten" Hochkomma passieren soll. Die folgenden Konstanten werden akzeptiert: `ENT_COMPAT`, `ENT_QUOTES` `ENT_NOQUOTES` wobei `ENT_COMPAT` der Standardwert ist.

- charset: Äquivalent zum Parameter charset der nativen PHP Funktion htmlentities. Er definiert das Zeichenset welches beim Filtern verwendet werden soll. Anders als bei der nativen PHP Funktion ist der Standardwert 'UTF-8'. Siehe "http://php.net/htmlentities" für eine Liste der unterstützten Zeichensets.

  Diese Option kann auch über den Parameter `$options`, als `Zend_Config` Objekt oder als Array gesetzt werden. Der Optionsschlüssel wird entweder als Zeichenset oder als Kodierung akzeptiert.

- doublequote: Äquivalent zum Parameter double_encode der nativen PHP Funktion htmlentities. Wenn er auf false gesetzt wird, werden existierende html entities nicht kodiert. Der Standardwert ist es alles zu konvertieren (true).

  Diese Option muss über den Parameter `$options` oder die Methode `setDoubleEncode()` gesetzt werden.

## Einfache Verwendung

Siehe das folgende Beispiel für das Standardverhalten dieses Filters.

    $filter = new Zend_Filter_HtmlEntities();

    print $filter->filter('<');

## Hochkomma Stil

`Zend_Filter_HtmlEntities` erlaubt es den verwendete Hochkomma Stil zu verändern. Dies kan nützlich sein wenn man doppelte, einfache oder beide Typen von Hochkommas un-gefiltert lassen will. Siehe das folgende Beispiel:

    $filter = new Zend_Filter_HtmlEntities(array('quotestyle' => ENT_QUOTES));

    $input  = "Ein 'einfaches' und " . '"doppeltes"';
    print $filter->filter($input);

Das obige Beispiel gibt Ein 'einfaches' und "doppeltes" zurück. Es ist zu beachten dass sowohl 'einfache' als auch "doppelte" Hochkommas gefiltert werden.

    $filter = new Zend_Filter_HtmlEntities(array('quotestyle' => ENT_COMPAT));

    $input  = "Ein 'einfaches' und " . '"doppeltes"';
    print $filter->filter($input);

Das obige Beispiel gibt Ein 'einfaches' und "doppeltes" zurück. Es ist zu beachten dass "doppelte" Hochkommas gefiltert werden während 'einfache' Hochkommas nich verändert werden.

    $filter = new Zend_Filter_HtmlEntities(array('quotestyle' => ENT_NOQUOTES));

    $input  = "Ein 'einfaches' und" . '"doppeltes"';
    print $filter->filter($input);

Das obige Beispiel gibt Ein 'einfaches' und "doppeltes" zurück. Es ist zu beachten dass "doppelte" oder 'einfache' Hochkommas verändert werden.

## Helfer Methoden

Um die Option quotestyle nach der Instanzierung zu erhalten oder zu ändern, können die zwei Methoden `setQuoteStyle()` und `getQuoteStyle()` verwendet werden. `setQuoteStyle()` akzeptiert einen `$quoteStyle` Parameter. Die folgenden Konstanten werden akzeptiert: `ENT_COMPAT`, `ENT_QUOTES`, `ENT_NOQUOTES`

    $filter = new Zend_Filter_HtmlEntities();

    $filter->setQuoteStyle(ENT_QUOTES);
    print $filter->getQuoteStyle(ENT_QUOTES);

Um die Option charset nach der Instanzierung zu erhalten oder zu ändern, können die zwei Methoden `setCharSet()` und `getCharSet()` verwendet werden. `setCharSet()` akzeptiert einen `$charSet` Parameter. Siehe "http://php.net/htmlentities" für eine Liste der unterstützten Zeichensets.

    $filter = new Zend_Filter_HtmlEntities();

    $filter->setQuoteStyle(ENT_QUOTES);
    print $filter->getQuoteStyle(ENT_QUOTES);

Um die Option doublequote nach der Instanzierung zu erhalten oder zu ändern, können die zwei Methoden `setDoubleQuote()` und `getDoubleQuote()` verwendet werden. `setDoubleQuote()` akzeptiert einen boolschen Parameter `$doubleQuote`.

    $filter = new Zend_Filter_HtmlEntities();

    $filter->setQuoteStyle(ENT_QUOTES);
    print $filter->getQuoteStyle(ENT_QUOTES);