pyphp

Php parser, compiler and interpreter for python

Usage

Executing php code

You can execute php code using the pyphp.executer module. The execute_file reads a php file and executes it, while execute_php executes given php code.

• To run a php script:

  import pyphp.executer
  pyphp.executer.execute_file('my_php_code.php')

  my_php_code.php contents:

  Hello <?php echo "World\n";?>

• To run php code

  import pyphp.executer
  
  phpcode = r'Hello <?php echo "World.\n"; ?>';
  
  pyphp.executer.execute_php(phpcode)

  output:

  Hello World.

• You can redirect the script's output to any file-like object, such as StringIO

  import pyphp.executer
  import StringIO
  
  stdout = StringIO.StringIO()
  phpcode = r'Hello <?php echo "World.\n"; ?>';
  
  pyphp.executer.execute_php(phpcode, stdout=stdout)
  
  print repr(`stdout.getvalue())

  output:

  'Hello World.\n'

• You can run the php file directly by using the module as a script:

  python pyphph/executer.py phpscript.php arg1 arg2 ...

Using the parser

The parser breaks up the php code into a list of tokens.

• This will parse a php file in the same directory and return it as a list of tokens.

  import pyphp.parser
  token_list = pyphp.parser.parse_file("my_php_code.php")

• You can also parse the php code directly:

  import pyphp.parser
  
  phpcode = r'Hello <?php echo "World.\n";?>';
  
  token_list = pyphp.parser.parse_php(phpcode)

• token_list would be a list like this:

  [Token['DIRECT_OUTPUT', 'Hello '],
  Token['WS'],
  Token['IDENTIFIER', 'echo'],
  Token['WS'],
  Token['STRING', 'World\n'],
  Token[';']]

  this token list can then be fed to the compiler to generate a syntax tree.

Using the compiler

The compiler takes a list of tokens a creates a syntax tree representing the code

• This will compile a php file in the same directory and return it as a syntax tree.

  import pyphp.compiler
  syntax_tree = pyphp.compiler.compile_file("my_php_code.php")

• You can also compile the php code :

  
  import pyphp.compiler

phpcode = r'Hello <?php echo "World.\n";?>';

syntax_tree = pyphp.compiler.compile_php(phpcode)

- Or compile the list of tokens directly:
``` python
import pyphp.parser
import pyphp.compiler

phpcode = r'Hello <?php echo "World.\n";?>';

token_list = pyphp.parser.parse_php(phpcode)

syntax_tree = pyphp.compiler.compile_php(token_list)

• syntax_tree would be a TreeNode object like this:

  TreeNode<php_file>[
  TreeNode<direct_output>['Hello '],
  TreeNode<echo>[
      TreeNode<primitive>[
          Token['STRING', 'World\n']
      ]
  ]
  ]

  This TreeNode object can then be fed to execute_php to run the code.

PHP Library support

Currently, only a minimal set of PHP's language features and built in library is supported, but the plan is to support as most of it as possible.

Language features not supported yet are namespaces, anonymous functions, lots of other stuff.

Below is the official subset of PHP's built in features currently supported.