Spec-Zone.ru › PHPUnit

Конфигурация

PHPUnit формирует эффективную конфигурацию для запуска набора тестов, объединяя три слоя:

  1. Встроенные значения по умолчанию, поставляемые вместе с PHPUnit.

  2. Конфигурация XML, загружаемая из phpunit.xml (или файла, переданного в --configuration) и применяемая поверх значений по умолчанию.

  3. Параметры CLI, переданные в командной строке и применяемые поверх конфигурации XML.

Каждый слой переопределяет предыдущий для тех настроек, которых он касается. Настройки, не указанные в слое, наследуются от нижележащего слоя. Например, beStrictAboutCoverageMetadata по умолчанию имеет значение false; установка beStrictAboutCoverageMetadata="true" в phpunit.xml включает его для всех запусков; передача --strict-coverage включает его для одного запуска, даже если XML-файл не включает эту настройку.

В таблицах этого приложения сопоставляются параметры CLI (см. Параметры CLI) и атрибуты и элементы конфигурации XML (см. Файл конфигурации XML), участвующие в этой модели переопределения, а также их встроенные значения по умолчанию. Параметры, не участвующие в этой модели (только CLI или только XML), перечислены в конце.

Конфигурация

Параметр CLI

Настройка XML

По умолчанию

--bootstrap <file>

атрибут bootstrap элемента <phpunit>

—

--cache-directory <dir>

атрибут cacheDirectory элемента <phpunit>

—

--cache-result / --do-not-cache-result

атрибут cacheResult элемента <phpunit>

true

--extension <class>

<bootstrap> в <extensions>

(добавочное)

--include-path <path>

<includePath> в <php>

(добавочное)

-d <key[=value]>

<ini> в <php>

(добавочное)

--use-baseline <file>

атрибут baseline элемента <source>

—

Выбор

Параметр CLI

Настройка XML

По умолчанию

--testsuite <name>

атрибут defaultTestSuite элемента <phpunit>

—

--group <name>

<group> в <groups><include>

—

--exclude-group <name>

<group> в <groups><exclude>

—

Выполнение

Параметр CLI

Настройка XML

По умолчанию

--process-isolation

атрибут processIsolation элемента <phpunit>

false

--globals-backup

атрибут backupGlobals элемента <phpunit>

false

--static-backup

атрибут backupStaticProperties элемента <phpunit>

false

--strict-coverage

атрибут beStrictAboutCoverageMetadata элемента <phpunit>

false

--require-coverage-contribution

атрибут requireCoverageContribution элемента <phpunit>

false

--strict-global-state

атрибут beStrictAboutChangesToGlobalState элемента <phpunit>

false

--disallow-test-output

атрибут beStrictAboutOutputDuringTests элемента <phpunit>

false

--do-not-report-useless-tests

атрибут beStrictAboutTestsThatDoNotTestAnything элемента <phpunit> (инвертированное значение)

true

--enforce-time-limit

атрибут enforceTimeLimit элемента <phpunit>

false

--default-time-limit <sec>

атрибут defaultTimeLimit элемента <phpunit>

0

--order-by <order>

атрибут executionOrder элемента <phpunit>

default

--random-order

executionOrder = "random"

default

--reverse-order

executionOrder = "reverse"

default

--resolve-dependencies / --ignore-dependencies

атрибут resolveDependencies элемента <phpunit>

true

Остановка при возникновении проблем

Параметр CLI

Настройка XML

По умолчанию

--stop-on-defect

атрибут stopOnDefect элемента <phpunit>

false

--stop-on-error

атрибут stopOnError элемента <phpunit>

false

--stop-on-failure

атрибут stopOnFailure элемента <phpunit>

false

--stop-on-warning

атрибут stopOnWarning элемента <phpunit>

false

--stop-on-risky

атрибут stopOnRisky элемента <phpunit>

false

--stop-on-deprecation

атрибут stopOnDeprecation элемента <phpunit>

false

--stop-on-notice

атрибут stopOnNotice элемента <phpunit>

false

--stop-on-skipped

атрибут stopOnSkipped элемента <phpunit>

false

--stop-on-incomplete

атрибут stopOnIncomplete элемента <phpunit>

false

Завершение с ошибкой при возникновении проблем

Параметр CLI

Настройка XML

По умолчанию

--fail-on-all-issues

failOnAllIssues атрибут элемента <phpunit>

false

--fail-on-empty-test-suite / --do-not-fail-on-empty-test-suite

failOnEmptyTestSuite атрибут элемента <phpunit>

false

--fail-on-warning / --do-not-fail-on-warning

failOnWarning атрибут элемента <phpunit>

false

--fail-on-risky / --do-not-fail-on-risky

failOnRisky атрибут элемента <phpunit>

false

--fail-on-deprecation / --do-not-fail-on-deprecation

failOnDeprecation атрибут элемента <phpunit>

false

--fail-on-phpunit-deprecation / --do-not-fail-on-phpunit-deprecation

failOnPhpunitDeprecation атрибут элемента <phpunit>

false

--fail-on-phpunit-notice / --do-not-fail-on-phpunit-notice

failOnPhpunitNotice атрибут элемента <phpunit>

false

--fail-on-phpunit-warning / --do-not-fail-on-phpunit-warning

failOnPhpunitWarning атрибут элемента <phpunit>

true

--fail-on-notice / --do-not-fail-on-notice

failOnNotice атрибут элемента <phpunit>

false

--fail-on-skipped / --do-not-fail-on-skipped

failOnSkipped атрибут элемента <phpunit>

false

--fail-on-incomplete / --do-not-fail-on-incomplete

failOnIncomplete атрибут элемента <phpunit>

false

Отчётность

Параметр CLI

Настройка XML

По умолчанию

--colors=<flag>

colors атрибут элемента <phpunit>

false

--columns <n>

columns атрибут элемента <phpunit>

80

--diff-context <n>

diffContext атрибут элемента <phpunit>

3

--stderr

stderr атрибут элемента <phpunit>

false

--reverse-list

reverseDefectList атрибут элемента <phpunit>

false

--testdox

testdox атрибут элемента <phpunit>

false

--testdox-summary

testdoxSummary атрибут элемента <phpunit>

false

--display-all-issues

displayDetailsOnAllIssues атрибут элемента <phpunit>

false

--display-incomplete

displayDetailsOnIncompleteTests атрибут элемента <phpunit>

false

--display-skipped

displayDetailsOnSkippedTests атрибут элемента <phpunit>

false

--display-deprecations

displayDetailsOnTestsThatTriggerDeprecations атрибут элемента <phpunit>

false

--display-phpunit-deprecations

displayDetailsOnPhpunitDeprecations атрибут элемента <phpunit>

false

--display-phpunit-notices

displayDetailsOnPhpunitNotices атрибут элемента <phpunit>

false

--display-errors

displayDetailsOnTestsThatTriggerErrors атрибут элемента <phpunit>

false

--display-notices

displayDetailsOnTestsThatTriggerNotices атрибут элемента <phpunit>

false

--display-warnings

displayDetailsOnTestsThatTriggerWarnings атрибут элемента <phpunit>

false

Журналирование

Параметр CLI

Настройка XML

По умолчанию

--log-junit <file>

<junit outputFile> внутри <logging>

—

--log-otr <file>

<otr outputFile> внутри <logging>

—

--include-git-information

includeGitInformation атрибут элемента <logging><otr>

false

--log-teamcity <file>

<teamcity outputFile> внутри <logging>

—

--testdox-html <file>

<testdoxHtml outputFile> внутри <logging>

—

--testdox-text <file>

<testdoxText outputFile> внутри <logging>

—

Покрытие кода

Параметр CLI

Параметр XML

По умолчанию

--path-coverage

атрибут pathCoverage у <coverage>

false

--disable-coverage-ignore

атрибут disableCodeCoverageIgnore у <coverage>

false

--coverage-clover <file>

<clover outputFile> в <coverage><report>

—

--coverage-openclover <file>

<openclover outputFile> в <coverage><report>

—

--coverage-cobertura <file>

<cobertura outputFile> в <coverage><report>

—

--coverage-crap4j <file>

<crap4j outputFile> в <coverage><report>

—

--coverage-html <dir>

<html outputDirectory> в <coverage><report>

—

--coverage-php <file>

<php outputFile> в <coverage><report>

—

--coverage-text[=<file>]

<text outputFile> в <coverage><report>

—

--only-summary-for-coverage-text

атрибут showOnlySummary у <coverage><report><text>

false

--show-uncovered-for-coverage-text

атрибут showUncoveredFiles у <coverage><report><text>

false

--coverage-xml <dir>

<xml outputDirectory> в <coverage><report>

—

--exclude-source-from-xml-coverage

атрибут includeSource у <coverage><report><xml> (инвертировано)

true

Параметры только для CLI

Следующие параметры CLI не имеют соответствующего параметра XML. Они управляют текущим запуском тестового исполнителя, выполняют разовые операции или подавляют части конфигурации XML.

Выбор конфигурации и разовые операции:

  • -c, --configuration <file>

  • --no-configuration

  • --no-extensions

  • --no-coverage

  • --no-logging

  • --generate-configuration

  • --migrate-configuration

  • --generate-baseline <file>

  • --ignore-baseline

  • --warm-coverage-cache

Выбор и фильтрация тестов:

  • --all

  • --testsuite <name> (также переопределяет атрибут XML defaultTestSuite; см. выше)

  • --exclude-testsuite <name>

  • --filter <pattern>

  • --exclude-filter <pattern>

  • --covers <name>

  • --uses <name>

  • --requires-php-extension <name>

  • --test-suffix <suffix>

Интроспекция:

  • --list-suites

  • --list-groups

  • --list-tests

  • --list-test-files

  • --list-tests-xml <file>

Альтернативный вывод и потоковая передача событий:

  • --debug

  • --with-telemetry

  • --teamcity

  • --log-events-text <file>

  • --log-events-verbose-text <file>

  • --no-output

  • --no-progress

  • --no-results

Покрытие кода:

  • --coverage-filter <dir>

Разное:

  • --random-order-seed <N>

  • -h, --help

  • --version

  • --atleast-version <min>

  • --check-version

  • --check-php-configuration

Параметры только для XML

Следующие параметры конфигурации XML не имеют соответствующих параметров CLI и могут быть изменены только путём редактирования файла конфигурации.

У элемента <phpunit>:

  • controlGarbageCollector (по умолчанию: false)

  • numberOfTestsBeforeGarbageCollection (по умолчанию: 100)

  • requireCoverageMetadata (по умолчанию: false)

  • timeoutForSmallTests (по умолчанию: 1)

  • timeoutForMediumTests (по умолчанию: 10)

  • timeoutForLargeTests (по умолчанию: 60)

  • extensionsDirectory

  • shortenArraysForExportThreshold

Определение набора тестов:

  • Элемент <testsuites> и его дочерние элементы

Конфигурация исходного кода:

  • Элемент <source> и все его атрибуты и дочерние элементы

Покрытие кода:

  • атрибут includeUncoveredFiles у <coverage> (по умолчанию: true)

  • атрибут ignoreDeprecatedCodeUnits у <coverage> (по умолчанию: false)

  • атрибуты цвета и границ <html> (lowUpperBound, highLowerBound, colorSuccessLow, colorSuccessMedium, colorSuccessHigh, colorSuccessBar, colorWarning, colorWarningBar, colorDanger, colorDangerBar, colorBreadcrumbs, их варианты *Dark и customCssFile)

  • атрибут threshold у <coverage><report><crap4j> (по умолчанию: 50)

Окружение PHP:

  • <const> в <php>

  • <var> в <php>

  • <env> в <php>

  • <get> в <php>

  • <post> в <php>

  • <cookie> в <php>

  • <server> в <php>

  • <files> в <php>

  • <request> в <php>

Расширения:

  • Элементы <parameter> в <extensions><bootstrap>

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

Spec-Zone.ru

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