This package is not installable via Composer 1.x, please make sure you upgrade to Composer 2+. Read more about our Composer 1.x deprecation policy.

Migrate your tests to the newest PHPUnit version

dev-master 2021-08-02 07:00 UTC

This package is auto-updated.

Last update: 2021-10-02 07:21:13 UTC


Build Status Coverage Status

PHPUnit migration tool

Migrate project to the newest version of PHPUnit.

[Work In Progress] Use it on the own risk :)

How to use the tool?

Clone the project:

$ git clone https://github.com/webimpress/phpunit-migration.git

Go into the directory and install dependencies:

$ cd phpunit-migration
$ composer install

To update your project to the newest version of PHPUnit go to your project directory and run:

$ ../path/to/phpunit-migration/bin/phpunit-migration migrate

What the tool is changing?

  1. compose dependencies to the latest PHPUnit versions,
  2. \PHPUnit_Framework_TestCase to namespaced \PHPUnit\Framework\TestCase,
  3. setExpectedException to expectException*,
  4. setUp and tearDown to protected and correct case (setup => setUp etc.),
  5. FQCN in @cover tag (i.e. @covers MyClass to @covers \MyClass),
  6. assertInternalType and assertNotInternalType to more specific assertion method (PHPUnit 7.5+),
  7. getMock to getMockBuilder with other required function calls (PHPUnit 5.4+),
  8. getMockBuilder(...)->...->getMock() to createMock(...) if possible (PHPUnit 5.4+),
  9. assertEquals() and assertNotEquals() with $delta, $maxDepth, $canonicalize and $ignoreCase parameters to more specific assertion method (PHPUnit 7.5+),
  10. add void return type to the following methods: setUp(), tearDown(), setUpBeforeClass(), tearDownAfterClass(), assertPreConditions(), assertPostConditions(), onNotSuccessfulTest(\Throwable $th) (PHPUnit 8.0+),
  11. expectExceptionMessageRegExp to expectExceptionMessageMatches (PHPUnit 8.4+),
  12. use new (more readable) assertion names:
  • assertNotIsReadable replaced by assertIsNotReadable',
  • assertNotIsWritable replaced by assertIsNotWritable',
  • assertDirectoryNotExists replaced by assertDirectoryDoesNotExist',
  • assertDirectoryNotIsReadable replaced by assertDirectoryIsNotReadable',
  • assertDirectoryNotIsWritable replaced by assertDirectoryIsNotWritable',
  • assertFileNotExists replaced by assertFileDoesNotExist',
  • assertFileNotIsReadable replaced by assertFileIsNotReadable',
  • assertFileNotIsWritable replaced by assertFileIsNotWritable',
  • assertRegExp replaced by assertMatchesRegularExpression',
  • assertNotRegExp replaced by assertDoesNotMatchRegularExpression'. (PHPUnit 9.1+),
  1. TODO: getMockBuilder(...)->...->setMethods(...)->getMock() to createPartialMock(...) if possible (PHPUnit 5.5.3+),
  2. TODO: assertContains() and assertNotContains() on string haystack to more specific assertion method (PHPUnit 7.5+),
  3. TODO: $this->assert to self::assert.

What the tool is NOT doing?

  1. changing PHPUnit_Framework_Error_* classes
  2. probably other things I don't remember now ;-)


Please remember it is developer tool and it should be used only as a helper to migrate your tests to newer version of PHPUnit. Always after migration run all your test to verify if applied changes are right and your tests are still working!