voku/simple-php-code-parser

• add AstNodeInspector helpers for exact node source slices, one-based start columns, and shallow value-independent AST shape fingerprints so downstream analyzers can reuse parser mechanics without reimplementing traversal plumbing
• fix PHP 8.5 relative self / parent / static type preservation so lexical AST types win only when AST evidence exists, while pure Reflection stays honest
• fix inheritdoc merging when no parent class exists by avoiding null parent lookups

Document the behaviour changes since 0.22.1 in the changelog and add the
tests that prove nothing else changed.

The behaviour delta was measured by diffing the full parsed model of a
433-file corpus (synthetic syntax fixtures, nikic/php-parser and
phpdocumentor) between 0.22.1 and HEAD. Exactly three changes showed up,
all of them intended:

• reflected property/parameter types are now consistently fully
  qualified (\Psr\Container\ContainerInterface instead of
  Psr\Container\ContainerInterface)
• enum cases no longer leak into PHPEnum::$constants
• PHPEnum::$is_final / $is_abstract / $is_anonymous are no longer
  null for enums that cannot be autoloaded

New tests:

• ReflectionTypeFormattingRegressionTest: pins the rendered type strings
  for the AST path and the reflection path and asserts they agree, plus
  the no-autoload guarantee
• PublicApiSurfaceTest: snapshot of every public property and method, so
  a removal or an incompatible signature change fails the build
• ModelInvariantsRegressionTest: parses the whole library and every
  fixture and checks the model invariants, including that class-like
  types are always fully qualified
• ParserEntryPointsTest: end-to-end coverage of getAstFromFile(),
  getFileInfoFromFile(), the container setters and getFunctionsInfo(),
  which had no test before
• PHPEnumRegressionTest / AutoloadSafetyRegressionTest: extended to all
  three enum read paths and to the shared autoload guard

All new tests fail against 0.22.1 and pass on both nikic/php-parser v4
and v5.

Also widen the extractHooksFromReflection() array key type, which
phpstan rejected on PHP 8.4 because getHooks() is keyed by name.

Co-Authored-By: Claude Opus 5 [email protected]

• BREAKING (output only): PHPProperty::$type / PHPParameter::$type read via reflection are now consistently fully qualified, e.g. Psr\Container\ContainerInterface is now reported as \Psr\Container\ContainerInterface. Previously the leading \ was only added when class_exists() happened to be true, so interfaces, enums-in-unloadable-files and any not-yet-autoloadable class silently lost it, while the AST path always emitted it. Both paths now agree. Consumers that compare these strings verbatim have to expect the leading \ (built-in types, self, parent, static and intersection types are unchanged)
• BREAKING (output only): enum cases no longer show up in PHPEnum::$constants; they were already available (with more detail) via $cases / $caseDetails
• fix: formatting a reflected property/parameter type no longer autoloads the referenced class, which could fatal when that class uses syntax the current runtime cannot compile
• fix: PHPEnum read from a plain ReflectionClass (which is what Utils::createClassReflectionInstance() returns) now reports $scalarType and $cases / $caseDetails; before, that data was only filled in when a ReflectionEnum was passed explicitly
• fix: PHPEnum::$is_final / $is_abstract / $is_anonymous now always reflect the language guarantees (true / false / false) instead of staying null when the enum could not be autoloaded
• fix: traits with constants use the shared PHP-version autoload guard again, so the runtime-compatibility check is identical for classes, interfaces, traits and enums
• add regression coverage for all of the above, plus a public-API surface test, model invariants over the whole code base and end-to-end coverage of every PhpCodeParser entry point

Co-Authored-By: Claude Sonnet 5 [email protected]

• fix: reflecting/parsing a private or protected class constant referenced from outside its declaring class (via constant() / ReflectionParameter::getDefaultValue()) threw an uncaught \Error and aborted the whole parse; now recovered gracefully
• fix: PHPConst reflection path assigned an unnormalized gettype() string (e.g. 'NULL' instead of 'null') when a constant's value couldn't be resolved
• add regression coverage for parsing/reflecting code that references private/protected constants across class boundaries
• fix: phpstan dead-catch false positive on the \Error catch around ReflectionParameter::getDefaultValue() (its stub only declares \ReflectionException, but it also throws \Error at runtime for this case)

[+]: Add support for source-range information and enhance PHP model e…

• add source-range info to every model element: endLine, startFilePos, endFilePos (byte offsets), enabling precise sed/byte-range reads of a single declaration without loading the whole file
• add PHPFileInfo + PhpCodeParser::getFileInfoFromFile() for a lightweight per-file summary (namespaces, imports, declares)
• add PhpCodeParser::getAstFromFile() / getAstFromString() to expose the names-resolved php-parser AST directly for syntax outside the compact Model API
• add import-aware, resolved phpdoc types via PhpDocContextConnector: typeFromPhpDocResolved / returnTypeFromPhpDocResolved resolve aliased class names (e.g. use Vendor\Payload as Message;) without touching legacy rendered fields
• add $traitUses / $traitAdaptations (aliasing, insteadof) to class-like models; interfaces now retain all declared parent interfaces
• add $throws (from @throws), is_returned_by_ref, and (for methods) is_abstract to function/method models; add is_promoted to parameters
• add PHPEnumCase + $caseDetails on PHPEnum for source-aware, attribute-aware enum cases, alongside the existing legacy $cases value map
• fix: only the first property in a multi-property declaration (e.g. public $a, $b;) was parsed; all properties in the group are now read
• add extensive regression coverage for the above

[*]: update the changelog

• BREAKING: runtime support now requires PHP >= 8.1 (instead of PHP >= 7.4), while the parser still analyzes older PHP source syntax from PHP 5.3 through PHP 8.5
• add broad PHP 8.x syntax and metadata support, including enums, attributes, typed constants, readonly / promoted properties, #[\Override], and property hooks with asymmetric visibility
• improve phpdoc parsing and recovery for malformed docs, modern type syntax, inherited annotations, and raw @param / @return preservation
• modernize parser compatibility and dependencies: support nikic/php-parser v4.18 and v5, update phpDocumentor / phpdoc-parser / phpunit / phpstan dependencies, and replace React-based file reads
• improve autoloading and reflection safety for version-specific syntax and better file read error reporting
• add extensive regression coverage plus feature validation for analyzable PHP source syntax from PHP 5.3 through PHP 8.5

[+]: use "phpstan/phpdoc-parser" for more phpdocs + more tests

• use "phpstan/phpdoc-parser" for more phpdocs

[*]: update the changelog

• add support for "readonly" properties
• replace deprecated "parts" property from nikic/PHP-Parser
• use "phpstan/phpdoc-parser" as fallback for parameters e.g. for callable() types
• use php types
• add more tests

[*]: update the changelog

• try to fix autoload #11
• inheritDoc: use all types (not only from phpdoc) from parent classes & interfaces
• add more tests

[*]: update the changelog

• support for "::class" from PHP 8

[*]: update the changelog

• fix fatal error for non existing classes

• update "phpdocumentor/type-resolver" (with support for int-ranges)
• clean-up some errors reported by phpstan

• quick-fix for missing namespaces in types

• optimize NULL detecting from reflection for types
• "BasePHPClass" -> add more information from reflection
• "PHPConst" -> add "visibility"

• use native php reflection, instead of (slower) better reflection
• remove "react/filesystem" (not working with phar files)

• temporary fix for phpdoc like int<0,1>
• update dependencies

• update dependencies

• update dependencies

• "PhpCodeParser" -> optimize exception handling of "amphp/parallel" for async code analysis per file

• "PhpCodeParser" -> ignore exceptions from auto loaded external classes

• "PhpCodeParser" -> allow different file extensions

• fix php variable detection

• save the raw phpdoc for "@return" and "@param" v2

• save the raw phpdoc for "@return" and "@param"

• support for modern phpdocs for "@param" and "@return"

• update vendor libs
• PHP 7.2 as minimal requirement
• remove custom PseudoTypes for phpDocumentor (PseudoTypes are now build in into phpDocumentor itself)
• add more tests

• save special phpdoc @tags and the content of these tags

• optimize performance via static cache

• move "PhpCodeChecker" in a separate repository
• move "PhpCodeDumpApi" in a separate repository
• clean-up vendor dependencies

• "PhpCodeCheckerCommand" -> allow to exclude some files
• optimize parallel execution (cpu cores === max parallel executions)
• update vendor (phpdocumentor & better-reflection)

• "PhpCodeParser" -> add "getFromClassName()"

• "PHPTrait" -> add support for "Trait"-files

• "PhpCodeParser" -> fix cache key
• "PhpCodeChecker" -> fix the autoloader parameter

• "PHPInterface" -> fix recursion
• "PhpCodeParser" -> analyse only ".php" files in the given path

• "PhpCodeParser" -> ignore errors outside the current file-path-scope
• "PhpCodeParser" -> use more generic autoloader logic
• "PhpCodeChecker" -> fix more inheritdoc errors

• "PhpCodeChecker" -> check wrong phpdocs from class properties
• "PhpCodeParser" -> allow to exclude some files

• replace PhpReflection with BetterReflection v2
• fix bugs reported by PhpStan & PhpCodeCheck

• replace PhpReflection with BetterReflection

• "PhpCodeParser" -> fetch phpdoc-data for @inheritdoc

• "ParserErrorHandler" -> show more parsing errors in the results
• "PHPInterface" -> fix PhpReflection usage

• "PhpCodeCheckerCommand" -> fix "$skipMixedTypesAsError" usage

• "PHPFunction" -> fix phpdoc parsing error

• add default values for parameter and properties
• add types from default values
• normalize types (e.g. double => float)

• "PHPClass" fix phpdoc
• add "PhpCodeChecker"-class

• fix code issues reported by psalm + phpstan

• use "amphp/parallel" for async code analyse per file

• init (forked from "JetBrains/phpstorm-stubs")
• add "PHPProperties"
• add "PHP Reflection" AND / OR "nikic/PHP-Parser"
• get phpdocs types via phpDocumentor (+ psalm)