ClassNameExtractor

Extracts a FQCN from a PHP source file by regexing its `namespace`/`class` declarations — no autoloading, no tokenizer, just enough to let the `coa:verify-*` CLI entry points accept either a FQCN or a file path. Shared by the `verify-controller.php` / `verify-entity.php` CLI shims so the "accept a path" convenience does not get re-implemented twice.

public static function fromFile(string $filePath): ?string

Extracts the FQCN declared in `$filePath`; `null` when no `class` declaration is found.

Parameters