Тестовый запуск командной строки (1)

Вступление

Тестер запуска командной строки PHPUnit используется для запуска тестов PHPUnit на терминале. это

$ phpunit ArrayTest
PHPUnit |version|.0 by Sebastian Bergmann and contributors.
..
Time: 0 seconds
OK (2 tests, 2 assertions)

Когда приведенная выше команда вызывается, как показано, средство выполнения тестов командной строки PHPUnit будет искать файл `ArrayTest.php` в текущем рабочем каталоге, загружать его и ожидать, что в нем будет найден тестовый класс` ArrayTest`. Затем он выполнит тесты этого класса.

Для каждого выполненного теста инструмент командной строки PHPUnit использует один символ, чтобы указать ход выполнения теста. Некоторые из этих персонажей включают в себя:

• `.` Это печатается, когда тест завершается успешно.
• `F` Это означает, что утверждение не выполнено во время выполнения тестового метода.
• `E` Указывает на возникновение ошибки при выполнении тестового метода.
• `R` Печатается, когда тест помечен как рискованный.
• `S` Это печатается, когда тест был пропущен
• `I` Указывает, что тесты помечены как незавершенные или еще не выполненные.

PHPUnit различает сбои и ошибки. Сбой - это нарушенное утверждение PHPUnit, такое как неудачный вызов assertSame () `.

Ошибка - это непредвиденное исключение или ошибка PHP. Иногда это различие оказывается полезным, поскольку ошибки, как правило, легче исправить, чем ошибки.

# Параметры командной строки

В PHPUnit есть много параметров командной строки, разработанных для того, чтобы сделать тест PHPUnit простым и понятным. Команда `phpunit --help` предоставит вам полный список всех параметров командной строки PHPUnit, как показано ниже.

$ phpunit --help

PHPUnit | version | .0 Себастьян Бергманн и его участники.

Использование:

phpunit [параметры] UnitTest [UnitTest.php]

phpunit [опции] <каталог>

Варианты покрытия кода:

Параметры ведения журнала:

Варианты выбора теста:

Параметры выполнения теста:

Параметры конфигурации:

Разные варианты:

# Команды командной строки

`phpunit UnitTest`

Эта команда выполняет тесты, предоставляемые классом `UnitTest`. Ожидается, что этот класс будет объявлен в файле `UnitTest.php`.

UnitTest должен быть либо классом, который наследуется от PHPUnit / Framework / TestCase, либо классом, который предоставляет метод public static suite (), который возвращает объект `PHPUnit / Framework / Test`, например, экземпляром Класс PHPUnit / Framework / TestSuite.

`phpunit UnitTest UnitTest.php`

Запускает тесты, предоставляемые классом UnitTest. Ожидается, что этот класс будет объявлен в указанном исходном файле.

Некоторые необязательные флаги также могут быть переданы вышеупомянутой команде, некоторые из этих необязательных флагов:

`--coverage-clover`

Создает файл журнала в формате XML с информацией о покрытии кода для выполнения тестов.

Следует отметить, что эта функциональность доступна только в том случае, если установлены расширения tokenizer и Xdebug.

`--coverage-crap4j`

Создает отчет о покрытии кода в формате Crap4j. Эта функциональность также доступна только после установки расширений Tokenizer и Xdebug.

`--coverage-html`

Создает отчет о покрытии кода в формате HTML. Эта опция также работает, только если установлены расширения tokenizer и Xdebug.

`--coverage-php`

Это создает сериализованный объект PHP_CodeCoverage с информацией о покрытии кода.

Обратите внимание, что эта функция доступна только в том случае, если установлены расширения Tokenizer и Xdebug.

`--coverage-Text`

Создает файл журнала или вывод из командной строки в удобочитаемом формате с информацией о покрытии кода для запуска тестов. Эта функциональность доступна только в том случае, если установлены расширения tokenizer и Xdebug.

`--log-junit`

Создает файл журнала в формате JUnit XML для запуска тестов.

`--testdox-html` и` --testdox-text`

Создает гибкую документацию в формате HTML или обычном тексте для запускаемых тестов.

`--filter`

Запускает только тесты, имя которых соответствует заданному шаблону регулярного выражения. Если шаблон не заключен в разделители, PHPUnit будет заключать шаблон в разделители `/`.

Соответствующие имена тестов будут иметь один из следующих форматов:

`TestNameSpace / TestCaseClass :: testMethod`

Формат имени теста по умолчанию эквивалентен использованию магической константы `__METHOD__` внутри метода теста.

`TestNamespace / TestCaseClass :: testMethod с набором данных # 0`

Когда у теста есть поставщик данных, к каждой итерации данных добавляется текущий индекс, добавляемый в конец имени теста по умолчанию.

`TestNamespace / TestCaseClass :: testMethod с набором данных« мои именованные данные »`

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

Фрагмент кода ниже иллюстрирует пример именованных наборов данных.

<?php
use PHPUnit\Framework\TestCase;
namespace TestNamespace;
class TestCaseClass extends TestCase
{
    /**
     * @dataProvider provider
     */
    public function testMethod($data)
    {
        $this->assertTrue($data);
    }
    public function provider()
    {
        return [
            'my named data' => [true],
            'my data'       => [true]
        ];
    }
}

`/ путь / к / мой / test.php`

Имя теста для теста PHPUnit - это путь к файловой системе. Пример ниже иллюстрирует некоторые допустимые шаблоны фильтров.

--filter 'TestNamespace // TestCaseClass :: testMethod'

--filter 'TestNamespace // TestCaseClass'

--filter TestNamespace

--filter TestCaseClase

--filter testMethod

--filter '/ :: testMethod. * "Мои именованные данные" /'

--filter '/ :: testMethod. * # 5 $ /'

--filter '/ :: testMethod. * # (5 | 6 | 7) $ /'

Ярлыки также можно использовать для проверки наличия доступных поставщиков данных, примеры которых приведены ниже для некоторых ярлыков фильтров.

--filter 'testMethod # 2'

--filter 'testMethod # 2-4'

--filter '# 2'

--filter '# 2-4'

--filter ' [электронная почта защищена] именованные данные'

--filter ' [электронная почта защищена] * данные'

--filter '@my named data'

--filter '@ my. * data'

Предыдущая: Написание тестов для phpunit (исключения и ошибки)
Далее: Тестер командной строки (2)