Skip to content
PHP to JavaScript converter and VM written in JavaScript
Branch: master
Clone or download
niklasvh Merge pull request #63 from maxvyaznikov/master
Fix for undefined for Node_Expr_BitwiseAnd
Latest commit 7a6ca09 Mar 3, 2015
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
adapters/filesystem
build Updated instructions on building and updated to latest grunt Aug 25, 2014
cfg
dist Make options optional Aug 25, 2014
grammar
src Fix for undefined for Node_Expr_BitwiseAnd Feb 28, 2015
templates loop iterator fixes Jul 24, 2012
tests Make options optional Aug 25, 2014
tmp_files
.gitignore
.npmignore
.travis.yml
Gruntfile.js
LICENSE-MIT Added license information Jan 15, 2013
package.json
readme.md
thread.js

readme.md

php.js

PHP VM in JavaScript

This library reads PHP code and transforms it into JavaScript code which can be run in the PHP VM in this library, resulting in same results as with PHP. It starts by tokenizing the PHP code into tokens, which it then uses to build an AST tree. Once the tree has been constructed, the script compiles it into JavaScript that can be interpreted by the VM and then executes it. Any additional unconverted code that gets executed within the VM, such as eval or lambda functions will go through the same process before being executed.

The code can be directly run in your browser, meaning you can execute php code straight out of your browser! It can also be run on node.js, but strongly recommend not to, due to potential security issues.

Some examples

Usage

var engine = new PHP ('<?php echo "Hello world!"; ?>', options);
console.log(engine.vm.OUTPUT_BUFFER); // the outputted buffer from the script

The code is by default run synchronously so the output will be immidiately readable upon the engine finishing execution. Alternatively, the VM can be set to run under a web worker as well, in which case a callback function will need to be provided.

Status

This project was purely for my personal learning. If it isn't obvious, this shouldn't be incorporated in any type of application, and the only reason it is open source is that if someone would find useful information or parts from it. I took a test driven approach to developing this library, which means that I have been mostly focusing on getting the php unit tests (which PHP uses itself) to work correctly. If a certain functionality hasn't been a part of the base unit tests (around 670 in total), it most likely won't work or only works partially. Additionally, only a fraction of module functions have been implemented, and even for the ones that have been, many of them are only partially implemented (i.e. signature checks haven't really been implemented to any functions, although user created functions support them). However, additional functions can easily be added, as they can be written in PHP and have them compiled into JavaScript.

The current status of the passing tests can be seen here. I'll be the first admit that there are still a lot of bugs, but considering the complexity of the language, it is well on its way.

Building

npm install
grunt 

License

JavaScript code licensed under MIT license PHP Files and tests under The PHP License, version 3.01

Credits

  • Test cases from php-src - The PHP License, version 3.01
  • Grammar parser adapted from PHP-Parser - by Nikita Popov

Questions & Comments

If you encounter a bug, please feel free to post it on GitHub. For questions or comments, you can contact me at Twitter @niklasvh or Google Plus

You can’t perform that action at this time.