.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.4.
.TH PHPUNIT "1" "June 2017" "phpunit 5.4.6" "User Commands"
.SH NAME
phpunit \- PHPUnit command line interface
.SH SYNOPSIS
.B phpunit
[\fI\,options\/\fR] \fI\,UnitTest \/\fR[\fI\,UnitTest.php\/\fR]
.br
.B phpunit
[\fI\,options\/\fR] \fI\,<directory>\/\fR
.SH DESCRIPTION
Code Coverage Options:
.TP
\fB\-\-coverage\-clover\fR <file>
Generate code coverage report in Clover XML format.
.TP
\fB\-\-coverage\-crap4j\fR <file>
Generate code coverage report in Crap4J XML format.
.TP
\fB\-\-coverage\-html\fR <dir>
Generate code coverage report in HTML format.
.TP
\fB\-\-coverage\-php\fR <file>
Export PHP_CodeCoverage object to file.
.TP
\fB\-\-coverage\-text=\fR<file>
Generate code coverage report in text format.
Default: Standard output.
.TP
\fB\-\-coverage\-xml\fR <dir>
Generate code coverage report in PHPUnit XML format.
.TP
\fB\-\-whitelist\fR <dir>
Whitelist <dir> for code coverage analysis.
.HP
\fB\-\-disable\-coverage\-ignore\fR Disable annotations for ignoring code coverage.
.PP
Logging Options:
.TP
\fB\-\-log\-junit\fR <file>
Log test execution in JUnit XML format to file.
.TP
\fB\-\-log\-tap\fR <file>
Log test execution in TAP format to file.
.TP
\fB\-\-log\-teamcity\fR <file>
Log test execution in TeamCity format to file.
.TP
\fB\-\-log\-json\fR <file>
Log test execution in JSON format.
.TP
\fB\-\-testdox\-html\fR <file>
Write agile documentation in HTML format to file.
.TP
\fB\-\-testdox\-text\fR <file>
Write agile documentation in Text format to file.
.TP
\fB\-\-testdox\-xml\fR <file>
Write agile documentation in XML format to file.
.TP
\fB\-\-reverse\-list\fR
Print defects in reverse order
.PP
Test Selection Options:
.TP
\fB\-\-filter\fR <pattern>
Filter which tests to run.
.TP
\fB\-\-testsuite\fR <pattern>
Filter which testsuite to run.
.TP
\fB\-\-group\fR ...
Only runs tests from the specified group(s).
.TP
\fB\-\-exclude\-group\fR ...
Exclude tests from the specified group(s).
.TP
\fB\-\-list\-groups\fR
List available test groups.
.TP
\fB\-\-test\-suffix\fR ...
Only search for test in files with specified
suffix(es). Default: Test.php,.phpt
.PP
Test Execution Options:
.TP
\fB\-\-report\-useless\-tests\fR
Be strict about tests that do not test anything.
.TP
\fB\-\-strict\-coverage\fR
Be strict about @covers annotation usage.
.TP
\fB\-\-strict\-global\-state\fR
Be strict about changes to global state
.TP
\fB\-\-disallow\-test\-output\fR
Be strict about output during tests.
.HP
\fB\-\-disallow\-resource\-usage\fR Be strict about resource usage during small tests.
.TP
\fB\-\-enforce\-time\-limit\fR
Enforce time limit based on test size.
.TP
\fB\-\-disallow\-todo\-tests\fR
Disallow @todo\-annotated tests.
.TP
\fB\-\-process\-isolation\fR
Run each test in a separate PHP process.
.TP
\fB\-\-no\-globals\-backup\fR
Do not backup and restore $GLOBALS for each test.
.TP
\fB\-\-static\-backup\fR
Backup and restore static attributes for each test.
.TP
\fB\-\-colors=\fR<flag>
Use colors in output ("never", "auto" or "always").
.TP
\fB\-\-columns\fR <n>
Number of columns to use for progress output.
.TP
\fB\-\-columns\fR max
Use maximum number of columns for progress output.
.TP
\fB\-\-stderr\fR
Write to STDERR instead of STDOUT.
.TP
\fB\-\-stop\-on\-error\fR
Stop execution upon first error.
.TP
\fB\-\-stop\-on\-failure\fR
Stop execution upon first error or failure.
.TP
\fB\-\-stop\-on\-warning\fR
Stop execution upon first warning.
.TP
\fB\-\-stop\-on\-risky\fR
Stop execution upon first risky test.
.TP
\fB\-\-stop\-on\-skipped\fR
Stop execution upon first skipped test.
.TP
\fB\-\-stop\-on\-incomplete\fR
Stop execution upon first incomplete test.
.TP
\fB\-\-fail\-on\-warning\fR
Treat tests with warnings as failures.
.TP
\fB\-\-fail\-on\-risky\fR
Treat risky tests as failures.
.TP
\fB\-v\fR|\-\-verbose
Output more verbose information.
.TP
\fB\-\-debug\fR
Display debugging information during test execution.
.TP
\fB\-\-loader\fR <loader>
TestSuiteLoader implementation to use.
.TP
\fB\-\-repeat\fR <times>
Runs the test(s) repeatedly.
.TP
\fB\-\-tap\fR
Report test execution progress in TAP format.
.TP
\fB\-\-teamcity\fR
Report test execution progress in TeamCity format.
.TP
\fB\-\-testdox\fR
Report test execution progress in TestDox format.
.TP
\fB\-\-testdox\-group\fR
Only include tests from the specified group(s).
.TP
\fB\-\-testdox\-exclude\-group\fR
Exclude tests from the specified group(s).
.TP
\fB\-\-printer\fR <printer>
TestListener implementation to use.
.PP
Configuration Options:
.TP
\fB\-\-bootstrap\fR <file>
A "bootstrap" PHP file that is run before the tests.
.HP
\fB\-c\fR|\-\-configuration <file> Read configuration from XML file.
.TP
\fB\-\-no\-configuration\fR
Ignore default configuration file (phpunit.xml).
.TP
\fB\-\-no\-coverage\fR
Ignore code coverage configuration.
.TP
\fB\-\-include\-path\fR <path(s)>
Prepend PHP's include_path with given path(s).
.TP
\fB\-d\fR key[=value]
Sets a php.ini value.
.TP
\fB\-\-generate\-configuration\fR
Generate configuration file with suggested settings.
.PP
Miscellaneous Options:
.TP
\fB\-h\fR|\-\-help
Prints this usage information.
.TP
\fB\-\-version\fR
Prints the version and exits.
.TP
\fB\-\-atleast\-version\fR <min>
Checks that version is greater than min and exits.