elevenways/doen

Introduction

Have you ever needed to use the functionality of a node.js package in your PHP project, but don't want to spend hours writing a wrapper? Well now you can.

Thanks to ReactPHP it was quite a simple script to get working.

Installation

Installation is easy via Composer:

Or you can add it manually to your composer.json file.

Usage

Simple require() example

API

Doen

new Doen(\React\EventLoop\LoopInterface $loop, array $options = [])

Create a new Doen instance, which always creates a new Node.js instance too.

By default it'll use the node binary, but this can be overridden with the node_path option.

require(string $name) ⇒ \Elevenways\Doen\Reference

Require a node.js module and return a reference to it.

evaluate(string $code) ⇒ \React\Promise\Promise

Execute an expression and return its value.

evaluateFunction(string $function, $args = []) ⇒ \React\Promise\Promise

Execute a function with the supplied arguments and return its value.

evaluateToRef(string $code, $args = null) ⇒ \Elevenways\Doen\Reference

Execute an expression or a function and return a reference to its value.

close() ⇒ void

Close the node.js process

Reference

getValue(callable $on_fulfilled = null, callable $on_rejected = null) ⇒ \React\Promise\Promise

Get the actual value of the reference

then(callable $on_fulfilled = null, callable $on_rejected = null) ⇒ \React\Promise\Promise

Execute the callables when this reference resolves. It will not resolve to its value, but to its type for primitives and to its class for objects.

__monkeyPatch($method_name, Closure $fnc) ⇒ void

Add a method to this instance on-the-fly

Contributing

Contributions are REALLY welcome. Please check the contributing guidelines for more details. Thanks!

Authors

• Jelle De Loecker - Follow me on Github (:octocat:@skerit) and on Twitter (🐦@skeriten)

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE file for details.