This library finds all the definitions in a file or tree that HHVM understands. It is used to generate the Hack reference documentation, and be used for other purposes such as generating autoload maps

This project requires HHVM 3.9 or later - however, if the code being scanned requires a later version of HHVM, definition-finder may not be able to parse it on the lower version.

There are three main entrypoints:

• FileParser::FromFile(string $filename)
• FileParser::FromData(string $data, ?string $filename = null)
• TreeParser::FromPath(string $path)

FileParser returns definitions from a single file, whereas TreeParser recurses over an entire directory tree. All 3 of these functions return an implementation of BaseParser. There are three forms of accessors:

• getClasses(): vec<ScannedClass> - returns a vec of [ScannedClass](src/definitions/ScannedClass.php], which has a similar interface to ReflectionClass
• getClassNames(): vec<string> - returns a vec of class names
• getClass(string $name): ScannedClass - returns a ScannedClass for the specified class, or throws an exception if it was not found

Similar functions exist for interfaces, traits, constants, enums, and typedefs.

hhvm composer require facebook/definition-finder

The API is stable, and this is used in production to generate the Hack reference documentation.

This is a recursive parser built on the token stream exposed by token_get_all().

We welcome GitHub issues and pull requests - please see CONTRIBUTING.md for details.

definition-finder is MIT-licensed.