type-lang/reader

Library for reading TypeLang AST nodes from types exposed by PHP Reflection objects

2.0.0-beta1 2026-07-12 18:26 UTC

Requires

• php: ^8.4
• type-lang/types: ^2.0

Requires (Dev)

• phpstan/phpstan: ^2.2.5
• phpunit/phpunit: ^13.2.4
• type-lang/printer: ^2.0

MIT

• php
• parser
• reflection
• language
• converter

Published on Packagist.org on 2026-07-12 18:43 UTC

README

Converts native PHP types exposed by Reflection objects into TypeLang TypeLang\Type\* AST nodes.

Given a ReflectionClassConstant, ReflectionProperty, ReflectionParameter or ReflectionFunctionAbstract, it returns the matching type node (or null when no type is declared).

Full documentation is available at typelang.dev.

Installation

Install the package via Composer:

composer require type-lang/reader

Requirements:

• PHP 8.4+

Usage

TypeLang\Reader\ReflectionReader exposes a find*Type() method for every kind of Reflection object:

$reader = new TypeLang\Reader\ReflectionReader();

$node = $reader->findFunctionType(
    new ReflectionFunction(function (): void {}),
);

var_dump($node);
// object(TypeLang\Type\NamedTypeNode) {
//   ["name"] => "void"
//   ...
// }

Combine it with type-lang/printer to dump the resolved types of a whole class:

$class = new ReflectionClass(Path\To\Example::class);
$reader = new TypeLang\Reader\ReflectionReader();
$printer = new TypeLang\Printer\PrettyTypePrinter();

foreach ($class->getProperties() as $property) {
    if ($type = $reader->findPropertyType($property)) {
        echo "property {$property->name}: {$printer->print($type)}\n";
    }
}

foreach ($class->getMethods() as $method) {
    if ($type = $reader->findFunctionType($method)) {
        echo "method {$method->name}(): {$printer->print($type)}\n";
    }
}

Constants (findConstantType()) and parameters (findParameterType()) are read the same way.