Creating native instructions in PHP since 2014
C PHP C++ Shell
Latest commit 8fdd8c8 Jan 17, 2016 @krakjoe some moar stuff


Build Status

A lesson in the art of JoeJITFu!

JIT-Fu is a PHP extension that exposes an OO API for the creation of native instructions to PHP userland, using libjit.

A JoeJITFu elephpant

Disclaimer: the elephpant above is an artists rendition, the actual animal may or may not exist ...


Because apparently, that's super important ...

use JITFU\Context;
use JITFU\Type;
use JITFU\Signature;
use JITFU\Func;
use JITFU\Value;

$context = new Context();

$integer   = Type::of(Type::int);

$function = new Func($context, new Signature($integer, [$integer]), function($args) use($integer) {
    $zero     = new Value($this, 0, $integer);
    $one      = new Value($this, 1, $integer);
    $two      = new Value($this, 2, $integer);

    /* if ($arg == 0) return 0; */
        $this->doEq($args[0], $zero),
        function() use ($zero) {

    /* if ($arg == 1) return 1; */
        $this->doEq($args[0], $one),
        function() use($one) {

    /* return $function($arg-1) + $function($arg-2); */
            $this->doCall($this, [$this->doSub($args[0], $one)]),
            $this->doCall($this, [$this->doSub($args[0], $two)]))); 

if (stripos('win', PHP_OS) !== 0) {

var_dump($function(40)); /* __invoke with magicalness */

The code above will yield something like the following output on Linux:

[joe@localhost jit]$ time php objects.php 
function Fibonacci(i1 : int) : int
        incoming_reg(i1, rdi)
        i6 = i1 == 0
        if i1 != 0 then goto .L0
        i7 = i1 == 1
        if i1 != 1 then goto .L1
        i8 = i1 - 1
        outgoing_reg(i8, rdi)
        call 0x08215dfd0
        return_reg(i10, rax)
        i12 = i1 - 2
        outgoing_reg(i12, rdi)
        call 0x08215dfd0
        return_reg(i14, rax)
        i15 = i10 + i14


real    0m1.001s
user    0m0.997s
sys     0m0.003s

On my machine, this is ~60 times faster than PHP.

This library is not useful for compiling Zend opcodes

Installation Instructions


This extension is being developed against the latest libjit sources, it is advisable to install a fresh copy of libjit even if the system has one present:

git clone git://
cd libjit
./configure --prefix=/opt
sudo make install

Now you can build the PHP extension:

git clone
cd jitfu
./configure --with-jitfu=/opt
sudo make install

The example sessions above will result in a build of libjit and JIT-Fu


Snapshots of the master branch are built at 1-2 AM UTC on Mondays. Currently only VC11 x86 builds against PHP 5.5 and 5.6 are available, these should work with the packages that can be downloaded from The bundled libjit is built as an self-contained binary with MinGW from a patched version of the master branch.

  • Download the appropriate package for your PHP installation from here.
  • Place php_jitfu.dll in your configured extension_dir.
  • Place libjit.dll in a directory that appears in your %PATH%.

Note: The dump() methods are currently unavailable on Windows. Calling these methods on Windows will result in a JITFU\Exception being thrown.


  • integration tests for as much as possible
  • other cool things, probably
  • pecl & phpdoc