Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc Update Sep 12, 2014
examples Fixed typos Sep 1, 2014
lib Add support for free instruction to PHP compiler Dec 22, 2014
travis Add proper prefix, travis really needs some way to test locally Sep 5, 2014
.gitignore Add detail into how phi functions are resolved Sep 12, 2014
LICENSE Initial release of Recki Compiler Toolkit Aug 29, 2014
composer.json More work on PECL compilation Oct 22, 2014
composer.lock More work on PECL compilation Oct 22, 2014
phpunit.xml.dist More PECL work, support string concatonation and garbage collection t… Oct 22, 2014


Build Status Coverage Status

The Recki Compiler Toolkit for PHP

Disclaimer: This is not an official Google product.

Warning: This is an incomplete work-in-progress.


Recki-CT is pre-alpha quality right now. This means that it shouldn't be used in production at all.

What Is Recki-CT?

Recki-CT is a set of tools that implement a compiler for PHP, and is written in PHP!

Specifically, Recki-CT compiles a subset of PHP code. The subset is designed to allow a code base to be statically analyzed. This means that global variables, dynamic variables (variable-variables, variable function calls, etc) and references are not allowed.

What Isn't Recki-CT?

Recki-CT is not a re-implementation of PHP. It aims to be a limited subset of the language (one that can be staticly reasoned about).

This means that it is not designed to replace PHP, but instead augment it.


PHP itself isn't slow. It's plenty fast enough for most use-cases. As a language, PHP has a lot of corner cases and results in a really complex engine implementation. As such, rewriting a new engine isn't going to gain you a lot. The complexity is going to be in there somewhere.

So with Recki-CT, we take a different approach. Rather than rewriting the entire engine, we sit on top of an existing engine. The compiler then can compile PHP code into native machine code which can out-perform most JIT compiled implementations (sometimes by very significant margins).

The designed mode of operation for Recki is as an AOT (Ahead-Of-Time) compiler. Since it uses aggressive analysis and optimizations, runtime compilation would be a inefficient target. Instead, an Intermediate Representation can be cached, leaving only the final conversion to machine code to happen at runtime.

Where can I find out more?

Check out the documentation!!!

  1. Introduction and FAQ
  2. Installation
  3. Basic Operation
  4. Types
  5. Intermediate Representation

How do I install Recki-CT?

See the Installation Documentation.

How do I use Recki-CT?

A very simple example:

 * @return void
function foo($bar) {}

// Instead of using:

// Use:
$foo = Jit::JitFu('foo');

Note that a docblock must be present, and must document every parameter type and the return type.

Check out the examples folder for more examples!


Recki-CT is released under the Apache-2 License.



And join the Google Group mailing list.

You can’t perform that action at this time.