Файл конфигурации 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 cachedepends: упорядочивание по зависимостям (тесты без зависимостей вначале, зависимые — в конце)depends,defects: упорядочивание по зависимостям сначала, потом по дефектамdepends,duration: упорядочивание по зависимостям сначала, потом по продолжительностиdepends,random: упорядочивание по зависимостям сначала, потом случайным образомdepends,reverse: упорядочивание по зависимостям сначала, потом в обратном порядкеduration: упорядочивание по продолжительности (самый быстрый тест вначале, самый медленный — в конце), требует включенного кеша результатов result cacheno-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>
Элемент <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 ошибок.
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';
Элемент <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