Подготовка данных — PHP: Автоматическое тестирование

Большинство тестов на одну и ту же функциональность сильно похожи друг на друга. Особенно в части начальной подготовки данных. В прошлом уроке каждый тест начинался со строчки: Stack\make(). Это ещё не дублирование, но уже шаг в эту сторону. Как правило, реальные тесты сложнее и включают в себя большую подготовительную работу.

Допустим, мы разрабатываем библиотеку functional-php и хотим протестировать её функции для обработки коллекций:

• filter
• every
• zip
• и другие

Для работы этих функций нужна заранее подготовленная коллекция. Проще всего придумать одну, которая подойдёт для тестирования большинства или даже всех функций:

<?php

$coll = ['One', true, 3, 10, 'cat', [], '', 10, false];

Осталось найти место для определения этой коллекции. Для решения подобных задач в тестовых фреймворках используются хуки, специальные методы, вызываемые фреймворком на определенные события. Самый используемый среди них метод setUp(). Он автоматически вызывается перед каждым тестом:

<?php

namespace Hexlet\Phpunit\Tests

use PHPUnit\Framework\TestCase;
use Hexlet\Phpunit\Functional;

class FunctionalTest extends TestCase
{
    // Так определяется переменная на уровне класса
    // Ее называют свойством
    // private – закрывает ее от внешнего доступа
    private $coll;

    // Метод ничего не возвращает
    public function setUp(): void
    {
        // Так к переменной происходит доступ внутри класса
        // В данном случае запись данных
        $this->coll = ['One', true, 3, 10, 'cat', [], '', 10, false];
    }

    public function testFilter(): void
    {
        // Тут идет обращение к свойству
        Functional\filter($this->coll, fn(element) => is_numeric(element));
    }

    public function testZip(): void
    {
        // Тут идет обращение к свойству
        $coll2 = [/* тут другая коллекция конкретно для данного теста */];
        $result = Functional\zip($this->coll, $coll2);
        $expected = /* тут что ожидаем */;
        $this->assertEquals($expected, $result);
    }
}

Каждое выполнение хука устанавливает значения свойств в начальное значение. Это важно в том случае, если тест меняет эти данные. Только в этом случае тесты не будут зависеть от друг друга и порядка их выполнения.

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

Сами хуки принадлежат конкретному классу. То есть если в тестах есть несколько классов, то хуки определенные в одном классе, не вызываются для тестов других классов.

Дополнительные материалы

1. Фикстуры

Остались вопросы? Задайте их в разделе «Обсуждение»

Вам ответят команда поддержки Хекслета или другие студенты.