PHP funkce nl2br()

   06. 07. 2020
Obsah článku:
  1. Parametry
  2. Podrobný popis
  3. Příklad
  4. Návratové hodnoty
  5. Změny ve verzích
  6. Další zdroje

Funkce převede zalomení řádků (\n) ve stringu na HTML tag <br>.

Parametry

Parametr Datový typ Výchozí hodnota Poznámka
$string string není Vstupní řetězec.
$is_xhtml bool null Přepne způsob escapování podle kontextu.

Podrobný popis

$retezec = 'text
další text
a ještě něco';

echo nl2br($retezec);

Vrátí:

text<br>
další text<br>
a ještě něco

Zalomené řádky v textu převede na html značky. Tento tag se používá na místech, kde uživatel zadává jakýkoliv text (textarea) a hrozí případ, že použije více řádkový text.

Ošetření klasických inputů (type="text") nemá význam, jelikož zde nelze zadat víceřádkový text.

Poznámka: Od PHP 4.0.5, je funkce nl2br() XHTML způsobilá. Všechny verze před 4.0.5 vrátí string se značkou vloženou před konce řádků místo <br />.

Příklad

echo nl2br("Welcome\r\nThis is my HTML document", false);

Vrátí:

Welcome<br>
This is my HTML document

Návratové hodnoty

string

Vrací upravený řetězec včetně HTML značek.

Změny ve verzích

Verze Poznámka
5.3.0 Byl přidán volitelný parametr is_xhtml parametr.
4.0.5 nl2br () je nyní kompatibilní s XHTML. Všechny starší verze vrátí řetězec se zalomením vkládají řádků místo <br />.

Další zdroje

Oficiální dokumentace nl2br()

Nechte si posílat nové články do mailu:
Jan Barášek

Jan Barášek     Více o autorovi

Autor článku podniká jako fullstack senior developer v Praze. Spravuje 300 různě velkých webových projektů, fungujících dodnes. Během spolupráce nabral hluboké zkušenosti, které na tomto webu předává dál.

Rád vám pomůžu:

Kontakt Konzultace a služby Nabídka spolupráce