phply

phply is a parser for the PHP programming language written using PLY, a Lex/YACC-style parser generator toolkit for Python.

Why?

Good question. Because I'm crazy. Because it seemed possible.

Things I'm interested in doing with it:

Converting PHP code to Python
Running PHP templates in a Python environment
Learning more about parsing "industrial" languages, warts and all

What does it stand for?

phply -> PHP PLY
phply -> PHP Hypertext Preprocessor Python Lex YACC
phply -> PHP Hypertext Preprocessor Hypertext Preprocessor Python Lex Yet Another Compiler Compiler
(... to be completed ...)

How do you pronounce it?

If you're conservative, it's pronounced "pee aich ply". If you're liberal, it's "fiply". And if you're anarchist, pronounce it however you want. Who am I to tell you what to do?

What's working?

Lexer matching the standard PHP lexer token-for-token
Parser and abstract syntax tree for most of the PHP grammar
Script to convert PHP source to JSON-based ASTs
Script to convert PHP source to Jinja2 source (experimental)

What's not?

Some things can't be parsed yet. They are getting fewer by the day, but there is still a fair amount of work to do:

Nowdocs
Backticks
Binary string literals and casts
Labels and goto
Some other stuff, probably

Who's working on it?

See the AUTHORS file.

How do I use it?

Lexer test: python phply/phplex.py
Parser test: python phply/phpparse.py
JSON dump: cd tools; python php2json.py < input.php > output.json
Jinja2 conversion: cd tools; python php2jinja.py < input.php > output.html
Fork me on GitHub and start hacking :)

dharrya/phply