├── .github
    ├── FUNDING.yml
    └── workflows
    │   ├── ci.yml
    │   └── demo.yml
├── demo
    ├── src
    │   └── index.php
    ├── .gitignore
    └── public
    │   └── index.html
├── .gitignore
├── .env
├── docker-bake.hcl
├── .editorconfig
├── NOTICE
├── LICENSE
├── CHANGELOG.md
├── source
    └── phpw.c
├── Dockerfile
└── README.md


/.github/FUNDING.yml:
--------------------------------------------------------------------------------
1 | github: [soyuka]
2 | 


--------------------------------------------------------------------------------
/demo/src/index.php:
--------------------------------------------------------------------------------
1 | <?php
2 | phpinfo();
3 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | build
2 | lib
3 | third_party
4 | 


--------------------------------------------------------------------------------
/.env:
--------------------------------------------------------------------------------
1 | UID=1000
2 | EMCC_CORES=8
3 | ENVIRONMENT=${ENVIRONMENT:-web}
4 | 


--------------------------------------------------------------------------------
/docker-bake.hcl:
--------------------------------------------------------------------------------
1 | target "default" {
2 | 	output = ["type=local,dest=./build"]
3 | 	tags = ["php-wasm"]
4 | }
5 | 


--------------------------------------------------------------------------------
/demo/.gitignore:
--------------------------------------------------------------------------------
1 | dist/
2 | public/php-web.data
3 | public/php-web.data.js
4 | public/php-web.mjs
5 | public/php-web.wasm
6 | 


--------------------------------------------------------------------------------
/.editorconfig:
--------------------------------------------------------------------------------
 1 | [*]
 2 | trim_trailing_whitespace = true
 3 | insert_final_newline     = true
 4 | indent_style             = tab
 5 | indent_size              = 4
 6 | end_of_line              = lf
 7 | charset                  = utf-8
 8 | 
 9 | [*.{yml,yaml}]
10 | trim_trailing_whitespace = true
11 | insert_final_newline     = true
12 | indent_style             = space
13 | indent_size              = 2
14 | end_of_line              = lf
15 | charset                  = utf-8
16 | 
17 | 


--------------------------------------------------------------------------------
/.github/workflows/ci.yml:
--------------------------------------------------------------------------------
 1 | name: Build Docker image
 2 | on:
 3 |   pull_request:
 4 |     branches:
 5 |       - main
 6 | jobs:
 7 |   build:
 8 |     runs-on: ubuntu-latest
 9 |     steps:
10 |       -
11 |         name: Checkout
12 |         uses: actions/checkout@v4
13 |       -
14 |         name: Build and push
15 |         uses: docker/build-push-action@v5
16 |         with:
17 |           context: .
18 |           push: false
19 |           tags: soyuka/php-wasm:latest
20 |           cache-from: type=registry,ref=soyuka/php-wasm:latest
21 |           cache-to: type=inline
22 | 


--------------------------------------------------------------------------------
/NOTICE:
--------------------------------------------------------------------------------
 1 | php-wasm aka PIB
 2 | 
 3 | Copyright 2018-2020 Oraoto
 4 | Copyright 2019-2020 Sean Morris
 5 | 
 6 | Licensed under the Apache License, Version 2.0 (the "License");
 7 | you may not use this file except in compliance with the License.
 8 | You may obtain a copy of the License at
 9 | 
10 | http://www.apache.org/licenses/LICENSE-2.0
11 | 
12 | Copyright (c) 2020 soyuka 
13 | 
14 | Licensed under the MIT License
15 | Makefile and source/ under Apache License, Version 2.0
16 | 
17 | Unless required by applicable law or agreed to in writing, software
18 | distributed under the License is distributed on an "AS IS" BASIS,
19 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
20 | See the License for the specific language governing permissions and
21 | limitations under the License.
22 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | Copyright (c) 2020 soyuka
 2 | Copyright (c) 2019-2020 seanmorris (Makefile and source/) under Apache2 License https://github.com/seanmorris/php-wasm)
 3 | Copyright (c) 2018 Oraoto
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy
 6 | of this software and associated documentation files (the "Software"), to deal
 7 | in the Software without restriction, including without limitation the rights
 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 | 
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 | 
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 | 


--------------------------------------------------------------------------------
/demo/public/index.html:
--------------------------------------------------------------------------------
 1 | <iframe id="output" width="100%" height="50%" frameBorder="0"></iframe>
 2 | <script type="module">
 3 | 	import phpBinary from "./php-web.mjs";
 4 | 
 5 | 	async function main() {
 6 | 		const output = document.getElementById('output')
 7 | 		const buffer = [];
 8 | 		const {ccall, FS} = await phpBinary({
 9 | 			print(data) {
10 | 				buffer.push(data);
11 | 			}
12 | 		})
13 | 
14 | 		console.log(ccall("phpw_exec", "string", ["string"], ["phpversion();"]));
15 | 
16 | 		window.FS = FS;
17 | 		window.run = () => {
18 | 			// Note that `/src` is the path we used when preloading!
19 | 			ccall("phpw", null, ["string"], ["/src/index.php"]);
20 | 			output.contentWindow.document.body.innerHTML = buffer.join('');
21 | 			buffer.length = 0;
22 | 		}
23 | 
24 | 		run();
25 | 	}
26 | 
27 | 	main();
28 | </script>
29 | <div id="monaco" style="min-height: 100px"></div>
30 | <script type="module">
31 | 	import * as monaco from 'https://cdn.jsdelivr.net/npm/monaco-editor@0.39.0/+esm';
32 | 	const editor = monaco.editor.create(document.getElementById('monaco'));
33 | 	// FS is documented at https://emscripten.org/docs/api_reference/Filesystem-API.html
34 | 	// everything is synchronous
35 | 	const model = editor.getModel();
36 | 	model.setLanguage('php');
37 | 	model.setValue(window.FS.readFile('/src/index.php', {encoding: 'utf8'}).toString());
38 | 	model.onDidChangeContent((v) => {
39 | 		window.FS.unlink('/src/index.php')
40 | 		window.FS.writeFile('/src/index.php', model.getValue());
41 | 		window.run();
42 | 	});
43 | </script>
44 | 


--------------------------------------------------------------------------------
/CHANGELOG.md:
--------------------------------------------------------------------------------
 1 | # php-wasm aka PIB
 2 | 
 3 | Changes
 4 | 
 5 | ## 0.0.3 - New Horizons
 6 | 
 7 | * php.exec() may be used to evaluate a single php expression & return its result.
 8 | * php may now access & traverse the dom and access nodes.
 9 | * The querySelector method is available on dom nodes.
10 | * addEventListener/removeEventListener is also available on dom nodes.
11 | * sqlite3 v3.33 is now statically linked to php & the sqlite3 extension is enabled.
12 | * The following extensions are now enabled: sqlite3, pdo, & pdo-sqlite.
13 | * Totally revamped build process that tracks build artifact relationships.
14 | * Builds for web, node, shell, worker & webview.
15 | 
16 | ## 0.0.2 - Gaining Momentum
17 | 
18 | * php objects now have persistent memory, may be cleared with `php.refresh();`.
19 | * php code may now access Javascript (and thus, the DOM) via the [VRZNO](https://github.com/seanmorris/vrzno) project. The extension is preinstalled with php-wasm.
20 | * `<script type = "text/php">` tags are now supported, both inline and with `src=...`. Both require opening tags as of now.
21 | * Building of object files is now separated from building of binary files so multiple binaries may be built from the same set of objects.
22 | * License changed from MIT to Apache-2.0, which has similar terms, but USERS must have visibility of the attribution, rather that just DEVELOPERS.
23 | * Build dependencies are now expressed in the makefile
24 | * Project can be built in its entirety by running `make`.
25 | * Ensuring newlines in PHP output are respected.
26 | 
27 | 
28 | ## 0.0.1 - Humble Beginnings
29 | 
30 | * Event-oriented interface added to php object.
31 | * Buildscript was slightly improved with a makefile
32 | 


--------------------------------------------------------------------------------
/source/phpw.c:
--------------------------------------------------------------------------------
 1 | #include "sapi/embed/php_embed.h"
 2 | #include <emscripten.h>
 3 | #include <stdlib.h>
 4 | 
 5 | #include "zend_globals_macros.h"
 6 | #include "zend_exceptions.h"
 7 | #include "zend_closures.h"
 8 | 
 9 | int main() {
10 |   return 0;
11 | }
12 | 
13 | void phpw_flush()
14 | {
15 |   fprintf(stdout, "\n");
16 |   fprintf(stderr, "\n");
17 | }
18 | 
19 | char *EMSCRIPTEN_KEEPALIVE phpw_exec(char *code)
20 | {
21 |   // This sets USE_ZEND_ALLOC=0 to avoid nunmap errors
22 |   setenv("USE_ZEND_ALLOC", "0", 1);
23 |   php_embed_init(0, NULL);
24 |   char *retVal = NULL;
25 | 
26 |   zend_try
27 |   {
28 |     zval retZv;
29 | 
30 |     zend_eval_string(code, &retZv, "php-wasm evaluate expression");
31 | 
32 |     convert_to_string(&retZv);
33 | 
34 |     retVal = Z_STRVAL(retZv);
35 |   } zend_catch {
36 |   } zend_end_try();
37 | 
38 |   phpw_flush();
39 |   php_embed_shutdown();
40 | 
41 |   return retVal;
42 | }
43 | 
44 | void EMSCRIPTEN_KEEPALIVE phpw_run(char *code)
45 | {
46 |   setenv("USE_ZEND_ALLOC", "0", 1);
47 |   php_embed_init(0, NULL);
48 |   zend_try
49 |   {
50 |     zend_eval_string(code, NULL, "php-wasm run script");
51 |     if(EG(exception))
52 |     {
53 |       zend_exception_error(EG(exception), E_ERROR);
54 |     }
55 |   } zend_catch {
56 |     /* int exit_status = EG(exit_status); */
57 |   } zend_end_try();
58 | 
59 |   phpw_flush();
60 |   php_embed_shutdown();
61 | }
62 | 
63 | int EMBED_SHUTDOWN = 1;
64 | 
65 | void phpw(char *file)
66 | {
67 |   setenv("USE_ZEND_ALLOC", "0", 1);
68 |   if (EMBED_SHUTDOWN == 0) {
69 | 	  php_embed_shutdown();
70 |   }
71 | 
72 |   php_embed_init(0, NULL);
73 |   EMBED_SHUTDOWN = 0;
74 |   zend_first_try {
75 |     zend_file_handle file_handle;
76 |     zend_stream_init_filename(&file_handle, file);
77 |     // file_handle.primary_script = 1;
78 | 
79 |     if (php_execute_script(&file_handle) == FAILURE) {
80 |       php_printf("Failed to execute PHP script.\n");
81 |     }
82 | 
83 |     zend_destroy_file_handle(&file_handle);
84 |   } zend_catch {
85 |     /* int exit_status = EG(exit_status); */
86 |   } zend_end_try();
87 | 
88 |   phpw_flush();
89 |   php_embed_shutdown();
90 |   EMBED_SHUTDOWN = 1;
91 | }
92 | 


--------------------------------------------------------------------------------
/.github/workflows/demo.yml:
--------------------------------------------------------------------------------
 1 | # Simple workflow for deploying static content to GitHub Pages
 2 | name: Deploy static content to Pages
 3 | 
 4 | on:
 5 |   # Runs on pushes targeting the default branch
 6 |   push:
 7 |     branches: ["main"]
 8 | 
 9 |   # Allows you to run this workflow manually from the Actions tab
10 |   workflow_dispatch:
11 | 
12 | # Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
13 | permissions:
14 |   contents: read
15 |   pages: write
16 |   id-token: write
17 | 
18 | # Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
19 | # However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
20 | concurrency:
21 |   group: "pages"
22 |   cancel-in-progress: true
23 | 
24 | jobs:
25 |   # Single deploy job since we're just deploying
26 |   deploy:
27 |     environment:
28 |       name: github-pages
29 |       url: ${{ steps.deployment.outputs.page_url }}
30 |     runs-on: ubuntu-latest
31 |     steps:
32 |       - name: Checkout
33 |         uses: actions/checkout@v3
34 |       -
35 |         name: Set up Docker Buildx
36 |         uses: docker/setup-buildx-action@v3
37 |       -
38 |         name: Login to Docker Hub
39 |         uses: docker/login-action@v3
40 |         with:
41 |           username: ${{ secrets.DOCKERHUB_USERNAME }}
42 |           password: ${{ secrets.DOCKERHUB_TOKEN }}
43 |       -
44 |         name: Build PHP WASM
45 |         uses: docker/build-push-action@v5
46 |         with:
47 |           context: .
48 |           push: true
49 |           tags: soyuka/php-wasm:latest
50 |           cache-from: type=registry,ref=soyuka/php-wasm:latest
51 |           cache-to: type=inline
52 |       - name: Setup Pages
53 |         uses: actions/configure-pages@v3
54 |       - name: Build website
55 |         working-directory: demo
56 |         run: |
57 |           docker create --name=php-wasm docker.io/soyuka/php-wasm:latest
58 |           mkdir -p public/ dist/
59 |           docker cp php-wasm:/build/php-web.mjs ./dist
60 |           docker cp php-wasm:/build/php-web.wasm ./public
61 |           docker run -v $(pwd)/src:/src -v $(pwd)/public:/public -v $(pwd)/dist:/dist docker.io/soyuka/php-wasm:latest python3 /emsdk/upstream/emscripten/tools/file_packager.py /public/php-web.data --use-preload-cache --lz4 --preload "/src" --js-output=/dist/php-web.data.js --no-node --exclude '*/.*' --export-name=createPhpModule
62 |           sed '/--pre-js/r dist/php-web.data.js' dist/php-web.mjs > public/php-web.mjs
63 |       - name: Upload artifact
64 |         uses: actions/upload-pages-artifact@v2
65 |         with:
66 |           path: 'demo/public'
67 |       - name: Deploy to GitHub Pages
68 |         id: deployment
69 |         uses: actions/deploy-pages@v2
70 | 


--------------------------------------------------------------------------------
/Dockerfile:
--------------------------------------------------------------------------------
  1 | FROM emscripten/emsdk:3.1.35 as build_tool
  2 | 
  3 | RUN apt-get update && \
  4 |   apt-get --no-install-recommends -y install \
  5 |     build-essential \
  6 |     automake \
  7 |     autoconf \
  8 |     libtool \
  9 |     pkgconf \
 10 |     python3 \
 11 |     bison \
 12 |     flex \
 13 |     make \
 14 |     re2c \
 15 |     gdb \
 16 |     git \
 17 |     libxml2 \
 18 |     libxml2-dev \
 19 |     pv \
 20 |     re2c
 21 | 
 22 | FROM build_tool AS libxml
 23 | ARG LIBXML2_TAG=v2.9.10
 24 | RUN git clone https://gitlab.gnome.org/GNOME/libxml2.git libxml2 \
 25 | 		--branch $LIBXML2_TAG \
 26 | 		--single-branch     \
 27 | 		--depth 1
 28 | WORKDIR /src/libxml2
 29 | RUN ./autogen.sh
 30 | RUN emconfigure ./configure --prefix=/src/libxml2/build --enable-static --disable-shared --with-python=no --with-threads=no
 31 | RUN emmake make -j8
 32 | RUN emmake make install
 33 | 
 34 | FROM build_tool AS sqlite
 35 | RUN wget https://sqlite.org/2020/sqlite-amalgamation-3330000.zip \
 36 |         && unzip sqlite-amalgamation-3330000.zip \
 37 |         && rm sqlite-amalgamation-3330000.zip \
 38 |         && mv sqlite-amalgamation-3330000 sqlite
 39 | WORKDIR /src/sqlite
 40 | RUN emcc -Oz -DSQLITE_OMIT_LOAD_EXTENSION -DSQLITE_DISABLE_LFS -DSQLITE_ENABLE_FTS3 -DSQLITE_ENABLE_FTS3_PARENTHESIS -DSQLITE_THREADSAFE=0 -DSQLITE_ENABLE_NORMALIZE -c sqlite3.c -o sqlite3.o
 41 | 
 42 | FROM build_tool as php_src
 43 | ARG PHP_BRANCH=PHP-8.3.0
 44 | RUN git clone https://github.com/php/php-src.git php-src \
 45 | 		--branch $PHP_BRANCH \
 46 | 		--single-branch \
 47 | 		--depth 1
 48 | 
 49 | FROM php_src AS php-wasm
 50 | ARG WASM_ENVIRONMENT=web
 51 | ARG JAVASCRIPT_EXTENSION=mjs
 52 | ARG EXPORT_NAME=createPhpModule
 53 | ARG MODULARIZE=1
 54 | ARG EXPORT_ES6=1
 55 | ARG ASSERTIONS=0
 56 | ARG OPTIMIZE=-O1
 57 | # TODO: find a way to keep this, it can't be empty if defined...
 58 | # ARG PRE_JS=
 59 | ARG INITIAL_MEMORY=256mb
 60 | COPY --from=libxml /src/libxml2/build/ /src/usr
 61 | COPY --from=sqlite /src/sqlite/sqlite3.o /src/usr/lib/
 62 | COPY --from=sqlite /src/sqlite/sqlite3.h /src/usr/include/sqlite3/
 63 | ENV LIBXML_LIBS "-L/src/usr/lib"
 64 | ENV LIBXML_CFLAGS "-I/src/usr/include/libxml2"
 65 | ENV SQLITE_CFLAGS "-I/src/usr/include/sqlite3"
 66 | ENV SQLITE_LIBS "-L/src/usr/lib"
 67 | RUN cd /src/php-src && ./buildconf --force \
 68 |     && emconfigure ./configure \
 69 | 		--enable-embed=static \
 70 | 		--with-layout=GNU  \
 71 | 		--with-libxml      \
 72 | 		--enable-xml       \
 73 | 		--disable-cgi      \
 74 | 		--disable-cli      \
 75 | 		--disable-fiber-asm \
 76 | 		--disable-all      \
 77 | 		--enable-session   \
 78 | 		--enable-filter    \
 79 | 		--enable-calendar  \
 80 | 		--enable-dom       \
 81 | 		--disable-rpath    \
 82 | 		--disable-phpdbg   \
 83 | 		--without-pear     \
 84 | 		--with-valgrind=no \
 85 | 		--without-pcre-jit \
 86 | 		--enable-bcmath    \
 87 | 		--enable-json      \
 88 | 		--enable-ctype     \
 89 | 		--enable-mbstring  \
 90 | 		--disable-mbregex  \
 91 | 		--with-config-file-scan-dir=/src/php  \
 92 | 		--enable-tokenizer \
 93 | 		--enable-simplexml   \
 94 | 		--enable-pdo       \
 95 | 		--with-pdo-sqlite  \
 96 | 		--with-sqlite3
 97 | RUN cd /src/php-src && emmake make -j8
 98 | # PHP7 outputs a libphp7 whereas php8 a libphp
 99 | RUN cd /src/php-src && bash -c '[[ -f .libs/libphp7.la ]] && mv .libs/libphp7.la .libs/libphp.la && mv .libs/libphp7.a .libs/libphp.a && mv .libs/libphp7.lai .libs/libphp.lai || exit 0'
100 | COPY ./source /src/source
101 | RUN cd /src/php-src && emcc $OPTIMIZE \
102 | 		-I .     \
103 | 		-I Zend  \
104 | 		-I main  \
105 | 		-I TSRM/ \
106 | 		-c \
107 | 		/src/source/phpw.c \
108 | 		-o /src/phpw.o \
109 | 		-s ERROR_ON_UNDEFINED_SYMBOLS=0
110 | RUN mkdir /build && cd /src/php-src && emcc $OPTIMIZE \
111 | 	-o /build/php-$WASM_ENVIRONMENT.$JAVASCRIPT_EXTENSION \
112 | 	--llvm-lto 2                     \
113 | 	-s EXPORTED_FUNCTIONS='["_phpw", "_phpw_flush", "_phpw_exec", "_phpw_run", "_chdir", "_setenv", "_php_embed_init", "_php_embed_shutdown", "_zend_eval_string"]' \
114 | 	-s EXTRA_EXPORTED_RUNTIME_METHODS='["ccall", "UTF8ToString", "lengthBytesUTF8", "FS"]' \
115 | 	-s ENVIRONMENT=$WASM_ENVIRONMENT    \
116 | 	-s FORCE_FILESYSTEM=1            \
117 | 	-s MAXIMUM_MEMORY=2gb             \
118 | 	-s INITIAL_MEMORY=$INITIAL_MEMORY \
119 | 	-s ALLOW_MEMORY_GROWTH=1         \
120 | 	-s ASSERTIONS=$ASSERTIONS      \
121 | 	-s ERROR_ON_UNDEFINED_SYMBOLS=0  \
122 | 	-s MODULARIZE=$MODULARIZE        \
123 | 	-s INVOKE_RUN=0                  \
124 | 	-s LZ4=1                  \
125 | 	-s EXPORT_ES6=$EXPORT_ES6 \
126 | 	-s EXPORT_NAME=$EXPORT_NAME \
127 | 	# -s DECLARE_ASM_MODULE_EXPORTS=0 \
128 | 	-lidbfs.js                       \
129 | 		/src/phpw.o /src/usr/lib/sqlite3.o .libs/libphp.a /src/usr/lib/libxml2.a
130 | RUN rm -r /src/*
131 | 
132 | FROM scratch
133 | COPY --from=php-wasm /build/ .
134 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | # WASM PHP
  2 | 
  3 | Project based on https://github.com/seanmorris/php-wasm which was forked from https://github.com/oraoto/pib
  4 | 
  5 | I fixed some inconsistencies in the Makefile and removed non-essential things. This fork:
  6 |   - builds sqlite3
  7 |   - builds libxml
  8 |   - no javascript abstraction
  9 |   - exposes FS and builds with [IDBFS](https://emscripten.org/docs/api_reference/Filesystem-API.html#FS.syncfs)
 10 |   - does not build https://github.com/seanmorris/vrzno which allows javascript access from PHP (TODO add this back opt-in cause it's really cool)
 11 |   - does not add preloaded data, having this separatly from php-wasm builds allows for more flexibility (see [preload data section](#preload-data))
 12 | 
 13 | ## Build
 14 | 
 15 | ```
 16 | docker buildx bake
 17 | ```
 18 | 
 19 | Builded files will be located in `build/php-web.js` and `build/php-web.wasm`.
 20 | The module we export in this image is called `createPhpModule`.
 21 | 
 22 | ### Build arguments
 23 | 
 24 | Use this as template to build PHP with emscripten. At build these arguments are available:
 25 | 
 26 | ```console
 27 | LIBXML2_TAG=v2.9.10
 28 | PHP_BRANCH=PHP-8.3.0
 29 | ```
 30 | 
 31 | The next args are used for [emcc options](https://github.com/soyuka/php-wasm/blob/513f284e1ba8f26d66e08a97291f484b3dd7de1b/Dockerfile#L108) `-sOPTION`
 32 | see [settings.js](https://github.com/emscripten-core/emscripten/blob/9bdb310b89472a0f4d64f36e4a79273d8dc7fa98/src/settings.js#L633).
 33 | In fact it's even easier for you to set them directly in [the Dockerfile](https://github.com/soyuka/php-wasm/blob/513f284e1ba8f26d66e08a97291f484b3dd7de1b/Dockerfile#L108).
 34 | 
 35 | ```console
 36 | WASM_ENVIRONMENT=web
 37 | ASSERTIONS=0
 38 | OPTIMIZE=-O2
 39 | INITIAL_MEMORY=256mb
 40 | JAVASCRIPT_EXTENSION=mjs # change by js if needed
 41 | MODULARIZE=1
 42 | EXPORT_ES6=1
 43 | EXPORT_NAME=createPhpModule
 44 | ```
 45 | 
 46 | ### Preload data
 47 | 
 48 | My preferred option is to use the [`file_packager`](https://github.com/emscripten-core/emscripten/blob/9bdb310b89472a0f4d64f36e4a79273d8dc7fa98/tools/file_packager) tool to build the preloaded data in a `php-web.data.js` (and `php-web.data` file). These are preloaded into IDBFS. That can be changed changing the `-lidbfs.js` argument to `emcc`.
 49 | 
 50 | This will preload `SOME_DIR` into the `/src` directory inside the WASM filesystem:
 51 | 
 52 | ```
 53 | mkdir -p php-wasm
 54 | docker run -v SOME_DIR:/src -v $(pwd)/php-wasm:/dist -w /dist soyuka/php-wasm:8.2.9 python3 /emsdk/upstream/emscripten/tools/file_packager.py php-web.data --use-preload-cache --lz4 --preload "/src" --js-output=php-web.data.js --no-node --exclude '*/.*' --export-name=createPhpModule
 55 | ls php-wasm/
 56 | ```
 57 | 
 58 | Note that the `php-web.data.js` must be either used as `PRE_JS` argument to emcc or it needs to be included inside the `php-web.js`:
 59 | 
 60 | ```
 61 | sed '/--pre-js/r php-wasm/php-web.data.js' php-wasm/php-web.mjs > this-has-preloaded-data-php-web.mjs
 62 | ```
 63 | 
 64 | We match the `export-name` with the emcc `EXPORT_NAME` option. Use excludes to downsize the preloaded data weight.
 65 | 
 66 | ## Usage
 67 | 
 68 | To execute some php, call `phpw_exec` using [`ccall`](https://emscripten.org/docs/porting/connecting_cpp_and_javascript/Interacting-with-code.html#interacting-with-code-ccall-cwrap), for example:
 69 | 
 70 | ```javascript
 71 | const phpBinary = require('build/php-web');
 72 | 
 73 | return phpBinary({
 74 |     onAbort: function(reason) {
 75 |       console.error('WASM aborted: ' + reason)
 76 |     },
 77 |     print: function (...args) {
 78 |       console.log('stdout: ', args)
 79 |     },
 80 |     printErr: function (...args) {
 81 |       console.log('stderr: ', args)
 82 |     }
 83 | })
 84 | .then(({ccall, FS}) => {
 85 |   const phpVersion = ccall(
 86 |     'phpw_exec'
 87 |     , 'string'
 88 |     , ['string']
 89 |     , [`phpversion();`]
 90 |   );
 91 | })
 92 | ```
 93 | 
 94 | ### API
 95 | 
 96 | ```javascript
 97 | phpw_exec(string code): string
 98 | phpw_run(string code): void
 99 | phpw(string filePath): void
100 | ```
101 | 
102 | ### Example calls:
103 | 
104 | 
105 | ```javascript
106 | const STR = 'string';
107 | ccall("phpw", null, [STR], ["public/index.php"]);
108 | console.log(ccall("phpw_exec", STR, [STR], ["phpversion();"]));
109 | ```
110 | 
111 | [More about how to call exposed functions](https://emscripten.org/docs/porting/connecting_cpp_and_javascript/Interacting-with-code.html?highlight=call#interacting-with-code-ccall-cwrap)
112 | 
113 | ## Demo
114 | 
115 | Before running the demo, you need to build the library.
116 | 
117 | ```bash
118 | docker buildx bake
119 | ```
120 | 
121 | Then you need to copy
122 | the `php-web.js` and `php-web.wasm` to the `demo` directory.
123 | 
124 | ```console
125 | $ cp build/php-web.* demo/public/
126 | ```
127 | 
128 | Then to build the preloaded data:
129 | 
130 | ```bash
131 | docker run \
132 |   -v $(pwd)/demo/src:/src \
133 |   -v $(pwd)/demo/public:/dist \
134 |   -w /dist \
135 |   soyuka/php-wasm:8.2.9 \
136 |   python3 \
137 |     /emsdk/upstream/emscripten/tools/file_packager.py \
138 |     php-web.data \
139 |       --use-preload-cache \
140 |       --lz4 \
141 |       --preload "/src" \
142 |       --js-output=php-web.data.js \
143 |       --no-node \
144 |       --exclude '*/.*' \
145 |       --export-name=createPhpModule
146 | ```
147 | 
148 | Then attach the `php-web.data.js` to the `demo/public/php-web.mjs`:
149 | 
150 | ```bash
151 | sed '/--pre-js/r demo/public/php-web.data.js' demo/public/php-web.mjs > this-has-preloaded-data-php-web.mjs ; mv this-has-preloaded-data-php-web.mjs demo/public/php-web.mjs
152 | ```
153 | 
154 | And finally open a web sserver in the `demo` directory:
155 | 
156 | ```console
157 | $ php -S 127.0.0.1:8000 -t demo/public
158 | ```
159 | 
160 | ## TODO
161 | 
162 | - add opt-in / opt-out sqlite libxml vrzno and mb more
163 | 


--------------------------------------------------------------------------------