recki-ct

  • Owner: google/recki-ct
  • Platform:
  • License:: Apache License 2.0
  • Category::
  • Topic:
  • Like:
    0
      Compare:

Github stars Tracking Chart

Recki-CT

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.

Stability

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.

Why?

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:
foo($baz);

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

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!

License

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

Contributing

See CONTRIBUTING.md

And join the Google Group mailing list.

Overview

Name With Ownergoogle/recki-ct
Primary LanguagePHP
Program languagePHP (Language Count: 2)
Platform
License:Apache License 2.0
Release Count0
Created At2014-08-29 18:46:29
Pushed At2018-12-05 16:47:34
Last Commit At2014-12-22 11:20:23
Stargazers Count550
Watchers Count49
Fork Count45
Commits Count77
Has Issues Enabled
Issues Count6
Issue Open Count3
Pull Requests Count7
Pull Requests Open Count1
Pull Requests Close Count4
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private
To the top