PHPUnit Testing Framework

You can install PHPUnit by downloading a PHP Archive (PHAR) file. This file bundles all required dependencies into a single file. Replace X.Y in the commands below with the specific version of PHPUnit you wish to install.

$ wget https://phar.phpunit.de/phpunit-X.Y.phar

$ php phpunit-X.Y.phar --version

PHPUnit supports using baselines to manage existing issues (like deprecations or coverage gaps) so they don't cause new test runs to fail.

• Generate a baseline: Use generateBaseline to create a baseline file.
• Use a baseline: Use useBaseline to specify a file to use as a baseline.
• Ignore baseline: Use ignoreBaseline to bypass the baseline during execution.

The PHPUnit\TextUI\CliArguments\Configuration class is an immutable object that represents the settings passed to PHPUnit via the Command Line Interface (CLI). It encapsulates all configuration options, including test selection, coverage settings, failure behaviors, and output formatting.

When using this class programmatically, most properties are accessed via getter methods that follow a pattern: a has{PropertyName}() method to check if the option was provided, followed by a {propertyName}() method to retrieve the value. If the value is not present, the getter will throw an Exception.

The following executionOrder attribute values in your XML configuration are hard-deprecated as of version 13.2.0:

To safely retrieve a configuration value from a Configuration instance, first check for its existence using the corresponding has* method to avoid an Exception.

Example pattern:

if ($configuration->hasBootstrap()) {
    $bootstrap = $configuration->bootstrap();
}

When extending PHPUnit, the following methods in TextUI\Configuration\Configuration are hard-deprecated as of version 13.3.0:

As of version 13.0.2, using with*() methods without an accompanying expects() call is hard-deprecated. To fix this, either:

1. Configure an expected invocation count using expects().
2. Use a test stub without the with*() call.