Жизненный цикл

Атрибуты жизненного цикла позволяют выполнять код до и после тестов — для подготовки окружения, очистки состояния и управления ресурсами.

За эту функциональность отвечает плагин \Testo\Lifecycle\LifecyclePlugin, входящий в набор SuitePlugins по умолчанию.

Инстанциирование класса

По умолчанию Testo создаёт экземпляр тестового класса один раз на тестовый класс, а не на каждый тест. Это значит:

• Свойства экземпляра сохраняются между тестами в одном классе
• Конструктор выполняется лениво — непосредственно перед первым вызовом нестатического метода
• Если все методы статические, класс не инстанциируется

final class ServiceTest
{
    private Client $client;
    private int $counter = 0;

    public function __construct()
    {
        // Выполняется один раз — естественное место для дорогой инициализации
        $this->client = new Client();
    }

    #[Test]
    public function firstTest(): void
    {
        $this->counter++;
        // $this->counter теперь 1
    }

    #[Test]
    public function secondTest(): void
    {
        $this->counter++;
        // $this->counter теперь 2 — состояние сохраняется между тестами
        // $this->client — всё тот же экземпляр
    }
}

Для контроля состояния между тестами используйте атрибуты жизненного цикла, описанные ниже.

Атрибуты

Атрибут	Когда выполняется	Как часто
#[BeforeTest]	Перед каждым тестовым методом	Один раз на тест
#[AfterTest]	После каждого тестового метода	Один раз на тест
#[BeforeClass]	Перед всеми тестами в классе	Один раз на тестовый класс
#[AfterClass]	После всех тестов в классе	Один раз на тестовый класс

Порядок выполнения

BeforeClass (один раз)
├── BeforeTest
│   └── Тест 1
│   └── AfterTest
├── BeforeTest
│   └── Тест 2
│   └── AfterTest
└── ...
AfterClass (один раз)

Базовый пример

final class DatabaseTest
{
    private static Connection $connection;
    private Transaction $transaction;

    #[BeforeClass]
    public static function connect(): void
    {
        self::$connection = new Connection();
    }

    #[AfterClass]
    public static function disconnect(): void
    {
        self::$connection->close();
    }

    #[BeforeTest]
    public function beginTransaction(): void
    {
        $this->transaction = self::$connection->beginTransaction();
    }

    #[AfterTest]
    public function rollback(): void
    {
        $this->transaction->rollback();
    }

    #[Test]
    public function insertsRecord(): void
    {
        self::$connection->insert('users', ['name' => 'John']);
        Assert::same(1, self::$connection->count('users'));
    }
}

Приоритет

Когда у вас несколько методов с одинаковым атрибутом жизненного цикла, используйте priority для управления порядком выполнения:

#[BeforeTest(priority: 100)]
public function initializeConfig(): void
{
    // Выполняется первым (наивысший приоритет)
}

#[BeforeTest(priority: 50)]
public function initializeLogger(): void
{
    // Выполняется вторым
}

#[BeforeTest] // priority: 0 (по умолчанию)
public function initializeService(): void
{
    // Выполняется последним
}

Большие значения выполняются первыми. Приоритет по умолчанию — 0.