All Attributes

Testo uses PHP attributes to configure tests, lifecycle hooks, data providers, and more. This page lists all available attributes grouped by plugin. Click any attribute name for full documentation with parameters and examples.

Attribute	Plugin	Description
#[AfterClass]#[AfterClass(int $priority = 0)]Runs a method once after all tests in the class. Suitable for cleanup.	Lifecycle	Runs a method once after all tests in the class. Suitable for cleanup.
#[AfterTest]#[AfterTest(int $priority = 0)]Runs a method after each test in the class.	Lifecycle	Runs a method after each test in the class.
#[BeforeClass]#[BeforeClass(int $priority = 0)]Runs a method once before all tests in the class. Suitable for expensive setup.	Lifecycle	Runs a method once before all tests in the class. Suitable for expensive setup.
#[BeforeTest]#[BeforeTest(int $priority = 0)]Runs a method before each test in the class.	Lifecycle	Runs a method before each test in the class.
#[Bench]#[Bench(array $callables, array $arguments = [], int $warmup = 1, int $calls = 1_000, int $iterations = 10)]Declares a benchmark comparing the method's performance against alternative implementations.	Bench	Declares a benchmark comparing the method's performance against alternative implementations.
#[Covers]#[Covers(string $classOrFunction, ?string $method = null)]Restricts which source code counts toward coverage for this test.	Codecov	Restricts which source code counts toward coverage for this test.
#[CoversNothing]#[CoversNothing]Excludes a test from coverage statistics.	Codecov	Excludes a test from coverage statistics.
#[DataCross]#[DataCross(DataProviderAttribute ...$providers)]Creates all possible combinations from providers (cartesian product).	Data	Creates all possible combinations from providers (cartesian product).
#[DataProvider]#[DataProvider(callable|string $provider)]Provides data for a parameterized test from a method or callable.	Data	Provides data for a parameterized test from a method or callable.
#[DataSet]#[DataSet(array $arguments, ?string $name = null)]Declares a set of arguments for a parameterized test. Can be used multiple times — each attribute creates a separate test run.	Data	Declares a set of arguments for a parameterized test. Can be used multiple times — each attribute creates a separate test run.
#[DataUnion]#[DataUnion(DataProviderAttribute ...$providers)]Merges data from multiple providers into a single sequential set.	Data	Merges data from multiple providers into a single sequential set.
#[DataZip]#[DataZip(DataProviderAttribute ...$providers)]Pairs up providers element by element.	Data	Pairs up providers element by element.
#[Retry]#[Retry(int $maxAttempts = 3, bool $markFlaky = true)]Declares a retry policy for a test on failure.	Retry	Declares a retry policy for a test on failure.
#[Test]#[Test()]Explicitly marks a method, function, or class as a test.	Test	Explicitly marks a method, function, or class as a test.
#[TestInline]#[TestInline(array $arguments, mixed $result = null)]Declares an inline test on a method or function.	Inline	Declares an inline test on a method or function.