Using PHP Extensions

There are two ways to load extensions at runtime, using the dl() function or php.ini. The following code will attempt to load the .so files from the same directory the main WASM binary was loaded from, unless further configuration is provided.

<?php
dl('php-8.3-xml.so');
dl('php-8.3-dom.so');

You can also pass an array as the extensions argument to the constructor from Javascript to automatically generate an ini file that loads your extensions.

const php = new PhpWeb({sharedLibs: [
    `php8.3-xml.so`,
    `php8.3-dom.so`,
]});

The class used to load PHP (PhpWeb here) implements a phpVersion property to ensure libs can be loaded for any compatible version:

const php = new PhpWeb({sharedLibs: [
    `php${PhpWeb.phpVersion}-xml.so`,
    `php${PhpWeb.phpVersion}-dom.so`,
]});

Dynamic Extensions from Remote Servers

You can also load extensions from remote servers with URLs:

const php = new PhpWeb({sharedLibs: [`https://unpkg.com/php-wasm-phar/php8.3-phar.so`]});

The above is shorthand for the following code. Passing ini: true will automatically load the extension via /php.ini, passing ini: false will wait for a call to dl() to do the lookup.

const php = new PhpWeb({sharedLibs: [
    {
        name: `php8.3-phar.so`,
        url:  `https://unpkg.com/php-wasm-phar/php8.3-phar.so`,
        ini:  true,
    }
]});

Strings starting with /, ./, http:// or https:// will be treated as URLs:

const php = new PhpWeb({sharedLibs: [
    `./php8.3-phar.so`
]});

Some extensions require supporting libraries. You can provide URLs for those as sharedLibs as well, just pass ini: false:

(name is implied to be the last section of the URL here.)

const php = new PhpWeb({sharedLibs: [
    { url: 'https://unpkg.com/php-wasm-sqlite/php8.3-sqlite.so', ini: true  },
    { url: 'https://unpkg.com/php-wasm-sqlite/sqlite.so',        ini: false },
]});

Loading Dynamic Extensions as JS Modules:

Dynamic extensions can be loaded as modules.

So long as the main file of the module defines the getLibs and getFiles methods, extensions may be loaded like so:

new PhpNode({sharedLibs:[ await import('php-wasm-intl') ]})

Dynamic extensions can also be loaded as modules from any static HTTP server with an ESM directory structure.

// This will load both sqlite.so & php8.x-sqlite.so:
const php = new PhpWeb({sharedLibs: [ await import('https://cdn.jsdelivr.net/npm/php-wasm-sqlite') ]});

Unfortunately, this notation is not available for Service Workers, as they do not yet support dynamic imports(). Hopefully this will change soon.

Extension List

The following extensions may be loaded at runtime. This allows the shared extensions and their dependencies to be cached, reused, and selected à la carte for each application

Using PHP Extensions

Dynamic Extensions from Remote Servers

Loading Dynamic Extensions as JS Modules:

Extension List

gd

iconv

intl

xml

dom

simplexml

yaml

zip

mbstring

openssl

phar

sqlite

pdo-sqlite

zlib