PHPUnit, популярная среда тестирования PHP, предлагает различные функции, упрощающие процесс тестирования. Одной из ценных функций является возможность остановить выполнение набора тестов, как только произойдет сбой. В этой статье блога мы углубимся в функцию PHPUnit «остановка при сбое» и рассмотрим различные методы ее эффективной реализации. Итак, начнём!

Метод 1: использование параметра командной строки --stop-on-failure
PHPUnit предоставляет удобный параметр командной строки --stop-on-failure, который автоматически останавливает выполнение набора тестов при встречается неудача. Чтобы использовать его, просто добавьте параметр при запуске PHPUnit из командной строки:

phpunit --stop-on-failure

Метод 2: реализация методов stopOnErrorи stopOnFailure.
PHPUnit предлагает два специальных метода: stopOnErrorи stopOnFailure, которые позволяют вам контролировать, должно ли выполнение набора тестов останавливаться в случае ошибок или сбоев соответственно. Эти методы можно использовать в классе тестового примера, чтобы указать желаемое поведение.

Пример:

class MyTestCase extends \PHPUnit\Framework\TestCase
{
    protected function setUp(): void
    {
        $this->stopOnFailure();
    }
// Test methods...
    protected function tearDown(): void
    {
        // Clean up tasks...
    }
}

Метод 3: использование утверждений с настраиваемыми обработчиками ошибок
PHPUnit позволяет определять собственные обработчики ошибок с помощью функции set_error_handler. Объединив это с методом stopOnFailure, вы сможете добиться желаемого поведения.

Пример:

class MyTestCase extends \PHPUnit\Framework\TestCase
{
    protected function setUp(): void
    {
        set_error_handler([$this, 'customErrorHandler']);
    }
    protected function customErrorHandler($errno, $errstr, $errfile, $errline)
    {
        if ($errno === E_USER_ERROR) {
            $this->stopOnFailure();
        }
// Custom error handling logic...
    }
// Test methods...
    protected function tearDown(): void
    {
        // Clean up tasks...
    }
}

Метод 4: расширение класса TestListenerAdapter
PHPUnit предоставляет класс TestListenerAdapter, который позволяет создавать собственные прослушиватели тестовых событий. Расширяя этот класс, вы можете реализовать желаемое поведение при возникновении сбоя.

Пример:

use PHPUnit\Framework\TestListenerAdapter;
use PHPUnit\Framework\Test;
class MyTestListener extends TestListenerAdapter
{
    public function addFailure(Test $test, \Throwable $t, float $time): void
    {
        parent::addFailure($test, $t, $time);
        $test->stopOnFailure();
    }
}
// Register the custom listener
PHPUnit\Framework\TestListenerDefaultImplementation::add(
    new MyTestListener()
);

В этой статье мы рассмотрели несколько способов включения функции «остановка при сбое» в PHPUnit. Предпочитаете ли вы использовать параметры командной строки, специальные методы, специальные обработчики ошибок или расширение класса TestListenerAdapter, PHPUnit предлагает гибкость, соответствующую вашим потребностям. Эффективно используя эти методы, вы сможете улучшить рабочий процесс тестирования, быстро выявить сбои и обеспечить стабильность ваших приложений PHP.