phpspec/prophecy
Prophecy
Prophecy is a PHP mocking framework and test double library used to simulate object dependencies during unit testing. It serves as a behavioral testing tool for creating mocks, stubs, and dummies to isolate code and ensure predictable test results.
The framework enables interaction verification by tracking method call counts and arguments to validate that specific interactions occurred. It supports defining specific return values or custom logic for method calls to simulate various execution scenarios.
The library provides capabilities for argument matching based on type or value, interaction spying to record calls, and the generation of lightweight dummy objects that satisfy interface type hints.
Features
- PHP Testing Frameworks - Provides a specialized mocking and test double framework designed specifically for the PHP ecosystem.
- Test Double Implementations - Provides controlled substitutes for real objects, including mocks, stubs, and spies, to isolate code during testing.
- Method Interception Proxies - Implements a dynamic proxy system to intercept method calls and inject custom behavioral logic without altering source code.
- Interaction Expectations - Tracks call counts and arguments to validate that specific object interactions occurred as required by the test.
- Mocking Frameworks - Provides a complete framework for creating simulated objects and stubbing method calls to isolate PHP components.
- Object Interaction Verification - Verifies that specific methods on an object are called with expected arguments to validate internal logic.
- Dynamic Mock Objects - Provides runtime generation of proxy objects to simulate dependencies and track interactions during unit tests.
- Test Double Libraries - Generates mock, dummy, and spy objects to isolate code and ensure predictable results during PHP testing.
- Dummy Implementations - Generates minimal object instances that satisfy type hints by returning null for every method defined in an interface.
- Argument Constraint Matchers - Provides logic for validating method parameters against custom predicates, types, or patterns during mock interaction.
- Test Argument Validators - Includes routines for validating arguments passed to mock objects using types, values, or custom callbacks.
- Method Call Frequency Constraints - Enforces specific limits on the number of times a method is invoked during test execution.
- Dummy Object Generation - Generates lightweight token objects that implement specific interfaces and return null for all method calls.
- Method Stubbing Utilities - Provides mechanisms to define specific return values or custom logic for mock method calls.
- Interface Stubbing - Generates lightweight objects that implement required interfaces to satisfy type hints without implementing full business logic.
- Interaction Spies - Provides utilities for capturing method invocation history on mock objects for post-execution verification.
- Reflection-Based Proxies - Inspects class signatures at runtime via reflection to generate compatible proxy objects for mocking.
- Testing and Quality - Opinionated mocking framework.
