Testing Winter Boot Applications with #[WinterBootTest]

​

The #[WinterBootTest] attribute

<?php
declare(strict_types=1);

namespace com\example\test;

use dev\winterframework\stereotype\Autowired;
use dev\winterframework\stereotype\test\WinterBootTest;

#[WinterBootTest]
class UserServiceTest
{
    #[Autowired]
    private UserService $users;

    public function testCreateUser(): void
    {
        $id = $this->users->create('alice', 'alice@example.com');
        // assert on $id
    }
}

​

The bundled test runner

​

Run

php srcTests/run.php

​

Layout

• run.php discovers *Test.php files in the directory and runs every public test* method, printing ok or FAIL per test plus a pass/fail summary.
• Support/TestCase.php is a base class with assertSame, assertTrue, assertFalse, assertNull, and assertThrows. Assertion failures throw AssertionFailed.
• Support/StubPropertySource.php is an in-memory PropertySource for tests. Choose the dataset via the dataset key of the propertySources entry in the fixture yml, and register rows in StubPropertySource::$datasets before building the context.
• fixtures/<name>/application.yml is a config directory you pass to new WinterPropertyContext(['.../fixtures/<name>']).

​

Add a test

​

Related pages

• Dependency injection explains how the container resolves #[Autowired] dependencies in test beans.
• Application lifecycle covers container boot order that also applies to test contexts.