php-wasm-xmlwriter 0.1.0

package/8.0.mjs

@@ -0,0 +1,13 @@
+const importMeta = import.meta;
+const url = new URL(importMeta.url ?? 'http://example.com#this-is-an-error-supression-hack');
+const ini = !!(Number(url.searchParams.get('ini') ?? true));
+
+/**
+ * Returns the shared library definitions for this package build.
+ * @returns {Array<object>} Shared library definitions for the current package version.
+ */
+export const getLibs = () => [
+	{name: 'php8.0-xmlwriter.so', url: new URL('./php8.0-xmlwriter.so', import.meta.url), ini}
+];
+
+export default {getLibs};

package/8.1.mjs

@@ -0,0 +1,13 @@
+const importMeta = import.meta;
+const url = new URL(importMeta.url ?? 'http://example.com#this-is-an-error-supression-hack');
+const ini = !!(Number(url.searchParams.get('ini') ?? true));
+
+/**
+ * Returns the shared library definitions for this package build.
+ * @returns {Array<object>} Shared library definitions for the current package version.
+ */
+export const getLibs = () => [
+	{name: 'php8.1-xmlwriter.so', url: new URL('./php8.1-xmlwriter.so', import.meta.url), ini}
+];
+
+export default {getLibs};

package/8.2.mjs

@@ -0,0 +1,13 @@
+const importMeta = import.meta;
+const url = new URL(importMeta.url ?? 'http://example.com#this-is-an-error-supression-hack');
+const ini = !!(Number(url.searchParams.get('ini') ?? true));
+
+/**
+ * Returns the shared library definitions for this package build.
+ * @returns {Array<object>} Shared library definitions for the current package version.
+ */
+export const getLibs = () => [
+	{name: 'php8.2-xmlwriter.so', url: new URL('./php8.2-xmlwriter.so', import.meta.url), ini}
+];
+
+export default {getLibs};

package/8.3.mjs

@@ -0,0 +1,13 @@
+const importMeta = import.meta;
+const url = new URL(importMeta.url ?? 'http://example.com#this-is-an-error-supression-hack');
+const ini = !!(Number(url.searchParams.get('ini') ?? true));
+
+/**
+ * Returns the shared library definitions for this package build.
+ * @returns {Array<object>} Shared library definitions for the current package version.
+ */
+export const getLibs = () => [
+	{name: 'php8.3-xmlwriter.so', url: new URL('./php8.3-xmlwriter.so', import.meta.url), ini}
+];
+
+export default {getLibs};

package/8.4.mjs

@@ -0,0 +1,13 @@
+const importMeta = import.meta;
+const url = new URL(importMeta.url ?? 'http://example.com#this-is-an-error-supression-hack');
+const ini = !!(Number(url.searchParams.get('ini') ?? true));
+
+/**
+ * Returns the shared library definitions for this package build.
+ * @returns {Array<object>} Shared library definitions for the current package version.
+ */
+export const getLibs = () => [
+	{name: 'php8.4-xmlwriter.so', url: new URL('./php8.4-xmlwriter.so', import.meta.url), ini}
+];
+
+export default {getLibs};

package/8.5.mjs

@@ -0,0 +1,13 @@
+const importMeta = import.meta;
+const url = new URL(importMeta.url ?? 'http://example.com#this-is-an-error-supression-hack');
+const ini = !!(Number(url.searchParams.get('ini') ?? true));
+
+/**
+ * Returns the shared library definitions for this package build.
+ * @returns {Array<object>} Shared library definitions for the current package version.
+ */
+export const getLibs = () => [
+	{name: 'php8.5-xmlwriter.so', url: new URL('./php8.5-xmlwriter.so', import.meta.url), ini}
+];
+
+export default {getLibs};

package/README.md

@@ -0,0 +1,39 @@
+# php-wasm-xmlwriter
+
+`php-wasm-xmlwriter` provides the `xmlwriter` extension for `php-wasm`.
+
+## Install
+
+```sh
+npm install php-wasm php-wasm-libxml php-wasm-xmlwriter
+```
+
+## What It Loads
+
+The package resolves the active runtime version to `php8.x-xmlwriter.so`.
+Load `php-wasm-libxml` alongside it when you are using XMLWriter as a shared or dynamic extension.
+
+## Usage
+
+```js
+import { PhpWeb } from 'php-wasm/PhpWeb.mjs';
+import libxml from 'php-wasm-libxml';
+import xmlwriter from 'php-wasm-xmlwriter';
+
+const php = new PhpWeb({
+  version: '8.4',
+  sharedLibs: [libxml, xmlwriter],
+});
+
+await php.run(`<?php var_dump(extension_loaded('xmlwriter'));`);
+```
+
+## Custom Builds
+
+Enable `WITH_XMLWRITER` in `.php-wasm-rc`.
+Shared and dynamic XMLWriter builds also need `WITH_LIBXML` enabled.
+
+## Build Options
+
+- `WITH_XMLWRITER`: defaults to `dynamic`. Allowed values: `0`, `1`, `static`, `dynamic`.
+- `WITH_LIBXML`: `WITH_XMLWRITER=static` requires `WITH_LIBXML=static`. `WITH_XMLWRITER=dynamic` requires libxml to be enabled in the build.

package/index.d.ts

@@ -0,0 +1,7 @@
+export type PhpRuntimeVersion = '8.0' | '8.1' | '8.2' | '8.3' | '8.4' | '8.5';
+export interface PhpVersionedRuntime { phpVersion?: PhpRuntimeVersion; }
+export interface PhpPreloadFile { url: string | URL; path?: string; parent?: string; name?: string; }
+export interface PhpSharedLibrary { name?: string; url: string | URL; ini?: boolean; getLibs?: () => PhpSharedLibrary[]; getFiles?: () => PhpPreloadFile[]; }
+export function getLibs(php: PhpVersionedRuntime): PhpSharedLibrary[];
+declare const _default: { getLibs: typeof getLibs };
+export default _default;

package/index.mjs

@@ -0,0 +1,24 @@
+import xmlwriter8_5 from './8.5.mjs';
+import xmlwriter8_4 from './8.4.mjs';
+import xmlwriter8_3 from './8.3.mjs';
+import xmlwriter8_2 from './8.2.mjs';
+import xmlwriter8_1 from './8.1.mjs';
+import xmlwriter8_0 from './8.0.mjs';
+
+const versionTable = {
+	'8.5': xmlwriter8_5,
+	'8.4': xmlwriter8_4,
+	'8.3': xmlwriter8_3,
+	'8.2': xmlwriter8_2,
+	'8.1': xmlwriter8_1,
+	'8.0': xmlwriter8_0
+};
+
+/**
+ * Returns the shared library definitions for the active PHP version.
+ * @param {object} php PHP runtime wrapper used to select the versioned package build.
+ * @returns {Array<object>} Shared library definitions for the active PHP version.
+ */
+export const getLibs = php => versionTable[php.phpVersion].getLibs();
+
+export default {getLibs};

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "php-wasm-xmlwriter",
+  "description": "xmlwriter for php-wasm.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/seanmorris/php-wasm.git"
+  },
+  "author": "Sean Morris <php-wasm@seanmorr.is>",
+  "version": "0.1.0",
+  "main": "index.mjs",
+  "types": "index.d.ts",
+  "files": [
+    "*.mjs",
+    "index.d.ts",
+    "test/basic.mjs",
+    "README.md",
+    "static.mak",
+    "*.so"
+  ]
+}

package/static.mak

@@ -0,0 +1,41 @@
+#!/usr/bin/env make
+
+DOCKER_RUN_IN_EXT_XMLWRITER =${DOCKER_ENV} -e NOCONFIGURE=1 -e EMCC_CFLAGS='-fPIC -flto -O${SUB_OPTIMIZE}' -w /src/third_party/php${PHP_VERSION}-xmlwriter/ emscripten-builder
+
+WITH_XMLWRITER?=dynamic
+
+ifeq ($(filter ${WITH_XMLWRITER},0 1 static dynamic),)
+$(error WITH_XMLWRITER MUST BE 0, 1, static, OR dynamic. WITH_XMLWRITER: '${WITH_XMLWRITER}' PLEASE CHECK YOUR SETTINGS FILE: $(abspath ${ENV_FILE}))
+endif
+
+ifeq (${WITH_XMLWRITER},1)
+WITH_XMLWRITER=dynamic
+endif
+
+ifeq (${WITH_XMLWRITER},static)
+ifeq ($(filter ${WITH_LIBXML},static),)
+$(error WITH_XMLWRITER=static REQUIRES WITH_LIBXML=static. WITH_LIBXML: '${WITH_LIBXML}' WITH_XMLWRITER: '${WITH_XMLWRITER}' PLEASE CHECK YOUR SETTINGS FILE: $(abspath ${ENV_FILE}))
+endif
+CONFIGURE_FLAGS+= --enable-xmlwriter
+TEST_LIST+=$(shell ls packages/xmlwriter/test/*.mjs)
+endif
+
+ifeq (${WITH_XMLWRITER},dynamic)
+ifeq ($(filter ${WITH_LIBXML},1 static shared dynamic),)
+$(error WITH_XMLWRITER=dynamic REQUIRES WITH_LIBXML=[static|shared]. WITH_LIBXML: '${WITH_LIBXML}' WITH_XMLWRITER: '${WITH_XMLWRITER}' PLEASE CHECK YOUR SETTINGS FILE: $(abspath ${ENV_FILE}))
+endif
+TEST_LIST+=$(shell ls packages/xmlwriter/test/*.mjs)
+EXTRA_MODULES+= packages/xmlwriter/php${PHP_VERSION}-xmlwriter.so
+endif
+
+third_party/php${PHP_VERSION}-xmlwriter/config.m4: third_party/php${PHP_VERSION}-src/patched
+	${DOCKER_RUN} cp -Lprf /src/third_party/php${PHP_VERSION}-src/ext/xmlwriter /src/third_party/php${PHP_VERSION}-xmlwriter
+
+packages/xmlwriter/php${PHP_VERSION}-xmlwriter.so: ${PHPIZE} third_party/php${PHP_VERSION}-xmlwriter/config.m4
+	${DOCKER_RUN_IN_EXT_XMLWRITER} chmod +x /src/third_party/php${PHP_VERSION}-src/scripts/phpize;
+	${DOCKER_RUN_IN_EXT_XMLWRITER} /src/third_party/php${PHP_VERSION}-src/scripts/phpize;
+	${DOCKER_RUN_IN_EXT_XMLWRITER} emconfigure ./configure PKG_CONFIG_PATH=${PKG_CONFIG_PATH} --prefix='/src/lib/php${PHP_VERSION}' --with-php-config=/src/lib/php${PHP_VERSION}/bin/php-config;
+	${DOCKER_RUN_IN_EXT_XMLWRITER} sed -i 's#-shared#-static#g' Makefile;
+	${DOCKER_RUN_IN_EXT_XMLWRITER} sed -i 's#-export-dynamic##g' Makefile;
+	${DOCKER_RUN_IN_EXT_XMLWRITER} emmake make -j${CPU_COUNT} EXTRA_INCLUDES='-I/src/third_party/php${PHP_VERSION}-src';
+	${DOCKER_RUN_IN_EXT_XMLWRITER} emcc -shared -o /src/$@ -fPIC -flto -sSIDE_MODULE=1 -O${SUB_OPTIMIZE} -Wl,--whole-archive .libs/xmlwriter.a /src/packages/libxml/libxml2.so

package/test/basic.mjs

@@ -0,0 +1,48 @@
+import { test } from 'node:test';
+import { strict as assert } from 'node:assert';
+import { PhpNode } from '../../../test/lib/PhpNode.mjs';
+import { env } from 'node:process';
+
+import libxml from 'php-wasm-libxml';
+import xmlwriter from 'php-wasm-xmlwriter';
+
+test('XMLWriter Extension is enabled. (loaded via strings)', async () => {
+	const php = env.WITH_XMLWRITER === 'dynamic'
+		? new PhpNode({sharedLibs:[
+			{ url: './packages/libxml/libxml2.so', ini: false },
+			`./packages/xmlwriter/php${process.env.PHP_VERSION ?? '8.4'}-xmlwriter.so`
+		]})
+		: new PhpNode;
+
+	let stdOut = '', stdErr = '';
+
+	php.addEventListener('output', event => event.detail.forEach(line => void (stdOut += line)));
+	php.addEventListener('error', event => event.detail.forEach(line => void (stdErr += line)));
+
+	await php.binary;
+
+	const exitCode = await php.run(`<?php var_dump(extension_loaded('xmlwriter'));`);
+
+	assert.equal(exitCode, 0);
+	assert.equal(stdOut, `bool(true)\n`);
+	assert.equal(stdErr, '');
+});
+
+test('XMLWriter Extension is enabled. (loaded via module)', async () => {
+	const php = env.WITH_XMLWRITER === 'dynamic'
+		? new PhpNode({sharedLibs:[libxml, xmlwriter]})
+		: new PhpNode;
+
+	let stdOut = '', stdErr = '';
+
+	php.addEventListener('output', event => event.detail.forEach(line => void (stdOut += line)));
+	php.addEventListener('error', event => event.detail.forEach(line => void (stdErr += line)));
+
+	await php.binary;
+
+	const exitCode = await php.run(`<?php var_dump(extension_loaded('xmlwriter'));`);
+
+	assert.equal(exitCode, 0);
+	assert.equal(stdOut, `bool(true)\n`);
+	assert.equal(stdErr, '');
+});