@php-wasm/compile-extension 0.0.0 → 3.1.26

package/LICENSE

@@ -0,0 +1,339 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 2, June 1991
+
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
+ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+License is intended to guarantee your freedom to share and change free
+software--to make sure the software is free for all its users.  This
+General Public License applies to most of the Free Software
+Foundation's software and to any other program whose authors commit to
+using it.  (Some other Free Software Foundation software is covered by
+the GNU Lesser General Public License instead.)  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+this service if you wish), that you receive source code or can get it
+if you want it, that you can change the software or use pieces of it
+in new free programs; and that you know you can do these things.
+
+  To protect your rights, we need to make restrictions that forbid
+anyone to deny you these rights or to ask you to surrender the rights.
+These restrictions translate to certain responsibilities for you if you
+distribute copies of the software, or if you modify it.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must give the recipients all the rights that
+you have.  You must make sure that they, too, receive or can get the
+source code.  And you must show them these terms so they know their
+rights.
+
+  We protect your rights with two steps: (1) copyright the software, and
+(2) offer you this license which gives you legal permission to copy,
+distribute and/or modify the software.
+
+  Also, for each author's protection and ours, we want to make certain
+that everyone understands that there is no warranty for this free
+software.  If the software is modified by someone else and passed on, we
+want its recipients to know that what they have is not the original, so
+that any problems introduced by others will not reflect on the original
+authors' reputations.
+
+  Finally, any free program is threatened constantly by software
+patents.  We wish to avoid the danger that redistributors of a free
+program will individually obtain patent licenses, in effect making the
+program proprietary.  To prevent this, we have made it clear that any
+patent must be licensed for everyone's free use or not licensed at all.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                    GNU GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License applies to any program or other work which contains
+a notice placed by the copyright holder saying it may be distributed
+under the terms of this General Public License.  The "Program", below,
+refers to any such program or work, and a "work based on the Program"
+means either the Program or any derivative work under copyright law:
+that is to say, a work containing the Program or a portion of it,
+either verbatim or with modifications and/or translated into another
+language.  (Hereinafter, translation is included without limitation in
+the term "modification".)  Each licensee is addressed as "you".
+
+Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running the Program is not restricted, and the output from the Program
+is covered only if its contents constitute a work based on the
+Program (independent of having been made by running the Program).
+Whether that is true depends on what the Program does.
+
+  1. You may copy and distribute verbatim copies of the Program's
+source code as you receive it, in any medium, provided that you
+conspicuously and appropriately publish on each copy an appropriate
+copyright notice and disclaimer of warranty; keep intact all the
+notices that refer to this License and to the absence of any warranty;
+and give any other recipients of the Program a copy of this License
+along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and
+you may at your option offer warranty protection in exchange for a fee.
+
+  2. You may modify your copy or copies of the Program or any portion
+of it, thus forming a work based on the Program, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+    a) You must cause the modified files to carry prominent notices
+    stating that you changed the files and the date of any change.
+
+    b) You must cause any work that you distribute or publish, that in
+    whole or in part contains or is derived from the Program or any
+    part thereof, to be licensed as a whole at no charge to all third
+    parties under the terms of this License.
+
+    c) If the modified program normally reads commands interactively
+    when run, you must cause it, when started running for such
+    interactive use in the most ordinary way, to print or display an
+    announcement including an appropriate copyright notice and a
+    notice that there is no warranty (or else, saying that you provide
+    a warranty) and that users may redistribute the program under
+    these conditions, and telling the user how to view a copy of this
+    License.  (Exception: if the Program itself is interactive but
+    does not normally print such an announcement, your work based on
+    the Program is not required to print an announcement.)
+
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Program,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works.  But when you
+distribute the same sections as part of a whole which is a work based
+on the Program, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Program.
+
+In addition, mere aggregation of another work not based on the Program
+with the Program (or with a work based on the Program) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+  3. You may copy and distribute the Program (or a work based on it,
+under Section 2) in object code or executable form under the terms of
+Sections 1 and 2 above provided that you also do one of the following:
+
+    a) Accompany it with the complete corresponding machine-readable
+    source code, which must be distributed under the terms of Sections
+    1 and 2 above on a medium customarily used for software interchange; or,
+
+    b) Accompany it with a written offer, valid for at least three
+    years, to give any third party, for a charge no more than your
+    cost of physically performing source distribution, a complete
+    machine-readable copy of the corresponding source code, to be
+    distributed under the terms of Sections 1 and 2 above on a medium
+    customarily used for software interchange; or,
+
+    c) Accompany it with the information you received as to the offer
+    to distribute corresponding source code.  (This alternative is
+    allowed only for noncommercial distribution and only if you
+    received the program in object code or executable form with such
+    an offer, in accord with Subsection b above.)
+
+The source code for a work means the preferred form of the work for
+making modifications to it.  For an executable work, complete source
+code means all the source code for all modules it contains, plus any
+associated interface definition files, plus the scripts used to
+control compilation and installation of the executable.  However, as a
+special exception, the source code distributed need not include
+anything that is normally distributed (in either source or binary
+form) with the major components (compiler, kernel, and so on) of the
+operating system on which the executable runs, unless that component
+itself accompanies the executable.
+
+If distribution of executable or object code is made by offering
+access to copy from a designated place, then offering equivalent
+access to copy the source code from the same place counts as
+distribution of the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+  4. You may not copy, modify, sublicense, or distribute the Program
+except as expressly provided under this License.  Any attempt
+otherwise to copy, modify, sublicense or distribute the Program is
+void, and will automatically terminate your rights under this License.
+However, parties who have received copies, or rights, from you under
+this License will not have their licenses terminated so long as such
+parties remain in full compliance.
+
+  5. You are not required to accept this License, since you have not
+signed it.  However, nothing else grants you permission to modify or
+distribute the Program or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Program (or any work based on the
+Program), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+  6. Each time you redistribute the Program (or any work based on the
+Program), the recipient automatically receives a license from the
+original licensor to copy, distribute or modify the Program subject to
+these terms and conditions.  You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties to
+this License.
+
+  7. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Program at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Program by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Program.
+
+If any portion of this section is held invalid or unenforceable under
+any particular circumstance, the balance of the section is intended to
+apply and the section as a whole is intended to apply in other
+circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system, which is
+implemented by public license practices.  Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+  8. If the distribution and/or use of the Program is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Program under this License
+may add an explicit geographical distribution limitation excluding
+those countries, so that distribution is permitted only in or among
+countries not thus excluded.  In such case, this License incorporates
+the limitation as if written in the body of this License.
+
+  9. The Free Software Foundation may publish revised and/or new versions
+of the General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+Each version is given a distinguishing version number.  If the Program
+specifies a version number of this License which applies to it and "any
+later version", you have the option of following the terms and conditions
+either of that version or of any later version published by the Free
+Software Foundation.  If the Program does not specify a version number of
+this License, you may choose any version ever published by the Free Software
+Foundation.
+
+  10. If you wish to incorporate parts of the Program into other free
+programs whose distribution conditions are different, write to the author
+to ask for permission.  For software which is copyrighted by the Free
+Software Foundation, write to the Free Software Foundation; we sometimes
+make exceptions for this.  Our decision will be guided by the two goals
+of preserving the free status of all derivatives of our free software and
+of promoting the sharing and reuse of software generally.
+
+                            NO WARRANTY
+
+  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
+OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
+TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
+REPAIR OR CORRECTION.
+
+  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
+REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
+OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
+TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
+YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
+PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+convey the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 2 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License along
+    with this program; if not, write to the Free Software Foundation, Inc.,
+    51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program is interactive, make it output a short notice like this
+when it starts in an interactive mode:
+
+    Gnomovision version 69, Copyright (C) year name of author
+    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, the commands you use may
+be called something other than `show w' and `show c'; they could even be
+mouse-clicks or menu items--whatever suits your program.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a "copyright disclaimer" for the program, if
+necessary.  Here is a sample; alter the names:
+
+  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
+  `Gnomovision' (which makes passes at compilers) written by James Hacker.
+
+  <signature of Ty Coon>, 1 April 1989
+  Ty Coon, President of Vice
+
+This General Public License does not permit incorporating your program into
+proprietary programs.  If your program is a subroutine library, you may
+consider it more useful to permit linking proprietary applications with the
+library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.

package/README.md

@@ -1,6 +1,345 @@
 # @php-wasm/compile-extension
 
-Placeholder package for the PHP.wasm extension compiler.
+Builds a PHP extension source directory into PHP.wasm JSPI side modules for a
+PHP version matrix.
 
-The implementation will be published from
-https://github.com/WordPress/wordpress-playground.
+```bash
+npx @php-wasm/compile-extension \
+	--source ./ext-src \
+	--name wp_mysql_parser \
+	--php-versions 8.4 \
+	--out ./dist
+```
+
+The command writes one JSPI `.so` per PHP version and a `manifest.json` that
+can be consumed by PHP.wasm extension-loading helpers. The manifest matches
+the `PHPExtensionManifest` shape from `@php-wasm/universal`:
+
+```json
+{
+	"name": "wp_mysql_parser",
+	"version": "0.1.0",
+	"artifacts": [
+		{
+			"phpVersion": "8.4",
+			"sourcePath": "wp_mysql_parser-php8.4-jspi.so"
+		}
+	]
+}
+```
+
+To stage sidecar files (data directories, web UI assets, ICU data, etc.) under
+an absolute VFS prefix, pass `--extra-files <hostDir>:<vfsRoot>`. The host
+directory is copied next to the manifest and recorded under `extraFiles.nodes`:
+
+```bash
+npx @php-wasm/compile-extension \
+	--source ./spx-src \
+	--name spx \
+	--php-versions 8.2 \
+	--extra-files ./web-ui:/internal/shared/spx \
+	--out ./dist
+```
+
+Empty directories are recorded as `type: "directory"` nodes so the loader
+creates them before PHP starts.
+
+The supported `--php-versions` are `7.4` and `8.0` through `8.5`.
+
+Docker is required. The build reuses the `packages/php-wasm/compile` base image
+and its PHP patch set, then runs `phpize`, `emconfigure`, and `emmake` inside
+the container.
+
+## Running in CI
+
+The package only needs Docker and Node. A typical GitHub Actions job:
+
+```yaml
+- uses: actions/checkout@v4
+
+- uses: actions/setup-node@v4
+  with:
+    node-version: '24'
+
+- run: |
+    npx --yes @php-wasm/compile-extension \
+      --source ./my-extension \
+      --name my_extension \
+      --php-versions 8.0,8.1,8.2,8.3,8.4,8.5 \
+      --out ./dist/my-extension
+```
+
+In a matrix workflow, set `strategy.max-parallel: 1` on the WASM job —
+parallel Docker builds on hosted runners often hit apt-mirror flakes during
+the base image build.
+
+## Loading the result
+
+Host the entire output directory somewhere static and pass the manifest URL to
+the runtime through the startup-time `extensions` option:
+
+```ts
+import { loadNodeRuntime } from '@php-wasm/node';
+import { PHP } from '@php-wasm/universal';
+
+const php = new PHP(
+	await loadNodeRuntime('8.4', {
+		extensions: [
+			{
+				source: {
+					format: 'manifest',
+					manifestUrl: 'https://example.com/wp_mysql_parser/manifest.json',
+				},
+			},
+		],
+	})
+);
+```
+
+The loader chooses the artifact whose `phpVersion` matches the running
+PHP.wasm runtime, downloads it, stages the `.so`, writes a startup `.ini`
+file, copies any `extraFiles` declared in the manifest, and registers the
+extension scan directory before PHP starts.
+
+In Node.js, `manifestUrl` may also be a local path:
+
+```ts
+const php = new PHP(
+	await loadNodeRuntime('8.4', {
+		extensions: [
+			{
+				source: {
+					format: 'manifest',
+					manifestUrl: './dist/wp_mysql_parser/manifest.json',
+				},
+			},
+		],
+	})
+);
+```
+
+Pass a direct `.so` URL when the caller chooses the artifact instead of a
+manifest:
+
+```ts
+const php = new PHP(
+	await loadNodeRuntime('8.4', {
+		extensions: [
+			{
+				name: 'wp_mysql_parser',
+				source: {
+					format: 'url',
+					url: 'https://example.com/extensions/wp_mysql_parser-php8.4-jspi.so',
+				},
+			},
+		],
+	})
+);
+```
+
+Use `loadWithIniDirective: 'zend_extension'` for Zend extensions such as
+Xdebug. Use `extraFiles` and `env` for sidecar files needed by the extension.
+
+## Dependencies
+
+The helper can only link WebAssembly objects built with the same Emscripten
+toolchain and JSPI ABI as the PHP runtime. Native host libraries from
+`/usr/lib`, Homebrew, apt, or npm packages cannot be linked into the `.so`.
+
+For dependencies already built by Playground, build the matching target and pass
+the mounted path under `/php-wasm-compile`:
+
+```bash
+make -C packages/php-wasm/compile libz_jspi
+
+npx @php-wasm/compile-extension \
+	--source ./zlib-probe \
+	--name zlib_probe \
+	--php-versions 8.4 \
+	--extra-cflags "-I/php-wasm-compile/libz/jspi/dist/root/lib/include" \
+	--extra-ldflags "/php-wasm-compile/libz/jspi/dist/root/lib/lib/libz.a"
+```
+
+For dependencies that are not in `packages/php-wasm/compile`, either:
+
+- Vendor the dependency source under your extension and build it from
+  `config.m4`, using paths under `/build` after the helper copies `/src`.
+- Build the dependency with Emscripten before running the helper, place the
+  resulting headers and `.a` archive under the extension source directory, and
+  pass `/build/...` paths through `--extra-cflags` and `--extra-ldflags`.
+- Add a Docker layer that builds the dependency with Emscripten, then pass the
+  resulting include and archive paths through `--extra-cflags`,
+  `--extra-ldflags`, and `--config-args`.
+
+For example, if an extension vendors an external library that is not provided by
+Playground and stores its Emscripten build output under
+`vendor/string-score/install`, pass the copied `/build` paths:
+
+```bash
+npx @php-wasm/compile-extension \
+	--source ./external-lib-probe \
+	--name external_lib_probe \
+	--php-versions 8.4 \
+	--extra-cflags "-I/build/vendor/string-score/install/include" \
+	--extra-ldflags "/build/vendor/string-score/install/lib/libstring_score.a"
+```
+
+Prebuilt static archives, including Rust `staticlib` archives, should also be
+passed through `--extra-ldflags`. The helper detects `.a` entries and
+force-links them into the final side module with `--whole-archive`:
+
+```bash
+npx @php-wasm/compile-extension \
+	--source ./my-rust-extension \
+	--name my_rust_extension \
+	--php-versions 8.4 \
+	--extra-ldflags "/build/target/wasm32-unknown-emscripten/release/libmy_rust_extension.a"
+```
+
+Do not use `PHP_ADD_LIBRARY_WITH_PATH` for sibling `.a` archives in
+`config.m4`. PHP's libtool setup can look for a matching `.so`, fail to link
+the archive into the side module, and still leave a build artifact behind. Use
+`--extra-ldflags` for static archives instead.
+
+If the dependency uses CMake, build it as a static archive with Emscripten and
+store the install tree under the extension source directory:
+
+```bash
+# Run this inside the same Emscripten toolchain used for the target PHP.wasm
+# version and JSPI ABI.
+source /root/emsdk/emsdk_env.sh
+
+emcmake cmake \
+	-S vendor/libfoo \
+	-B vendor/libfoo/build \
+	-DCMAKE_BUILD_TYPE=Release \
+	-DCMAKE_INSTALL_PREFIX="$PWD/vendor/libfoo/install" \
+	-DBUILD_SHARED_LIBS=OFF
+
+emmake cmake --build vendor/libfoo/build --target install
+
+npx @php-wasm/compile-extension \
+	--source . \
+	--name my_extension \
+	--php-versions 8.4 \
+	--extra-cflags "-I/build/vendor/libfoo/install/include" \
+	--extra-ldflags "/build/vendor/libfoo/install/lib/libfoo.a"
+```
+
+For plain Makefile dependencies, force the Makefile to use Emscripten tools and
+link the resulting archive the same way:
+
+```bash
+source /root/emsdk/emsdk_env.sh
+
+emmake make -C vendor/libfoo \
+	CC=emcc \
+	CXX=em++ \
+	AR=emar \
+	RANLIB=emranlib \
+	PREFIX="$PWD/vendor/libfoo/install" \
+	install
+
+npx @php-wasm/compile-extension \
+	--source . \
+	--name my_extension \
+	--php-versions 8.4 \
+	--extra-cflags "-I/build/vendor/libfoo/install/include" \
+	--extra-ldflags "/build/vendor/libfoo/install/lib/libfoo.a"
+```
+
+The final PHP extension still needs to be a `phpize` extension with `config.m4`.
+If an extension is CMake-only or Makefile-only and produces the final `.so`
+without `phpize`, add a thin `config.m4` wrapper that builds the PHP extension
+and treats the CMake/Make output as dependency code. A fully custom final build
+script is outside v1.
+
+Rust extensions should wrap the Rust crate with a small `config.m4` and C shim
+that defines the PHP module entry and calls exported Rust functions over C ABI.
+The helper image includes a host `php` CLI for build scripts such as
+`ext-php-rs`, exports `BINDGEN_EXTRA_CLANG_ARGS` for the PHP.wasm target and
+sysroot, and sets `CFLAGS_wasm32_unknown_emscripten=-fPIC` for `cc-rs` build
+scripts. Rust `staticlib` archives must still be built with `panic=abort` and a
+nightly rebuilt standard library:
+
+```bash
+RUSTFLAGS="-C panic=abort" cargo +nightly build \
+	--release \
+	--target wasm32-unknown-emscripten \
+	-Zbuild-std=std,panic_abort
+```
+
+Keep dependencies aligned with the custom extension target. Custom extensions
+are JSPI-only, so link `jspi` dependency archives.
+
+`ext-php-rs` `0.15` depends on PHP 8 Zend APIs and does not compile against
+PHP `7.4` headers, so Rust extensions built on top of `ext-php-rs` `0.15`
+should restrict `--php-versions` to `8.0` through `8.5`. The helper itself
+still supports PHP `7.4` for non-Rust extensions and for Rust extensions that
+bind Zend directly through `bindgen`.
+
+`--extra-cflags` is visible during `./configure`. `--extra-ldflags` is applied
+to the final side-module link so dependency archives do not break Autoconf's
+compiler smoke tests. If an extension's `config.m4` insists on link-probing a
+dependency, pass explicit `--config-args` to select the known dependency path or
+patch the extension's build recipe to use the WebAssembly archive directly.
+Static `.a` archives passed via `--extra-ldflags` are force-linked with
+`--whole-archive` so the side module contains the dependency code it needs.
+
+## Troubleshooting
+
+`Could not detect the extension name`
+
+Pass `--name` explicitly, or make sure `config.m4` contains `PHP_ARG_ENABLE`,
+`PHP_ARG_WITH`, or `PHP_NEW_EXTENSION` for the extension.
+
+`configure: error: ... not found`
+
+The dependency headers or libraries are not visible inside the container. Use
+paths under `/build` for files copied from `--source`, or
+`/php-wasm-compile/<dependency>/<mode>/dist/root/lib` for Playground-built
+dependencies.
+
+`undefined symbol` when loading the extension
+
+The extension references a function that is not exported by the PHP main module
+or was not linked from a WebAssembly dependency archive. Add the dependency
+archive to `--extra-ldflags`, or rebuild the main PHP.wasm runtime if the symbol
+must come from PHP core.
+
+`WebAssembly.LinkError` or startup crashes
+
+Check that the extension loads in a JSPI runtime. The custom extension helper
+does not build Asyncify artifacts.
+
+`wasm-ld: unknown file type` or `file not recognized`
+
+One of the linked libraries is a native host library. Rebuild that dependency
+with Emscripten and link the resulting `.a` file.
+
+`R_WASM_MEMORY_ADDR_SLEB cannot be used against symbol`
+
+A C or C++ object in a static archive was not compiled as position-independent
+code. Rebuild it with `-fPIC`, or make sure Rust `cc-rs` sees
+`CFLAGS_wasm32_unknown_emscripten=-fPIC`.
+
+`__cpp_exception` is undefined when loading a Rust extension
+
+The Rust archive was built against an unwinding `std`. Rebuild it with
+`RUSTFLAGS="-C panic=abort"` and
+`cargo +nightly build -Zbuild-std=std,panic_abort`.
+
+`bad export type for 'stdin'` or another C runtime global
+
+The side module pulled in a dependency object that expects a mutable C runtime
+global the main PHP.wasm module does not export. Rebuild the dependency with the
+unused feature disabled, link a smaller archive that excludes that object, or
+move the dependency into the main PHP.wasm build so the global is provided by
+the runtime.
+
+`phpize` cannot find headers
+
+The helper image builds and installs a minimal matching PHP source tree before
+running `phpize`. If an extension includes headers from optional PHP extensions,
+copy or generate those headers in the Docker layer or include them in the
+extension source.

package/cli.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+export declare function main(args?: string[]): Promise<void>;
+export declare function normalizeDashPrefixedOptionValues(args: string[]): string[];
+export declare function splitShellWords(value: string): string[];

package/cli.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import{realpathSync as w,existsSync as v}from"node:fs";import i from"node:path";import{fileURLToPath as x}from"node:url";import A from"yargs";import{hideBin as D}from"yargs/helpers";import{mkdir as g,writeFile as N,readFile as E,cp as F,readdir as P,stat as b}from"node:fs/promises";import y from"node:os";import{spawn as O}from"node:child_process";function _(e){const t=i.join(e,"packages/php-wasm");return{workspaceRoot:e,phpWasmRoot:t,compileRoot:i.join(t,"compile")}}async function I(){try{await p("docker",["--version"],{stdio:"ignore"})}catch(e){throw new Error("Docker is required to compile PHP.wasm extensions, but the docker command was not found.",{cause:e})}}async function k(e){await p("make",["base-image"],{cwd:e.compileRoot})}async function j(e){const t=$(e);return await p("docker",["build","-f","compile-extension/docker/Dockerfile.ext",".",`--tag=${t}`,"--progress=plain","--build-arg",`PHP_VERSION=${e.phpRelease}`,"--build-arg","JSPI=yes"],{cwd:e.phpWasmRoot}),t}async function C(e){const t=$(e),r=["run","--rm","-v",`${e.sourceDir}:/src:ro`,"-v",`${e.outDir}:/out`,"-v",`${e.compileRoot}:/php-wasm-compile:ro`,"--env",`EXTENSION_NAME=${e.name}`,"--env",`PHP_VERSION_SHORT=${e.phpVersion}`,"--env",`ASYNC_MODE=${e.asyncMode}`,"--env",`ARTIFACT_FILENAME=${e.artifactFile}`,"--env",`OPTIMIZE=${e.optimize}`,"--env",`CONFIG_ARGS_COUNT=${e.configArgs.length}`];e.extraCflags&&r.push("--env",`EXTRA_CFLAGS=${e.extraCflags}`),e.extraLdflags&&r.push("--env",`EXTRA_LDFLAGS=${e.extraLdflags}`),e.configArgs.forEach((n,a)=>{r.push("--env",`CONFIG_ARG_${a}=${n}`)}),r.push(t),await p("docker",r,{cwd:e.workspaceRoot})}function $(e){return`playground-php-wasm:compile-extension-php${e.phpVersion.replaceAll(".","-")}-${e.asyncMode}`}async function p(e,t,r={}){console.log(`Running ${e} ${t.join(" ")}`),await new Promise((n,a)=>{const s=O(e,t,{cwd:r.cwd,stdio:r.stdio??"inherit",env:process.env});s.on("error",a),s.on("close",c=>{if(c===0){n();return}a(new Error(`${e} exited with code ${c}`))})})}const T="jspi";async function L(e){const t={name:e.name,version:e.version,artifacts:e.artifacts.map(r=>({phpVersion:r.phpVersion,sourcePath:r.sourcePath}))};return e.extraFiles&&(t.extraFiles=e.extraFiles),t}async function M(e){await g(e.outDir,{recursive:!0});const t=i.join(e.outDir,"manifest.json");return await N(t,`${JSON.stringify(e.manifest,null,2)}
+`),t}const z=["8.5","8.4","8.3","8.2","8.1","8.0","7.4"],H={"8.5":"8.5.5","8.4":"8.4.20","8.3":"8.3.30","8.2":"8.2.30","8.1":"8.1.34","8.0":"8.0.30","7.4":"7.4.33"};async function V(e){const t=i.resolve(e.workspaceRoot,e.outDir),r=i.resolve(e.workspaceRoot,e.sourceDir),n=_(e.workspaceRoot),a=await G(r),s=e.phpVersions.map(l=>({phpVersion:l,asyncMode:T}));await g(t,{recursive:!0}),await I(),await k(n);const c=await J(s,B(e.jobs,s.length),async({phpVersion:l,asyncMode:o})=>{const h=W(l),m=`${e.name}-php${l}-${o}.so`;return await j({...n,phpVersion:l,phpRelease:h,asyncMode:o}),await C({...n,sourceDir:r,outDir:t,name:e.name,phpVersion:l,asyncMode:o,artifactFile:m,optimize:e.optimize,extraCflags:e.extraCflags,extraLdflags:e.extraLdflags,configArgs:e.configArgs}),{phpVersion:l,sourcePath:m,path:i.join(t,m)}}),f=await L({name:e.name,version:a,artifacts:c,extraFiles:e.extraFiles});return{manifestPath:await M({outDir:t,manifest:f}),artifacts:c,manifest:f}}function W(e){return H[e]??e}async function G(e){try{const t=JSON.parse(await E(i.join(e,"package.json"),"utf8"));if(typeof t.version=="string")return t.version}catch{}return"0.0.0"}async function J(e,t,r){const n=new Array(e.length);let a=0;const s=Array.from({length:Math.min(t,e.length)},async()=>{for(;a<e.length;){const c=a++;n[c]=await r(e[c])}});return await Promise.all(s),n}function B(e,t){return t===0?1:e&&e>0?Math.min(e,t):Math.min(y.availableParallelism?.()??y.cpus().length,t)}const X=[/\bPHP_ARG_ENABLE\(\s*\[?([A-Za-z0-9_]+)\]?/m,/\bPHP_ARG_WITH\(\s*\[?([A-Za-z0-9_]+)\]?/m,/\bPHP_NEW_EXTENSION\(\s*\[?([A-Za-z0-9_]+)\]?/m];async function U(e){const t=i.join(e,"config.m4");let r;try{r=await E(t,"utf8")}catch(a){throw new Error(`Could not read ${t}. Pass --name or provide a config.m4 file.`,{cause:a})}const n=Z(r);if(!n)throw new Error(`Could not detect the extension name from ${t}. Pass --name explicitly.`);return n}function Z(e){for(const t of X){const r=t.exec(e);if(r?.[1])return r[1]}return null}function q(e){const t=e.lastIndexOf(":");if(t<0)throw new Error(`Invalid --extra-files value ${JSON.stringify(e)}. Expected "<hostDir>:<vfsRoot>".`);const r=e.slice(0,t),n=e.slice(t+1);if(!r||!n)throw new Error(`Invalid --extra-files value ${JSON.stringify(e)}. Expected "<hostDir>:<vfsRoot>".`);if(!n.startsWith("/"))throw new Error(`--extra-files vfsRoot must be an absolute VFS path. Received ${JSON.stringify(n)}.`);return{hostDir:r,vfsRoot:n}}async function Y(e,t,r){if(!e.length)return;const n=e[0].vfsRoot;for(const f of e)if(f.vfsRoot!==n)throw new Error("All --extra-files entries must share the same vfsRoot. Received "+JSON.stringify(e.map(u=>u.vfsRoot)));const a=[],s=new Set,c=new Set;for(const f of e){const u=i.resolve(r,f.hostDir),l=i.basename(u),o=i.join(t,l);if(c.has(o))throw new Error(`--extra-files destination collides on disk: ${o}. Two host directories share the same basename, so one would overwrite the other.`);c.add(o),await g(i.dirname(o),{recursive:!0}),await F(u,o,{recursive:!0}),await R(o,async(h,m)=>{const d=i.relative(o,h).split(i.sep).join("/");if(!d)return;const S=`${l}/${d}`;if(m){if(!((await P(h)).length===0))return;if(s.has(d))throw new Error(`--extra-files vfsPath collides across specs: ${d}.`);s.add(d),a.push({vfsPath:d,type:"directory"});return}if(s.has(d))throw new Error(`--extra-files vfsPath collides across specs: ${d}.`);s.add(d),a.push({vfsPath:d,sourcePath:S})})}return a.sort((f,u)=>f.vfsPath<u.vfsPath?-1:f.vfsPath>u.vfsPath?1:0),{vfsRoot:n,nodes:a}}async function R(e,t){for(const r of await P(e)){const n=i.join(e,r),a=await b(n);await t(n,a.isDirectory()),a.isDirectory()&&await R(n,t)}}const K=new Set(["--config-args","--extra-cflags","--extra-ldflags"]);async function Q(e=D(process.argv)){const t=await A(ee(e)).scriptName("@php-wasm/compile-extension").usage("Usage: $0 --source <dir> [options]").options({source:{type:"string",demandOption:!0,description:"Extension source directory containing config.m4"},name:{type:"string",description:"Extension name. Defaults to parsing config.m4."},"php-versions":{type:"string",default:z.join(","),description:"Comma-separated PHP major.minor versions."},out:{type:"string",default:"./dist",description:"Output directory."},"extra-cflags":{type:"string",description:"Extra CFLAGS appended to the side-module build."},"extra-ldflags":{type:"string",description:"Extra LDFLAGS appended to the side-module build."},"config-args":{type:"string",default:"",description:"Extra ./configure arguments, parsed as shell words."},optimize:{type:"string",default:"2",description:"Optimization level passed as -O<level>."},jobs:{type:"number",description:"Maximum concurrent docker builds."},"extra-files":{type:"string",array:!0,default:[],description:"Stage a host directory under an absolute VFS root. Format: <hostDir>:<vfsRoot>. Files are copied next to the manifest and recorded in extraFiles."}}).strict().help().parse(),r=ne(process.cwd()),n=i.resolve(r,t.source),a=t.name??await U(n),s=te(t["php-versions"],"php-versions"),c=re(t["config-args"]||""),f=t["extra-files"].map(q),u=i.resolve(r,t.out),l=await Y(f,u,r),o=await V({workspaceRoot:r,sourceDir:n,outDir:t.out,name:a,phpVersions:s,extraCflags:t["extra-cflags"],extraLdflags:t["extra-ldflags"],configArgs:c,optimize:t.optimize,jobs:t.jobs,extraFiles:l});console.log(`Wrote ${o.artifacts.length} artifacts.`),console.log(`Wrote ${o.manifestPath}.`)}ae(import.meta.url)&&Q().catch(e=>{console.error(e instanceof Error?e.message:e),process.exit(1)});function ee(e){const t=[];for(let r=0;r<e.length;r++){const n=e[r];if(K.has(n)&&r+1<e.length&&!e[r+1].startsWith(`${n}=`)){t.push(`${n}=${e[r+1]}`),r++;continue}t.push(n)}return t}function te(e,t){const r=e.split(",").map(n=>n.trim()).filter(Boolean);if(r.length===0)throw new Error(`--${t} must contain at least one value.`);return r}function re(e){const t=[];let r="",n=null,a=!1;for(const s of e){if(a){r+=s,a=!1;continue}if(s==="\\"){a=!0;continue}if(n){s===n?n=null:r+=s;continue}if(s==='"'||s==="'"){n=s;continue}if(/\s/.test(s)){r.length>0&&(t.push(r),r="");continue}r+=s}if(a&&(r+="\\"),n)throw new Error("Unterminated quote in --config-args.");return r.length>0&&t.push(r),t}function ne(e){let t=i.resolve(e);for(;t!==i.dirname(t);){if(v(i.join(t,"packages/php-wasm/compile"))&&v(i.join(t,"nx.json")))return t;t=i.dirname(t)}return process.cwd()}function ae(e){const t=process.argv[1];if(!t)return!1;try{return w(t)===w(x(e))}catch{return i.resolve(t)===x(e)}}
+//# sourceMappingURL=cli.js.map

package/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sources":["../../../../packages/php-wasm/compile-extension/src/docker.ts","../../../../packages/php-wasm/compile-extension/src/manifest.ts","../../../../packages/php-wasm/compile-extension/src/compile.ts","../../../../packages/php-wasm/compile-extension/src/detect.ts","../../../../packages/php-wasm/compile-extension/src/extra-files.ts","../../../../packages/php-wasm/compile-extension/src/cli.ts"],"sourcesContent":["import { spawn } from 'node:child_process';\nimport path from 'node:path';\n\nimport type { AsyncMode } from './manifest';\n\nexport interface DockerBuildContext {\n\tworkspaceRoot: string;\n\tphpWasmRoot: string;\n\tcompileRoot: string;\n}\n\nexport interface DockerImageOptions extends DockerBuildContext {\n\tphpVersion: string;\n\tphpRelease: string;\n\tasyncMode: AsyncMode;\n}\n\nexport interface DockerRunOptions extends DockerImageOptions {\n\tsourceDir: string;\n\toutDir: string;\n\tname: string;\n\tartifactFile: string;\n\toptimize: string;\n\textraCflags?: string;\n\textraLdflags?: string;\n\tconfigArgs: string[];\n}\n\nexport function createDockerContext(workspaceRoot: string): DockerBuildContext {\n\tconst phpWasmRoot = path.join(workspaceRoot, 'packages/php-wasm');\n\treturn {\n\t\tworkspaceRoot,\n\t\tphpWasmRoot,\n\t\tcompileRoot: path.join(phpWasmRoot, 'compile'),\n\t};\n}\n\nexport async function assertDockerIsAvailable(): Promise<void> {\n\ttry {\n\t\tawait runCommand('docker', ['--version'], {\n\t\t\tstdio: 'ignore',\n\t\t});\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t'Docker is required to compile PHP.wasm extensions, but the docker command was not found.',\n\t\t\t{ cause: error }\n\t\t);\n\t}\n}\n\nexport async function buildBaseImage(context: DockerBuildContext) {\n\tawait runCommand('make', ['base-image'], {\n\t\tcwd: context.compileRoot,\n\t});\n}\n\nexport async function buildExtensionImage(\n\toptions: DockerImageOptions\n): Promise<string> {\n\tconst imageTag = getExtensionImageTag(options);\n\tawait runCommand(\n\t\t'docker',\n\t\t[\n\t\t\t'build',\n\t\t\t'-f',\n\t\t\t'compile-extension/docker/Dockerfile.ext',\n\t\t\t'.',\n\t\t\t`--tag=${imageTag}`,\n\t\t\t'--progress=plain',\n\t\t\t'--build-arg',\n\t\t\t`PHP_VERSION=${options.phpRelease}`,\n\t\t\t'--build-arg',\n\t\t\t'JSPI=yes',\n\t\t],\n\t\t{\n\t\t\tcwd: options.phpWasmRoot,\n\t\t}\n\t);\n\treturn imageTag;\n}\n\nexport async function runExtensionBuild(options: DockerRunOptions) {\n\tconst imageTag = getExtensionImageTag(options);\n\tconst runArgs = [\n\t\t'run',\n\t\t'--rm',\n\t\t'-v',\n\t\t`${options.sourceDir}:/src:ro`,\n\t\t'-v',\n\t\t`${options.outDir}:/out`,\n\t\t'-v',\n\t\t`${options.compileRoot}:/php-wasm-compile:ro`,\n\t\t'--env',\n\t\t`EXTENSION_NAME=${options.name}`,\n\t\t'--env',\n\t\t`PHP_VERSION_SHORT=${options.phpVersion}`,\n\t\t'--env',\n\t\t`ASYNC_MODE=${options.asyncMode}`,\n\t\t'--env',\n\t\t`ARTIFACT_FILENAME=${options.artifactFile}`,\n\t\t'--env',\n\t\t`OPTIMIZE=${options.optimize}`,\n\t\t'--env',\n\t\t`CONFIG_ARGS_COUNT=${options.configArgs.length}`,\n\t];\n\n\tif (options.extraCflags) {\n\t\trunArgs.push('--env', `EXTRA_CFLAGS=${options.extraCflags}`);\n\t}\n\tif (options.extraLdflags) {\n\t\trunArgs.push('--env', `EXTRA_LDFLAGS=${options.extraLdflags}`);\n\t}\n\n\toptions.configArgs.forEach((arg, index) => {\n\t\trunArgs.push('--env', `CONFIG_ARG_${index}=${arg}`);\n\t});\n\n\trunArgs.push(imageTag);\n\n\tawait runCommand('docker', runArgs, {\n\t\tcwd: options.workspaceRoot,\n\t});\n}\n\nfunction getExtensionImageTag(\n\toptions: Pick<DockerImageOptions, 'phpVersion' | 'asyncMode'>\n) {\n\tconst phpVersion = options.phpVersion.replaceAll('.', '-');\n\treturn `playground-php-wasm:compile-extension-php${phpVersion}-${options.asyncMode}`;\n}\n\ninterface RunCommandOptions {\n\tcwd?: string;\n\tstdio?: 'inherit' | 'ignore';\n}\n\nasync function runCommand(\n\tcommand: string,\n\targs: string[],\n\toptions: RunCommandOptions = {}\n): Promise<void> {\n\tconsole.log(`Running ${command} ${args.join(' ')}`);\n\tawait new Promise<void>((resolve, reject) => {\n\t\tconst child = spawn(command, args, {\n\t\t\tcwd: options.cwd,\n\t\t\tstdio: options.stdio ?? 'inherit',\n\t\t\tenv: process.env,\n\t\t});\n\t\tchild.on('error', reject);\n\t\tchild.on('close', (code) => {\n\t\t\tif (code === 0) {\n\t\t\t\tresolve();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\treject(new Error(`${command} exited with code ${code}`));\n\t\t});\n\t});\n}\n","import { mkdir, writeFile } from 'node:fs/promises';\nimport path from 'node:path';\n\nexport const ExtensionAsyncMode = 'jspi';\nexport type AsyncMode = typeof ExtensionAsyncMode;\n\n/**\n * One sidecar file or empty directory staged alongside an artifact.\n *\n * Mirrors `PHPExtensionManifestExtraFile` in `@php-wasm/universal`.\n */\nexport interface ExtensionManifestExtraFile {\n\t/** Joined with the group's `vfsRoot` to form the final VFS path. */\n\tvfsPath: string;\n\t/** Defaults to \"file\". Only file nodes need a `sourcePath`. */\n\ttype?: 'file' | 'directory';\n\t/** Relative to the manifest URL/base URL, or an absolute URL. */\n\tsourcePath?: string;\n}\n\nexport interface ExtensionManifestExtraFiles {\n\t/** Absolute VFS prefix joined with each node's `vfsPath`. */\n\tvfsRoot?: string;\n\tnodes?: ExtensionManifestExtraFile[];\n}\n\nexport interface ExtensionArtifact {\n\tphpVersion: string;\n\t/** Path to the `.so` file, relative to the manifest URL or absolute. */\n\tsourcePath: string;\n\t/** URL-backed files needed only by this artifact. */\n\textraFiles?: ExtensionManifestExtraFiles;\n}\n\nexport interface ExtensionManifest {\n\tname: string;\n\tversion: string;\n\tartifacts: ExtensionArtifact[];\n\t/** URL-backed files shared by every artifact in this manifest. */\n\textraFiles?: ExtensionManifestExtraFiles;\n}\n\nexport interface BuiltArtifact {\n\tphpVersion: string;\n\t/** Path to the `.so` file, relative to the manifest URL. */\n\tsourcePath: string;\n\t/** Absolute path on disk where the `.so` was written. */\n\tpath: string;\n}\n\nexport async function createManifest(options: {\n\tname: string;\n\tversion: string;\n\tartifacts: BuiltArtifact[];\n\textraFiles?: ExtensionManifestExtraFiles;\n}): Promise<ExtensionManifest> {\n\tconst manifest: ExtensionManifest = {\n\t\tname: options.name,\n\t\tversion: options.version,\n\t\tartifacts: options.artifacts.map((artifact) => ({\n\t\t\tphpVersion: artifact.phpVersion,\n\t\t\tsourcePath: artifact.sourcePath,\n\t\t})),\n\t};\n\tif (options.extraFiles) {\n\t\tmanifest.extraFiles = options.extraFiles;\n\t}\n\treturn manifest;\n}\n\nexport async function writeManifest(options: {\n\toutDir: string;\n\tmanifest: ExtensionManifest;\n}): Promise<string> {\n\tawait mkdir(options.outDir, { recursive: true });\n\tconst manifestPath = path.join(options.outDir, 'manifest.json');\n\tawait writeFile(\n\t\tmanifestPath,\n\t\t`${JSON.stringify(options.manifest, null, 2)}\\n`\n\t);\n\treturn manifestPath;\n}\n\nexport function findExtensionArtifact(\n\tmanifest: ExtensionManifest,\n\tphpVersion: string\n): ExtensionArtifact | undefined {\n\treturn manifest.artifacts.find(\n\t\t(artifact) => artifact.phpVersion === phpVersion\n\t);\n}\n","import { mkdir, readFile } from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\n\nimport {\n\tassertDockerIsAvailable,\n\tbuildBaseImage,\n\tbuildExtensionImage,\n\tcreateDockerContext,\n\trunExtensionBuild,\n} from './docker';\nimport type {\n\tAsyncMode,\n\tBuiltArtifact,\n\tExtensionManifestExtraFiles,\n} from './manifest';\nimport { createManifest, ExtensionAsyncMode, writeManifest } from './manifest';\n\nexport const SupportedExtensionPHPVersions = [\n\t'8.5',\n\t'8.4',\n\t'8.3',\n\t'8.2',\n\t'8.1',\n\t'8.0',\n\t'7.4',\n] as const;\n\nconst PHP_RELEASE_BY_MINOR: Record<string, string> = {\n\t'8.5': '8.5.5',\n\t'8.4': '8.4.20',\n\t'8.3': '8.3.30',\n\t'8.2': '8.2.30',\n\t'8.1': '8.1.34',\n\t'8.0': '8.0.30',\n\t'7.4': '7.4.33',\n};\n\nexport interface CompileExtensionOptions {\n\tworkspaceRoot: string;\n\tsourceDir: string;\n\toutDir: string;\n\tname: string;\n\tphpVersions: string[];\n\textraCflags?: string;\n\textraLdflags?: string;\n\tconfigArgs: string[];\n\toptimize: string;\n\tjobs?: number;\n\t/** Sidecar files to record at the manifest level. */\n\textraFiles?: ExtensionManifestExtraFiles;\n}\n\nexport async function compileExtensionMatrix(options: CompileExtensionOptions) {\n\tconst outDir = path.resolve(options.workspaceRoot, options.outDir);\n\tconst sourceDir = path.resolve(options.workspaceRoot, options.sourceDir);\n\tconst context = createDockerContext(options.workspaceRoot);\n\tconst version = await detectManifestVersion(sourceDir);\n\tconst matrix: Array<{ phpVersion: string; asyncMode: AsyncMode }> =\n\t\toptions.phpVersions.map((phpVersion) => ({\n\t\t\tphpVersion,\n\t\t\tasyncMode: ExtensionAsyncMode,\n\t\t}));\n\n\tawait mkdir(outDir, { recursive: true });\n\tawait assertDockerIsAvailable();\n\tawait buildBaseImage(context);\n\n\tconst artifacts = await mapLimit(\n\t\tmatrix,\n\t\tnormalizeJobCount(options.jobs, matrix.length),\n\t\tasync ({ phpVersion, asyncMode }) => {\n\t\t\tconst phpRelease = resolvePHPRelease(phpVersion);\n\t\t\tconst artifactFile = `${options.name}-php${phpVersion}-${asyncMode}.so`;\n\t\t\tawait buildExtensionImage({\n\t\t\t\t...context,\n\t\t\t\tphpVersion,\n\t\t\t\tphpRelease,\n\t\t\t\tasyncMode,\n\t\t\t});\n\t\t\tawait runExtensionBuild({\n\t\t\t\t...context,\n\t\t\t\tsourceDir,\n\t\t\t\toutDir,\n\t\t\t\tname: options.name,\n\t\t\t\tphpVersion,\n\t\t\t\tphpRelease,\n\t\t\t\tasyncMode,\n\t\t\t\tartifactFile,\n\t\t\t\toptimize: options.optimize,\n\t\t\t\textraCflags: options.extraCflags,\n\t\t\t\textraLdflags: options.extraLdflags,\n\t\t\t\tconfigArgs: options.configArgs,\n\t\t\t});\n\t\t\treturn {\n\t\t\t\tphpVersion,\n\t\t\t\tsourcePath: artifactFile,\n\t\t\t\tpath: path.join(outDir, artifactFile),\n\t\t\t} satisfies BuiltArtifact;\n\t\t}\n\t);\n\n\tconst manifest = await createManifest({\n\t\tname: options.name,\n\t\tversion,\n\t\tartifacts,\n\t\textraFiles: options.extraFiles,\n\t});\n\tconst manifestPath = await writeManifest({ outDir, manifest });\n\treturn { manifestPath, artifacts, manifest };\n}\n\nexport function resolvePHPRelease(phpVersion: string): string {\n\treturn PHP_RELEASE_BY_MINOR[phpVersion] ?? phpVersion;\n}\n\nasync function detectManifestVersion(sourceDir: string): Promise<string> {\n\ttry {\n\t\tconst packageJson = JSON.parse(\n\t\t\tawait readFile(path.join(sourceDir, 'package.json'), 'utf8')\n\t\t) as { version?: unknown };\n\t\tif (typeof packageJson.version === 'string') {\n\t\t\treturn packageJson.version;\n\t\t}\n\t} catch {\n\t\t// Native PHP extension sources usually do not contain package.json.\n\t}\n\treturn '0.0.0';\n}\n\nasync function mapLimit<T, R>(\n\titems: T[],\n\tlimit: number,\n\tworker: (item: T) => Promise<R>\n): Promise<R[]> {\n\tconst results: R[] = new Array(items.length) as R[];\n\tlet nextIndex = 0;\n\tconst workers = Array.from(\n\t\t{ length: Math.min(limit, items.length) },\n\t\tasync () => {\n\t\t\twhile (nextIndex < items.length) {\n\t\t\t\tconst index = nextIndex++;\n\t\t\t\tresults[index] = await worker(items[index]);\n\t\t\t}\n\t\t}\n\t);\n\tawait Promise.all(workers);\n\treturn results;\n}\n\nfunction normalizeJobCount(\n\tjobs: number | undefined,\n\ttaskCount: number\n): number {\n\tif (taskCount === 0) {\n\t\treturn 1;\n\t}\n\tif (jobs && jobs > 0) {\n\t\treturn Math.min(jobs, taskCount);\n\t}\n\treturn Math.min(os.availableParallelism?.() ?? os.cpus().length, taskCount);\n}\n","import { readFile } from 'node:fs/promises';\nimport path from 'node:path';\n\nconst EXTENSION_NAME_PATTERNS = [\n\t/\\bPHP_ARG_ENABLE\\(\\s*\\[?([A-Za-z0-9_]+)\\]?/m,\n\t/\\bPHP_ARG_WITH\\(\\s*\\[?([A-Za-z0-9_]+)\\]?/m,\n\t/\\bPHP_NEW_EXTENSION\\(\\s*\\[?([A-Za-z0-9_]+)\\]?/m,\n];\n\nexport async function detectExtensionName(sourceDir: string): Promise<string> {\n\tconst configPath = path.join(sourceDir, 'config.m4');\n\tlet config: string;\n\ttry {\n\t\tconfig = await readFile(configPath, 'utf8');\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t`Could not read ${configPath}. Pass --name or provide a config.m4 file.`,\n\t\t\t{ cause: error }\n\t\t);\n\t}\n\n\tconst detected = detectExtensionNameFromConfig(config);\n\tif (!detected) {\n\t\tthrow new Error(\n\t\t\t`Could not detect the extension name from ${configPath}. Pass --name explicitly.`\n\t\t);\n\t}\n\treturn detected;\n}\n\nexport function detectExtensionNameFromConfig(config: string): string | null {\n\tfor (const pattern of EXTENSION_NAME_PATTERNS) {\n\t\tconst match = pattern.exec(config);\n\t\tif (match?.[1]) {\n\t\t\treturn match[1];\n\t\t}\n\t}\n\treturn null;\n}\n","import { cp, mkdir, readdir, stat } from 'node:fs/promises';\nimport path from 'node:path';\n\nimport type {\n\tExtensionManifestExtraFile,\n\tExtensionManifestExtraFiles,\n} from './manifest';\n\n/**\n * Parses a `--extra-files` CLI argument of the form `<hostDir>:<vfsRoot>`.\n *\n * `vfsRoot` must be an absolute VFS path so the loader can stage files\n * without making up a default root. Splitting on the *last* colon lets\n * Windows host paths like `C:\\dir:/internal/root` round-trip cleanly.\n */\nexport function parseExtraFilesSpec(spec: string): {\n\thostDir: string;\n\tvfsRoot: string;\n} {\n\tconst separator = spec.lastIndexOf(':');\n\tif (separator < 0) {\n\t\tthrow new Error(\n\t\t\t`Invalid --extra-files value ${JSON.stringify(\n\t\t\t\tspec\n\t\t\t)}. Expected \"<hostDir>:<vfsRoot>\".`\n\t\t);\n\t}\n\tconst hostDir = spec.slice(0, separator);\n\tconst vfsRoot = spec.slice(separator + 1);\n\tif (!hostDir || !vfsRoot) {\n\t\tthrow new Error(\n\t\t\t`Invalid --extra-files value ${JSON.stringify(\n\t\t\t\tspec\n\t\t\t)}. Expected \"<hostDir>:<vfsRoot>\".`\n\t\t);\n\t}\n\tif (!vfsRoot.startsWith('/')) {\n\t\tthrow new Error(\n\t\t\t`--extra-files vfsRoot must be an absolute VFS path. Received ${JSON.stringify(\n\t\t\t\tvfsRoot\n\t\t\t)}.`\n\t\t);\n\t}\n\treturn { hostDir, vfsRoot };\n}\n\n/**\n * Copies one or more host directories into `outDir` and returns a manifest\n * `extraFiles` group whose `sourcePath` entries are relative to `outDir`.\n *\n * Each spec is `<hostDir>:<vfsRoot>`. All specs must agree on `vfsRoot`\n * because the manifest format only stores a single `vfsRoot` per group.\n *\n * Files keep their relative path under `vfsRoot`. Empty directories are\n * recorded as `type: 'directory'` nodes so the loader creates them.\n */\nexport async function stageExtraFilesIntoOutDir(\n\tspecs: Array<{ hostDir: string; vfsRoot: string }>,\n\toutDir: string,\n\tworkspaceRoot: string\n): Promise<ExtensionManifestExtraFiles | undefined> {\n\tif (!specs.length) {\n\t\treturn undefined;\n\t}\n\tconst vfsRoot = specs[0].vfsRoot;\n\tfor (const spec of specs) {\n\t\tif (spec.vfsRoot !== vfsRoot) {\n\t\t\tthrow new Error(\n\t\t\t\t'All --extra-files entries must share the same vfsRoot. Received ' +\n\t\t\t\t\tJSON.stringify(specs.map((entry) => entry.vfsRoot))\n\t\t\t);\n\t\t}\n\t}\n\n\tconst nodes: ExtensionManifestExtraFile[] = [];\n\tconst claimedVfsPaths = new Set<string>();\n\tconst claimedDestinations = new Set<string>();\n\tfor (const spec of specs) {\n\t\tconst absoluteHostDir = path.resolve(workspaceRoot, spec.hostDir);\n\t\tconst targetSubdir = path.basename(absoluteHostDir);\n\t\tconst destinationDir = path.join(outDir, targetSubdir);\n\t\tif (claimedDestinations.has(destinationDir)) {\n\t\t\tthrow new Error(\n\t\t\t\t`--extra-files destination collides on disk: ${destinationDir}. ` +\n\t\t\t\t\t`Two host directories share the same basename, so one would overwrite the other.`\n\t\t\t);\n\t\t}\n\t\tclaimedDestinations.add(destinationDir);\n\t\tawait mkdir(path.dirname(destinationDir), { recursive: true });\n\t\tawait cp(absoluteHostDir, destinationDir, { recursive: true });\n\n\t\tawait walk(destinationDir, async (entryPath, isDirectory) => {\n\t\t\tconst relativeUnderRoot = path\n\t\t\t\t.relative(destinationDir, entryPath)\n\t\t\t\t.split(path.sep)\n\t\t\t\t.join('/');\n\t\t\tif (!relativeUnderRoot) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst sourcePath = `${targetSubdir}/${relativeUnderRoot}`;\n\t\t\tif (isDirectory) {\n\t\t\t\tconst empty = (await readdir(entryPath)).length === 0;\n\t\t\t\tif (!empty) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (claimedVfsPaths.has(relativeUnderRoot)) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`--extra-files vfsPath collides across specs: ${relativeUnderRoot}.`\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tclaimedVfsPaths.add(relativeUnderRoot);\n\t\t\t\tnodes.push({\n\t\t\t\t\tvfsPath: relativeUnderRoot,\n\t\t\t\t\ttype: 'directory',\n\t\t\t\t});\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (claimedVfsPaths.has(relativeUnderRoot)) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`--extra-files vfsPath collides across specs: ${relativeUnderRoot}.`\n\t\t\t\t);\n\t\t\t}\n\t\t\tclaimedVfsPaths.add(relativeUnderRoot);\n\t\t\tnodes.push({\n\t\t\t\tvfsPath: relativeUnderRoot,\n\t\t\t\tsourcePath,\n\t\t\t});\n\t\t});\n\t}\n\t// Sort with a locale-independent comparator so the manifest is byte-stable\n\t// across machines (`localeCompare` honors the host locale).\n\tnodes.sort((a, b) =>\n\t\ta.vfsPath < b.vfsPath ? -1 : a.vfsPath > b.vfsPath ? 1 : 0\n\t);\n\n\treturn {\n\t\tvfsRoot,\n\t\tnodes,\n\t};\n}\n\nasync function walk(\n\tdir: string,\n\tvisitor: (entryPath: string, isDirectory: boolean) => Promise<void>\n): Promise<void> {\n\tfor (const entry of await readdir(dir)) {\n\t\tconst entryPath = path.join(dir, entry);\n\t\tconst entryStat = await stat(entryPath);\n\t\tawait visitor(entryPath, entryStat.isDirectory());\n\t\tif (entryStat.isDirectory()) {\n\t\t\tawait walk(entryPath, visitor);\n\t\t}\n\t}\n}\n","#!/usr/bin/env node\nimport { existsSync, realpathSync } from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\n\nimport {\n\tcompileExtensionMatrix,\n\tSupportedExtensionPHPVersions,\n} from './compile';\nimport { detectExtensionName } from './detect';\nimport { parseExtraFilesSpec, stageExtraFilesIntoOutDir } from './extra-files';\n\nconst OptionsWithDashPrefixedValues = new Set([\n\t'--config-args',\n\t'--extra-cflags',\n\t'--extra-ldflags',\n]);\n\nexport async function main(args = hideBin(process.argv)) {\n\tconst argv = await yargs(normalizeDashPrefixedOptionValues(args))\n\t\t.scriptName('@php-wasm/compile-extension')\n\t\t.usage('Usage: $0 --source <dir> [options]')\n\t\t.options({\n\t\t\tsource: {\n\t\t\t\ttype: 'string',\n\t\t\t\tdemandOption: true,\n\t\t\t\tdescription: 'Extension source directory containing config.m4',\n\t\t\t},\n\t\t\tname: {\n\t\t\t\ttype: 'string',\n\t\t\t\tdescription: 'Extension name. Defaults to parsing config.m4.',\n\t\t\t},\n\t\t\t'php-versions': {\n\t\t\t\ttype: 'string',\n\t\t\t\tdefault: SupportedExtensionPHPVersions.join(','),\n\t\t\t\tdescription: 'Comma-separated PHP major.minor versions.',\n\t\t\t},\n\t\t\tout: {\n\t\t\t\ttype: 'string',\n\t\t\t\tdefault: './dist',\n\t\t\t\tdescription: 'Output directory.',\n\t\t\t},\n\t\t\t'extra-cflags': {\n\t\t\t\ttype: 'string',\n\t\t\t\tdescription: 'Extra CFLAGS appended to the side-module build.',\n\t\t\t},\n\t\t\t'extra-ldflags': {\n\t\t\t\ttype: 'string',\n\t\t\t\tdescription: 'Extra LDFLAGS appended to the side-module build.',\n\t\t\t},\n\t\t\t'config-args': {\n\t\t\t\ttype: 'string',\n\t\t\t\tdefault: '',\n\t\t\t\tdescription:\n\t\t\t\t\t'Extra ./configure arguments, parsed as shell words.',\n\t\t\t},\n\t\t\toptimize: {\n\t\t\t\ttype: 'string',\n\t\t\t\tdefault: '2',\n\t\t\t\tdescription: 'Optimization level passed as -O<level>.',\n\t\t\t},\n\t\t\tjobs: {\n\t\t\t\ttype: 'number',\n\t\t\t\tdescription: 'Maximum concurrent docker builds.',\n\t\t\t},\n\t\t\t'extra-files': {\n\t\t\t\ttype: 'string',\n\t\t\t\tarray: true,\n\t\t\t\tdefault: [] as string[],\n\t\t\t\tdescription:\n\t\t\t\t\t'Stage a host directory under an absolute VFS root. Format: <hostDir>:<vfsRoot>. Files are copied next to the manifest and recorded in extraFiles.',\n\t\t\t},\n\t\t})\n\t\t.strict()\n\t\t.help()\n\t\t.parse();\n\n\tconst workspaceRoot = findWorkspaceRoot(process.cwd());\n\tconst sourceDir = path.resolve(workspaceRoot, argv['source'] as string);\n\tconst name =\n\t\t(argv['name'] as string | undefined) ??\n\t\t(await detectExtensionName(sourceDir));\n\tconst phpVersions = parseCsv(\n\t\targv['php-versions'] as string,\n\t\t'php-versions'\n\t);\n\tconst configArgs = splitShellWords((argv['config-args'] as string) || '');\n\tconst extraFilesSpecs = (argv['extra-files'] as string[]).map(\n\t\tparseExtraFilesSpec\n\t);\n\tconst outDir = path.resolve(workspaceRoot, argv['out'] as string);\n\tconst extraFiles = await stageExtraFilesIntoOutDir(\n\t\textraFilesSpecs,\n\t\toutDir,\n\t\tworkspaceRoot\n\t);\n\n\tconst result = await compileExtensionMatrix({\n\t\tworkspaceRoot,\n\t\tsourceDir,\n\t\toutDir: argv['out'] as string,\n\t\tname,\n\t\tphpVersions,\n\t\textraCflags: argv['extra-cflags'] as string | undefined,\n\t\textraLdflags: argv['extra-ldflags'] as string | undefined,\n\t\tconfigArgs,\n\t\toptimize: argv['optimize'] as string,\n\t\tjobs: argv['jobs'] as number | undefined,\n\t\textraFiles,\n\t});\n\n\tconsole.log(`Wrote ${result.artifacts.length} artifacts.`);\n\tconsole.log(`Wrote ${result.manifestPath}.`);\n}\n\nif (isCliEntrypoint(import.meta.url)) {\n\tmain().catch((error) => {\n\t\tconsole.error(error instanceof Error ? error.message : error);\n\t\tprocess.exit(1);\n\t});\n}\n\nexport function normalizeDashPrefixedOptionValues(args: string[]): string[] {\n\tconst normalized: string[] = [];\n\tfor (let i = 0; i < args.length; i++) {\n\t\tconst arg = args[i];\n\t\tif (\n\t\t\tOptionsWithDashPrefixedValues.has(arg) &&\n\t\t\ti + 1 < args.length &&\n\t\t\t!args[i + 1].startsWith(`${arg}=`)\n\t\t) {\n\t\t\tnormalized.push(`${arg}=${args[i + 1]}`);\n\t\t\ti++;\n\t\t\tcontinue;\n\t\t}\n\t\tnormalized.push(arg);\n\t}\n\treturn normalized;\n}\n\nfunction parseCsv(value: string, name: string): string[] {\n\tconst values = value\n\t\t.split(',')\n\t\t.map((entry) => entry.trim())\n\t\t.filter(Boolean);\n\tif (values.length === 0) {\n\t\tthrow new Error(`--${name} must contain at least one value.`);\n\t}\n\treturn values;\n}\n\nexport function splitShellWords(value: string): string[] {\n\tconst words: string[] = [];\n\tlet current = '';\n\tlet quote: '\"' | \"'\" | null = null;\n\tlet escaping = false;\n\n\tfor (const character of value) {\n\t\tif (escaping) {\n\t\t\tcurrent += character;\n\t\t\tescaping = false;\n\t\t\tcontinue;\n\t\t}\n\t\tif (character === '\\\\') {\n\t\t\tescaping = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (quote) {\n\t\t\tif (character === quote) {\n\t\t\t\tquote = null;\n\t\t\t} else {\n\t\t\t\tcurrent += character;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\t\tif (character === '\"' || character === \"'\") {\n\t\t\tquote = character;\n\t\t\tcontinue;\n\t\t}\n\t\tif (/\\s/.test(character)) {\n\t\t\tif (current.length > 0) {\n\t\t\t\twords.push(current);\n\t\t\t\tcurrent = '';\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\t\tcurrent += character;\n\t}\n\n\tif (escaping) {\n\t\tcurrent += '\\\\';\n\t}\n\tif (quote) {\n\t\tthrow new Error('Unterminated quote in --config-args.');\n\t}\n\tif (current.length > 0) {\n\t\twords.push(current);\n\t}\n\treturn words;\n}\n\nfunction findWorkspaceRoot(startDirectory: string): string {\n\tlet directory = path.resolve(startDirectory);\n\twhile (directory !== path.dirname(directory)) {\n\t\tif (\n\t\t\texistsSync(path.join(directory, 'packages/php-wasm/compile')) &&\n\t\t\texistsSync(path.join(directory, 'nx.json'))\n\t\t) {\n\t\t\treturn directory;\n\t\t}\n\t\tdirectory = path.dirname(directory);\n\t}\n\treturn process.cwd();\n}\n\nfunction isCliEntrypoint(metaUrl: string): boolean {\n\tconst entrypoint = process.argv[1];\n\tif (!entrypoint) {\n\t\treturn false;\n\t}\n\ttry {\n\t\treturn (\n\t\t\trealpathSync(entrypoint) === realpathSync(fileURLToPath(metaUrl))\n\t\t);\n\t} catch {\n\t\treturn path.resolve(entrypoint) === fileURLToPath(metaUrl);\n\t}\n}\n"],"names":["createDockerContext","workspaceRoot","phpWasmRoot","path","assertDockerIsAvailable","runCommand","error","buildBaseImage","context","buildExtensionImage","options","imageTag","getExtensionImageTag","runExtensionBuild","runArgs","arg","index","command","args","resolve","reject","child","spawn","code","ExtensionAsyncMode","createManifest","manifest","artifact","writeManifest","mkdir","manifestPath","writeFile","SupportedExtensionPHPVersions","PHP_RELEASE_BY_MINOR","compileExtensionMatrix","outDir","sourceDir","version","detectManifestVersion","matrix","phpVersion","artifacts","mapLimit","normalizeJobCount","asyncMode","phpRelease","resolvePHPRelease","artifactFile","packageJson","readFile","items","limit","worker","results","nextIndex","workers","jobs","taskCount","os","EXTENSION_NAME_PATTERNS","detectExtensionName","configPath","config","detected","detectExtensionNameFromConfig","pattern","match","parseExtraFilesSpec","spec","separator","hostDir","vfsRoot","stageExtraFilesIntoOutDir","specs","entry","nodes","claimedVfsPaths","claimedDestinations","absoluteHostDir","targetSubdir","destinationDir","cp","walk","entryPath","isDirectory","relativeUnderRoot","sourcePath","readdir","a","b","dir","visitor","entryStat","stat","OptionsWithDashPrefixedValues","main","hideBin","argv","yargs","normalizeDashPrefixedOptionValues","findWorkspaceRoot","name","phpVersions","parseCsv","configArgs","splitShellWords","extraFilesSpecs","extraFiles","result","isCliEntrypoint","normalized","i","value","values","words","current","quote","escaping","character","startDirectory","directory","existsSync","metaUrl","entrypoint","realpathSync","fileURLToPath"],"mappings":"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"}

package/compile.d.ts

@@ -0,0 +1,26 @@
+import type { ExtensionManifestExtraFiles } from './manifest';
+export declare const SupportedExtensionPHPVersions: readonly ["8.5", "8.4", "8.3", "8.2", "8.1", "8.0", "7.4"];
+export interface CompileExtensionOptions {
+    workspaceRoot: string;
+    sourceDir: string;
+    outDir: string;
+    name: string;
+    phpVersions: string[];
+    extraCflags?: string;
+    extraLdflags?: string;
+    configArgs: string[];
+    optimize: string;
+    jobs?: number;
+    /** Sidecar files to record at the manifest level. */
+    extraFiles?: ExtensionManifestExtraFiles;
+}
+export declare function compileExtensionMatrix(options: CompileExtensionOptions): Promise<{
+    manifestPath: string;
+    artifacts: {
+        phpVersion: string;
+        sourcePath: string;
+        path: string;
+    }[];
+    manifest: import("./manifest").ExtensionManifest;
+}>;
+export declare function resolvePHPRelease(phpVersion: string): string;

package/detect.d.ts

@@ -0,0 +1,2 @@
+export declare function detectExtensionName(sourceDir: string): Promise<string>;
+export declare function detectExtensionNameFromConfig(config: string): string | null;

package/docker/Dockerfile.ext

@@ -0,0 +1,64 @@
+FROM playground-php-wasm:base
+
+ARG PHP_VERSION
+ARG JSPI="no"
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+	bison \
+	php-cli
+
+RUN git clone https://github.com/php/php-src.git /root/php-src \
+	--branch php-$PHP_VERSION \
+	--single-branch \
+	--depth 1
+
+RUN cd /root/php-src && ./buildconf --force
+
+COPY ./compile/php/php*.patch /root/
+RUN cd /root && git apply --no-index /root/php${PHP_VERSION:0:3}*.patch -v
+
+RUN source /root/emsdk/emsdk_env.sh && \
+	cd /root/php-src && \
+	emconfigure ./configure \
+	--disable-fiber-asm \
+	--enable-embed \
+	--disable-cgi \
+	--disable-opcache-jit \
+	--disable-opcache \
+	--disable-phpdbg \
+	--without-pcre-jit \
+	--disable-cli \
+	--disable-libxml \
+	--without-libxml \
+	--disable-dom \
+	--disable-xml \
+	--disable-simplexml \
+	--disable-xmlreader \
+	--disable-xmlwriter \
+	--without-sqlite3 \
+	--without-pdo-sqlite \
+	--without-iconv
+
+RUN /root/replace.sh 's/ZEND_USE_ASM_ARITHMETIC 1/ZEND_USE_ASM_ARITHMETIC 0/g' /root/php-src/Zend/zend_operators.h
+RUN /root/replace.sh 's/defined\(__GNUC__\)/0/g' /root/php-src/Zend/zend_multiply.h
+RUN /root/replace.sh 's/defined\(__GNUC__\)/0/g' /root/php-src/Zend/zend_cpuinfo.c
+RUN /root/replace.sh 's/defined\(__clang__\)/0/g' /root/php-src/Zend/zend_cpuinfo.c
+
+RUN source /root/emsdk/emsdk_env.sh && \
+	cd /root/php-src && \
+	emmake make install
+
+RUN mkdir -p /usr/local/include/php/ext/standard && \
+	if [ -f /root/php-src/ext/standard/php_smart_string.h ]; then \
+		cp /root/php-src/ext/standard/*.h /usr/local/include/php/ext/standard/; \
+	else \
+		echo '#include "Zend/zend_smart_string.h"' > /usr/local/include/php/ext/standard/php_smart_string.h; \
+	fi && \
+	if [ -d /root/php-src/ext/random ]; then \
+		cp /root/php-src/ext/random/*.h /usr/local/include/php/ext/standard/; \
+	fi
+
+COPY ./compile-extension/scripts/build-in-docker.sh /usr/local/bin/build-php-wasm-extension
+RUN chmod +x /usr/local/bin/build-php-wasm-extension
+
+ENTRYPOINT ["/usr/local/bin/build-php-wasm-extension"]

package/docker.d.ts

@@ -0,0 +1,26 @@
+import type { AsyncMode } from './manifest';
+export interface DockerBuildContext {
+    workspaceRoot: string;
+    phpWasmRoot: string;
+    compileRoot: string;
+}
+export interface DockerImageOptions extends DockerBuildContext {
+    phpVersion: string;
+    phpRelease: string;
+    asyncMode: AsyncMode;
+}
+export interface DockerRunOptions extends DockerImageOptions {
+    sourceDir: string;
+    outDir: string;
+    name: string;
+    artifactFile: string;
+    optimize: string;
+    extraCflags?: string;
+    extraLdflags?: string;
+    configArgs: string[];
+}
+export declare function createDockerContext(workspaceRoot: string): DockerBuildContext;
+export declare function assertDockerIsAvailable(): Promise<void>;
+export declare function buildBaseImage(context: DockerBuildContext): Promise<void>;
+export declare function buildExtensionImage(options: DockerImageOptions): Promise<string>;
+export declare function runExtensionBuild(options: DockerRunOptions): Promise<void>;

package/extra-files.d.ts

@@ -0,0 +1,26 @@
+import type { ExtensionManifestExtraFiles } from './manifest';
+/**
+ * Parses a `--extra-files` CLI argument of the form `<hostDir>:<vfsRoot>`.
+ *
+ * `vfsRoot` must be an absolute VFS path so the loader can stage files
+ * without making up a default root. Splitting on the *last* colon lets
+ * Windows host paths like `C:\dir:/internal/root` round-trip cleanly.
+ */
+export declare function parseExtraFilesSpec(spec: string): {
+    hostDir: string;
+    vfsRoot: string;
+};
+/**
+ * Copies one or more host directories into `outDir` and returns a manifest
+ * `extraFiles` group whose `sourcePath` entries are relative to `outDir`.
+ *
+ * Each spec is `<hostDir>:<vfsRoot>`. All specs must agree on `vfsRoot`
+ * because the manifest format only stores a single `vfsRoot` per group.
+ *
+ * Files keep their relative path under `vfsRoot`. Empty directories are
+ * recorded as `type: 'directory'` nodes so the loader creates them.
+ */
+export declare function stageExtraFilesIntoOutDir(specs: Array<{
+    hostDir: string;
+    vfsRoot: string;
+}>, outDir: string, workspaceRoot: string): Promise<ExtensionManifestExtraFiles | undefined>;

package/manifest.d.ts

@@ -0,0 +1,52 @@
+export declare const ExtensionAsyncMode = "jspi";
+export type AsyncMode = typeof ExtensionAsyncMode;
+/**
+ * One sidecar file or empty directory staged alongside an artifact.
+ *
+ * Mirrors `PHPExtensionManifestExtraFile` in `@php-wasm/universal`.
+ */
+export interface ExtensionManifestExtraFile {
+    /** Joined with the group's `vfsRoot` to form the final VFS path. */
+    vfsPath: string;
+    /** Defaults to "file". Only file nodes need a `sourcePath`. */
+    type?: 'file' | 'directory';
+    /** Relative to the manifest URL/base URL, or an absolute URL. */
+    sourcePath?: string;
+}
+export interface ExtensionManifestExtraFiles {
+    /** Absolute VFS prefix joined with each node's `vfsPath`. */
+    vfsRoot?: string;
+    nodes?: ExtensionManifestExtraFile[];
+}
+export interface ExtensionArtifact {
+    phpVersion: string;
+    /** Path to the `.so` file, relative to the manifest URL or absolute. */
+    sourcePath: string;
+    /** URL-backed files needed only by this artifact. */
+    extraFiles?: ExtensionManifestExtraFiles;
+}
+export interface ExtensionManifest {
+    name: string;
+    version: string;
+    artifacts: ExtensionArtifact[];
+    /** URL-backed files shared by every artifact in this manifest. */
+    extraFiles?: ExtensionManifestExtraFiles;
+}
+export interface BuiltArtifact {
+    phpVersion: string;
+    /** Path to the `.so` file, relative to the manifest URL. */
+    sourcePath: string;
+    /** Absolute path on disk where the `.so` was written. */
+    path: string;
+}
+export declare function createManifest(options: {
+    name: string;
+    version: string;
+    artifacts: BuiltArtifact[];
+    extraFiles?: ExtensionManifestExtraFiles;
+}): Promise<ExtensionManifest>;
+export declare function writeManifest(options: {
+    outDir: string;
+    manifest: ExtensionManifest;
+}): Promise<string>;
+export declare function findExtensionArtifact(manifest: ExtensionManifest, phpVersion: string): ExtensionArtifact | undefined;

package/package.json

@@ -1,15 +1,54 @@
 {
-	"name": "@php-wasm/compile-extension",
-	"version": "0.0.0",
-	"description": "Placeholder for the PHP.wasm extension compiler package.",
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/WordPress/wordpress-playground"
-	},
-	"homepage": "https://developer.wordpress.org/playground",
-	"author": "The WordPress contributors",
-	"license": "GPL-2.0-or-later",
-	"publishConfig": {
-		"access": "public"
-	}
-}
+  "name": "@php-wasm/compile-extension",
+  "version": "3.1.26",
+  "description": "Build PHP.wasm extension side modules across PHP versions",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/WordPress/wordpress-playground"
+  },
+  "homepage": "https://developer.wordpress.org/playground",
+  "author": "The WordPress contributors",
+  "publishConfig": {
+    "access": "public",
+    "directory": "../../../dist/packages/php-wasm/compile-extension"
+  },
+  "license": "GPL-2.0-or-later",
+  "type": "module",
+  "main": "./cli.js",
+  "module": "./cli.js",
+  "types": "./cli.d.ts",
+  "bin": {
+    "php-wasm-compile-extension": "./cli.js"
+  },
+  "dependencies": {
+    "ajv": "8.12.0",
+    "express": "4.22.0",
+    "fast-xml-parser": "^5.5.1",
+    "fs-ext-extra-prebuilt": "2.2.7",
+    "ini": "4.1.2",
+    "jsonc-parser": "3.3.1",
+    "wasm-feature-detect": "1.8.0",
+    "ws": "8.18.0",
+    "yargs": "17.7.2",
+    "@php-wasm/node": "3.1.26",
+    "@php-wasm/universal": "3.1.26"
+  },
+  "engines": {
+    "node": ">=20.10.0",
+    "npm": ">=10.2.3"
+  },
+  "gitHead": "6acfccb8e79f4e664429e3f729f04dbf2ff55303",
+  "packageManager": "npm@10.9.2",
+  "overrides": {
+    "rollup": "^4.34.6",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "typescript": "5.4.5",
+    "@playwright/test": "1.55.1",
+    "tmp": "0.2.5",
+    "form-data": "^4.0.4",
+    "lodash": "^4.17.23",
+    "glob": "^9.3.0",
+    "webpackbar": "^7.0.0"
+  }
+}

package/scripts/build-in-docker.sh

@@ -0,0 +1,114 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [ ! -d /src ]; then
+	echo "Missing /src extension source mount." >&2
+	exit 1
+fi
+
+if [ -z "${EXTENSION_NAME:-}" ]; then
+	echo "Missing EXTENSION_NAME." >&2
+	exit 1
+fi
+
+ASYNC_MODE="${ASYNC_MODE:-jspi}"
+OPTIMIZE="${OPTIMIZE:-2}"
+ARTIFACT_FILENAME="${ARTIFACT_FILENAME:-${EXTENSION_NAME}-php${PHP_VERSION_SHORT:-unknown}-${ASYNC_MODE}.so}"
+MAKE_JOBS="${MAKE_JOBS:-$(nproc)}"
+USER_EXTRA_CFLAGS="${EXTRA_CFLAGS:-}"
+USER_EXTRA_LDFLAGS="${EXTRA_LDFLAGS:-}"
+unset EXTRA_CFLAGS EXTRA_LDFLAGS
+
+rm -rf /build
+mkdir -p /build /out
+cp -R /src/. /build/
+cd /build
+
+phpize .
+source /root/emsdk/emsdk_env.sh
+export EMSDK_SYSROOT="${EMSDK_SYSROOT:-${EMSDK}/upstream/emscripten/cache/sysroot}"
+
+BASE_CFLAGS="-DZEND_ENABLE_ZVAL_LONG64 -D__x86_64__ -fPIC -O${OPTIMIZE}"
+BASE_LDFLAGS="-sSIDE_MODULE=1 -sWASM_BIGINT -fPIC -O${OPTIMIZE}"
+
+if [ "$ASYNC_MODE" != "jspi" ]; then
+	echo "Unsupported ASYNC_MODE: ${ASYNC_MODE}." >&2
+	echo "Custom extensions can only be built for JSPI runtimes." >&2
+	exit 1
+fi
+ASYNC_FLAGS="-sSUPPORT_LONGJMP=wasm -fwasm-exceptions -sJSPI"
+
+EXTRA_LINK_FLAGS=""
+EXTRA_STATIC_ARCHIVES=""
+for flag in $USER_EXTRA_LDFLAGS; do
+	if [[ "$flag" == *.a ]]; then
+		EXTRA_STATIC_ARCHIVES="${EXTRA_STATIC_ARCHIVES} ${flag}"
+	else
+		EXTRA_LINK_FLAGS="${EXTRA_LINK_FLAGS} ${flag}"
+	fi
+done
+
+export CFLAGS="${BASE_CFLAGS} ${USER_EXTRA_CFLAGS}"
+export CXXFLAGS="${BASE_CFLAGS} ${USER_EXTRA_CFLAGS}"
+export BINDGEN_EXTRA_CLANG_ARGS="--target=wasm32-unknown-emscripten --sysroot=${EMSDK_SYSROOT} -DZEND_ENABLE_ZVAL_LONG64 -D__x86_64__ ${BINDGEN_EXTRA_CLANG_ARGS:-}"
+export CFLAGS_wasm32_unknown_emscripten="-fPIC ${CFLAGS_wasm32_unknown_emscripten:-}"
+export CXXFLAGS_wasm32_unknown_emscripten="-fPIC ${CXXFLAGS_wasm32_unknown_emscripten:-}"
+export CC_wasm32_unknown_emscripten="${CC_wasm32_unknown_emscripten:-emcc}"
+export CXX_wasm32_unknown_emscripten="${CXX_wasm32_unknown_emscripten:-em++}"
+export AR_wasm32_unknown_emscripten="${AR_wasm32_unknown_emscripten:-emar}"
+export RANLIB_wasm32_unknown_emscripten="${RANLIB_wasm32_unknown_emscripten:-emranlib}"
+CONFIGURE_LDFLAGS="${BASE_LDFLAGS} ${ASYNC_FLAGS}"
+BUILD_LDFLAGS="${CONFIGURE_LDFLAGS} ${EXTRA_LINK_FLAGS}"
+export LDFLAGS="${CONFIGURE_LDFLAGS}"
+# The libtool patch below injects EMCC_FLAGS into the final archive command.
+# Keep dependency archives out of LDFLAGS so libtool does not drop or duplicate them.
+export EMCC_FLAGS="${BUILD_LDFLAGS}"
+export EMCC_STATIC_ARCHIVES="${EXTRA_STATIC_ARCHIVES}"
+
+configure_args=("--host=i386-unknown-freebsd" "--enable-${EXTENSION_NAME}" "--disable-static" "--enable-shared")
+config_args_count="${CONFIG_ARGS_COUNT:-0}"
+for ((i = 0; i < config_args_count; i++)); do
+	arg_name="CONFIG_ARG_${i}"
+	configure_args+=("${!arg_name}")
+done
+
+if ! emconfigure ./configure "${configure_args[@]}"; then
+	if [ -f config.log ]; then
+		cat config.log >&2
+	fi
+	exit 1
+fi
+
+if [ -f libtool ]; then
+	if [ -n "$EMCC_STATIC_ARCHIVES" ]; then
+		/root/replace.sh 's|^archive_cmds="\\\$CC|archive_cmds="emcc \\\$EMCC_FLAGS -shared --whole-archive \\\$EMCC_STATIC_ARCHIVES --no-whole-archive|' libtool || true
+	else
+		/root/replace.sh 's|^archive_cmds="\\\$CC|archive_cmds="emcc \\\$EMCC_FLAGS|' libtool || true
+	fi
+fi
+
+emmake make -j"${MAKE_JOBS}"
+
+module_path="modules/${EXTENSION_NAME}.so"
+if [ ! -f "$module_path" ]; then
+	module_path="$(find modules -maxdepth 1 -name '*.so' -print -quit)"
+fi
+
+if [ -z "$module_path" ] || [ ! -f "$module_path" ]; then
+	echo "Could not find a built .so under /build/modules." >&2
+	exit 1
+fi
+
+if [ -x /root/emsdk/upstream/bin/wasm-opt ]; then
+	/root/emsdk/upstream/bin/wasm-opt -Oz \
+		--enable-bulk-memory \
+		--enable-nontrapping-float-to-int \
+		--enable-sign-ext \
+		--enable-mutable-globals \
+		--enable-exception-handling \
+		"$module_path" \
+		-o "$module_path"
+fi
+
+mkdir -p /out
+cp "$module_path" "/out/${ARTIFACT_FILENAME}"