Spec-Zone.ru › PHPUnit

Файл конфигурации XML

Элемент <phpunit>

Атрибут backupGlobals

Возможные значения: true или false (по умолчанию: false)

PHPUnit может выборочно сохранять все глобальные и суперглобальные переменные перед каждым тестом и восстанавливать это сохранение после каждого теста.

Этот атрибут настраивает эту операцию для всех тестов. Данную конфигурацию можно переопределить, используя атрибут BackupGlobals на уровне класса тестового случая и тестового метода.

Атрибут backupStaticProperties

Возможные значения: true или false (по умолчанию: false)

PHPUnit может выборочно сохранять все статические свойства во всех объявленных классах перед каждым тестом и восстанавливать это сохранение после каждого теста.

Этот атрибут настраивает эту операцию для всех тестов. Данную конфигурацию можно переопределить, используя атрибут BackupStaticProperties на уровне класса тестового случая и тестового метода.

Атрибут bootstrap

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

Атрибут cacheDirectory

Этот атрибут настраивает каталог, в котором PHPUnit кэширует информацию, такую как результаты тестов (см. ниже), или результат статического анализа кода, выполняемого для отчётов о покрытии кода.

Атрибут cacheResult

Возможные значения: true или false (по умолчанию: true)

Этот атрибут настраивает кеширование результатов тестов. Это кэширование необходимо для упорядочения тестов по дефектам или продолжительности с помощью атрибута executionOrder (см. Атрибут executionOrder).

Атрибут colors

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает использование цветов в выводе PHPUnit.

Установка этого атрибута в true эквивалентна использованию параметра командной строки --colors=auto.

Установка этого атрибута в false эквивалентна использованию параметра командной строки --colors=never.

Атрибут columns

Возможные значения: целое число или строка max (по умолчанию: 80)

Этот атрибут настраивает количество столбцов для вывода хода выполнения.

Если max определено как значение, то количество столбцов будет максимальным для текущего терминала.

Атрибут controlGarbageCollector

Возможные значения: true или false (по умолчанию: false)

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

Настройка controlGarbageCollector="true" имеет следующие последствия:

  • Отключить автоматический сбор мусора, используя gc_disable(), перед запуском первого теста

  • Вызвать сбор мусора, используя gc_collect_cycles(), перед запуском первого теста

  • Вызвать сбор мусора, используя gc_collect_cycles(), после каждого n-го теста

  • Вызвать сбор мусора, используя gc_collect_cycles(), после выполнения последнего теста

  • Включить автоматический сбор мусора, используя gc_enable(), после выполнения последнего теста

Количество тестов, которые необходимо выполнить перед запуском сбора мусора, контролируется атрибутом numberOfTestsBeforeGarbageCollection (см. ниже).

Атрибут numberOfTestsBeforeGarbageCollection

Возможные значения: целое число (по умолчанию: 100)

Настраивает количество тестов, которые необходимо выполнить перед запуском сбора мусора (см. выше).

Атрибут requireCoverageMetadata

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, будет ли тест помечен как рискованный (см. Непреднамеренно покрытый код), если он не указывает код, который он намерен покрыть, используя атрибут.

Атрибут processIsolation

Возможные значения: true или false (по умолчанию: false)

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

Атрибут stopOnDefect

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, должно ли выполнение набора тестов прекращаться после первой ошибки, сбоя, предупреждения или рискованного теста.

Атрибут stopOnError

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, должно ли выполнение набора тестов прекращаться после первой ошибки.

Атрибут stopOnFailure

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, должно ли выполнение набора тестов прекращаться после первого сбоя.

Атрибут stopOnWarning

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, должно ли выполнение набора тестов прекращаться после первого предупреждения.

Атрибут stopOnRisky

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, должно ли выполнение набора тестов прекращаться после первого рискованного теста.

Атрибут stopOnDeprecation

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, должно ли выполнение набора тестов прекращаться после первого теста, который вызвал устаревшую функцию (E_DEPRECATED, E_USER_DEPRECATED или устаревшую функцию PHPUnit).

Атрибут stopOnNotice

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, должно ли выполнение набора тестов прекращаться после первого теста, который вызвал уведомление (E_STRICT, E_NOTICE или E_USER_NOTICE).

Атрибут stopOnSkipped

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, должно ли выполнение набора тестов прекращаться после первого пропущенного теста.

Атрибут stopOnIncomplete

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, должно ли выполнение набора тестов прекращаться после первого неполного теста.

Атрибут failOnEmptyTestSuite

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, должен ли исполняемый файл PHPUnit завершиться с кодом ошибки, указывающим на сбой, когда настроенный набор тестов пуст.

The failOnWarning Attribute

Возможные значения: true или false (по умолчанию: false)

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

The failOnRisky Attribute

Возможные значения: true или false (по умолчанию: false)

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

The failOnDeprecation Attribute

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, должен ли исполняемый файл PHPUnit завершаться с кодом выхода оболочки, указывающим на ошибку, когда все тесты пройдены успешно, но есть тесты, которые вызвали устаревание (E_DEPRECATED или E_USER_DEPRECATED).

The failOnPhpunitDeprecation Attribute

Возможные значения: true или false (по умолчанию: false)

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

The failOnNotice Attribute

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, должен ли исполняемый файл PHPUnit завершаться с кодом выхода оболочки, указывающим на ошибку, когда все тесты пройдены успешно, но есть тесты, которые вызвали уведомление (E_STRICT, E_NOTICE или E_USER_NOTICE).

The failOnSkipped Attribute

Возможные значения: true или false (по умолчанию: false)

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

The failOnIncomplete Attribute

Возможные значения: true или false (по умолчанию: false)

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

The beStrictAboutChangesToGlobalState Attribute

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, должен ли PHPUnit отмечать тест как рискованный, когда глобальное состояние изменяется кодом, который тестируется (или кодом теста).

The beStrictAboutOutputDuringTests Attribute

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, должен ли PHPUnit отмечать тест как рискованный, когда код, который тестируется (или код теста), выводит данные.

The beStrictAboutTestsThatDoNotTestAnything Attribute

Возможные значения: true или false (по умолчанию: true)

Этот атрибут настраивает, должен ли PHPUnit отмечать тест как рискованный, когда не выполняются никакие утверждения (ожидания также учитываются).

The beStrictAboutCoverageMetadata Attribute

Возможные значения: true или false (по умолчанию: false)

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

The enforceTimeLimit Attribute

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, должны ли применяться ограничения по времени.

The defaultTimeLimit Attribute

Возможные значения: целое число (по умолчанию: 0)

Этот атрибут настраивает значение ограничения по времени по умолчанию (в секундах).

The timeoutForSmallTests Attribute

Возможные значения: целое число (по умолчанию: 1)

Этот атрибут настраивает ограничение по времени для тестов с атрибутом Small (в секундах).

The timeoutForMediumTests Attribute

Возможные значения: целое число (по умолчанию: 10)

Этот атрибут настраивает ограничение по времени для тестов с атрибутом Medium (в секундах).

The timeoutForLargeTests Attribute

Возможные значения: целое число (по умолчанию: 60)

Этот атрибут настраивает ограничение по времени для тестов с атрибутом Large (в секундах).

The defaultTestSuite Attribute

Этот атрибут настраивает имя тестового набора по умолчанию.

The stderr Attribute

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, должен ли PHPUnit выводить свои данные в stderr вместо stdout.

The reverseDefectList Attribute

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, должны ли тесты, которые не завершились успешно, выводиться в обратном порядке.

The registerMockObjectsFromTestArgumentsRecursively Attribute

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, должны ли массивы и графы объектов, передаваемые из одного теста в другой с помощью атрибутов Depends*, рекурсивно сканироваться на предмет объектов-заглушек.

The extensionsDirectory Attribute

Когда используется phpunit.phar, этот атрибут можно использовать для настройки каталога, из которого будут загружаться все файлы *.phar в качестве расширений для исполняемого файла PHPUnit.

Атрибут executionOrder

Возможные значения: default, defects, depends, no-depends, duration, random, reverse, size (по умолчанию: default)

Можно использовать несколько значений. Их нужно разделять через ,.

Этот атрибут настраивает порядок выполнения тестов.

  • default: упорядочивание как PHPUnit нашел тесты

  • defects: упорядочивание по дефектам (ошибкам, провалу, предупреждению, неполноте, риску, пропусканию, неизвестно, успеху), требует включенного кеша результатов result cache

  • depends: упорядочивание по зависимостям (тесты без зависимостей вначале, зависимые — в конце)

  • depends,defects: упорядочивание по зависимостям сначала, потом по дефектам

  • depends,duration: упорядочивание по зависимостям сначала, потом по продолжительности

  • depends,random: упорядочивание по зависимостям сначала, потом случайным образом

  • depends,reverse: упорядочивание по зависимостям сначала, потом в обратном порядке

  • duration: упорядочивание по продолжительности (самый быстрый тест вначале, самый медленный — в конце), требует включенного кеша результатов result cache

  • no-depends: не упорядочивание по зависимостям

  • no-depends,defects: не упорядочивание по зависимостям, потом по дефектам

  • no-depends,duration: не упорядочивание по зависимостям, потом по продолжительности

  • no-depends,random: не упорядочивание по зависимостям, потом случайным образом

  • no-depends,reverse: не упорядочивание по зависимостям, потом в обратном порядке

  • no-depends,size: не упорядочивание по зависимостям, потом по размеру

  • random: упорядочивание случайным образом

  • reverse: упорядочивание как PHPUnit нашел тесты, затем в обратном порядке

  • size: упорядочивание по размеру (малый, средний, большой, неизвестно), также см. (см. Small, Medium и Large)

Атрибут resolveDependencies

Возможные значения: true или false (по умолчанию: true)

Этот атрибут настраивает, будут ли разрешаться зависимости между тестами (выраженные с помощью атрибутов Depends*).

Атрибут testdox

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, будет ли вывод печататься в формате TestDox.

Атрибут testdoxSummary

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, будет ли вывод TestDox для неудачных тестов повторяться после обычного вывода TestDox.

Атрибут displayDetailsOnIncompleteTests

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, будут ли выводиться подробности о неполных тестах.

Атрибут displayDetailsOnSkippedTests

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, будут ли выводиться подробности о пропущенных тестах.

Атрибут displayDetailsOnTestsThatTriggerDeprecations

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, будут ли выводиться подробности о тестах, которые вызвали предупреждения о устаревании.

Атрибут displayDetailsOnPhpunitDeprecations

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, будут ли выводиться подробности о предупреждениях PHPUnit о устаревании.

Атрибут displayDetailsOnTestsThatTriggerErrors

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, будут ли выводиться подробности о тестах, которые вызвали ошибки.

Атрибут displayDetailsOnTestsThatTriggerNotices

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, будут ли выводиться подробности о тестах, которые вызвали сообщения.

Атрибут displayDetailsOnTestsThatTriggerWarnings

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, будут ли выводиться подробности о тестах, которые вызвали предупреждения.

Атрибут shortenArraysForExportThreshold

Возможные значения: целое число (по умолчанию: 0)

Этот атрибут настраивает, будет ли экспорт массивов ограничен заданным количеством элементов.

Если установлено значение 0 (по умолчанию), тогда экспорт массивов не ограничен.

Элемент <testsuites>

Родительский элемент: <phpunit>

Этот элемент является корневым для одного или нескольких элементов <testsuite>, используемых для настройки выполняемых тестов.

Элемент <testsuite>

Родительский элемент: <testsuites>

Элемент <testsuite> должен иметь атрибут name и может содержать один или несколько дочерних элементов <directory> и/или <file>, которые настраивают каталоги и/или файлы, которые следует искать для тестов, соответственно.

<testsuites>
<testsuitename="unit">
<directory>tests/unit</directory>
</testsuite>

<testsuitename="integration">
<directory>tests/integration</directory>
</testsuite>

<testsuitename="edge-to-edge">
<directory>tests/edge-to-edge</directory>
</testsuite>
</testsuites>

Требуемую версию PHP можно указать с помощью атрибутов phpVersion и phpVersionOperator:

<testsuites>
<testsuitename="unit">
<directoryphpVersion="8.0.0"phpVersionOperator=">=">tests/unit</directory>
</testsuite>
</testsuites>

В приведённом примере тесты из каталога tests/unit добавляются в набор тестов только в случае, если версия PHP не ниже 8.0.0. Атрибут phpVersionOperator является необязательным и по умолчанию равен >=.

Тесты, найденные с помощью элементов <directory> и <file>, могут быть добавлены в список групп через запятую:

<testsuites>
<testsuitename="unit">
<directorygroups="foo,bar">tests/foo-bar</directory>
</testsuite>
</testsuites>
END_OF_DOCUMENT_MARKER

Элемент <source>

Родительский элемент: <phpunit>

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

В дальнейшем мы будем ссылаться на код, настроенный с помощью этого элемента, как на «ваш код» или «код первой стороны». Мы будем называть код, который не является «вашим кодом», «кодом третьей стороны».

Элемент <include>

Родительский элемент: <source>

Настраивает набор файлов, которые должны быть включены в список файлов исходного кода проекта.

<include>
<directorysuffix=".php">src</directory>
</include>

Приведенный выше пример инструктирует PHPUnit включить все файлы исходного кода с .php суффиксом в каталоге src и его подкаталогах.

Элемент <exclude>

Родительский элемент: <source>

Настраивает набор файлов, которые должны быть исключены из списка файлов исходного кода проекта.

<include>
<directorysuffix=".php">src</directory>
</include>

<exclude>
<directorysuffix=".php">src/generated</directory>
<file>src/autoload.php</file>
</exclude>

Приведенный выше пример инструктирует PHPUnit включить все файлы исходного кода с .php суффиксом в каталоге src и его подкаталогах, но исключить все файлы с .php суффиксом в каталоге src/generated и его подкаталогах, а также файл src/autoload.php.

Элемент <directory>

Родительские элементы: <include>, <exclude>

Настраивает каталог и его подкаталоги для включения или исключения из списка файлов исходного кода проекта.

Атрибут prefix

Возможные значения: строка

Настраивает фильтр на основе префикса, который применяется к именам файлов в каталоге и его подкаталогах.

Атрибут suffix

Возможные значения: строка (по умолчанию: '.php')

Настраивает фильтр на основе суффикса, который применяется к именам файлов в каталоге и его подкаталогах.

Элемент <file>

Родительские элементы: <include>, <exclude>

Настраивает файл для включения или исключения из списка файлов исходного кода проекта.

Элемент <deprecationTrigger>

Родительский элемент: <source>

Некоторые библиотеки используют оболочку вокруг функции PHP trigger_error(), например, symfony/deprecation-contracts или doctrine/deprecations. Использование такой оболочки добавляет дополнительную рамку стека, которую необходимо учитывать при отчете о месте, где было вызвано устаревание.

Элемент <deprecationTrigger> вместе со своими дочерними элементами <function> и <method> может использоваться для настройки функций или методов соответственно, как триггеров устаревания.

Элемент <function>

Родительский элемент: <deprecationTrigger>

<deprecationTrigger>
<function>trigger_deprecation</function>
</deprecationTrigger>

Приведенная выше конфигурация устанавливает глобальную функцию trigger_deprecation() в качестве триггера устаревания.

Элемент <method>

Родительский элемент: <deprecationTrigger>

<deprecationTrigger>
<method>DeprecationTrigger::triggerDeprecation</method>
</deprecationTrigger>

Приведенная выше конфигурация устанавливает метод public static triggerDeprecation() класса DeprecationTrigger в качестве триггера устаревания.

Атрибут <ignoreSelfDeprecations>

Возможные значения: true или false (по умолчанию: false)

Игнорировать устаревшие методы (E_DEPRECATED и E_USER_DEPRECATED), вызванные кодом первой стороны в коде первой стороны.

Атрибут <ignoreDirectDeprecations>

Возможные значения: true или false (по умолчанию: false)

Игнорировать устаревшие методы (E_DEPRECATED и E_USER_DEPRECATED), вызванные кодом первой стороны в коде третьей стороны.

Атрибут <ignoreIndirectDeprecations>

Возможные значения: true или false (по умолчанию: false, рекомендуется: true)

Игнорировать устаревшие методы (E_DEPRECATED и E_USER_DEPRECATED), вызванные кодом третьей стороны.

Атрибут <restrictDeprecations>

Возможные значения: true или false (по умолчанию: false)

Ограничивает отчеты об ошибках E_DEPRECATED и E_USER_DEPRECATED ошибках списком файлов исходного кода проекта.

Устаревание: restrictDeprecations устарел

Начиная с PHPUnit 11.1, атрибут restrictDeprecations устарел. Он будет удален в PHPUnit 12.

Вместо этого используйте атрибуты ignoreSelfDeprecations, ignoreDirectDeprecations и ignoreIndirectDeprecations.

Атрибут <restrictNotices>

Возможные значения: true или false (по умолчанию: false)

Ограничивает отчеты об ошибках E_STRICT, E_NOTICE и E_USER_NOTICE ошибках списком файлов исходного кода проекта.

Атрибут <restrictWarnings>

Возможные значения: true или false (по умолчанию: false)

Ограничивает отчеты об ошибках E_WARNING и E_USER_WARNING ошибках списком файлов исходного кода проекта.

Атрибут <baseline>

Возможные значения: строка

Файл эталона, который будет использоваться при запуске набора тестов.

Атрибут <ignoreSuppressionOfDeprecations>

Возможные значения: true или false (по умолчанию: false)

Игнорировать подавление (с помощью оператора @) ошибок E_USER_DEPRECATED ошибок.

Атрибут <ignoreSuppressionOfPhpDeprecations>

Возможные значения: true или false (по умолчанию: false)

Игнорировать подавление (с помощью оператора @) ошибок E_DEPRECATED ошибок.

Атрибут <ignoreSuppressionOfErrors>

Возможные значения: true или false (по умолчанию: false)

Игнорировать подавление (с помощью оператора @) ошибок E_USER_ERROR ошибок.

Атрибут <ignoreSuppressionOfNotices>

Возможные значения: true или false (по умолчанию: false)

Игнорировать подавление (с помощью оператора @) ошибок E_USER_NOTICE ошибок.

END_OF_DOCUMENT_MARKER

The <ignoreSuppressionOfPhpNotices> Атрибут

Возможные значения: true или false (по умолчанию: false)

Игнорировать подавление (используя оператор @) ошибок E_STRICT и E_NOTICE ошибок.

The <ignoreSuppressionOfWarnings> Атрибут

Возможные значения: true или false (по умолчанию: false)

Игнорировать подавление (используя оператор @) ошибок E_USER_WARNING ошибок.

The <ignoreSuppressionOfPhpWarnings> Атрибут

Возможные значения: true или false (по умолчанию: false)

Игнорировать подавление (используя оператор @) ошибок E_WARNING ошибок.

Элемент <coverage>

Родительский элемент: <phpunit>

Элемент <coverage> и его дочерние элементы могут использоваться для настройки покрытия кода:

<coverageincludeUncoveredFiles="true"
pathCoverage="false"
ignoreDeprecatedCodeUnits="true"
disableCodeCoverageIgnore="true">
<!-- ... -->
</coverage>

Атрибут includeUncoveredFiles

Возможные значения: true или false (по умолчанию: true)

При установке значения true, все файлы исходного кода, настроенные для анализа покрытия кода, будут включены в отчет(ы) о покрытии кода. Это включает файлы исходного кода, которые не выполняются во время выполнения тестов.

Атрибут ignoreDeprecatedCodeUnits

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, будут ли игнорироваться блоки кода, помеченные как @deprecated, при анализе покрытия кода.

Атрибут pathCoverage

Возможные значения: true или false (по умолчанию: false)

При установке значения false, будут собираться, обрабатываться и отображаться только данные о покрытии строк.

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

Атрибут disableCodeCoverageIgnore

Возможные значения: true или false (по умолчанию: false)

Этот атрибут настраивает, будут ли игнорироваться метаданные для игнорирования кода.

Элемент <report>

Родительский элемент: <coverage>

Настраивает генерируемые отчеты о покрытии кода.

<report>
<cloveroutputFile="clover.xml"/>
<coberturaoutputFile="cobertura.xml"/>
<crap4joutputFile="crap4j.xml"threshold="50"/>
<htmloutputDirectory="html-coverage"lowUpperBound="50"highLowerBound="90"/>
<phpoutputFile="coverage.php"/>
<textoutputFile="coverage.txt"showUncoveredFiles="false"showOnlySummary="true"/>
<xmloutputDirectory="xml-coverage"/>
</report>

Элемент <clover>

Родительский элемент: <report>

Настраивает отчет о покрытии кода в формате Clover XML.

Атрибут outputFile

Возможные значения: строка

Файл, в который записывается отчет Clover XML.

Элемент <cobertura>

Родительский элемент: <report>

Настраивает отчет о покрытии кода в формате Cobertura XML.

Атрибут outputFile

Возможные значения: строка

Файл, в который записывается отчет Cobertura XML.

Элемент <crap4j>

Родительский элемент: <report>

Настраивает отчет о покрытии кода в формате Crap4J XML.

Атрибут outputFile

Возможные значения: строка

Файл, в который записывается отчет Crap4J XML.

Атрибут threshold

Возможные значения: целое число (по умолчанию: 50)

Элемент <html>

Родительский элемент: <report>

Настраивает отчет о покрытии кода в формате HTML.

Атрибут outputDirectory

Директория, в которую записывается HTML-отчет.

Атрибут lowUpperBound

Возможные значения: целое число (по умолчанию: 50)

Верхняя граница того, что считается низким покрытием.

Атрибут highLowerBound

Возможные значения: целое число (по умолчанию: 90)

Нижняя граница того, что считается высоким покрытием.

Атрибут colorSuccessHigh

Возможные значения: строка (по умолчанию: #99cb84)

Цвет, используемый для обозначения того, что строка кода покрыта малыми (и большими) тестами, например.

Атрибут colorSuccessMedium

Возможные значения: строка (по умолчанию: #c3e3b5)

Цвет, используемый для обозначения того, что строка кода покрыта средними (и большими) тестами, например.

Атрибут colorSuccessLow

Возможные значения: строка (по умолчанию: #dff0d8)

Цвет, используемый для обозначения того, что строка кода покрыта большими тестами, например.

Атрибут colorWarning

Возможные значения: строка (по умолчанию: #fcf8e3)

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

Атрибут colorDanger

Возможные значения: строка (по умолчанию: #f2dede)

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

Атрибут customCssFile

Возможные значения: строка

Путь к пользовательскому файлу CSS.

Элемент <php>

Родительский элемент: <report>

Настраивает отчет о покрытии кода в формате PHP.

Атрибут outputFile

Возможные значения: строка

Файл, в который записывается отчет PHP.

Элемент <text>

Родительский элемент: <report>

Настраивает отчет о покрытии кода в текстовом формате.

Атрибут outputFile

Возможные значения: строка

Файл, в который записывается текстовый отчет.

Атрибут showUncoveredFiles

Возможные значения: true или false (по умолчанию: false)

Атрибут showOnlySummary

Возможные значения: true или false (по умолчанию: false)

Элемент <xml>

Родительский элемент: <report>

Настраивает отчет о покрытии кода в формате PHPUnit XML.

Атрибут outputDirectory

Возможные значения: строка

Директория, в которую записывается отчет PHPUnit XML.

Элемент <logging>

Родительский элемент: <phpunit>

Элемент <logging> и его потомки могут быть использованы для настройки ведения журнала выполнения теста.

<logging>
<junitoutputFile="junit.xml"/>
<teamcityoutputFile="teamcity.txt"/>
<testdoxHtmloutputFile="testdox.html"/>
<testdoxTextoutputFile="testdox.txt"/>
</logging>

Элемент <junit>

Родительский элемент: <logging>

Настраивает файл журнала результатов теста в формате JUnit XML.

Атрибут outputFile

Возможные значения: строка

Файл, в который записывается файл журнала результатов теста в формате JUnit XML.

Элемент <teamcity>

Родительский элемент: <logging>

Настраивает файл журнала результатов теста в формате TeamCity.

Атрибут outputFile

Возможные значения: строка

Файл, в который записывается файл журнала результатов теста в формате TeamCity.

Элемент <testdoxHtml>

Родительский элемент: <logging>

Настраивает файл журнала результатов теста в формате TestDox HTML.

Атрибут outputFile

Возможные значения: строка

Файл, в который записывается файл журнала результатов теста в формате TestDox HTML.

Элемент <testdoxText>

Родительский элемент: <logging>

Настраивает файл журнала результатов теста в текстовом формате TestDox.

Атрибут outputFile

Возможные значения: строка

Файл, в который записывается файл журнала результатов теста в текстовом формате TestDox.

Элемент <groups>

Родительский элемент: <phpunit>

Элемент <groups> и его потомки <include>, <exclude> и <group> могут использоваться для выбора групп тестов, помеченных атрибутом Group (документировано в Группе), которые должны (или не должны) быть запущены:

<groups>
<include>
<group>name</group>
</include>
<exclude>
<group>name</group>
</exclude>
</groups>

Приведенный выше пример эквивалентен вызову исполнителя тестов PHPUnit с --group name --exclude-group name.

Элемент <extensions>

Родительский элемент: <phpunit>

Элемент <extensions> и его потомки <bootstrap> могут быть использованы для регистрации расширений исполнителя тестов.

Элемент <bootstrap>

Родительский элемент: <extensions>

<extensions>
<bootstrapclass="Vendor\ExampleExtensionForPhpunit\Extension"/>
</extensions>

Элемент <parameter>

Родительский элемент: <bootstrap>

Элемент <parameter> может быть использован для настройки параметров, которые передаются расширению для инициализации.

<extensions>
<bootstrapclass="Vendor\ExampleExtensionForPhpunit\Extension">
<parametername="message"value="the-message"/>
</bootstrap>
</extensions>

Элемент <php>

Родительский элемент: <phpunit>

Элемент <php> и его потомки могут быть использованы для настройки параметров PHP, констант и глобальных переменных. Он также может быть использован для добавления include_path в начало.

Элемент <includePath>

Родительский элемент: <php>

Этот элемент может быть использован для добавления пути в начало include_path.

Элемент <ini>

Родительский элемент: <php>

Этот элемент может быть использован для установки параметра конфигурации PHP.

<php>
<ininame="foo"value="bar"/>
</php>

Вышеприведенная XML-конфигурация соответствует следующему коду PHP:

ini_set('foo', 'bar');

Элемент <const>

Родительский элемент: <php>

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

<php>
<constname="foo"value="bar"/>
</php>

Вышеприведенная XML-конфигурация соответствует следующему коду PHP:

define('foo', 'bar');

Элемент <var>

Родительский элемент: <php>

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

<php>
<varname="foo"value="bar"/>
</php>

Вышеприведенная XML-конфигурация соответствует следующему коду PHP:

$GLOBALS['foo'] = 'bar';

Элемент <env>

Родительский элемент: <php>

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

<php>
<envname="foo"value="bar"/>
</php>

Вышеприведенная XML-конфигурация соответствует следующему коду PHP:

$_ENV['foo'] = 'bar';

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

<php>
<envname="foo"value="bar"force="true"/>
</php>

Элемент <get>

Родительский элемент: <php>

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

<php>
<getname="foo"value="bar"/>
</php>

Вышеприведенная XML-конфигурация соответствует следующему коду PHP:

$_GET['foo'] = 'bar';

Элемент <post>

Родительский элемент: <php>

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

<php>
<postname="foo"value="bar"/>
</php>

Вышеприведенная XML-конфигурация соответствует следующему коду PHP:

$_POST['foo'] = 'bar';

Элемент <cookie>

Родительский элемент: <php>

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

<php>
<cookiename="foo"value="bar"/>
</php>

Вышеприведенная XML-конфигурация соответствует следующему коду PHP:

$_COOKIE['foo'] = 'bar';

Элемент <server>

Родительский элемент: <php>

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

<php>
<servername="foo"value="bar"/>
</php>

Вышеприведенная XML-конфигурация соответствует следующему коду PHP:

$_SERVER['foo'] = 'bar';

Элемент <files>

Родительский элемент: <php>

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

<php>
<filesname="foo"value="bar"/>
</php>

Вышеприведенная XML-конфигурация соответствует следующему коду PHP:

$_FILES['foo'] = 'bar';

Элемент <request>

Родительский элемент: <php>

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

<php>
<requestname="foo"value="bar"/>
</php>

Вышеприведенная XML-конфигурация соответствует следующему коду PHP:

$_REQUEST['foo'] = 'bar';

© 2005–2025 Sebastian Bergmann
Licensed under the Creative Commons Attribution 3.0 Unported License.
https://docs.phpunit.de/en/12.0/configuration.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API