NewYour coding agent can read the release notes before it upgrades.Set up the MCP server β
Packagist
Packagist, #2174 most downloaded on Packagist
π Nette Tester: enjoyable unit testing in PHP. Tests are plain PHP scripts that run in parallel, with readable assertions and code coverage.
Latest stable
v2.7.0
Last release 26 days ago
26 Oct 2026
Ships fairly regularly
a new release about every 4 months
Nearly every release is documented
notes for 45 of 47 stable releases
Nothing withdrawn
no release was ever pulled
14 years old
47 releases Β· first in 2012
Drag across the ruler to compare, or tap a release to open it.
Assertion type 'integer' in Assert::type() is deprecated, use 'int'
Tester 2.7 makes itself at home in CI: failures land right in the pull request diff, hanging tests no longer hang the pipeline, and slow tests have nowhere to hide.
-o github output marks failed tests directly in the PR diff view, and it switches on automatically when Tester runs on GitHub Actions, so there is nothing to configure--timeout <seconds> sets a limit for every test, @timeout overrides it per file; a test that runs over is terminated and reported as a failure instead of blocking the whole run--slowest β prints the 10 (or as many as you ask for) slowest tests after the run, so you know exactly where the time goes#[DataProvider] and #[Throws] attributes β TestCase methods can now use PHP attributes instead of docblock annotations; the annotations keep workingHttpAssert::fetch() accepts a timeout (30 seconds by default), so an unresponsive server can't stall a testTestCase methods are discovered in parallel with other tests, and each test file's annotations are parsed only onceEnvironment::skip(), Environment::exit() and TestCase::skip() now return never; a subclass overriding them must change its return type tootester command exits with a non-zero code when it finds no tests, so a mistyped path no longer passes in CITestCase data provider that returns no data sets is now an error, just like an empty file-level provider'integer' in Assert::type() is deprecated, use 'int'Environment::lock() reports an error when the lock directory does not existYour coding agent can read these notes before it upgrades. Set up the MCP server β
Runner now warns you when Xdebug is active and slows the whole run down many times over, so a forgotten xdebug.mode no longer quietly costs you minute
xdebug.mode no longer quietly costs you minutes (no warning when Xdebug serves as the code coverage engine)TestCase::run() runs every test method even after one fails, so a single run shows you all failures at once: results first, details of each failure af
redirect('https://β¦', 302) instead of a bare redirect()@phpVersion handles the boundary versions correctly: @phpVersion 8.4.3 runs on PHP 8.4.3 and < 8.0 no longer runs on 8.0; common forms like @phpVersion 8.1 behave as before'' or '0'; to skip the message check, pass nullfailures attribute instead of errors; update your CI if it reads only errors--stop-on-fail and parallel jobs, running tests are finished before the runner exits, and Ctrl+C terminates themfollow: true takes headers from the final response onlytester exits with code 1 when the requested report cannot be generated%f%), FileMock (append, rb+, touch()), DomQuery selectors on PHP < 8.4, Dumper with references and the JUnit report with invalid UTF-8 in the output@multiple with an invalid value and Helpers::purge() on a path resolving to the root directory are reported as errorsPhpInterpreter now passes the command to proc_open() as an array, so PHP handles argument escaping itself and the subshell is bypassed on Linux too β
proc_open() as an array, so PHP handles argument escaping itself and the subshell is bypassed on Linux too β fewer surprises with paths and arguments containing spaces or special charactersLogicException instead of silently returning an unset value when the test hasn't finished running yet β mistakes surface immediately rather than turning into puzzling downstream errorsThe headline: Tester now respects your system php.ini by default, which is a breaking change but makes the "it works on my machine" debugging sessionsβ¦
This release brings true parallel test execution on Windows, smarter PHP configuration handling, and a bunch of quality-of-life improvements. The headline: Tester now respects your system php.ini by default, which is a breaking change but makes the "it works on my machine" debugging sessions a lot shorter.
php.ini by default (#465)stream_select() fix means Windows users can now enjoy actual parallelism, not just the illusion of it.test() and testException() lifecycle improvements β Both functions now properly call setUp() and tearDown(), and tearDown() runs even when tests fail. Your cleanup code will actually clean up.testNoError()Nothing published for this version
* support for PHP 8.5 * added HttpAssert * added Assert::notMatch()
Dumper::toPhp() prints enum case directly
Dumper::toPhp() prints enum case directly (#457)DomQuery::closest()TestHandler: improve cache file uniqueness
Add testcase method's name to the test's title.
DomQuery::matches()test(): checks count of argumentsImplemented console-lines mode which prints each test on separate line.
console-lines mode which prints each test on separate line. (#443)Environment::setupFunctions() creates global functions testException()fixed accessed property before initialization
get_debug_type()Capture stderr of test via temp file and output it in test results [Closes #420]
CloverXMLGenerator: reports file name is case of parse error
Assert::exception() prints stack of unexpected exceptioninterrupt signal is converted to InterruptException and handled by CliTester
Dumper::dumpException() added option to change output file name via AssertException::$outputNameTestCase:prepareTestData(): check that every data provider item is array #431
TestCase:prepareTestData(): check that every data provider item is array #431Assert::$expandPatterns to disable patterns expansionTestCase: added method skip() for skipping tests [Closes #379]
Environment::loadData(): --dataprovider arg is exact key, not query (BC break) [Closes #428]
Dumper: keep full data provider name in output files
touch() expects parameter 2 to be int, null given' #403For the details you can have a look at the diff.
Dumper: keep full data provider name in output files
with() (#410)touch() expects parameter 2 to be int, null given' #403For the details you can have a look at the diff.
Runner: added support for CTRL-C
pcntl_signal() can be disabledFor the details you can have a look at the diff.
Environment: 'file' can be undefined when is test called via register_shutdown_function()
register_shutdown_function() (#411)For the details you can have a look at the diff.
watch mode: changed files are detected by filemtime
Assert::notNull()FileMutator fixes--watch mode recovers from errors (e.g. missing file)
--watch mode recovers from errors (e.g. missing file)FileMutator (during scandir() or recursive mkdir())Assert::noError() throws exception when called with more than one parameterExpect for complex assertions formulation (#398)Helper::purge() protection to not purge root directory (#392)Runner::addPhpIniOption() to be able set PHP INI option from --setup scriptFor more information see documentation and changelog.
Minimal PHP version since this release is 7.1. That's actually the main reason for this release.
Minimal PHP version since this release is 7.1. That's actually the main reason for this release.
Internal code improvements
Bypass finals respects final as a literal
Added notification when empty code coverage report data
The --coverage-src option is repeatable (#388)
For more information see documentation and changelog.
Assert::error() accepts array of E_XXXX without error message
For more information see documentation and changelog.
For more information see documentation and changelog.
For more information see documentation and changelog.
required PHP 5.6 and supports PHP up to 7.2
*Test.php as a test files too-C option to use system-wide php.ini--temp option@phpExtension test file annotation%w% and %% modifiers for Assert::match()For more information see documentation and changelog.
This release is the last in the 1.x series. It is compatible with PHP 5.4 - 7.2.
This release is the last in the 1.x series. It is compatible with PHP 5.4 - 7.2.
The following 2.0 series, even marked as compatibility breaking, has very good compatibility, but supports PHP from version 5.6.
For more information see documentation and changelog.
Tester itself is tested on AppVeyor (Windows CI)
For more information see documentation and changelog.
HtmlGenerator: not evaluated sources are counted as not covered #248
For more information see documentation and changelog.
This release fixes issue of TestCase::tearDown() double calling:
This release fixes issue of TestCase::tearDown() double calling:
For more information see documentation and changelog.
Assert: added noError() assertion #250
noError() assertion #250@throws is applied to testMethods() only, not to setUp() nor tearDown() (BC break) #238setUp() and tearDown() exceptionstearDown() is called even on error in test method #254 #255Dumper::toPhp() better support for anonymous classes and ClosuresFor more information see documentation and changelog.
added Job::getErrorOutput() & PhpInterpreter::getErrorOutput() for PHP startup errors [Closes #229][Closes #230]
For more information see documentation and changelog.
generates code coverage report in Clover XML format (via tester --coverage coverage.xml)
tester --coverage coverage.xml)tester -o junit)Tester to srcFor more information see documentation and changelog.
This release fixes some minor issues. For more information see documentation and changes.
This release fixes some minor issues. For more information see documentation and changes.
This release fixes some issues:
This release fixes some issues:
For more information see documentation and changes.
tap: replacement for the deprecated --tap option (Test Anything Protocol)
-o (output format) which can enumerate from:
console: the same as default, but logo is not printedtap: replacement for the deprecated --tap option (Test Anything Protocol)none: nothing is printed, only bad usage errors when occuresEnvironment::setup() and file tester.phpis_readable & is_writableFor more information see documentation and changelog.
added option --stop-on-fail that stops execution upon first error
--stop-on-fail that stops execution upon first error@testcase, @multiple or @dataproviderFor more information see documentation and changelog.
Tester: added options --coverage and --coverage-src for generating code coverage reports (tool coverage-report.php was removed)
--coverage and --coverage-src for generating code coverage reports (tool coverage-report.php was removed)-log changed to -l or --log to be consistent with other optionsAssert::isEqual can compare recursive objects [Closes #93]Assert::nan()Tester\Environment::loadData() for loading data via annotation @dataProviderFor more information see documentation and changelog.
Four years ago was added to the Nette Framework new simple unit test framework ;-) Now Nette Tester has become stable testing tool with integrated sup
Four years ago was added to the Nette Framework new simple unit test framework ;-) Now Nette Tester has become stable testing tool with integrated support in NetBeans 8.0 and lot of features:
For more information see readme.md.
Assert::error() can test more than one error
Assert::error() can test more than one errorFor more information see readme.md.
you can watch multiple directories via --watch
--watchFor more information see readme.md.
output in TAP format using --tap
--taptester *.phpoutput/ subdirectory, message diff file.expected file.actual is printedFor more information see readme.md.
much better colorized error messages!
--colors@exitCode, @htmlCode, @outputMatch and @outputMatchFile@throws for TestCaseAssert::match is fully customizable via Assert::$pattern and regular expressionsAssert::type accepts default PHP typesAssert::matchFile, truthy and falseyFor more information see readme.md.
After 4 years of development Nette Tester has become stable testing tool with a lot of cool features:
After 4 years of development Nette Tester has become stable testing tool with a lot of cool features:
For more information see readme.md.
Nothing published for this version
One column per quarter.