mini\Converter\ConverterRegistry class

Documentation

Registry for type converters

Manages converters that transform values from one type to another. Supports union input types and automatic resolution to most specific converter.

Features:

  • Union input types (e.g., string|int)
  • Single-type converters can override union members (more specific wins)
  • Detects conflicting registrations (overlapping unions, duplicates)
  • Type hierarchy resolution for objects (class → interfaces → parent → parent interfaces)
  • Fallback handler for type families (e.g., all BackedEnums)

Resolution order:

  • Direct single-type converter (most specific)
  • Union type converter via alias (less specific)
  • Parent class converters
  • Interface converters
  • Fallback handler (if registered)

Inheritance

Implements: mini\Converter\ConverterRegistryInterface

Properties (2)

private array $converters

Converters indexed by target type, then input type

public readonly mini\Hooks\Handler $fallback

Fallback handler for conversions without registered converters

Methods (12)

public __construct()

Documentation missing

public register()

Register a converter

public replace()

Replace an existing converter

private doRegister()

Internal registration logic

public has()

Check if a converter exists for input to target type

public get()

Get the converter for input to target type

public convert()

Convert a value to target type

public tryConvert()

Try to convert a value, returning null if no converter handles it

private findConverter()

Find most specific converter for input to target type

private lookupConverterForType()

Look up a converter for specific input type to target type

private normalizeInputTypes()

Normalize input type string into a canonical key and list of member types.

private walkInputTypes()

Walk the type hierarchy for an object

Source

src/Converter/ConverterRegistry.php:29-398