glayzzle
v0.3.0
Published
Run PHP file with javascript (NodeJS/Browser).
Downloads
5
Readme
Glayzzle - PHP to JS transpiler
This is a CLI library in order to run a PHP script using the NodeJS V8 engine.
Why (disclaimer) ?
I'm a PHP developper from years. Now I'm mainly using NodeJS and Javascript because that's the way to go. I won't discuss about NodeJS vs PHP, because they came with different advantages, and honestly I like both for diferents reasons.
The main motivation behind this project is to empower a PHP developper with the same abilities of NodeJS or Javascript. You are maybe thinking, if a developper want to do same thing as a nodejs application can do, why not learning and using directly NodeJS ? Well, here some reasons :
- Learning curve
- Grasp Prototypal principles, scopes ...
- Habits & loosing landmarks
- Loosing typehinting habits, or dyslike Duck Typing
- Loosing SOLID principles / patterns
- ... and maybe others, lets chat if you want to share your experience
You are JS purist and Glayzzle burns your eyes !
This project is not made for someone who masters JS and don't like PHP. It's just a matter of taste, some guys prefer SOLID vs Duck typing, and may prefer use a friendly syntax used from years instead learning a new syntax like Typescript.
What you can do with ?
The project is still under developpement, so you can't use it yet :smile:.
Seriously, I plan to :
- Handle all PHP structures (namespace, classes, traits, interfaces)
- Impl a PHP core specific layer (in order to support main PHP functions)
- Impl a new syntax keyword in order to natively support any Javascript library
- Impl a debug support with node
- Impl plugins for gulp/grunt/babel in order to export code for browser
- Add a support for apache codova
- Add a support for electron
Things you could do with :
- Write a mobile application
- Write a GUI application
- Every cool stuff you could do in NodeJS
- Write an application for the browser
- Use frameworks like Vue.JS, SailsJS or Express/Koa
Things you can't do :
- Run an old application (PHP modules like PDO or lib_mysql will not be available)
- Dynamic variable name lookup like
$$var
, not sure I want to degrade overall performance in order to be able to do that - Maybe others, work is still in progress
For JS guys who cry : Don't block the loop !
PHP is synchronous, some implementations with libevent/promises was done as experiments - like react php (BTW the Hello world
demo is almost the same as NodeJS :wink:)
The main problem here is how to make run synchronous code without blocking the loop.
My answer to this would be : let I/O tasks to be run asynchrously, and execute next statement when task result is ready.
Now how to do that without breaking the structure flow, and without degrading performances ?
I will use generators and promises in order to achieve this, the resulting transpiled code will be easy to read and will perform well with a native support.
Install & Run :
npm install -g glayzzle
glz -r "echo 'hello world';"
To run a PHP file you can use the same parameter as PHP :
glz -f your-file.php
// or
glz your-file.php
You can also run a script as a server (using NodeJS cluster module)
glz -S 127.0.0.1:8080 index.php
Other planed things :
- Add a standalone FCGI support in order to run it with Apache/Ngnix
- Add a generic daemon FCGI server (something similar to php-fcgi)
Project Status :
Actually the project is a Prof Of Concept, and does not run over all PHP syntax.
Here's my todo list :
- [x] 100% - Develop a parser/lexer
- [ ] 10% - Develop a runtime
- [ ] 20% - Develop a transpiler
- [ ] 10% - Develop a compatibility layer
- [ ] 0% - Write some awesome demo
If you want to contribute, or found a typo (I'm French), fell free to contact me from my website http://glayzzle.com or from github.