Add example of a nowdoc/heredoc as a function parameter

[TimWolla]

I believe the indentation requirement of nowdoc/heredoc is not obviously correct within a multi-line function parameter list, as the ending delimiter also needs to be indented compared to e.g. an anonymous function.

<?php

// Right?
var_dump(
    'foo',
    <<<'EOT'
        Line 1
        Line 2
        Line 3
        EOT,
    'bar',
);

// Wrong?
var_dump(
    'foo',
    <<<'EOT'
    Line 1
    Line 2
    Line 3
    EOT,
    'bar',
);

see https://3v4l.org/eGlGY
see #5

[TimWolla]

Likewise there is no actual example of the correct format for a multi-line array (or anon function) within a multi-line parameter list. It just says that those do not imply that the parameter list itself is multi-line.

[KorvinSzanto]

I'd argue that:

Instead, the heredoc MUST be indented once past the indentation of the scope it's declared in.

makes it clear that your first example is allowed and your second example is disallowed.

[TimWolla]

I don't think it's clear, otherwise I wouldn't have opened this issue. Especially since a function call does not open a new scope if using common terminology (in PHP it's even arguable if if opens a new scope). Also the nowdoc/heredoc section is the only section where the term “scope” appears.

Certainly another explicit example can't hurt?

[TimWolla]

Alternatively this could be rephrased entirely:

"The heredoc body and ending delimiter must be indented one additional level compared to the opening delimiter"

[KorvinSzanto]

"Scope" here refers to the indentation scope, not the variable scope. I wouldn't mind adding another example if you want to open a PR.