wiki.techinc.nl/tests/phpunit/PHPUnit4And6Compat.php
Kunal Mehta b34260f379 Provide PHPUnit 4 and 6 compatibility layer
PHPUnit 6 removed some functions that were heavily used in version 4. To
be able to support both versions for a short time, we'll use a trait to
fill in the missing methods until we drop PHPUnit 4 support.

This trait is included in MediaWikiTestCase so most tests will be able
to benefit from it by default. Otherwise, anything that calls
setExpectedException() or getMock() will need to use it.

Change-Id: I707129e471e960e034e2aa994a467b9dc0239b69
2018-04-06 14:33:25 -07:00

119 lines
3.6 KiB
PHP

<?php
/**
* Copyright (C) 2018 Kunal Mehta <legoktm@member.fsf.org>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
*/
/**
* @since 1.31
*/
trait PHPUnit4And6Compat {
/**
* @see PHPUnit_Framework_TestCase::setExpectedException
*
* This function was renamed to expectException() in PHPUnit 6, so this
* is a temporary backwards-compatibility layer while we transition.
*/
public function setExpectedException( $name, $message = '', $code = null ) {
if ( is_callable( [ $this, 'expectException' ] ) ) {
$this->expectException( $name );
if ( $message !== '' ) {
$this->expectExceptionMessage( $message );
}
if ( $code !== null ) {
$this->expectExceptionCode( $code );
}
} else {
parent::setExpectedException( $name, $message, $code );
}
}
/**
* @see PHPUnit_Framework_TestCase::getMock
*
* @return PHPUnit_Framework_MockObject_MockObject
*/
public function getMock( $originalClassName, $methods = [], array $arguments = [],
$mockClassName = '', $callOriginalConstructor = true, $callOriginalClone = true,
$callAutoload = true, $cloneArguments = false, $callOriginalMethods = false,
$proxyTarget = null
) {
if ( is_callable( 'parent::getMock' ) ) {
return parent::getMock(
$originalClassName, $methods, $arguments, $mockClassName,
$callOriginalConstructor, $callOriginalClone, $callAutoload,
$cloneArguments, $callOriginalMethods, $proxyTarget
);
} else {
$builder = $this->getMockBuilder( $originalClassName )
->setMethods( $methods )
->setConstructorArgs( $arguments )
->setMockClassName( $mockClassName )
->setProxyTarget( $proxyTarget );
if ( $callOriginalConstructor ) {
$builder->enableOriginalConstructor();
} else {
$builder->disableOriginalConstructor();
}
if ( $callOriginalClone ) {
$builder->enableOriginalClone();
} else {
$builder->disableOriginalClone();
}
if ( $callAutoload ) {
$builder->enableAutoload();
} else {
$builder->disableAutoload();
}
if ( $cloneArguments ) {
$builder->enableArgumentCloning();
} else {
$builder->disableArgumentCloning();
}
if ( $callOriginalMethods ) {
$builder->enableProxyingToOriginalMethods();
} else {
$builder->disableProxyingToOriginalMethods();
}
return $builder->getMock();
}
}
/**
* Return a test double for the specified class. This
* is a forward port of the createMock function that
* was introduced in PHPUnit 5.4.
*
* @param string $originalClassName
* @return PHPUnit_Framework_MockObject_MockObject
* @throws Exception
*/
public function createMock( $originalClassName ) {
if ( is_callable( 'parent::createMock' ) ) {
return parent::createMock( $originalClassName );
}
// Compat for PHPUnit <= 5.4
return $this->getMockBuilder( $originalClassName )
->disableOriginalConstructor()
->disableOriginalClone()
->disableArgumentCloning()
// New in phpunit-mock-objects 3.2 (phpunit 5.4.0)
// ->disallowMockingUnknownTypes()
->getMock();
}
}