@php-wasm/node

WebAssembly PHP for Node.js

This package ships WebAssembly PHP binaries and the JavaScript API optimized for Node.js. It comes with the following PHP extensions:

• SQLite
• Libzip
• Libpng
• CLI
• OpenSSL
• MySQL

It uses the host filesystem directly and can access the network if you plug in a custom WS proxy.

Here's how to use it:

import { PHP } from '@php-wasm/node';
const php = PHP.load('8.0', {
	requestHandler: {
		documentRoot: new URL('./', import.meta.url).pathname,
	},
});

// Create and run a script directly
php.writeFile('./index.php', `<?php echo "Hello " . $_POST['name']; ?>`);
await php.run({ scriptPath: './index.php' });

// Or use the familiar HTTP concepts:
const response = await php.request({
	method: 'POST',
	url: '/index.php',
	data: { name: 'John' },
});
console.log(response.text);

Attribution

@php-wasm/node started as a fork of the original PHP to WebAssembly build published by Oraoto in https://github.com/oraoto/pib and modified by Sean Morris in https://github.com/seanmorris/php-wasm.

Changelog

[v0.6.15] (2024-04-16)

Blueprints

• Add ifAlreadyInstalled to installPlugin and installTheme steps. (#1244)
• Support a landingPage value without the initial slash. (#1227)

PHP WebAssembly

• Investigate OOB: Run unit tests with instrumented PHP 8.0 code. (#1220)
• Unit tests: Restore site-data.spec.ts. (#1194)
• Web PHP: Increase memory limit to 256 M. (#1232)

Website

• Browser: Display PHP output when Fatal Error is trigerred. (#1234)
• Fix accessibility issues found by Axe. (#1246)
• Request Handler: Urldecode the requested path. (#1228)

Bug Fixes

• fix: Set required engine version to 18.18.0. (#1214)

Various

• Blueprints/json example. (#1188)
• Doc: Update 01-index.md. (#1216)
• Move DefineSiteUrlStep doc warning so it displays in documentation. (#1245)
• Updated link to native WordPress importer. (#1243)
• documentation update proposal: Provide more info on features, extensions?. (#1208)
• php-wasm/node: Update express to newest version, and move it to devDependencies. (#1218)

Contributors

The following contributors merged PRs in this release:

@adamziel @artpi @bph @brandonpayton @eliot-akira @flexseth @ironnysh @kirjavascript