@php-wasm/universal 3.1.21 → 3.1.25

package/index.js

@@ -1,8 +1,8 @@
-var Y = (r) => {
+var J = (r) => {
   throw TypeError(r);
 };
-var W = (r, e, t) => e.has(r) || Y("Cannot " + t);
-var u = (r, e, t) => (W(r, e, "read from private field"), t ? t.call(r) : e.get(r)), y = (r, e, t) => e.has(r) ? Y("Cannot add the same private member more than once") : e instanceof WeakSet ? e.add(r) : e.set(r, t), g = (r, e, t, s) => (W(r, e, "write to private field"), s ? s.call(r, t) : e.set(r, t), t), m = (r, e, t) => (W(r, e, "access private method"), t);
+var q = (r, e, t) => e.has(r) || J("Cannot " + t);
+var d = (r, e, t) => (q(r, e, "read from private field"), t ? t.call(r) : e.get(r)), y = (r, e, t) => e.has(r) ? J("Cannot add the same private member more than once") : e instanceof WeakSet ? e.add(r) : e.set(r, t), w = (r, e, t, s) => (q(r, e, "write to private field"), s ? s.call(r, t) : e.set(r, t), t), m = (r, e, t) => (q(r, e, "access private method"), t);
 import { logger } from "@php-wasm/logger";
 import { dirname, joinPaths, Semaphore, createSpawnHandler, basename, normalizePath, AcquireTimeoutError, splitShellCommand } from "@php-wasm/util";
 import { parse, stringify } from "ini";
@@ -376,7 +376,7 @@ class PHPWorker {
   /** @inheritDoc */
   constructor(e, t) {
     y(this, v);
-    this.absoluteUrl = "", this.documentRoot = "", this.chroot = null, g(this, v, /* @__PURE__ */ new Map()), this.onMessageListeners = [], _private.set(this, {
+    this.absoluteUrl = "", this.documentRoot = "", this.chroot = null, w(this, v, /* @__PURE__ */ new Map()), this.onMessageListeners = [], _private.set(this, {
       monitor: t
     }), e && this.__internal_setRequestHandler(e);
   }
@@ -404,7 +404,7 @@ class PHPWorker {
    * a warning.
    */
   __internal_getRequestHandler() {
-    return _private.get(this).requestHandler;
+    return this.getRequestHandler();
   }
   async setPrimaryPHP(e) {
     _private.set(this, {
@@ -414,11 +414,11 @@ class PHPWorker {
   }
   /** @inheritDoc @php-wasm/universal!PHPRequestHandler.pathToInternalUrl  */
   pathToInternalUrl(e) {
-    return _private.get(this).requestHandler.pathToInternalUrl(e);
+    return this.getRequestHandler().pathToInternalUrl(e);
   }
   /** @inheritDoc @php-wasm/universal!PHPRequestHandler.internalUrlToPath  */
   internalUrlToPath(e) {
-    return _private.get(this).requestHandler.internalUrlToPath(e);
+    return this.getRequestHandler().internalUrlToPath(e);
   }
   /**
    * The onDownloadProgress event listener.
@@ -437,7 +437,7 @@ class PHPWorker {
   }
   /** @inheritDoc @php-wasm/universal!PHPRequestHandler.request */
   async request(e) {
-    return await _private.get(this).requestHandler.request(e);
+    return await this.getRequestHandler().request(e);
   }
   /**
    * Handles a request with streaming support for large responses.
@@ -450,27 +450,33 @@ class PHPWorker {
    * @param request - PHP Request data.
    */
   async requestStreamed(e) {
-    return await _private.get(this).requestHandler.requestStreamed(e);
+    return await this.getRequestHandler().requestStreamed(e);
   }
   /** @inheritDoc @php-wasm/universal!/PHP.run */
   async run(e) {
-    const { php: t, reap: s } = await this.acquirePHPInstance();
+    const t = _private.get(this), s = t.php;
+    if (!t.requestHandler && !(s != null && s.requestHandler) && s)
+      return await s.run(e);
+    const { php: n, reap: i } = await this.acquirePHPInstance();
     try {
-      return await t.run(e);
+      return await n.run(e);
     } finally {
-      s();
+      i();
     }
   }
   /** @inheritDoc @php-wasm/universal!/PHP.cli */
   async cli(e, t) {
-    const { php: s, reap: n } = await this.acquirePHPInstance();
-    let i;
+    const s = _private.get(this), n = s.php;
+    if (!s.requestHandler && !(n != null && n.requestHandler) && n)
+      return await n.cli(e, t);
+    const { php: i, reap: o } = await this.acquirePHPInstance();
+    let a;
     try {
-      i = await s.cli(e, t);
-    } catch (o) {
-      throw n(), o;
+      a = await i.cli(e, t);
+    } catch (c) {
+      throw o(), c;
     }
-    return i.finished.finally(n), i;
+    return a.finished.finally(o), a;
   }
   /** @inheritDoc @php-wasm/universal!/PHP.chdir */
   chdir(e) {
@@ -484,7 +490,7 @@ class PHPWorker {
    * @returns A PHP instance with a consistent chroot.
    */
   async acquirePHPInstance() {
-    const { php: e, reap: t } = await _private.get(this).requestHandler.instanceManager.acquirePHPInstance();
+    const { php: e, reap: t } = await this.getRequestHandler().instanceManager.acquirePHPInstance();
     return this.chroot !== null && e.chdir(this.chroot), this.registerWorkerListeners(e), { php: e, reap: t };
   }
   /** @inheritDoc @php-wasm/universal!/PHP.setSapiName */
@@ -545,7 +551,7 @@ class PHPWorker {
   }
   /** @inheritDoc @php-wasm/universal!/PHP.addEventListener */
   addEventListener(e, t) {
-    u(this, v).has(e) || u(this, v).set(e, /* @__PURE__ */ new Set()), u(this, v).get(e).add(t);
+    d(this, v).has(e) || d(this, v).set(e, /* @__PURE__ */ new Set()), d(this, v).get(e).add(t);
   }
   /**
    * Removes an event listener for a PHP event.
@@ -554,10 +560,10 @@ class PHPWorker {
    */
   removeEventListener(e, t) {
     var s;
-    (s = u(this, v).get(e)) == null || s.delete(t);
+    (s = d(this, v).get(e)) == null || s.delete(t);
   }
   dispatchEvent(e) {
-    const t = u(this, v).get(e.type);
+    const t = d(this, v).get(e.type);
     if (t)
       for (const s of t)
         s(e);
@@ -576,7 +582,17 @@ class PHPWorker {
   }
   async [Symbol.asyncDispose]() {
     var e;
-    await ((e = _private.get(this).requestHandler) == null ? void 0 : e[Symbol.asyncDispose]());
+    await ((e = this.getRequestHandler(!1)) == null ? void 0 : e[Symbol.asyncDispose]());
+  }
+  getRequestHandler(e = !0) {
+    var s;
+    const t = _private.get(this);
+    if (t.requestHandler)
+      return t.requestHandler;
+    if ((s = t.php) != null && s.requestHandler)
+      return this.__internal_setRequestHandler(t.php.requestHandler), t.php.requestHandler;
+    if (e)
+      throw new Error("PHPWorker is not connected to a request handler.");
   }
 }
 v = new WeakMap();
@@ -587,14 +603,14 @@ const RuntimeId = Symbol("RuntimeId"), loadedRuntimes = /* @__PURE__ */ new Map(
 let lastRuntimeId = 0;
 async function loadPHPRuntime(r, ...e) {
   const t = Object.assign({}, ...e), [s, n, i] = makePromise(), o = r.init(currentJsRuntime, {
-    onAbort(c) {
-      i(c), logger.error(c);
+    onAbort(l) {
+      i(l), logger.error(l);
     },
     ENV: {},
     // Emscripten sometimes prepends a '/' to the path, which
     // breaks vite dev mode. An identity `locateFile` function
     // fixes it.
-    locateFile: (c) => c,
+    locateFile: (l) => l,
     ...t,
     noInitialRun: !0,
     onRuntimeInitialized() {
@@ -602,10 +618,12 @@ async function loadPHPRuntime(r, ...e) {
     }
   });
   await s;
-  const a = ++lastRuntimeId;
-  return o.FS, o.id = a, o.originalExit = o._exit, o._exit = function(c) {
-    return o.outboundNetworkProxyServer && (o.outboundNetworkProxyServer.close(), o.outboundNetworkProxyServer.closeAllConnections()), loadedRuntimes.delete(a), o.originalExit(c);
-  }, o[RuntimeId] = a, loadedRuntimes.set(a, o), a;
+  const a = t.phpWasmAsyncMode ?? r.phpWasmAsyncMode;
+  a && (o.phpWasmAsyncMode = a);
+  const c = ++lastRuntimeId;
+  return o.FS, o.id = c, o.originalExit = o._exit, o._exit = function(l) {
+    return o.outboundNetworkProxyServer && (o.outboundNetworkProxyServer.close(), o.outboundNetworkProxyServer.closeAllConnections()), loadedRuntimes.delete(c), o.originalExit(l);
+  }, o[RuntimeId] = c, loadedRuntimes.set(c, o), c;
 }
 function popLoadedRuntime(r, {
   dangerouslyKeepTheRuntimeInTheMap: e = !1
@@ -644,8 +662,8 @@ const currentJsRuntime = function() {
   201: "Created",
   200: "OK"
 };
-var N, O;
-const D = class D {
+var O, U;
+const W = class W {
   constructor(e, t, s, n) {
     /**
      * Headers stream that doesn't get locked when the consumer
@@ -654,14 +672,14 @@ const D = class D {
      * Both streams must be readable when the StreamedPHPResponse is transferred
      * from the worker thread into the service worker.
      */
-    y(this, N);
+    y(this, O);
     /**
      * Headers stream reserved for internal parsing.
      */
-    y(this, O);
+    y(this, U);
     this.cachedParsedHeaders = null, this.cachedStdoutBytes = null, this.cachedStderrText = null;
     const [i, o] = e.tee();
-    g(this, N, i), g(this, O, o), this.stdout = t, this.stderr = s, this.exitCode = n;
+    w(this, O, i), w(this, U, o), this.stdout = t, this.stderr = s, this.exitCode = n;
   }
   /**
    * Creates a StreamedPHPResponse from a buffered PHPResponse.
@@ -690,7 +708,7 @@ const D = class D {
         ), a.close();
       }
     });
-    return new D(
+    return new W(
       i,
       t,
       o,
@@ -702,7 +720,7 @@ const D = class D {
    * Shorthand for `StreamedPHPResponse.fromPHPResponse(PHPResponse.forHttpCode(...))`.
    */
   static forHttpCode(e, t = "") {
-    return D.fromPHPResponse(
+    return W.fromPHPResponse(
       PHPResponse.forHttpCode(e, t)
     );
   }
@@ -711,7 +729,7 @@ const D = class D {
    * For parsed headers, use the `headers` property instead.
    */
   getHeadersStream() {
-    return u(this, N);
+    return d(this, O);
   }
   /**
    * True if the response is successful (HTTP status code 200-399),
@@ -772,12 +790,12 @@ const D = class D {
   }
   async getParsedHeaders() {
     return this.cachedParsedHeaders || (this.cachedParsedHeaders = parseHeadersStream(
-      u(this, O)
+      d(this, U)
     )), await this.cachedParsedHeaders;
   }
 };
-N = new WeakMap(), O = new WeakMap();
-let StreamedPHPResponse = D;
+O = new WeakMap(), U = new WeakMap();
+let StreamedPHPResponse = W;
 async function parseHeadersStream(r) {
   const e = await streamToText(r);
   let t;
@@ -1051,7 +1069,7 @@ class PHPExecutionFailureError extends Error {
   }
 }
 const PHP_INI_PATH = "/internal/shared/php.ini", AUTO_PREPEND_SCRIPT = "/internal/shared/auto_prepend_file.php", OPCACHE_FILE_FOLDER = "/internal/shared/opcache";
-var C, R, b, x, H, T, _, h, J, X, Q, K, Z, ee, te, re, $, se, q, z;
+var I, R, H, F, b, T, _, f, Y, X, Q, K, Z, ee, te, re, z, se, V, G;
 class PHP {
   /**
    * Initializes a PHP runtime.
@@ -1061,15 +1079,15 @@ class PHP {
    * @param  requestHandlerOptions - Optional. Options for the PHPRequestHandler. If undefined, no request handler will be initialized.
    */
   constructor(r) {
-    y(this, h);
-    y(this, C);
+    y(this, f);
+    y(this, I);
     y(this, R, !1);
-    y(this, b, null);
-    y(this, x, /* @__PURE__ */ new Map([
+    y(this, H, null);
+    y(this, F, /* @__PURE__ */ new Map([
       // Listen to all events
       ["*", /* @__PURE__ */ new Set()]
     ]));
-    y(this, H, []);
+    y(this, b, []);
     y(this, T, {});
     y(this, _, {
       enabled: !1,
@@ -1079,7 +1097,7 @@ class PHP {
       requestsMade: 0
     });
     this.semaphore = new Semaphore({ concurrency: 1 }), r !== void 0 && this.initializeRuntime(r), this.addEventListener("request.error", (e) => {
-      e.source === "php-wasm" && (u(this, _).needsRotating = !0);
+      e.source === "php-wasm" && (d(this, _).needsRotating = !0);
     });
   }
   /**
@@ -1088,7 +1106,7 @@ class PHP {
    * @param listener - The listener function to be called when the event is triggered.
    */
   addEventListener(r, e) {
-    u(this, x).has(r) || u(this, x).set(r, /* @__PURE__ */ new Set()), u(this, x).get(r).add(e);
+    d(this, F).has(r) || d(this, F).set(r, /* @__PURE__ */ new Set()), d(this, F).get(r).add(e);
   }
   /**
    * Removes an event listener for a PHP event.
@@ -1097,12 +1115,12 @@ class PHP {
    */
   removeEventListener(r, e) {
     var t;
-    (t = u(this, x).get(r)) == null || t.delete(e);
+    (t = d(this, F).get(r)) == null || t.delete(e);
   }
   dispatchEvent(r) {
     const e = [
-      ...u(this, x).get(r.type) || [],
-      ...u(this, x).get("*") || []
+      ...d(this, F).get(r.type) || [],
+      ...d(this, F).get("*") || []
     ];
     if (e)
       for (const t of e)
@@ -1148,8 +1166,8 @@ class PHP {
    * @param listener Callback function to handle the message.
    */
   onMessage(r) {
-    return u(this, H).push(r), async () => {
-      g(this, H, u(this, H).filter(
+    return d(this, b).push(r), async () => {
+      w(this, b, d(this, b).filter(
         (e) => e !== r
       ));
     };
@@ -1243,13 +1261,13 @@ class PHP {
 				}
 				`
     ), e.onMessage = async (t) => {
-      for (const s of u(this, H)) {
+      for (const s of d(this, b)) {
         const n = await s(t);
         if (n)
           return n;
       }
       return "";
-    }, g(this, b, improveWASMErrorReporting(e)), this.dispatchEvent({
+    }, w(this, H, improveWASMErrorReporting(e)), this.dispatchEvent({
       type: "runtime.initialized"
     });
   }
@@ -1264,7 +1282,7 @@ class PHP {
       throw new Error(
         "Could not set SAPI name. This can only be done before the PHP WASM module is initialized.Did you already dispatch any requests?"
       );
-    g(this, C, r);
+    w(this, I, r);
   }
   /**
    * Changes the current working directory in the PHP filesystem.
@@ -1486,8 +1504,8 @@ class PHP {
   async runStream(r) {
     const e = await this.semaphore.acquire();
     let t;
-    const s = m(this, h, z).call(this, async () => {
-      if (u(this, R) || (await this[__private__dont__use].ccall(
+    const s = m(this, f, G).call(this, async () => {
+      if (d(this, R) || (await this[__private__dont__use].ccall(
         "php_wasm_init",
         null,
         [],
@@ -1495,26 +1513,26 @@ class PHP {
         {
           isAsync: !0
         }
-      ), g(this, R, !0)), r.scriptPath && !this.fileExists(r.scriptPath))
+      ), w(this, R, !0)), r.scriptPath && !this.fileExists(r.scriptPath))
         throw new Error(
           `The script path "${r.scriptPath}" does not exist.`
         );
-      m(this, h, X).call(this, r.relativeUri || ""), m(this, h, ee).call(this, r.method || "GET");
-      const i = normalizeHeaders(r.headers || {}), o = i.host || "example.com:443", a = m(this, h, Z).call(this, o, r.protocol || "http");
-      if (m(this, h, Q).call(this, o), m(this, h, K).call(this, a), m(this, h, te).call(this, i), r.body && (t = m(this, h, re).call(this, r.body)), typeof r.code == "string")
-        this.writeFile("/internal/eval.php", r.code), m(this, h, $).call(this, "/internal/eval.php");
+      m(this, f, X).call(this, r.relativeUri || ""), m(this, f, ee).call(this, r.method || "GET");
+      const i = normalizeHeaders(r.headers || {}), o = i.host || "example.com:443", a = m(this, f, Z).call(this, o, r.protocol || "http");
+      if (m(this, f, Q).call(this, o), m(this, f, K).call(this, a), m(this, f, te).call(this, i), r.body && (t = m(this, f, re).call(this, r.body)), typeof r.code == "string")
+        this.writeFile("/internal/eval.php", r.code), m(this, f, z).call(this, "/internal/eval.php");
       else if (typeof r.scriptPath == "string")
-        m(this, h, $).call(this, r.scriptPath || "");
+        m(this, f, z).call(this, r.scriptPath || "");
       else
         throw new TypeError(
           "The request object must have either a `code` or a `scriptPath` property."
         );
-      const c = m(this, h, J).call(this, r.$_SERVER, i, a);
-      for (const d in c)
-        m(this, h, se).call(this, d, c[d]);
+      const c = m(this, f, Y).call(this, r.$_SERVER, i, a);
+      for (const u in c)
+        m(this, f, se).call(this, u, c[u]);
       const l = r.env || {};
-      for (const d in l)
-        m(this, h, q).call(this, d, l[d]);
+      for (const u in l)
+        m(this, f, V).call(this, u, l[u]);
       return await this[__private__dont__use].ccall(
         "wasm_sapi_handle_request",
         NUMBER,
@@ -1752,21 +1770,21 @@ class PHP {
    * or an internal crash.
    */
   enableRuntimeRotation(r) {
-    g(this, _, {
-      ...u(this, _),
+    w(this, _, {
+      ...d(this, _),
       enabled: !0,
       recreateRuntime: r.recreateRuntime,
       maxRequests: r.maxRequests ?? 400
     });
   }
   async rotateRuntime() {
-    if (!u(this, _).enabled)
+    if (!d(this, _).enabled)
       throw new Error(
         "Runtime rotation is not enabled. Call enableRuntimeRotation() first."
       );
     await this.hotSwapPHPRuntime(
-      await u(this, _).recreateRuntime()
-    ), u(this, _).requestsMade = 0, u(this, _).needsRotating = !1;
+      await d(this, _).recreateRuntime()
+    ), d(this, _).requestsMade = 0, d(this, _).needsRotating = !1;
   }
   /**
    * Hot-swaps the PHP runtime for a new one without
@@ -1777,13 +1795,13 @@ class PHP {
   async hotSwapPHPRuntime(r) {
     const e = this[__private__dont__use].FS, t = this.listFiles("/").map((c) => `/${c}`), s = this[__private__dont__use].spawnProcess, n = e.cwd();
     e.chdir("/");
-    const i = Object.entries(u(this, T)).map(
+    const i = Object.entries(d(this, T)).map(
       ([c, l]) => ({
         mountHandler: l.mountHandler,
         vfsPath: c
       })
     ), o = Object.values(
-      u(this, T)
+      d(this, T)
     ).reverse();
     for (const c of o)
       await c.unmount();
@@ -1791,7 +1809,7 @@ class PHP {
       this.exit();
     } catch {
     }
-    this.initializeRuntime(r), s && (this[__private__dont__use].spawnProcess = s), u(this, C) && this.setSapiName(u(this, C));
+    this.initializeRuntime(r), s && (this[__private__dont__use].spawnProcess = s), d(this, I) && this.setSapiName(d(this, I));
     const a = this[__private__dont__use].FS;
     for (const c of t)
       c && c !== "/request" && copyMEMFSNodes(e, a, c);
@@ -1826,11 +1844,11 @@ class PHP {
         try {
           await t();
         } finally {
-          delete u(this, T)[r];
+          delete d(this, T)[r];
         }
       }
     };
-    return u(this, T)[r] = s, () => s.unmount();
+    return d(this, T)[r] = s, () => s.unmount();
   }
   /**
    * Starts a PHP CLI session with given arguments.
@@ -1848,12 +1866,12 @@ class PHP {
   async cli(r, e = {}) {
     if (basename(r[0] ?? "") !== "php")
       return this.subProcess(r, e);
-    u(this, R) && (u(this, _).needsRotating = !0);
+    d(this, R) && (d(this, _).needsRotating = !0);
     const t = await this.semaphore.acquire();
-    return await m(this, h, z).call(this, () => {
+    return await m(this, f, G).call(this, () => {
       const s = e.env || {};
       for (const [n, i] of Object.entries(s))
-        m(this, h, q).call(this, n, i);
+        m(this, f, V).call(this, n, i);
       r = [r[0], "-c", PHP_INI_PATH, ...r.slice(1)];
       for (const n of r)
         this[__private__dont__use].ccall(
@@ -1866,7 +1884,7 @@ class PHP {
         async: !0
       });
     }).then((s) => (s.exitCode.finally(t), s)).finally(() => {
-      u(this, _).needsRotating = !0;
+      d(this, _).needsRotating = !0;
     });
   }
   /**
@@ -1948,13 +1966,13 @@ class PHP {
       this[__private__dont__use]._exit(r);
     } catch {
     }
-    g(this, R, !1), g(this, b, null), this[__private__dont__use] && (delete this[__private__dont__use].onMessage, delete this[__private__dont__use]);
+    w(this, R, !1), w(this, H, null), this[__private__dont__use] && (delete this[__private__dont__use].onMessage, delete this[__private__dont__use]);
   }
   [Symbol.dispose]() {
     this.exit(0);
   }
 }
-C = new WeakMap(), R = new WeakMap(), b = new WeakMap(), x = new WeakMap(), H = new WeakMap(), T = new WeakMap(), _ = new WeakMap(), h = new WeakSet(), /**
+I = new WeakMap(), R = new WeakMap(), H = new WeakMap(), F = new WeakMap(), b = new WeakMap(), T = new WeakMap(), _ = new WeakMap(), f = new WeakSet(), /**
  * Prepares the $_SERVER entries for the PHP runtime.
  *
  * @param defaults Default entries to include in $_SERVER.
@@ -1963,7 +1981,7 @@ C = new WeakMap(), R = new WeakMap(), b = new WeakMap(), x = new WeakMap(), H =
  *             was provided.
  * @returns Computed $_SERVER entries.
  */
-J = function(r, e, t) {
+Y = function(r, e, t) {
   const s = {
     ...r || {}
   };
@@ -2055,7 +2073,7 @@ J = function(r, e, t) {
     [NUMBER],
     [t]
   ), s;
-}, $ = function(r) {
+}, z = function(r) {
   this[__private__dont__use].ccall(
     "wasm_set_path_translated",
     null,
@@ -2069,87 +2087,87 @@ J = function(r, e, t) {
     [STRING, STRING],
     [r, e]
   );
-}, q = function(r, e) {
+}, V = function(r, e) {
   this[__private__dont__use].ccall(
     "wasm_add_ENV_entry",
     null,
     [STRING, STRING],
     [r, e]
   );
-}, z = async function(r) {
-  u(this, _).enabled && u(this, _).needsRotating && await this.rotateRuntime(), ++u(this, _).requestsMade, u(this, _).requestsMade >= u(this, _).maxRequests && (u(this, _).needsRotating = !0);
+}, G = async function(r) {
+  d(this, _).enabled && d(this, _).needsRotating && await this.rotateRuntime(), ++d(this, _).requestsMade, d(this, _).requestsMade >= d(this, _).maxRequests && (d(this, _).needsRotating = !0);
   const e = this[__private__dont__use], t = await createInvertedReadableStream();
-  e.onHeaders = (p) => {
-    a || s || t.controller.enqueue(p.slice());
+  e.onHeaders = (h) => {
+    a || s || t.controller.enqueue(h.slice());
   };
   let s = !1;
   const n = () => {
     s || (s = !0, t.controller.close());
   }, i = await createInvertedReadableStream();
-  e.onStdout = (p) => {
-    n(), !a && i.controller.enqueue(p.slice());
+  e.onStdout = (h) => {
+    n(), !a && i.controller.enqueue(h.slice());
   };
   const o = await createInvertedReadableStream();
-  e.onStderr = (p) => {
-    a || o.controller.enqueue(p.slice());
+  e.onStderr = (h) => {
+    a || o.controller.enqueue(h.slice());
   };
   let a = !1, c;
-  const d = (async () => {
-    var p;
+  const u = (async () => {
+    var h;
     try {
       return await Promise.race([
         r(),
-        new Promise((w, F) => {
-          var V;
-          c = (G) => {
-            isExitCode(G.error) || F(G.error);
-          }, (V = u(this, b)) == null || V.addEventListener(
+        new Promise((g, S) => {
+          var $;
+          c = (N) => {
+            isExitCode(N.error) || S(N.error);
+          }, ($ = d(this, H)) == null || $.addEventListener(
             "error",
             c,
             { once: !0 }
           );
         })
       ]);
-    } catch (f) {
-      if (isExitCode(f))
-        return f.status;
-      safeStreamError$1(i.controller, f), safeStreamError$1(o.controller, f), safeStreamError$1(t.controller, f), a = !0;
-      for (const w in this)
-        typeof this[w] == "function" && (this[w] = () => {
+    } catch (p) {
+      if (isExitCode(p))
+        return p.status;
+      safeStreamError$1(i.controller, p), safeStreamError$1(o.controller, p), safeStreamError$1(t.controller, p), a = !0;
+      for (const g in this)
+        typeof this[g] == "function" && (this[g] = () => {
           throw new Error(
             "PHP runtime has crashed – see the earlier error for details."
           );
         });
-      throw this.functionsMaybeMissingFromAsyncify = getFunctionsMaybeMissingFromAsyncify(), f;
+      throw this.functionsMaybeMissingFromAsyncify = getFunctionsMaybeMissingFromAsyncify(), p;
     } finally {
-      a || (safeStreamClose$1(i.controller), safeStreamClose$1(o.controller), n(), a = !0), (p = u(this, b)) == null || p.removeEventListener(
+      a || (safeStreamClose$1(i.controller), safeStreamClose$1(o.controller), n(), a = !0), (h = d(this, H)) == null || h.removeEventListener(
         "error",
         c
       );
     }
   })().then(
-    (p) => (p !== 0 && this.dispatchEvent({
+    (h) => (h !== 0 && this.dispatchEvent({
       type: "request.error",
       error: new Error(
-        `PHP.run() failed with exit code ${p}.`
+        `PHP.run() failed with exit code ${h}.`
       ),
       // Distinguish between PHP request and PHP-wasm errors
       source: "php-wasm"
-    }), p),
-    (p) => {
-      const f = p.source ?? "php-wasm";
+    }), h),
+    (h) => {
+      const p = h.source ?? "php-wasm";
       throw this.dispatchEvent({
         type: "request.error",
-        error: p,
-        source: f
-      }), p;
+        error: h,
+        source: p
+      }), h;
     }
   );
   return new StreamedPHPResponse(
     t.stream,
     i.stream,
     o.stream,
-    d
+    u
   );
 };
 function normalizeHeaders(r) {
@@ -2640,7 +2658,7 @@ const _default = "application/octet-stream", asx = "video/x-ms-asf", atom = "app
   xspf,
   zip
 };
-var S, I, U, L, M, E, A, k, j, P, ne, B, ie, oe, ae;
+var x, C, j, L, M, E, A, k, D, P, ne, B, ie, oe, ae;
 class PHPRequestHandler {
   /**
    * The request handler needs to decide whether to serve a static asset or
@@ -2655,23 +2673,23 @@ class PHPRequestHandler {
    */
   constructor(e) {
     y(this, P);
-    y(this, S);
-    y(this, I);
-    y(this, U);
+    y(this, x);
+    y(this, C);
+    y(this, j);
     y(this, L);
     y(this, M);
     y(this, E);
     y(this, A);
     y(this, k);
-    y(this, j);
+    y(this, D);
     const {
       documentRoot: t = "/www/",
       absoluteUrl: s = typeof location == "object" ? location.href : DEFAULT_BASE_URL,
       rewriteRules: n = [],
       pathAliases: i = [],
       getFileNotFoundAction: o = () => ({ type: "404" })
-    } = e, a = (d) => {
-      d.isDir(t) || d.mkdir(t), d.chdir(t), d.requestHandler = this;
+    } = e, a = (u) => {
+      u.isDir(t) || u.mkdir(t), u.chdir(t), u.requestHandler = this;
     };
     if (e.php)
       a(e.php), this.instanceManager = new SinglePHPInstanceManager({
@@ -2679,12 +2697,12 @@ class PHPRequestHandler {
       });
     else if (e.phpFactory)
       this.instanceManager = new PHPProcessManager({
-        phpFactory: async (d) => {
-          const p = await e.phpFactory({
-            ...d,
+        phpFactory: async (u) => {
+          const h = await e.phpFactory({
+            ...u,
             requestHandler: this
           });
-          return a(p), p;
+          return a(h), h;
         },
         maxPhpInstances: e.maxPhpInstances
       });
@@ -2692,18 +2710,18 @@ class PHPRequestHandler {
       throw new Error(
         "Either php or phpFactory must be provided in the configuration."
       );
-    g(this, k, e.cookieStore === void 0 ? new HttpCookieStore() : e.cookieStore), g(this, S, t);
+    w(this, k, e.cookieStore === void 0 ? new HttpCookieStore() : e.cookieStore), w(this, x, t);
     const c = new URL(s);
-    g(this, U, c.hostname), g(this, L, c.port ? Number(c.port) : c.protocol === "https:" ? 443 : 80), g(this, I, (c.protocol || "").replace(":", ""));
-    const l = u(this, L) !== 443 && u(this, L) !== 80;
-    g(this, M, [
-      u(this, U),
-      l ? `:${u(this, L)}` : ""
-    ].join("")), g(this, E, c.pathname.replace(/\/+$/, "")), g(this, A, [
-      `${u(this, I)}://`,
-      u(this, M),
-      u(this, E)
-    ].join("")), this.rewriteRules = n, g(this, j, i), this.getFileNotFoundAction = o;
+    w(this, j, c.hostname), w(this, L, c.port ? Number(c.port) : c.protocol === "https:" ? 443 : 80), w(this, C, (c.protocol || "").replace(":", ""));
+    const l = d(this, L) !== 443 && d(this, L) !== 80;
+    w(this, M, [
+      d(this, j),
+      l ? `:${d(this, L)}` : ""
+    ].join("")), w(this, E, c.pathname.replace(/\/+$/, "")), w(this, A, [
+      `${d(this, C)}://`,
+      d(this, M),
+      d(this, E)
+    ].join("")), this.rewriteRules = n, w(this, D, i), this.getFileNotFoundAction = o;
   }
   async getPrimaryPhp() {
     return await this.instanceManager.getPrimaryPhp();
@@ -2727,20 +2745,20 @@ class PHPRequestHandler {
    */
   internalUrlToPath(e) {
     const t = new URL(e, "https://playground.internal");
-    return t.pathname.startsWith(u(this, E)) && (t.pathname = t.pathname.slice(u(this, E).length)), toRelativeUrl(t);
+    return t.pathname.startsWith(d(this, E)) && (t.pathname = t.pathname.slice(d(this, E).length)), toRelativeUrl(t);
   }
   /**
    * The absolute URL of this PHPRequestHandler instance.
    */
   get absoluteUrl() {
-    return u(this, A);
+    return d(this, A);
   }
   /**
    * The directory in the PHP filesystem where the server will look
    * for the files to serve. Default: `/var/www`.
    */
   get documentRoot() {
-    return u(this, S);
+    return d(this, x);
   }
   /**
    * Serves the request – either by serving a static file, or by
@@ -2822,7 +2840,7 @@ class PHPRequestHandler {
        * before using it as a filesystem path.
        */
       decodeURIComponent(n.pathname),
-      u(this, E)
+      d(this, E)
     );
     let a = m(this, P, B).call(this, o);
     if (i.isDir(a)) {
@@ -2867,7 +2885,7 @@ class PHPRequestHandler {
             c.response
           );
         case "internal-redirect":
-          a = joinPaths(u(this, S), c.uri);
+          a = joinPaths(d(this, x), c.uri);
           break;
         case "404":
           return StreamedPHPResponse.forHttpCode(404);
@@ -2972,11 +2990,11 @@ class PHPRequestHandler {
   prepare_$_SERVER_superglobal(e, t, s) {
     const n = {
       REMOTE_ADDR: "127.0.0.1",
-      DOCUMENT_ROOT: u(this, S),
-      HTTPS: u(this, A).startsWith("https://") ? "on" : ""
+      DOCUMENT_ROOT: d(this, x),
+      HTTPS: d(this, A).startsWith("https://") ? "on" : ""
     };
-    return n.REQUEST_URI = e.pathname + e.search, s.startsWith(u(this, S)) && (n.SCRIPT_NAME = s.substring(
-      u(this, S).length
+    return n.REQUEST_URI = e.pathname + e.search, s.startsWith(d(this, x)) && (n.SCRIPT_NAME = s.substring(
+      d(this, x).length
     ), n.PHP_SELF = t.pathname, n.REQUEST_URI.startsWith(n.SCRIPT_NAME) && (n.PATH_INFO = n.REQUEST_URI.substring(
       n.SCRIPT_NAME.length
     ), n.PATH_INFO.includes("?") && (n.PATH_INFO = n.PATH_INFO.substring(
@@ -2988,7 +3006,7 @@ class PHPRequestHandler {
     await this.instanceManager[Symbol.asyncDispose]();
   }
 }
-S = new WeakMap(), I = new WeakMap(), U = new WeakMap(), L = new WeakMap(), M = new WeakMap(), E = new WeakMap(), A = new WeakMap(), k = new WeakMap(), j = new WeakMap(), P = new WeakSet(), /**
+x = new WeakMap(), C = new WeakMap(), j = new WeakMap(), L = new WeakMap(), M = new WeakMap(), E = new WeakMap(), A = new WeakMap(), k = new WeakMap(), D = new WeakMap(), P = new WeakSet(), /**
  * Apply the rewrite rules to the original request URL.
  *
  * @param originalRequestUrl - The original request URL.
@@ -2997,12 +3015,12 @@ S = new WeakMap(), I = new WeakMap(), U = new WeakMap(), L = new WeakMap(), M =
 ne = function(e) {
   const t = removePathPrefix(
     decodeURIComponent(e.pathname),
-    u(this, E)
+    d(this, E)
   ), s = applyRewriteRules(
     t,
     this.rewriteRules
   ), n = new URL(
-    joinPaths(u(this, E), s),
+    joinPaths(d(this, E), s),
     e.toString()
   );
   for (const [i, o] of e.searchParams.entries())
@@ -3018,12 +3036,12 @@ ne = function(e) {
  * @returns The resolved filesystem path
  */
 B = function(e) {
-  for (const t of u(this, j))
+  for (const t of d(this, D))
     if (e === t.urlPrefix || e.startsWith(t.urlPrefix + "/")) {
       const s = e.slice(t.urlPrefix.length);
       return joinPaths(t.fsPath, s);
     }
-  return joinPaths(u(this, S), e);
+  return joinPaths(d(this, x), e);
 }, /**
  * Serves a static file from the PHP filesystem.
  *
@@ -3064,22 +3082,22 @@ ie = function(e, t) {
 }, ae = async function(e, t, s, n, i) {
   let o = "GET";
   const a = {
-    host: u(this, M),
+    host: d(this, M),
     ...normalizeHeaders(t.headers || {})
   };
-  u(this, k) && (a.cookie = u(this, k).getCookieRequestHeader());
+  d(this, k) && (a.cookie = d(this, k).getCookieRequestHeader());
   let c = t.body;
   if (typeof c == "object" && !(c instanceof Uint8Array)) {
     o = "POST";
-    const { bytes: d, contentType: p } = await encodeAsMultipart(c);
-    c = d, a["content-type"] = p;
+    const { bytes: u, contentType: h } = await encodeAsMultipart(c);
+    c = u, a["content-type"] = h;
   }
   const l = await e.runStream({
     relativeUri: ensurePathPrefix(
       toRelativeUrl(new URL(n.toString())),
-      u(this, E)
+      d(this, E)
     ),
-    protocol: u(this, I),
+    protocol: d(this, C),
     method: t.method || o,
     $_SERVER: this.prepare_$_SERVER_superglobal(
       s,
@@ -3090,10 +3108,10 @@ ie = function(e, t) {
     scriptPath: i,
     headers: a
   });
-  if (u(this, k)) {
-    const d = await l.headers;
-    u(this, k).rememberCookiesFromResponseHeaders(
-      d
+  if (d(this, k)) {
+    const u = await l.headers;
+    d(this, k).rememberCookiesFromResponseHeaders(
+      u
     );
   }
   return l;
@@ -3134,6 +3152,200 @@ async function writeFiles(r, e, t, { rmRoot: s = !1 } = {}) {
     await r.fileExists(dirname(o)) || await r.mkdir(dirname(o)), i instanceof Uint8Array || typeof i == "string" ? await r.writeFile(o, i) : await writeFiles(r, o, i);
   }
 }
+const PHP_EXTENSIONS_DIR = "/internal/shared/extensions";
+async function resolvePHPExtension(r) {
+  const e = await resolvePHPExtensionSource(
+    r,
+    r.fetch ?? globalThis.fetch
+  );
+  return buildResolvedPHPExtension({
+    name: r.name ?? e.name,
+    soBytes: e.soBytes,
+    loadWithIniDirective: r.loadWithIniDirective,
+    iniEntries: r.iniEntries,
+    extraFiles: r.extraFiles,
+    env: r.env,
+    extensionDir: r.extensionDir
+  });
+}
+function withResolvedPHPExtensions(r, e) {
+  if (!e.length)
+    return r;
+  const t = {
+    ...r.ENV
+  };
+  for (const s of e) {
+    Object.assign(t, s.env);
+    const n = t.PHP_INI_SCAN_DIR, i = n ? n.split(":") : [];
+    t.PHP_INI_SCAN_DIR = !n || !i.includes(s.extensionDir) ? [...i, s.extensionDir].join(":") : n;
+  }
+  return {
+    ...r,
+    ENV: t,
+    onRuntimeInitialized: (s) => {
+      var n;
+      (n = r.onRuntimeInitialized) == null || n.call(r, s);
+      for (const i of e)
+        installPHPExtensionFilesSync(s.FS, i);
+    }
+  };
+}
+function buildResolvedPHPExtension(r) {
+  const e = r.extensionDir ?? PHP_EXTENSIONS_DIR, t = r.name;
+  if (!/^[a-zA-Z0-9_-]+$/.test(t))
+    throw new Error(
+      `Invalid PHP extension name ${JSON.stringify(
+        t
+      )}. Extension names are used to build VFS file names and ini paths, so they may only contain [a-zA-Z0-9_-].`
+    );
+  const s = r.loadWithIniDirective ?? "extension", n = joinPaths(e, `${t}.so`), i = joinPaths(e, `${t}.ini`), o = [
+    `${s}=${n}`,
+    ...Object.entries(r.iniEntries ?? {}).map(
+      ([c, l]) => `${c}=${l}`
+    )
+  ].join(`
+`), a = r.extraFiles ? {
+    ...r.extraFiles,
+    targetPath: r.extraFiles.targetPath ?? joinPaths(e, `${t}-assets`)
+  } : void 0;
+  return {
+    soPath: n,
+    soBytes: toUint8Array(r.soBytes),
+    iniPath: i,
+    iniContent: o,
+    extraFiles: a,
+    env: r.env,
+    extensionDir: e
+  };
+}
+function installPHPExtensionFilesSync(r, e) {
+  const t = "soPath" in e ? e : buildResolvedPHPExtension(e);
+  return FSHelpers.fileExists(r, t.extensionDir) || r.mkdirTree(t.extensionDir), r.writeFile(t.soPath, t.soBytes), r.writeFile(t.iniPath, t.iniContent), t.extraFiles && writeFileTreeSync(
+    r,
+    t.extraFiles.targetPath,
+    t.extraFiles.files
+  ), t;
+}
+async function resolvePHPExtensionSource(r, e) {
+  const t = r.source;
+  if (t.format === "so") {
+    const h = r.name ?? t.name;
+    if (!h)
+      throw new Error(
+        "name is required when loading an extension from direct bytes."
+      );
+    return t.sha256 && await assertSha256(t.bytes, t.sha256, h), { name: h, soBytes: toUint8Array(t.bytes) };
+  }
+  if (t.format === "url") {
+    let h;
+    try {
+      h = new URL(String(t.url));
+    } catch {
+      throw new Error(
+        `source.url must be an absolute URL when loading a PHP extension from a direct URL. Received: ${String(
+          t.url
+        )}`
+      );
+    }
+    const p = r.name ?? t.name ?? (() => {
+      const N = h.pathname.split("/").pop() ?? "";
+      return N.endsWith(".so") ? N.slice(0, -3) : void 0;
+    })();
+    if (!p)
+      throw new Error(
+        "name is required when loading an extension from a direct URL."
+      );
+    if (!e)
+      throw new Error(
+        "resolvePHPExtension() requires a fetch implementation."
+      );
+    const g = await e(h);
+    if (!g.ok)
+      throw new Error(
+        `Failed to fetch ${String(h)}: ${g.status}`
+      );
+    const S = new Uint8Array(await g.arrayBuffer());
+    return t.sha256 && await assertSha256(S, t.sha256, String(h)), { name: p, soBytes: S };
+  }
+  const s = "manifestUrl" in t ? new URL(String(t.manifestUrl)) : void 0;
+  let n;
+  if ("manifest" in t)
+    n = t.manifest;
+  else {
+    if (!e)
+      throw new Error(
+        "resolvePHPExtension() requires a fetch implementation."
+      );
+    const h = await e(s);
+    if (!h.ok)
+      throw new Error(
+        `Failed to fetch ${String(s)}: ${h.status}`
+      );
+    n = await h.json();
+  }
+  if (!n || typeof n != "object")
+    throw new Error("Extension manifest must be an object.");
+  const i = n;
+  if (typeof i.name != "string" || !i.name)
+    throw new Error("Extension manifest must include a name.");
+  if (!Array.isArray(i.artifacts))
+    throw new Error("Extension manifest must include an artifacts array.");
+  for (const h of i.artifacts) {
+    if (!h || typeof h.phpVersion != "string" || typeof h.file != "string")
+      throw new Error("Extension manifest contains an invalid artifact.");
+    if ("asyncMode" in h)
+      throw new Error(
+        "Extension manifests do not use asyncMode. External PHP extensions require JSPI."
+      );
+  }
+  const o = "baseUrl" in t && t.baseUrl ? new URL(String(t.baseUrl)) : s, a = i.artifacts.find(
+    (h) => h.phpVersion === r.phpVersion
+  );
+  if (!a)
+    throw new Error(
+      `No extension artifact found for PHP ${r.phpVersion}.`
+    );
+  if (!o)
+    throw new Error(
+      "Manifest artifacts require a manifest URL or baseUrl so relative files can be resolved."
+    );
+  const c = new URL(a.file, o);
+  if (!e)
+    throw new Error(
+      "resolvePHPExtension() requires a fetch implementation."
+    );
+  const l = await e(c);
+  if (!l.ok)
+    throw new Error(
+      `Failed to fetch ${String(c)}: ${l.status}`
+    );
+  const u = new Uint8Array(await l.arrayBuffer());
+  return a.sha256 && await assertSha256(u, a.sha256, a.file), {
+    name: i.name,
+    soBytes: u
+  };
+}
+function writeFileTreeSync(r, e, t) {
+  FSHelpers.fileExists(r, e) || r.mkdirTree(e);
+  for (const [s, n] of Object.entries(t)) {
+    const i = joinPaths(e, s), o = dirname(i);
+    FSHelpers.fileExists(r, o) || r.mkdirTree(o), n instanceof Uint8Array || typeof n == "string" ? r.writeFile(i, n) : writeFileTreeSync(r, i, n);
+  }
+}
+async function assertSha256(r, e, t) {
+  var o;
+  const s = (o = globalThis.crypto) == null ? void 0 : o.subtle;
+  if (!s)
+    throw new Error(
+      `Cannot verify ${t}: crypto.subtle is not available.`
+    );
+  const n = await s.digest("SHA-256", toUint8Array(r));
+  if (Array.from(new Uint8Array(n)).map((a) => a.toString(16).padStart(2, "0")).join("") !== e)
+    throw new Error(`SHA-256 mismatch for ${t}.`);
+}
+function toUint8Array(r) {
+  return r instanceof Uint8Array ? r : new Uint8Array(r);
+}
 function isLegacyPhpInstance(r) {
   var n;
   const e = Object.getOwnPropertySymbols(r)[0], t = r[e], s = (n = t == null ? void 0 : t.phpVersion) == null ? void 0 : n.major;
@@ -3146,25 +3358,25 @@ function ensureProxyFSHasMmapSupport(r) {
       throw new n.ErrnoError(19);
     if (a !== 0)
       throw new n.ErrnoError(22);
-    const d = t.malloc(o);
-    if (!d)
+    const u = t.malloc(o);
+    if (!u)
       throw new n.ErrnoError(48);
-    const p = t.HEAPU8.subarray(d, d + o);
-    let f = 0;
-    for (; f < o; ) {
-      const w = i.stream_ops.read(
+    const h = t.HEAPU8.subarray(u, u + o);
+    let p = 0;
+    for (; p < o; ) {
+      const g = i.stream_ops.read(
         i,
+        h,
         p,
-        f,
-        o - f,
-        f
+        o - p,
+        p
       );
-      if (w <= 0) break;
-      f += w;
+      if (g <= 0) break;
+      p += g;
     }
-    if (f !== o)
-      throw t.free(d), new n.ErrnoError(5);
-    return { ptr: d, allocated: !0 };
+    if (p !== o)
+      throw t.free(u), new n.ErrnoError(5);
+    return { ptr: u, allocated: !0 };
   }, s.stream_ops.msync = function(i, o, a, c, l) {
     return l & 2 || i.stream_ops.write(
       i,
@@ -3372,10 +3584,10 @@ class NodeSABSyncReceiveMessageTransport {
     ), Atomics.wait(i, 0, 0, 5e3) === "timed-out")
       throw new Error("Timeout waiting for response");
     for (; ; ) {
-      const d = NodeSABSyncReceiveMessageTransport.receiveMessageOnPort(e);
-      if (((l = d.message) == null ? void 0 : l.id) === o)
-        return d.message;
-      if (!d)
+      const u = NodeSABSyncReceiveMessageTransport.receiveMessageOnPort(e);
+      if (((l = u.message) == null ? void 0 : l.id) === o)
+        return u.message;
+      if (!u)
         throw new Error("No response received");
     }
   }
@@ -3453,51 +3665,51 @@ function expose(r, e = globalThis, t = ["*"], s) {
       path: [],
       ...i.data
     }, l = (i.data.argumentList || []).map(fromWireValue);
-    let d;
+    let u;
     try {
-      const p = c.slice(0, -1).reduce((w, F) => w[F], r), f = c.reduce((w, F) => w[F], r);
+      const h = c.slice(0, -1).reduce((g, S) => g[S], r), p = c.reduce((g, S) => g[S], r);
       switch (a) {
         case MessageType.GET:
-          d = f;
+          u = p;
           break;
         case MessageType.SET:
-          p[c.slice(-1)[0]] = fromWireValue(
+          h[c.slice(-1)[0]] = fromWireValue(
             i.data.value
-          ), d = !0;
+          ), u = !0;
           break;
         case MessageType.APPLY:
-          d = f.apply(p, l);
+          u = p.apply(h, l);
           break;
         case MessageType.CONSTRUCT:
           {
-            const w = new f(...l);
-            d = proxy(w);
+            const g = new p(...l);
+            u = proxy(g);
           }
           break;
         case MessageType.ENDPOINT:
           {
-            const { port1: w, port2: F } = new MessageChannel();
-            expose(r, F), d = transfer(w, [w]);
+            const { port1: g, port2: S } = new MessageChannel();
+            expose(r, S), u = transfer(g, [g]);
           }
           break;
         case MessageType.RELEASE:
-          d = void 0;
+          u = void 0;
           break;
         default:
           return;
       }
-    } catch (p) {
-      d = { value: p, [throwMarker]: 0 };
+    } catch (h) {
+      u = { value: h, [throwMarker]: 0 };
     }
-    Promise.resolve(d).catch((p) => ({ value: p, [throwMarker]: 0 })).then((p) => {
-      const [f, w] = toWireValue(p);
-      e.postMessage({ ...f, id: o }, w), a === MessageType.RELEASE && (e.removeEventListener("message", n), closeEndPoint(e), finalizer in r && typeof r[finalizer] == "function" && r[finalizer]());
+    Promise.resolve(u).catch((h) => ({ value: h, [throwMarker]: 0 })).then((h) => {
+      const [p, g] = toWireValue(h);
+      e.postMessage({ ...p, id: o }, g), a === MessageType.RELEASE && (e.removeEventListener("message", n), closeEndPoint(e), finalizer in r && typeof r[finalizer] == "function" && r[finalizer]());
     }).catch(() => {
-      const [p, f] = toWireValue({
+      const [h, p] = toWireValue({
         value: new TypeError("Unserializable return value"),
         [throwMarker]: 0
       });
-      e.postMessage({ ...p, id: o }, f);
+      e.postMessage({ ...h, id: o }, p);
     }).finally(() => {
       s == null || s(i);
     });
@@ -3568,16 +3780,16 @@ function createProxy(r, e, t = [], s = function() {
     },
     set(o, a, c) {
       throwIfProxyReleased(n);
-      const [l, d] = toWireValue(c);
+      const [l, u] = toWireValue(c);
       return requestResponseMessage(
         r,
         e,
         {
           type: MessageType.SET,
-          path: [...t, a].map((p) => p.toString()),
+          path: [...t, a].map((h) => h.toString()),
           value: l
         },
-        d
+        u
       ).then(fromWireValue);
     },
     apply(o, a, c) {
@@ -3589,16 +3801,16 @@ function createProxy(r, e, t = [], s = function() {
         }).then(fromWireValue);
       if (l === "bind")
         return createProxy(r, e, t.slice(0, -1));
-      const [d, p] = processArguments(c);
+      const [u, h] = processArguments(c);
       return requestResponseMessage(
         r,
         e,
         {
           type: MessageType.APPLY,
-          path: t.map((f) => f.toString()),
-          argumentList: d
+          path: t.map((p) => p.toString()),
+          argumentList: u
         },
-        p
+        h
       ).then(fromWireValue);
     },
     construct(o, a) {
@@ -3609,7 +3821,7 @@ function createProxy(r, e, t = [], s = function() {
         e,
         {
           type: MessageType.CONSTRUCT,
-          path: t.map((d) => d.toString()),
+          path: t.map((u) => u.toString()),
           argumentList: c
         },
         l
@@ -3809,19 +4021,19 @@ const errorProperties = [
     useToJSON: o,
     serialize: a
   });
-  for (const [l, d] of Object.entries(r)) {
-    if (d && d instanceof Uint8Array && d.constructor.name === "Buffer") {
+  for (const [l, u] of Object.entries(r)) {
+    if (u && u instanceof Uint8Array && u.constructor.name === "Buffer") {
       t[l] = "[object Buffer]";
       continue;
     }
-    if (d !== null && typeof d == "object" && typeof d.pipe == "function") {
+    if (u !== null && typeof u == "object" && typeof u.pipe == "function") {
       t[l] = "[object Stream]";
       continue;
     }
-    if (typeof d != "function") {
-      if (!d || typeof d != "object") {
+    if (typeof u != "function") {
+      if (!u || typeof u != "object") {
         try {
-          t[l] = d;
+          t[l] = u;
         } catch {
         }
         continue;
@@ -3834,10 +4046,10 @@ const errorProperties = [
     }
   }
   if (a || t instanceof Error)
-    for (const { property: l, enumerable: d } of errorProperties)
+    for (const { property: l, enumerable: u } of errorProperties)
       r[l] !== void 0 && r[l] !== null && Object.defineProperty(t, l, {
         value: isErrorLike(r[l]) || Array.isArray(r[l]) ? c(r[l]) : r[l],
-        enumerable: s ? !0 : d,
+        enumerable: s ? !0 : u,
         configurable: !0,
         writable: !0
       });
@@ -4782,18 +4994,25 @@ function createObjectPoolProxy(r) {
   }
   function i(o) {
     return s().then((a) => {
-      let c;
+      const c = (u) => {
+        const h = u == null ? void 0 : u.finished;
+        return h && typeof h.then == "function" ? Promise.resolve(h).then(
+          () => n(a),
+          () => n(a)
+        ) : n(a), u;
+      };
+      let l;
       try {
-        c = o(a);
-      } catch (l) {
-        throw n(a), l;
+        l = o(a);
+      } catch (u) {
+        throw n(a), u;
       }
-      return c != null && typeof c.then == "function" ? c.then(
-        (l) => (n(a), l),
-        (l) => {
-          throw n(a), l;
+      return l != null && typeof l.then == "function" ? l.then(
+        (u) => c(u),
+        (u) => {
+          throw n(a), u;
         }
-      ) : (n(a), c);
+      ) : c(l);
     });
   }
   return new Proxy({}, {
@@ -4803,14 +5022,14 @@ function createObjectPoolProxy(r) {
       if (a !== "then")
         return new Proxy(function() {
         }, {
-          apply(c, l, d) {
-            return i((p) => p[a](...d));
+          apply(c, l, u) {
+            return i((h) => h[a](...u));
           },
           get(c, l) {
             if (l === "then")
-              return (d, p) => i((f) => f[a]).then(
-                d,
-                p
+              return (u, h) => i((p) => p[a]).then(
+                u,
+                h
               );
           }
         });
@@ -4857,6 +5076,7 @@ export {
   PHPRequestHandler,
   PHPResponse,
   PHPWorker,
+  PHP_EXTENSIONS_DIR,
   ProcessIdAllocator,
   SinglePHPInstanceManager,
   StreamedPHPResponse,
@@ -4874,6 +5094,7 @@ export {
   exposeSyncAPI,
   getPhpIniEntries,
   inferMimeType,
+  installPHPExtensionFilesSync,
   isExitCode,
   isLegacyPHPVersion,
   isPathToSharedFS,
@@ -4887,12 +5108,14 @@ export {
   proxyFileSystem,
   releaseApiProxy,
   removePathPrefix,
+  resolvePHPExtension,
   rotatePHPRuntime,
   sandboxedSpawnHandlerFactory,
   setPhpIniEntries,
   streamToPort,
   toRelativeUrl,
   withPHPIniValues,
+  withResolvedPHPExtensions,
   writeFiles,
   writeFilesStreamToPhp
 };