Download the PHP package componenta/reflection without Composer
On this page you can find all versions of the php package componenta/reflection. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download componenta/reflection
More information about componenta/reflection
Files in componenta/reflection
Package reflection
Short Description Reflection utilities for PHP 8.4+ with attribute metadata, deep reflection, type inspection and safe coercion
License MIT
Informations about the package reflection
Componenta Reflection
Reflection utilities for PHP 8.4+.
Installation
Reflection
Reflection::class() supports classes, interfaces, traits and enums and returns null when the symbol does not exist.
Reflection::callable() supports functions, closures, concrete methods and invokable objects. Callables resolved only through __call() or __callStatic() are rejected because they have no concrete method signature to reflect.
Reflection::reflect() accepts mixed input and returns the corresponding native reflector or null when the value cannot be reflected reliably.
Attributes
Attribute definitions are cached, while attribute instances are created fresh for each read. hasMetadata() does not instantiate attributes.
Supported reflectors include functions, methods, classes, parameters, properties, class constants and global constants. Global constant attributes are available on PHP 8.5+.
Deep lookup
Deep lookup includes the class, methods, properties, property hooks and class constants. Paths are unambiguous:
Use getFirstDeepMetadata() for the first matching attribute and hasDeepMetadata() for an existence check without instantiating attributes.
Reflection types
ReflectionType supports named, union, intersection and DNF types.
getTypeNames(null) returns []. Nullable named types are normalized semantically, so ?int produces ['int', 'null'].
When native Reflection exposes self, parent or static, pass the declaring or effective class as scope:
For relative types declared in a trait, use the consuming class as the scope.
ReflectionType::toString() returns PHP's native string representation of the reflected type.
Coercion
Coercion is limited to reflected PHP types. Union coercion succeeds only when the value already matches a branch or exactly one branch is coercible; ambiguous conversions are rejected.
Arrays can be produced from arrays, iterables and Componenta\Arrayable\Arrayable values. Scalars are not wrapped into one-element arrays.
Cache management
Class, function and method reflectors are cached strongly. Object and closure reflectors use WeakMap and do not extend application object lifetime.
Development
Tests use Pest 4. Static analysis runs with PHPStan at maximum level. CI covers PHP 8.4 and PHP 8.5.