Code Monkey home page Code Monkey logo

pib's Introduction

PIB: PHP in Browser (and Node.js) aka php-wasm

php-wasm Apache-2.0 Licence Badge

CircleCI Size

v0.0.4 - Revisiting.

changelog

Examples

Getting Started

Install with npm:

$ npm install php-wasm

Static Assets:

You'll need to add the following postinstall script entry to your package.json to ensure the static assets are available to your web application. Make sure to replace public/ with the path to your public document root if necessary.

{
  "scripts": {
    "postinstall": [
      "cp node_modules/php-wasm/php-web.* public/"
    ]
  },
}

If you're using a more advanced bundler, use the vendor's documentation to learn how to move the files matching the following pattern to your public directory:

./node_modules/php-wasm/php-web.*

Usage

Using php-wasm is easy.

Automatic

Once the library is included in the page, you can run PHP right from a script tag! The src attribute is also supported for non-inline scripts.

<script type = "text/php">
	<?php vrzno_run('alert', ['Hello, world!']);
</script>

Manual

First, grab an instance of the object:

const PHP = require('php-wasm/PhpWeb').PhpWeb;
const php = new PHP;

or, in es6:

import { PhpWeb as PHP } from 'php-wasm/PhpWeb';
const php = new PHP;

Then, add an output listener:

php.addEventListener('output', (event) => {
	console.log(event.detail);
});

Be sure to wait until your WASM is fully loaded, then run some PHP:

php.addEventListener('ready', () => {
	php.run('<?php echo "Hello, world!";');
});

Get the result code of your script with then():

php.addEventListener('ready', () => {
	php.run('<?php echo "Hello, world!";').then(retVal => {
		// retVal contains the return code.
	});
});

Persistent Memory

So long as php.refresh() is not called from Javascript, the instance will maintain its own persistent memory.

<?php
// Run this over and over again...
print ++$x;

See the example in action here

Accessing the DOM

The DOM may be accessed via the VRZNO php extension. This is specially for the browser allowing PHP to access Javascript via a C api. It comes preinstalled with php-wasm.

See the example in action here

// Show an alert with vrzno_run. Note the second param is an array of args.
vrzno_run('alert', ['Hello, World!']);

$oldTitle = NULL;
$newTitle = 'Changed@' . date('h:i:s');

// Grab the current title.
$oldTitle = vrzno_eval('document.title');

// Change the document title.
vrzno_eval('document.title = "' . $newTitle . '"' );

php-wasm is a fork of oraoto/PIB...

Run PIB

Firefox is recommended for better user experience.

Building From Source

Using Docker

The quickest way to build PIB is by using Make & Docker. Simply issue the make command after checking out the repo, and it will build.

make

Using Emscripten SDK (emsdk) manually

Steps:

  • Setup emsdk (>= 1.38.11), see Installation Instructions
  • Run bash configure.sh
  • Run bash build-objects.sh
  • Run bash build.sh to build the web binary

Acknowledgements

  • php-wasm and makefile contributed by @seanmorris
  • The Web UI is based on Rust Playground.

pib's People

Contributors

assertchris avatar boyanio avatar marclaporte avatar matyo91 avatar mvorisek avatar oraoto avatar sasezaki avatar seanmorris avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.