summaryrefslogtreecommitdiff
path: root/www/wiki/tests/phpunit/PHPUnit4And6Compat.php
blob: 672ab4a4d650d6c0bf79b6488cd7be27d5564fd3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
<?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' ] ) ) {
			if ( $name !== null ) {
				$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();
	}
}