Initial (cleaned up) method for building the PHP WASM files

This is based on soyuka/php-wasm#7

Support for mbstring and the XML extensions will be in the next commit.

Author: derickr

.gitignore

@@ -0,0 +1,2 @@
+build/*.wasm
+build/*.js

Dockerfile

@@ -0,0 +1,76 @@
+FROM debian:bookworm as bookworm
+ARG PHP_VERSION=8.4.3
+WORKDIR /local/src
+
+# Copy SHIM source to /local/src
+COPY phpw.c /local/src/phpw.c
+
+# Apt-Install
+RUN apt-get update && \
+	apt-get --no-install-recommends -y install \
+	build-essential \
+	automake \
+	autoconf \
+	libtool \
+	pkg-config \
+	bison \
+	flex \
+	make \
+	re2c \
+	git \
+	pv \
+	ca-certificates \
+	python3
+
+# Install emscripten sdk
+RUN \
+	git clone  https://github.com/emscripten-core/emsdk.git && \
+	cd emsdk && \
+	./emsdk install latest && \
+	./emsdk activate latest
+
+# Download PHP and Set-Up Configure
+RUN \
+	git clone https://github.com/php/php-src.git php-src --branch PHP-$PHP_VERSION --single-branch --depth 1 && \
+	cd php-src && \
+	./buildconf --force
+
+# Setting ENV vars
+ENV PATH=/local/src/emsdk:/local/src/emsdk/upstream/emscripten:/usr/local/bin:/usr/bin
+ENV EMSDK=/local/src/emsdk
+ENV EMSDK_NODE=/local/src/emsdk/node/20.18.0_64bit/bin/node
+
+# Configure PHP
+RUN cd php-src && \
+	emconfigure ./configure --enable-embed=static \
+	--disable-all --without-pcre-jit --disable-fiber-asm --disable-cgi --disable-cli --disable-phpdbg \
+#	--with-libxml --enable-simplexml --enable-xml --enable-xmlreader --enable-dom \
+#	--enable-mbstring \
+	--enable-calendar --enable-ctype
+
+# Compile WASM shim
+RUN \
+	emcc -O2 -I php-src/. -I php-src/Zend -I php-src/main -I php-src/TSRM -c phpw.c -o phpw.o
+
+# Compile PHP
+RUN \
+	cd php-src && \
+	emmake make -j`nproc`
+
+# Create PHP-WASM
+RUN mkdir /build && \
+	emcc -o /build/php-$PHP_VERSION-web.mjs \
+	-O2 --llvm-lto 2 \
+	-s EXPORTED_FUNCTIONS='["_phpw", "_phpw_flush", "_phpw_exec", "_phpw_run", "_chdir", "_setenv", "_php_embed_init", "_php_embed_shutdown", "_zend_eval_string"]' \
+	-s EXPORTED_RUNTIME_METHODS='["ccall", "UTF8ToString", "lengthBytesUTF8", "FS"]' \
+	-s ENVIRONMENT=web \
+	-s MAXIMUM_MEMORY=128mb -s INITIAL_MEMORY=128mb -s ALLOW_MEMORY_GROWTH=0 \
+	-s ASSERTIONS=0 -s ERROR_ON_UNDEFINED_SYMBOLS=0 -s MODULARIZE=1 -s INVOKE_RUN=0 -s LZ4=1 -s EXPORT_ES6=1 \
+	-s EXPORT_NAME=createPhpModule \
+	phpw.o php-src/.libs/libphp.a \
+#	../install/lib/libxml2.a ../install/lib/libonig.a \
+	php-src/.libs/libphp.a
+
+# Save file
+FROM scratch
+COPY --from=bookworm /build/ .

README.rst

@@ -0,0 +1,39 @@
+PHP WASM Builder
+================
+
+The Dockerfile in this repository builds the PHP WASM files for use in the
+documentation, and the PHP Tour.
+
+You can build them, by running the following command::
+
+	docker buildx bake
+
+The builds will then up in the ``build/`` directory. These two files then need
+to be copied to https://github.com/php/web-php.git/js (as ``php-web.wasm`` and
+``php-web.mjs``)
+
+By default, this will build PHP 8.4.3, but you can override this by setting an
+argument::
+
+	docker buildx bake --set default.args.PHP_VERSION=8.3.16
+
+Supported Extensions
+--------------------
+
+- Core
+- calendar
+- ctype
+- date
+- dom
+- hash
+- json
+- libxml
+- mbstring
+- pcre
+- random
+- Reflection
+- SimpleXML
+- SPL
+- standard
+- xml
+- xmlreader

docker-bake.hcl

@@ -0,0 +1,4 @@
+target "default" {
+	output = ["type=local,dest=./build"]
+	tags = ["php-wasm"]
+}

phpw.c

@@ -0,0 +1,111 @@
+/**
+ * Copyright (c) 2025 The PHP Foundation
+ * Copyright (c) 2023-2024 Antoine Bluchet
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a
+ * copy of this software and associated documentation files (the "Software"),
+ * to deal in the Software without restriction, including without limitation
+ * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+ * and/or sell copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+ * DEALINGS IN THE SOFTWARE.
+ */
+#include "sapi/embed/php_embed.h"
+#include <emscripten.h>
+#include <stdlib.h>
+
+#include "zend_globals_macros.h"
+#include "zend_exceptions.h"
+#include "zend_closures.h"
+
+int main() {
+	return 0;
+}
+
+void phpw_flush()
+{
+	fprintf(stdout, "\n");
+	fprintf(stderr, "\n");
+}
+
+char *EMSCRIPTEN_KEEPALIVE phpw_exec(char *code)
+{
+	setenv("USE_ZEND_ALLOC", "0", 1);
+	php_embed_init(0, NULL);
+	char *retVal = NULL;
+
+	zend_try
+	{
+		zval ret_zv;
+
+		zend_eval_string(code, &ret_zv, "expression");
+		convert_to_string(&ret_zv);
+
+		retVal = Z_STRVAL(ret_zv);
+	} zend_catch {
+	} zend_end_try();
+
+	phpw_flush();
+	php_embed_shutdown();
+
+	return retVal;
+}
+
+void EMSCRIPTEN_KEEPALIVE phpw_run(char *code)
+{
+	setenv("USE_ZEND_ALLOC", "0", 1);
+	php_embed_init(0, NULL);
+
+	zend_try
+	{
+		zend_eval_string(code, NULL, "script");
+		if (EG(exception)) {
+			zend_exception_error(EG(exception), E_ERROR);
+		}
+	} zend_catch {
+		/* int exit_status = EG(exit_status); */
+	} zend_end_try();
+
+	phpw_flush();
+	php_embed_shutdown();
+}
+
+int EMBED_SHUTDOWN = 1;
+
+void phpw(char *file)
+{
+	setenv("USE_ZEND_ALLOC", "0", 1);
+	if (EMBED_SHUTDOWN == 0) {
+		php_embed_shutdown();
+	}
+
+	php_embed_init(0, NULL);
+	EMBED_SHUTDOWN = 0;
+	zend_first_try {
+		zend_file_handle file_handle;
+		zend_stream_init_filename(&file_handle, file);
+		// file_handle.primary_script = 1;
+
+		if (!php_execute_script(&file_handle)) {
+			php_printf("Failed to execute PHP script.\n");
+		}
+
+		zend_destroy_file_handle(&file_handle);
+	} zend_catch {
+		/* int exit_status = EG(exit_status); */
+	} zend_end_try();
+
+	phpw_flush();
+	php_embed_shutdown();
+	EMBED_SHUTDOWN = 1;
+}