wikimedia/testing-access-wrapper

A simple helper class to access non-public elements of a class when testing.

4.0.0 2025-11-03 13:34 UTC

Requires

• php: >=8.1

Requires (Dev)

• mediawiki/mediawiki-codesniffer: 48.0.0
• mediawiki/mediawiki-phan-config: 0.17.0
• mediawiki/minus-x: 1.1.3
• ockcyp/covers-validator: 1.7.0
• php-parallel-lint/php-console-highlighter: 1.0.0
• php-parallel-lint/php-parallel-lint: 1.4.0
• phpunit/phpunit: 10.5.58

GPL-2.0-or-later

• Adam Roses Wight
• Brad Jorsch
• Gergő Tisza

README

Wikimedia Testing Access Wrapper

Testing Access Wrapper is a simple helper for writing unit tests which provides convenient shortcuts for using reflection to access non-public properties/methods.

The code was originally part of MediaWiki. See composer.json for a list of authors.

Usage

use Wikimedia\TestingAccessWrapper;

class NonPublic {
	protected $prop;
	protected const CONSTANT = 4;
	protected function func() {}
	protected static function staticFunc() {}
}

class NonPublicCtor {
	protected function __construct() {}
}

$object = new NonPublic();
// or:
// $object = TestingAccessWrapper::construct( NonPublicCtor::class );

$wrapper = TestingAccessWrapper::newFromObject( $object );
$classWrapper = TestingAccessWrapper::newFromClass( NonPublic::class );

$wrapper->prop = 'foo';
$wrapper->func();
$classWrapper->staticFunc();

$value = TestingAccessWrapper::constant( NonPublic::class, 'CONSTANT' );

Running tests

composer install
composer test