NAME¶

PHPUnit - PHPUnit command line interface

SYNOPSIS¶

phpunit [ options] UnitTest [UnitTest.php]

DESCRIPTION¶

PHPUnit 4.2.6 by Sebastian Bergmann.

phpunit [options] <directory>

Code Coverage Options:

--coverage-clover <file>

Generate code coverage report in Clover XML format.

--coverage-crap4j <file>

Generate code coverage report in Crap4J XML format.

--coverage-html <dir>

Generate code coverage report in HTML format.

--coverage-php <file>

Export PHP_CodeCoverage object to file.

--coverage-text=<file>

Generate code coverage report in text format. Default: Standard output.

--coverage-xml <dir>

Generate code coverage report in PHPUnit XML format.

Logging Options:

--log-junit <file>

Log test execution in JUnit XML format to file.

--log-tap <file>

Log test execution in TAP format to file.

--log-json <file>

Log test execution in JSON format.

--testdox-html <file>

Write agile documentation in HTML format to file.

--testdox-text <file>

Write agile documentation in Text format to file.

Test Selection Options:

--filter <pattern>

Filter which tests to run.

--testsuite <pattern>

Filter which testsuite to run.

--group ...

Only runs tests from the specified group(s).

--exclude-group ...

Exclude tests from the specified group(s).

--list-groups

List available test groups.

--test-suffix ...

Only search for test in files with specified suffix(es). Default: Test.php,.phpt

Test Execution Options:

--report-useless-tests

Be strict about tests that do not test anything.

--strict-coverage

Be strict about unintentionally covered code.

--disallow-test-output

Be strict about output during tests.

--enforce-time-limit

Enforce time limit based on test size.

--disallow-todo-tests

Disallow @todo-annotated tests.

--strict

Run tests in strict mode (enables all of the above).

--process-isolation

Run each test in a separate PHP process.

--no-globals-backup

Do not backup and restore $GLOBALS for each test.

--static-backup

Backup and restore static attributes for each test.

--colors

Use colors in output.

--stderr

Write to STDERR instead of STDOUT.

--stop-on-error

Stop execution upon first error.

--stop-on-failure

Stop execution upon first error or failure.

--stop-on-risky

Stop execution upon first risky test.

--stop-on-skipped

Stop execution upon first skipped test.

--stop-on-incomplete

Stop execution upon first incomplete test.

-v|--verbose

Output more verbose information.

--debug

Display debugging information during test execution.

--loader <loader>

TestSuiteLoader implementation to use.

--repeat <times>

Runs the test(s) repeatedly.

--tap

Report test execution progress in TAP format.

--testdox

Report test execution progress in TestDox format.

--printer <printer>

TestListener implementation to use.

Configuration Options:

--bootstrap <file>

A "bootstrap" PHP file that is run before the tests.

--no-configuration

Ignore default configuration file (phpunit.xml).

--include-path <path(s)>

Prepend PHP's include_path with given path(s).

-d key[=value]

Sets a php.ini value.

Miscellaneous Options:

-h|--help

Prints this usage information.

--version

Prints the version and exits.