Bypass Finals
Introduction
Removes final keywords from source code on-the-fly and allows mocking of final methods and classes. It can be used together with any test tool such as PHPUnit, Mockery or Nette Tester.
Installation
The recommended way to install is through Composer:
composer require dg/bypass-finals --dev
It requires PHP version 7.1 (or 5.6 in case of release 1.1) and supports PHP up to 8.1.
Usage
Simply call this:
DG\BypassFinals::enable();
You need to enable it before the classes you want to remove the final are loaded. So call it as soon as possible, preferably right after vendor/autoload.php
is loaded.
Note that final internal PHP classes like Closure
cannot be mocked.
You can choose to only bypass finals in specific files or directories:
DG\BypassFinals::setWhitelist([
'*/Nette/*',
]);
This gives you finer control and can solve issues with certain frameworks and libraries.
You can try to increase performance by using the cache (the directory must exist):
DG\BypassFinals::$cacheDir = __DIR__ . '/tmp';
Support Project
Do you like BypassFinals?