doctrine/instantiator
Instantiator
Instantiator is a PHP library designed to create class instances without invoking their constructors. It uses the PHP Reflection API to allocate objects in memory and initialize them in a predefined state, bypassing standard constructor logic.
The project functions as a data hydration tool and a testing helper. It enables the population of PHP objects from external data sources by mapping values directly to properties, regardless of whether those properties are public, protected, or private. This capability allows for the generation of objects in specific internal states for unit tests without managing complex constructor dependencies.
The library provides utilities for object instantiation, reflection-based property injection, and data hydration. It supports the creation of object graphs by recursively instantiating dependent classes to populate complex hierarchies based on declared type hints.
Features
- No-Constructor Object Allocation - Allocates PHP objects in memory without calling any constructor, enabling initialization in a predefined state.
- Constructor Bypassing - Creates class instances by bypassing the constructor to avoid side effects and enable data hydration.
- PHP Data Hydration - Populates PHP objects with data from external sources by mapping values directly to properties.
- Data-Driven State Population - Populates an object's internal state by mapping external data sources directly to class properties.
- Data Hydration Tools - Fills PHP objects with data from external sources by mapping values directly to properties via reflection.
- Constructor-less Instantiation - Instantiates classes without invoking the constructor or other internal class logic.
- Private Property Access - Bypasses access restrictions via reflection to assign values to private and protected properties.
- Reflection-Based Access - Uses runtime type inspection to access or modify private properties that are otherwise restricted.
- Direct Property Injection - Sets the internal state of an object by assigning values directly to properties regardless of their visibility.
- Reflection-Based Instantiators - Creates PHP class instances without invoking their constructors, using reflection for direct property injection.
- Reflection-Based State Inspection - Uses language reflection capabilities to access and modify private or protected members of objects during runtime.
- Reflection Utilities - Uses the Reflection API to create object instances and manipulate non-public properties.
- Reflection-Based Property Injection - Sets object properties directly via reflection, bypassing visibility constraints to populate internal state from external data.
- Custom Object Hydration - Populates PHP objects with data from external sources by mapping values directly to properties.
- Data-Driven Object Initialization - Provides the ability to fill object state from external data sources by mapping values directly to properties without constructor involvement.
- Constructor-Bypassing Instantiation - Creates PHP class instances without triggering constructor logic to initialize objects in a predefined state.
- Visibility-Agnostic State Management - Treats private, protected, and public properties uniformly when populating internal object state.
- Visibility-Agnostic State Population - Provides the ability to populate internal object state regardless of property visibility modifiers.
- PHP Testing Frameworks - Generates PHP objects in specific internal states for unit tests without managing constructor dependencies.
- Testing and Mocking - Helps generate objects in specific states for unit tests without constructor dependencies.
- Object Persistence - Saves complex in-memory PHP data structures to persistent storage.
- Persistence Layers - Builds the persistence layer by mapping database records to objects without triggering constructors.
- Type-Hint-Driven Hydration - Matches input data to object properties by analyzing declared PHP type hints through reflection for accurate hydration.
- Type-Hint-Driven Mapping - Analyzes declared PHP type hints through reflection to match input data to the correct class properties.
- Type-Aware Value Mapping - Matches input data to object properties by analyzing the declared PHP type hints.
- Constructor-Bypassing Injection - Initializes objects without manual constructor arguments for testing or hydration purposes.
- Recursive Object Graph Hydration - Processes nested data structures by automatically instantiating dependent classes to populate complex object hierarchies.
- Dynamic Object Instantiation - Creates class instances directly from hierarchical configuration values, including nested dependencies.
- Recursive Type Resolution - Traverses nested object hierarchies to resolve and instantiate appropriate types based on reflection data.
- Reflection-Based Unmarshallers - Maps unstructured data to typed structures using language reflection while bypassing constructor setup logic.
- Dynamic Property Mapping - Uses reflection to map data keys to object properties at runtime without requiring decorators or inheritance.
- Dependency Mocking - Simulates dependencies by generating objects in specific internal states for unit testing.
- Unit Testing Utilities - Provides a utility for creating PHP objects in specific internal states for isolation testing.
- Unit Testing - Provides a way to create objects in specific internal states for isolated unit tests.
