@php-wasm/universal 3.1.20 → 3.1.22

package/index.js

@@ -1,8 +1,8 @@
-var J = (r) => {
+var Y = (r) => {
   throw TypeError(r);
 };
-var W = (r, e, t) => e.has(r) || J("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) ? J("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) || Y("Cannot " + t);
+var h = (r, e, t) => (q(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), 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);
+    h(this, v).has(e) || h(this, v).set(e, /* @__PURE__ */ new Set()), h(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 = h(this, v).get(e)) == null || s.delete(t);
   }
   dispatchEvent(e) {
-    const t = u(this, v).get(e.type);
+    const t = h(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 h(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)
+      h(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, T, H, w, p, Y, X, Q, K, Z, ee, te, re, $, se, q, z;
+var I, R, H, F, b, T, _, f, J, X, Q, K, Z, ee, te, re, z, se, V, G;
 class PHP {
   /**
    * Initializes a PHP runtime.
@@ -1061,17 +1079,17 @@ class PHP {
    * @param  requestHandlerOptions - Optional. Options for the PHPRequestHandler. If undefined, no request handler will be initialized.
    */
   constructor(r) {
-    y(this, p);
-    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, T, []);
-    y(this, H, {});
-    y(this, w, {
+    y(this, b, []);
+    y(this, T, {});
+    y(this, _, {
       enabled: !1,
       recreateRuntime: () => 0,
       needsRotating: !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, w).needsRotating = !0);
+      e.source === "php-wasm" && (h(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);
+    h(this, F).has(r) || h(this, F).set(r, /* @__PURE__ */ new Set()), h(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 = h(this, F).get(r)) == null || t.delete(e);
   }
   dispatchEvent(r) {
     const e = [
-      ...u(this, x).get(r.type) || [],
-      ...u(this, x).get("*") || []
+      ...h(this, F).get(r.type) || [],
+      ...h(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, T).push(r), async () => {
-      g(this, T, u(this, T).filter(
+    return h(this, b).push(r), async () => {
+      w(this, b, h(this, b).filter(
         (e) => e !== r
       ));
     };
@@ -1243,13 +1261,13 @@ class PHP {
 				}
 				`
     ), e.onMessage = async (t) => {
-      for (const s of u(this, T)) {
+      for (const s of h(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, p, z).call(this, async () => {
-      if (u(this, R) || (await this[__private__dont__use].ccall(
+    const s = m(this, f, G).call(this, async () => {
+      if (h(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, p, X).call(this, r.relativeUri || ""), m(this, p, ee).call(this, r.method || "GET");
-      const i = normalizeHeaders(r.headers || {}), o = i.host || "example.com:443", a = m(this, p, Z).call(this, o, r.protocol || "http");
-      if (m(this, p, Q).call(this, o), m(this, p, K).call(this, a), m(this, p, te).call(this, i), r.body && (t = m(this, p, re).call(this, r.body)), typeof r.code == "string")
-        this.writeFile("/internal/eval.php", r.code), m(this, p, $).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, p, $).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, p, Y).call(this, r.$_SERVER, i, a);
-      for (const d in c)
-        m(this, p, se).call(this, d, c[d]);
+      const c = m(this, f, J).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, p, 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, w, {
-      ...u(this, w),
+    w(this, _, {
+      ...h(this, _),
       enabled: !0,
       recreateRuntime: r.recreateRuntime,
       maxRequests: r.maxRequests ?? 400
     });
   }
   async rotateRuntime() {
-    if (!u(this, w).enabled)
+    if (!h(this, _).enabled)
       throw new Error(
         "Runtime rotation is not enabled. Call enableRuntimeRotation() first."
       );
     await this.hotSwapPHPRuntime(
-      await u(this, w).recreateRuntime()
-    ), u(this, w).requestsMade = 0, u(this, w).needsRotating = !1;
+      await h(this, _).recreateRuntime()
+    ), h(this, _).requestsMade = 0, h(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, H)).map(
+    const i = Object.entries(h(this, T)).map(
       ([c, l]) => ({
         mountHandler: l.mountHandler,
         vfsPath: c
       })
     ), o = Object.values(
-      u(this, H)
+      h(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), h(this, I) && this.setSapiName(h(this, I));
     const a = this[__private__dont__use].FS;
     for (const c of t)
       c && c !== "/request" && copyMEMFSNodes(e, a, c);
@@ -1823,12 +1841,14 @@ class PHP {
     ), s = {
       mountHandler: e,
       unmount: async () => {
-        await t(), delete u(this, H)[r];
+        try {
+          await t();
+        } finally {
+          delete h(this, T)[r];
+        }
       }
     };
-    return u(this, H)[r] = s, () => {
-      s.unmount();
-    };
+    return h(this, T)[r] = s, () => s.unmount();
   }
   /**
    * Starts a PHP CLI session with given arguments.
@@ -1846,12 +1866,12 @@ class PHP {
   async cli(r, e = {}) {
     if (basename(r[0] ?? "") !== "php")
       return this.subProcess(r, e);
-    u(this, R) && (u(this, w).needsRotating = !0);
+    h(this, R) && (h(this, _).needsRotating = !0);
     const t = await this.semaphore.acquire();
-    return await m(this, p, 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, p, 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(
@@ -1864,7 +1884,7 @@ class PHP {
         async: !0
       });
     }).then((s) => (s.exitCode.finally(t), s)).finally(() => {
-      u(this, w).needsRotating = !0;
+      h(this, _).needsRotating = !0;
     });
   }
   /**
@@ -1946,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(), T = new WeakMap(), H = new WeakMap(), w = new WeakMap(), p = 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.
@@ -1961,7 +1981,7 @@ C = new WeakMap(), R = new WeakMap(), b = new WeakMap(), x = new WeakMap(), T =
  *             was provided.
  * @returns Computed $_SERVER entries.
  */
-Y = function(r, e, t) {
+J = function(r, e, t) {
   const s = {
     ...r || {}
   };
@@ -2053,7 +2073,7 @@ Y = function(r, e, t) {
     [NUMBER],
     [t]
   ), s;
-}, $ = function(r) {
+}, z = function(r) {
   this[__private__dont__use].ccall(
     "wasm_set_path_translated",
     null,
@@ -2067,87 +2087,87 @@ Y = 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, w).enabled && u(this, w).needsRotating && await this.rotateRuntime(), ++u(this, w).requestsMade, u(this, w).requestsMade >= u(this, w).maxRequests && (u(this, w).needsRotating = !0);
+}, G = async function(r) {
+  h(this, _).enabled && h(this, _).needsRotating && await this.rotateRuntime(), ++h(this, _).requestsMade, h(this, _).requestsMade >= h(this, _).maxRequests && (h(this, _).needsRotating = !0);
   const e = this[__private__dont__use], t = await createInvertedReadableStream();
-  e.onHeaders = (h) => {
-    a || s || t.controller.enqueue(h.slice());
+  e.onHeaders = (d) => {
+    a || s || t.controller.enqueue(d.slice());
   };
   let s = !1;
   const n = () => {
     s || (s = !0, t.controller.close());
   }, i = await createInvertedReadableStream();
-  e.onStdout = (h) => {
-    n(), !a && i.controller.enqueue(h.slice());
+  e.onStdout = (d) => {
+    n(), !a && i.controller.enqueue(d.slice());
   };
   const o = await createInvertedReadableStream();
-  e.onStderr = (h) => {
-    a || o.controller.enqueue(h.slice());
+  e.onStderr = (d) => {
+    a || o.controller.enqueue(d.slice());
   };
   let a = !1, c;
-  const d = (async () => {
-    var h;
+  const u = (async () => {
+    var d;
     try {
       return await Promise.race([
         r(),
-        new Promise((_, 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);
+          }, ($ = h(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 _ in this)
-        typeof this[_] == "function" && (this[_] = () => {
+    } 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), (h = u(this, b)) == null || h.removeEventListener(
+      a || (safeStreamClose$1(i.controller), safeStreamClose$1(o.controller), n(), a = !0), (d = h(this, H)) == null || d.removeEventListener(
         "error",
         c
       );
     }
   })().then(
-    (h) => (h !== 0 && this.dispatchEvent({
+    (d) => (d !== 0 && this.dispatchEvent({
       type: "request.error",
       error: new Error(
-        `PHP.run() failed with exit code ${h}.`
+        `PHP.run() failed with exit code ${d}.`
       ),
       // Distinguish between PHP request and PHP-wasm errors
       source: "php-wasm"
-    }), h),
-    (h) => {
-      const f = h.source ?? "php-wasm";
+    }), d),
+    (d) => {
+      const p = d.source ?? "php-wasm";
       throw this.dispatchEvent({
         type: "request.error",
-        error: h,
-        source: f
-      }), h;
+        error: d,
+        source: p
+      }), d;
     }
   );
   return new StreamedPHPResponse(
     t.stream,
     i.stream,
     o.stream,
-    d
+    u
   );
 };
 function normalizeHeaders(r) {
@@ -2159,7 +2179,12 @@ function normalizeHeaders(r) {
 function copyMEMFSNodes(r, e, t) {
   if (getNodeType(r, t) !== "memfs" || !["memfs", "missing"].includes(getNodeType(e, t)))
     return;
-  const s = r.lookupPath(t);
+  const s = r.lookupPath(t, { follow: !1 });
+  if (r.isLink(s.node.mode)) {
+    const i = r.readlink(t);
+    e.symlink(i, t);
+    return;
+  }
   if (!r.isDir(s.node.mode)) {
     e.writeFile(t, r.readFile(t));
     return;
@@ -2466,7 +2491,43 @@ const SupportedPHPVersions = [
   "8.1",
   "8.0",
   "7.4"
-], LatestSupportedPHPVersion = SupportedPHPVersions[0], SupportedPHPVersionsList = SupportedPHPVersions, DEFAULT_BASE_URL = "http://example.com";
+], LatestSupportedPHPVersion = SupportedPHPVersions[0], SupportedPHPVersionsList = SupportedPHPVersions, LegacyPHPVersions = ["5.2"];
+function isLegacyPHPVersion(r) {
+  return LegacyPHPVersions.includes(r ?? "");
+}
+const AllPHPVersions = [
+  ...SupportedPHPVersions,
+  ...LegacyPHPVersions
+], LEGACY_PHP_INI_PATH = "/internal/shared/php.ini", LEGACY_PHP_INI_CONTENT = [
+  "auto_prepend_file=/internal/shared/auto_prepend_file.php",
+  "memory_limit=256M",
+  "ignore_repeated_errors = 1",
+  "error_reporting = E_ALL",
+  "display_errors = 1",
+  "html_errors = 1",
+  "display_startup_errors = On",
+  "log_errors = 1",
+  "always_populate_raw_post_data = -1",
+  "upload_max_filesize = 2000M",
+  "post_max_size = 2000M",
+  "allow_url_fopen = On",
+  "allow_url_include = Off",
+  "session.save_path = /home/web_user",
+  "implicit_flush = 1",
+  "output_buffering = 0",
+  "max_execution_time = 0",
+  "max_input_time = -1",
+  "disable_functions = ini_get_all",
+  "opcache.enable = 0",
+  "opcache.enable_cli = 0"
+].join(`
+`);
+function createLegacyPhpIniPreRunStep() {
+  return (r) => {
+    r.FS.mkdirTree("/internal/shared"), r.FS.writeFile(LEGACY_PHP_INI_PATH, LEGACY_PHP_INI_CONTENT);
+  };
+}
+const DEFAULT_BASE_URL = "http://example.com";
 function toRelativeUrl(r) {
   return r.origin === "null" ? r.toString() : r.toString().substring(r.origin.length);
 }
@@ -2597,7 +2658,7 @@ const _default = "application/octet-stream", asx = "video/x-ms-asf", atom = "app
   xspf,
   zip
 };
-var S, M, U, L, I, E, A, k, B, P, ne, j, 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
@@ -2612,23 +2673,23 @@ class PHPRequestHandler {
    */
   constructor(e) {
     y(this, P);
-    y(this, S);
-    y(this, M);
-    y(this, U);
+    y(this, x);
+    y(this, C);
+    y(this, j);
     y(this, L);
-    y(this, I);
+    y(this, M);
     y(this, E);
     y(this, A);
     y(this, k);
-    y(this, B);
+    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({
@@ -2636,12 +2697,12 @@ class PHPRequestHandler {
       });
     else if (e.phpFactory)
       this.instanceManager = new PHPProcessManager({
-        phpFactory: async (d) => {
-          const h = await e.phpFactory({
-            ...d,
+        phpFactory: async (u) => {
+          const d = await e.phpFactory({
+            ...u,
             requestHandler: this
           });
-          return a(h), h;
+          return a(d), d;
         },
         maxPhpInstances: e.maxPhpInstances
       });
@@ -2649,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, M, (c.protocol || "").replace(":", ""));
-    const l = u(this, L) !== 443 && u(this, L) !== 80;
-    g(this, I, [
-      u(this, U),
-      l ? `:${u(this, L)}` : ""
-    ].join("")), g(this, E, c.pathname.replace(/\/+$/, "")), g(this, A, [
-      `${u(this, M)}://`,
-      u(this, I),
-      u(this, E)
-    ].join("")), this.rewriteRules = n, g(this, B, 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 = h(this, L) !== 443 && h(this, L) !== 80;
+    w(this, M, [
+      h(this, j),
+      l ? `:${h(this, L)}` : ""
+    ].join("")), w(this, E, c.pathname.replace(/\/+$/, "")), w(this, A, [
+      `${h(this, C)}://`,
+      h(this, M),
+      h(this, E)
+    ].join("")), this.rewriteRules = n, w(this, D, i), this.getFileNotFoundAction = o;
   }
   async getPrimaryPhp() {
     return await this.instanceManager.getPrimaryPhp();
@@ -2684,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(h(this, E)) && (t.pathname = t.pathname.slice(h(this, E).length)), toRelativeUrl(t);
   }
   /**
    * The absolute URL of this PHPRequestHandler instance.
    */
   get absoluteUrl() {
-    return u(this, A);
+    return h(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 h(this, x);
   }
   /**
    * Serves the request – either by serving a static file, or by
@@ -2779,9 +2840,9 @@ class PHPRequestHandler {
        * before using it as a filesystem path.
        */
       decodeURIComponent(n.pathname),
-      u(this, E)
+      h(this, E)
     );
-    let a = m(this, P, j).call(this, o);
+    let a = m(this, P, B).call(this, o);
     if (i.isDir(a)) {
       if (!o.endsWith("/"))
         return StreamedPHPResponse.fromPHPResponse(
@@ -2806,10 +2867,10 @@ class PHPRequestHandler {
       let c = o;
       for (; c.startsWith("/") && c !== dirname(c); ) {
         c = dirname(c);
-        const l = m(this, P, j).call(this, c);
+        const l = m(this, P, B).call(this, c);
         if (i.isFile(l) && // Only run partial path resolution for PHP files.
         l.endsWith(".php")) {
-          a = m(this, P, j).call(this, c);
+          a = m(this, P, B).call(this, c);
           break;
         }
       }
@@ -2824,7 +2885,7 @@ class PHPRequestHandler {
             c.response
           );
         case "internal-redirect":
-          a = joinPaths(u(this, S), c.uri);
+          a = joinPaths(h(this, x), c.uri);
           break;
         case "404":
           return StreamedPHPResponse.forHttpCode(404);
@@ -2929,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: h(this, x),
+      HTTPS: h(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(h(this, x)) && (n.SCRIPT_NAME = s.substring(
+      h(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(
@@ -2945,7 +3006,7 @@ class PHPRequestHandler {
     await this.instanceManager[Symbol.asyncDispose]();
   }
 }
-S = new WeakMap(), M = new WeakMap(), U = new WeakMap(), L = new WeakMap(), I = new WeakMap(), E = new WeakMap(), A = new WeakMap(), k = new WeakMap(), B = 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.
@@ -2954,12 +3015,12 @@ S = new WeakMap(), M = new WeakMap(), U = new WeakMap(), L = new WeakMap(), I =
 ne = function(e) {
   const t = removePathPrefix(
     decodeURIComponent(e.pathname),
-    u(this, E)
+    h(this, E)
   ), s = applyRewriteRules(
     t,
     this.rewriteRules
   ), n = new URL(
-    joinPaths(u(this, E), s),
+    joinPaths(h(this, E), s),
     e.toString()
   );
   for (const [i, o] of e.searchParams.entries())
@@ -2974,13 +3035,13 @@ ne = function(e) {
  * @param urlPath - The URL path to resolve (e.g., '/phpmyadmin/index.php')
  * @returns The resolved filesystem path
  */
-j = function(e) {
-  for (const t of u(this, B))
+B = function(e) {
+  for (const t of h(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(h(this, x), e);
 }, /**
  * Serves a static file from the PHP filesystem.
  *
@@ -3021,22 +3082,22 @@ ie = function(e, t) {
 }, ae = async function(e, t, s, n, i) {
   let o = "GET";
   const a = {
-    host: u(this, I),
+    host: h(this, M),
     ...normalizeHeaders(t.headers || {})
   };
-  u(this, k) && (a.cookie = u(this, k).getCookieRequestHeader());
+  h(this, k) && (a.cookie = h(this, k).getCookieRequestHeader());
   let c = t.body;
   if (typeof c == "object" && !(c instanceof Uint8Array)) {
     o = "POST";
-    const { bytes: d, contentType: h } = await encodeAsMultipart(c);
-    c = d, a["content-type"] = h;
+    const { bytes: u, contentType: d } = await encodeAsMultipart(c);
+    c = u, a["content-type"] = d;
   }
   const l = await e.runStream({
     relativeUri: ensurePathPrefix(
       toRelativeUrl(new URL(n.toString())),
-      u(this, E)
+      h(this, E)
     ),
-    protocol: u(this, M),
+    protocol: h(this, C),
     method: t.method || o,
     $_SERVER: this.prepare_$_SERVER_superglobal(
       s,
@@ -3047,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 (h(this, k)) {
+    const u = await l.headers;
+    h(this, k).rememberCookiesFromResponseHeaders(
+      u
     );
   }
   return l;
@@ -3091,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 d = r.name ?? t.name;
+    if (!d)
+      throw new Error(
+        "name is required when loading an extension from direct bytes."
+      );
+    return t.sha256 && await assertSha256(t.bytes, t.sha256, d), { name: d, soBytes: toUint8Array(t.bytes) };
+  }
+  if (t.format === "url") {
+    let d;
+    try {
+      d = 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 = d.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(d);
+    if (!g.ok)
+      throw new Error(
+        `Failed to fetch ${String(d)}: ${g.status}`
+      );
+    const S = new Uint8Array(await g.arrayBuffer());
+    return t.sha256 && await assertSha256(S, t.sha256, String(d)), { 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 d = await e(s);
+    if (!d.ok)
+      throw new Error(
+        `Failed to fetch ${String(s)}: ${d.status}`
+      );
+    n = await d.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 d of i.artifacts)
+    if (!d || typeof d.phpVersion != "string" || d.asyncMode !== "jspi" && d.asyncMode !== "asyncify" || typeof d.file != "string")
+      throw new Error("Extension manifest contains an invalid artifact.");
+  const o = "baseUrl" in t && t.baseUrl ? new URL(String(t.baseUrl)) : s, a = i.artifacts.find(
+    (d) => d.phpVersion === r.phpVersion && d.asyncMode === r.asyncMode
+  );
+  if (!a)
+    throw new Error(
+      `No extension artifact found for PHP ${r.phpVersion} ${r.asyncMode}.`
+    );
+  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;
+  return typeof s == "number" && s < 7;
+}
 function ensureProxyFSHasMmapSupport(r) {
   const e = Object.getOwnPropertySymbols(r)[0], t = r[e], s = t.PROXYFS, n = t.FS;
   s.stream_ops.mmap || (s.stream_ops.mmap = function(i, o, a, c, l) {
@@ -3098,25 +3353,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 h = t.HEAPU8.subarray(d, d + o);
-    let f = 0;
-    for (; f < o; ) {
-      const _ = i.stream_ops.read(
+    const d = t.HEAPU8.subarray(u, u + o);
+    let p = 0;
+    for (; p < o; ) {
+      const g = i.stream_ops.read(
         i,
-        h,
-        f,
-        o - f,
-        f
+        d,
+        p,
+        o - p,
+        p
       );
-      if (_ <= 0) break;
-      f += _;
+      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,
@@ -3129,23 +3384,23 @@ function ensureProxyFSHasMmapSupport(r) {
   });
 }
 async function proxyFileSystem(r, e, t) {
-  const s = Object.getOwnPropertySymbols(r)[0];
-  for (const n of t)
-    r.fileExists(n) || r.mkdir(n), e.mkdir(n), await e.mount(n, (i) => {
-      ensureProxyFSHasMmapSupport(i);
-      const o = Object.getOwnPropertySymbols(i)[0];
-      return i[o].FS.mount(
+  const s = isLegacyPhpInstance(e), n = Object.getOwnPropertySymbols(r)[0];
+  for (const i of t)
+    r.fileExists(i) || r.mkdir(i), e.mkdir(i), await e.mount(i, (o) => {
+      s || ensureProxyFSHasMmapSupport(o);
+      const a = Object.getOwnPropertySymbols(o)[0];
+      return o[a].FS.mount(
         // @ts-ignore
-        i[o].PROXYFS,
+        o[a].PROXYFS,
         {
-          root: n,
+          root: i,
           // @ts-ignore
-          fs: r[s].FS
+          fs: r[n].FS
         },
-        n
+        i
       ), () => {
         try {
-          i[o].FS.unmount(n);
+          o[a].FS.unmount(i);
         } catch {
         }
       };
@@ -3324,10 +3579,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");
     }
   }
@@ -3405,51 +3660,51 @@ function expose(r, e = globalThis, t = ["*"], s) {
       path: [],
       ...i.data
     }, l = (i.data.argumentList || []).map(fromWireValue);
-    let d;
+    let u;
     try {
-      const h = c.slice(0, -1).reduce((_, F) => _[F], r), f = c.reduce((_, F) => _[F], r);
+      const d = 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:
-          h[c.slice(-1)[0]] = fromWireValue(
+          d[c.slice(-1)[0]] = fromWireValue(
             i.data.value
-          ), d = !0;
+          ), u = !0;
           break;
         case MessageType.APPLY:
-          d = f.apply(h, l);
+          u = p.apply(d, l);
           break;
         case MessageType.CONSTRUCT:
           {
-            const _ = new f(...l);
-            d = proxy(_);
+            const g = new p(...l);
+            u = proxy(g);
           }
           break;
         case MessageType.ENDPOINT:
           {
-            const { port1: _, port2: F } = new MessageChannel();
-            expose(r, F), d = transfer(_, [_]);
+            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 (h) {
-      d = { value: h, [throwMarker]: 0 };
+    } catch (d) {
+      u = { value: d, [throwMarker]: 0 };
     }
-    Promise.resolve(d).catch((h) => ({ value: h, [throwMarker]: 0 })).then((h) => {
-      const [f, _] = toWireValue(h);
-      e.postMessage({ ...f, id: o }, _), a === MessageType.RELEASE && (e.removeEventListener("message", n), closeEndPoint(e), finalizer in r && typeof r[finalizer] == "function" && r[finalizer]());
+    Promise.resolve(u).catch((d) => ({ value: d, [throwMarker]: 0 })).then((d) => {
+      const [p, g] = toWireValue(d);
+      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 [h, f] = toWireValue({
+      const [d, p] = toWireValue({
         value: new TypeError("Unserializable return value"),
         [throwMarker]: 0
       });
-      e.postMessage({ ...h, id: o }, f);
+      e.postMessage({ ...d, id: o }, p);
     }).finally(() => {
       s == null || s(i);
     });
@@ -3520,16 +3775,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((h) => h.toString()),
+          path: [...t, a].map((d) => d.toString()),
           value: l
         },
-        d
+        u
       ).then(fromWireValue);
     },
     apply(o, a, c) {
@@ -3541,16 +3796,16 @@ function createProxy(r, e, t = [], s = function() {
         }).then(fromWireValue);
       if (l === "bind")
         return createProxy(r, e, t.slice(0, -1));
-      const [d, h] = processArguments(c);
+      const [u, d] = 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
         },
-        h
+        d
       ).then(fromWireValue);
     },
     construct(o, a) {
@@ -3561,7 +3816,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
@@ -3761,19 +4016,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;
@@ -3786,10 +4041,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
       });
@@ -4734,18 +4989,25 @@ function createObjectPoolProxy(r) {
   }
   function i(o) {
     return s().then((a) => {
-      let c;
+      const c = (u) => {
+        const d = u == null ? void 0 : u.finished;
+        return d && typeof d.then == "function" ? Promise.resolve(d).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({}, {
@@ -4755,14 +5017,14 @@ function createObjectPoolProxy(r) {
       if (a !== "then")
         return new Proxy(function() {
         }, {
-          apply(c, l, d) {
-            return i((h) => h[a](...d));
+          apply(c, l, u) {
+            return i((d) => d[a](...u));
           },
           get(c, l) {
             if (l === "then")
-              return (d, h) => i((f) => f[a]).then(
-                d,
-                h
+              return (u, d) => i((p) => p[a]).then(
+                u,
+                d
               );
           }
         });
@@ -4790,6 +5052,7 @@ class ProcessIdAllocator {
   }
 }
 export {
+  AllPHPVersions,
   DEFAULT_BASE_URL,
   FSHelpers,
   FileLock,
@@ -4797,7 +5060,10 @@ export {
   FileLockManagerComposite,
   FileLockManagerInMemory,
   HttpCookieStore,
+  LEGACY_PHP_INI_CONTENT,
+  LEGACY_PHP_INI_PATH,
   LatestSupportedPHPVersion,
+  LegacyPHPVersions,
   MAX_ADDRESSABLE_FILE_OFFSET,
   PHP,
   PHPExecutionFailureError,
@@ -4805,6 +5071,7 @@ export {
   PHPRequestHandler,
   PHPResponse,
   PHPWorker,
+  PHP_EXTENSIONS_DIR,
   ProcessIdAllocator,
   SinglePHPInstanceManager,
   StreamedPHPResponse,
@@ -4815,13 +5082,16 @@ export {
   applyRewriteRules,
   consumeAPI,
   consumeAPISync,
+  createLegacyPhpIniPreRunStep,
   createObjectPoolProxy,
   ensurePathPrefix,
   exposeAPI,
   exposeSyncAPI,
   getPhpIniEntries,
   inferMimeType,
+  installPHPExtensionFilesSync,
   isExitCode,
+  isLegacyPHPVersion,
   isPathToSharedFS,
   iteratePhpFiles as iterateFiles,
   loadPHPRuntime,
@@ -4833,12 +5103,14 @@ export {
   proxyFileSystem,
   releaseApiProxy,
   removePathPrefix,
+  resolvePHPExtension,
   rotatePHPRuntime,
   sandboxedSpawnHandlerFactory,
   setPhpIniEntries,
   streamToPort,
   toRelativeUrl,
   withPHPIniValues,
+  withResolvedPHPExtensions,
   writeFiles,
   writeFilesStreamToPhp
 };