PyHP

PyHP is an (incomplete!) implementation of the PHP language using the RPython technology. It uses JIT transformer provided by the RPython library to achieve good performance.

PyHP stands for Python + PHP.

HippyVM is too built on top of RPython, and is a complete, working implementation.

Features

all variable types like int, float, string, array, iterator
if, while, for, foreach statements
functions
pass by value or by reference to a function
global variables in function blocks using global
global constants using define()
(incomplete) standard library functions
unicode support for function/variable names and string values. PHP 6 compatible!

Project structure

main.py - main entry point
sourceparcer.py - parses a given PHP file using the grammar.txt definition, and produces an AST tree consisting of operations.py nodes
bytecode.py - turns the AST tree produced by sourceparcer.py into bytecode by calling compile() on the tree. Produces a ByteCode instance consisting of opcodes.py nodes
frame.py - execution frame. Contains the stack and the variables/functions map for the function or the global program. A frame instance is passed to execute method of a Interpreter instance as the only parameter
interpreter.py - loops over a list of bytecodes and evaluates a opcodes.py handler
grammar.txt - EBNF PHP grammar used by sourceparcer.py

Additional files:

operations.py - AST tree nodes
opcodes.py - class per each opcode. Each opcode has a eval(frame) method which gets called by the Interpreter.execute() method
symbols.py - contains an optimized Map class used for symbols map in scopes.py
stdlib.py - various PHP standard library methods like strlen
datatypes.py - all datatypes' box classes used to store the variables, like int, float, array, etc.

Building

Build the container first

docker build -t juokaz/pyhp .

or pull from docker hup

docker pull juokaz/pyhp

Building the interpreter

make build

Or to build without JIT support

make build-nojit

Running the benchmark

make bench

Or run any PHP file

./build/pyhp bench.php

Starting the web server

./build/pyhp --server 8080

Accessible through http://localhost:8080/bench.php.

Printing the bytecode

./build/pyhp --bytecode bench.php

Printing the AST tree

./build/pyhp --ast bench.php

Debugging the interpreter

PYPYLOG=jit-log-opt:jit.txt ./build/pyhp bench.php

Plot the trace as a graph

PYTHONPATH=$PYTHONPATH:/home/vagrant/pypy-src/ python ~/pypy-src/rpython/tool/logparser.py draw-time jit.txt --mainwidth=8000 filename.png

Running the tests

make tests

Or to run with coverage information

make tests-cov

Building the docker container

docker build -t juokaz/pyhp .

Attributions and inspirations

JavaScript on top of RPython

Example interpreter

Pascal on top of RPython

HippyVM - php on top of RPython

gaurangkumar/pyhp