Benutzer-Werkzeuge

Webseiten-Werkzeuge


php:heredoc

Textabschnitte (z. B. HTML-Text) mit HEREDOC einfügen

Allgemein: Ab der PHP-Version 4 wird die sogenannte HEREDOC-Syntax unterstützt. HEREDOC kommt aus dem englischen, heißt wörtlich „hier Dokument“ und dient zur Bezeichnung von längeren, meist mehrzeiligen Textabschnitten. Dadurch entfallen die umschließenden Anführungszeichen um den String und somit auch das Escapen von Anführungszeichen innerhalb der Zeichenkette.

Bezeichner: Der Anfang wird durch 3 aufeinanderfolgenden „kleiner-als“-Zeichen gefolgt von einem Bezeichner, wie z. B. „HTML“ oder „JSCRIPT“ definiert. Üblicherweise wird der Bezeichner zur Verbesserung der Übersichtlichkeit in Großbuchstaben geschrieben.

Variablen: Innerhalb der HEREDOC-Syntax können auch PHP-Variablen eingesetzt werden. Diese sind in einfachen, geschweiften Klammern zu schreiben. Zwischen den geschweiften Klammern und dem Variablenbezeichner dürfen keine Leerzeichen eingefügt werden.

Wichtig: Nach dem öffnenden Bezeichner muss zwingend ein Zeilenumbruch erfolgen. Die Zeile mit dem schließenden Bezeichner darf, abgesehen vom Bezeichner selbst gefolgt von einem Semikolon, keine anderen Zeichen enthalten! Der schließende Bezeichner darf nicht eingerückt werden und es dürfen keine Leerzeichen oder Tabulatoren vor oder nach dem Semikolon stehen.


Beispiel:

<?php
	$text = <<<HTML
	<div class="headline">Die Klasse wurde mit Anführungszeichen gesetzt.</div>
	<p><b>HEREDOC</b>Hier können alle HTML-Tags verwendet werden.</p>
	<p>Es können auch PHP-Variablen verwendet werden. Aktuelles Datum: {$datum}</p>
HTML;
?>

Weitere Infos und Beispiele gibt es hier: www.rither.de

php/heredoc.txt · Zuletzt geändert: 2021/12/17 14:27 von webproducer