Include Interceptor
Library to intercept PHP includes. A fork of icewind1991/interceptor.
composer require nikic/include-interceptor
Usage
use Nikic\IncludeInterceptor\Interceptor;
$interceptor = new Interceptor(function(string $path) {
if (!wantToIntercept($path)) {
return null;
}
return transformCode(file_get_contents($path));
});
$interceptor->setUp(); // Start intercepting includes
require 'src/foo.php';
$interceptor->tearDown(); // Stop intercepting includes
The interception hook follows the following contract:
- It is only called if the included file exists.
- The passed
$pathis the realpath. - If the hook returns
null, no interception is performed. - If the hook returns a string, these are taken as the transformed content of the file.
For convenience, a FileFilter is provided that implements white- and black-listing of files and directories. Paths passed to addBlackList() and addWhiteList() should always be realpaths.
use Nikic\IncludeInterceptor\Interceptor;
use Nikic\IncludeInterceptor\FileFilter;
$fileFilter = FileFilter::createAllWhitelisted(); // Start with everything whitelisted
$fileFilter->addBlackList(__DIR__ . '/src/'); // Blacklist the src/ directory
$fileFilter->addWhiteList(__DIR__ . '/src/foo.php'); // But whitelist the src/foo.php file
$interceptor = new Interceptor(function(string $path) use ($fileFilter) {
if (!$fileFilter->test($path)) {
return null;
}
return transformCode(file_get_contents($path));
});
$interceptor->setUp();
require 'src/foo.php';
128 Oct 27, 2022
151 Nov 1, 2022
3 Jul 30, 2022
6 Dec 14, 2022
12 Nov 9, 2022
5 May 31, 2022
980 Dec 31, 2022
124 Jan 6, 2023
1 Oct 28, 2021
3 Oct 3, 2022
3 Aug 15, 2022
616 Dec 17, 2022
6 Nov 9, 2022
3.3k Dec 23, 2022
1.3k Jan 1, 2023
4.3k Dec 29, 2022
364 Oct 18, 2022
1.3k Dec 27, 2022
5 May 14, 2020