Mockery

Mockery is a popular PHP mocking library with an expressive API (Mockery::mock(), expects(), spy()). The testo/bridge-mockery package integrates it with Testo.

Plugin class: MockeryPlugin\Testo\Bridge\Mockery\MockeryPlugin. Not included in default plugins.

Installation

composer require --dev mockery/mockery testo/bridge-mockery

Setup

Register the MockeryPlugin\Testo\Bridge\Mockery\MockeryPlugin in the plugins section — either at the application level (for all suites) or for a specific Test Suite (for a particular set of tests).

Application level

use Testo\Application\Config\ApplicationConfig;
use Testo\Bridge\Mockery\MockeryPlugin;

return new ApplicationConfig(
    src: ['src'],
    suites: [ /** Suites **/ ],
    plugins: [
        new MockeryPlugin(),
    ],
);

Suite level

use Testo\Application\Config\SuiteConfig;
use Testo\Bridge\Mockery\MockeryPlugin;

new SuiteConfig(
    name: 'Unit',
    location: ['tests/Unit'],
    plugins: [
        new MockeryPlugin(),
    ],
);

Mock Expectation Verification

The bridge automatically verifies mock expectations after each test and maps the result to Testo statuses — manual teardown is not required. The rule is straightforward: if you declare an expectation and fulfill it, the test passes; if you don't, it fails.

• A fulfilled expectation counts as an assertion. So a test whose only check is a mock stays Status::Passed\Testo\Core\Value\Status::Passed rather than Status::Risky\Testo\Core\Value\Status::Risky (Testo marks a passing test with no assertions as risky — a safeguard against forgotten assertions, see Assert).
• An unfulfilled expectation fails the test (Failed) and shows up in the assertion history as a failure.

Passed

#[Test]
public function notifies(): void
{
    $mailer = Mockery::mock(Mailer::class);
    $mailer->expects('send')->once();       // expectation — and an assertion at that

    (new Notifier($mailer))->notify('hi');  // send() is called once, fulfilling the expectation
}

Risky

#[Test]
public function notifies(): void
{
    $mailer = Mockery::spy(Mailer::class);

    (new Notifier($mailer))->notify('hi');
    // no expectations, no assertions — nothing to check → Risky
}

Failed

#[Test]
public function notifies(): void
{
    $mailer = Mockery::mock(Mailer::class);
    $mailer->expects('send')->once();       // expect exactly one send() call

    // …but notify() was never called → expectation unfulfilled → Failed
}

The plugin only works with regular tests (for example, those marked with the #[Test]#[Test()]Explicitly marks a method, function, or class as a test. attribute). In inline tests, benchmarks, and other test types, mocks are not verified or cleaned up automatically — you'll need to handle that yourself, directly through Mockery.