Noir::PhpBlockParser

The block structure of PHP source, read off a PhpLexer's masked text (strings, comments, heredocs and inline HTML blanked), so no delimiter or keyword inside a literal or a comment can open, close or fake a block.

One linear pass builds a tree of the constructs analyzers ask about:

• statements: if / elseif / else chains, try / catch / finally, switch and its cases, loops, bare { } blocks, with each construct's parenthesised head (condition, subject) as a span;
• code units: named functions, methods, closures (function () use () { }) and arrow functions (fn () => expr), with their parameter lists, and match expressions — also when they sit inside an argument list or another construct's condition;
• declarations: class / trait / interface / enum (and new class) with their methods and properties as members;
• PHP 8 attributes #[A(...), B], attached to the declaration they precede.

Every delimiter pair is matched once up front, so the tree, close_of and array_entries all answer without rescanning. Ranges are character offsets into the lexed source (same as PhpLexer#masked); a block's body excludes its braces.