Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Rewrite of Roadsend PHP in C++ using LLVM
C++ C
branch: master
Failed to load latest commit information.
3rdparty add tinyxml and start using it to dump asts
c-runtime Switch to clang++ (sebastianbergmann)
cmake/modules Switch to clang++ (sebastianbergmann)
compiler Fixes for compiling with latest versions of LLVM
doc Update the pass notes to reflect reality after the switch lowering pa…
frontend Fixes for compiling with latest versions of LLVM
include Fixes for compiling with latest versions of LLVM
lib sigh
runtime Add the MainFunction and the Lower_Control_Flow pass.
sandbox cmake build work, and test with latest llvm 2.7svn
CMakeLists.txt cmake build work, and test with latest llvm 2.7svn
README

README

= Roadsend PHP: Raven (rphp) =

This is the development site for the rewrite of Roadsend PHP (rphp), based on LLVM and a new C++ runtime. It is an open source, liberally licensed project.

You can find the latest summary on recent developments on http://roadsend-php.blogspot.com

Features/Goals include: 
 * Highly optimized, JIT or static compiled native binaries (via LLVM)
 * PHP source level analysis and optimization
 * Rich diagnostics and error messages
 * Modular design
 * Clean and easy runtime and extension API
 * Full unicode support
 * Latest language features (e.g. PHP5 objects, exceptions, namespaces, lambda functions, etc)
 * Portability, Speed, Security

Unlike our previous project, we are not aiming for 100% compatibility with Zend Engine based PHP. 

== Current Status ==

 * CMake build system
 * Runtime library
  * Runtime variable representation
  * Port of basic runtime system layout
  * Standard Extension started
 * Commandline front end
  * Compile stand alone
  * Run in JIT
 * Compiler and Analysis
  * Full unicode preprocessor/lexer/parser in place
  * Pass system for AST tree traversal and transforming
  * Some code (IR) generation (detailed progress list coming soon)
  * Static analyzer which dumps (in XML)
   * Tokens
   * AST
   * Generated IR
   * Various analysis passes
  * Port of [http://phpcompiler.org phc] optimizer passes
 * Runtime Test Suite (CppUnit and PHP based)

Development currently takes place on Linux x86 (32 and 64) and OSX, but other platforms will be supported.

If you are looking for a fully functioning PHP compiler that works right now, please see our [http://code.roadsend.com/pcc original implementation] instead.

If you'd like to contribute, please contact us or join us in #roadsend on irc.freenode.net

== Requires ==

 * [http://llvm.org LLVM] 3.0 with clang++
 * [http://boost.org Boost] 1.38+ (only headers required, no libraries)
 * [http://cmake.org CMake] 2.6+
 * [http://icu-project.org ICU] 4.2+ 
 * [http://gmplib.org GMP] 4.3.1+

== Docs ==

 * [http://roadsend-php.blogspot.com Development Blog]
 * [http://code.roadsend.com/docs/doxygen/annotated.html Doxygen Source Documentation]

== Source ==

Browse the source at:
https://github.com/weyrick/roadsend-php-raven

== Build ==

rphp uses the CMake build system. Basic *nix instructions:

 * create "build" directory inside of rphp
 * in the build directory, type "cmake .."
 * make

Note that an in-tree build is not recommended, you should create a separate build directory.

== Sample Checkout and Build Session ==

Assuming you have the prerequisites installed, a sample checkout and build session might look like this:

~$ cd rphp
~rphp/$ mkdir build
~rphp/$ cd build
~rphp/build$ cmake ..
(... output ...)
~rphp/build$ make
(... build output ...)


All of the build files (including libraries and executables that are built) will be underneath this build directory.

== Running ==

 '''PLEASE NOTE that code generation is currently disabled while we finish rewriting the front end. Try rphp-analyzer instead!

Before running, setup some environment variables so rphp can find its library files. The following is a .bashrc excerpt, but what's important is to define RPHP_IR_PATH, RPHP_RUNTIME_PATH, and LD_LIBRARY_PATH if you wan to try both compiling and interpreting.

RPHP_PATH=~/rphp
RPHP_IR_PATH=$RPHP_PATH/lib
RPHP_RUNTIME_PATH=$RPHP_PATH/build/runtime/
LD_LIBRARY_PATH=$RPHP_RUNTIME_PATH:$LD_LIBRARY_PATH
export RPHP_IR_PATH RPHP_RUNTIME_PATH LD_LIBRARY_PATH

The compiler binaries will be located in the build directory in frontend/cli/.
"rphp" is the compiler and JIT interpreter. To execute a source file immediately (using JIT):

$ frontend/cli/rphp -f helloworld.php

To compile to a binary and run native:

$ frontend/cli/rphp helloworld.php
$ ./helloworld

To dump the various passes:
rphp-analyzer --dump-toks <file>
rphp-analyzer --dump-ast <file>
rphp --dump-ir <file>
Something went wrong with that request. Please try again.