marc/xray

X-Ray allows declaration of Zend Engine include() and eval() hooks.

X-Ray

, _(*1)

X-Ray allows declaration of Zend Engine include(), require() and eval() hooks.:, _(*2)

How to use:

// adding a compiler hook:
xray\set_compiler_hook(function(string $source, string $filename = null) : string {
    if ($filename === null)  {
        // here we intercept source included through eval()
        // do transformations on $source and return the new $source to be included        
    }
    else {
        // here we intercept source included from a *.php file
        // do transformations on $source and return the new $source to be included
    }
});

// removing the compiler hook:
$hook = xray\restore_compiler_hook();

How to install:

git clone https://github.com/marcioAlmada/xray
cd xray
phpize
./configure
make
sudo make install

Finally add extension=xray.so to your /etc/php.ini, _(*3)

Windows Support

Pull requests welcome. Anyone?, _(*4)

Why?

A compiler hook API was needed in order to have a decent infrastructure for YAY. But this ended up as a more general purpose internal framework so others projects can benefit too., _(*5)

Copyright

Copyright (c) 2015-* Márcio Almada. Distributed under the terms of an MIT-style license. See LICENSE for details., _(*6)