4
votes
$test= <<<EOF

....

EOF;

I have never see it before. What's it used for?

4

4 Answers

15
votes

This is called HEREDOC syntax, which is a way to define strings, on multiple lines, with variable interpolation.


Quoting the manual page:

Heredoc text behaves just like a double-quoted string, without the double quotes. This means that quotes in a heredoc do not need to be escaped, but the escape codes listed above can still be used. Variables are expanded, but the same care must be taken when expressing complex variables inside a heredoc as with strings.

(There is more to read, that I didn't copy-paste from the manual page)


And, as a very quick and simple example:

$a = 'World';
$string = <<<MARKER
<p>
  Hello, $a!
</p>
MARKER;
echo $string;

It will give you this output:

Hello, World!

And this HTML source:

<p>
  Hello, World!
</p>
0
votes
0
votes

http://www.php.net/manual/en/language.types.string.php#language.types.string.syntax.heredoc

Blockquote A third way to delimit strings is the heredoc syntax: <<<. After this operator, an identifier is provided, then a newline. The string itself follows, and then the same identifier again to close the quotation.

The closing identifier must begin in the first column of the line. Also, the identifier must follow the same naming rules as any other label in PHP: it must contain only alphanumeric characters and underscores, and must start with a non-digit character or underscore.

0
votes

Indeed, this is the Heredoc syntax.

Just in case you are wondering what interest it can have vs the regular string delimiters:

// These strings contain the same thing '"'"
$s1 = '\'"\'"';
$s2 = "'\"'\"";
$s3 = <<<EOS
'"'"
EOS

No more quote escaping.
A typical use case for me is when I need to store in a string some HTML code I have copy/pasted.