tebru/php-type

A type wrapper for PHP that support generic syntax

v0.1.7 2019-10-17 17:58 UTC

This package is auto-updated.

Last update: 2024-10-18 05:00:54 UTC


README

Build Status Code Coverage Scrutinizer Code Quality

This library wraps a type string and provides an API around getting information about the type. It also supports generic type syntax.

General Usage

The simplest way is to instantiate a new TypeToken and pass in the type.

new TypeToken('string');

The class also normalizes the type:

$typeShort = new TypeToken('int');
$typeLong = new TypeToken('integer');

$typeShort->getRawType(); // 'integer'
$typeLong->getRawType(); // 'integer'

$typeShort->getPhpType(); // 'integer'
$typeLong->getPhpType(); // 'integer'

$typeShort->isInteger(); // true
$typeLong->isInteger(); // true

Any of the core php types are supported as well as ? which represents a wildcard type. This can be used if the type is unknown at the time the type is instantiated. All of the possible types are represented as constants on the class.

Classes also work the same

$type = new TypeToken(\My\Foo::class);

$type->getRawType(); // 'My\Foo'
(string)$type; // 'My\Foo'
$type->getPhpType(); // 'object'
$type->isObject(); // true
$type->isA(\My\Foo::class); // true

->isA() checks the instantiated type's parent classes and interfaces in addition to the passed in class name.

You can also use generic syntax with angle brackets.

$type = new TypeToken('My\Foo<string, My\Foo2>');

$type->getRawType(); // 'My\Foo'
(string)$type; // 'My\Foo<string, My\Foo2>'
$type->getPhpType(); // 'object'
$type->isObject(); // true
$type->isA(\My\Foo::class); // true

$generics = $type->getGenerics();
(string)$generics[0]; // 'string'
(string)$generics[1]; // 'My\Foo2'

Calling ->getGenerics() will return an array of TypeToken objects.

Nested generics work the same way

new TypeToken('array<string, array<int>>');

This could represent an array with string keys and all values are an array of integers.

If you have a variable, you can get the type using the static factory method

TypeToken::createFromVariable($variable);

This uses the singleton method ::create() which will return the same instance on duplicate types.