@php-wasm/universal 3.1.1 → 3.1.3

package/index.js

@@ -1,8 +1,8 @@
-var q = (r) => {
+var G = (r) => {
   throw TypeError(r);
 };
-var B = (r, e, t) => e.has(r) || q("Cannot " + t);
-var u = (r, e, t) => (B(r, e, "read from private field"), t ? t.call(r) : e.get(r)), y = (r, e, t) => e.has(r) ? q("Cannot add the same private member more than once") : e instanceof WeakSet ? e.add(r) : e.set(r, t), g = (r, e, t, s) => (B(r, e, "write to private field"), s ? s.call(r, t) : e.set(r, t), t), m = (r, e, t) => (B(r, e, "access private method"), t);
+var W = (r, e, t) => e.has(r) || G("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) ? G("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);
 import "@php-wasm/node-polyfills";
 import { logger } from "@php-wasm/logger";
 import { dirname, joinPaths, Semaphore, createSpawnHandler, basename, normalizePath, AcquireTimeoutError, splitShellCommand } from "@php-wasm/util";
@@ -311,19 +311,31 @@ class FSHelpers {
     e.mkdirTree(t);
   }
   static copyRecursive(e, t, s) {
-    const n = e.lookupPath(t).node;
-    if (e.isDir(n.mode)) {
-      e.mkdirTree(s);
-      const i = e.readdir(t).filter(
-        (o) => o !== "." && o !== ".."
-      );
-      for (const o of i)
-        FSHelpers.copyRecursive(
-          e,
-          joinPaths(t, o),
-          joinPaths(s, o)
+    try {
+      const n = e.lookupPath(t).node;
+      if (e.isDir(n.mode)) {
+        if (t === s || s.startsWith(`${t}/`))
+          throw new ErrnoError(28);
+        e.mkdirTree(s);
+        const i = e.readdir(t).filter(
+          (o) => o !== "." && o !== ".."
         );
-    } else e.isLink(n.mode) ? e.symlink(e.readlink(t), s) : e.writeFile(s, e.readFile(t));
+        for (const o of i)
+          FSHelpers.copyRecursive(
+            e,
+            joinPaths(t, o),
+            joinPaths(s, o)
+          );
+      } else e.isLink(n.mode) ? e.symlink(e.readlink(t), s) : e.writeFile(s, e.readFile(t));
+    } catch (n) {
+      const i = getEmscriptenFsError(n);
+      throw i ? new Error(
+        `Could not copy ${t} to ${s}: ${i}`,
+        {
+          cause: n
+        }
+      ) : n;
+    }
   }
 }
 FSHelpers.readFileAsText = rethrowFileSystemError('Could not read "{path}"')(
@@ -359,9 +371,6 @@ FSHelpers.fileExists = rethrowFileSystemError('Could not stat "{path}"')(
 FSHelpers.mkdir = rethrowFileSystemError('Could not create directory "{path}"')(
   FSHelpers.mkdir
 );
-FSHelpers.copyRecursive = rethrowFileSystemError(
-  'Could not copy files from "{path}"'
-)(FSHelpers.copyRecursive);
 const _private = /* @__PURE__ */ new WeakMap();
 var x;
 class PHPWorker {
@@ -431,6 +440,19 @@ class PHPWorker {
   async request(e) {
     return await _private.get(this).requestHandler.request(e);
   }
+  /**
+   * Handles a request with streaming support for large responses.
+   * Returns a StreamedPHPResponse that allows processing the response
+   * body incrementally without buffering the entire response in memory.
+   *
+   * This is useful for large file downloads (>2GB) that would otherwise
+   * exceed JavaScript's Uint8Array size limits.
+   *
+   * @param request - PHP Request data.
+   */
+  async requestStreamed(e) {
+    return await _private.get(this).requestHandler.requestStreamed(e);
+  }
   /** @inheritDoc @php-wasm/universal!/PHP.run */
   async run(e) {
     const { php: t, reap: s } = await this.acquirePHPInstance();
@@ -623,9 +645,67 @@ const currentJsRuntime = function() {
   201: "Created",
   200: "OK"
 };
-class StreamedPHPResponse {
+var C;
+const D = class D {
   constructor(e, t, s, n) {
-    this.parsedHeaders = null, this.cachedStdoutBytes = null, this.cachedStderrText = null, this.headersStream = e, this.stdout = t, this.stderr = s, this.exitCode = n;
+    /**
+     * Response headers stream (internal).
+     */
+    y(this, C);
+    this.parsedHeaders = null, this.cachedStdoutBytes = null, this.cachedStderrText = null, g(this, C, e), this.stdout = t, this.stderr = s, this.exitCode = n;
+  }
+  /**
+   * Creates a StreamedPHPResponse from a buffered PHPResponse.
+   * Useful for unifying response handling when both types may be returned.
+   */
+  static fromPHPResponse(e) {
+    const t = new ReadableStream({
+      start(c) {
+        c.enqueue(e.bytes), c.close();
+      }
+    }), s = [];
+    for (const [c, l] of Object.entries(e.headers))
+      for (const d of l)
+        s.push(`${c}: ${d}`);
+    const n = JSON.stringify({
+      status: e.httpStatusCode,
+      headers: s
+    }), i = new ReadableStream({
+      start(c) {
+        c.enqueue(new TextEncoder().encode(n)), c.close();
+      }
+    }), o = new ReadableStream({
+      start(c) {
+        e.errors.length > 0 && c.enqueue(
+          new TextEncoder().encode(e.errors)
+        ), c.close();
+      }
+    }), a = new D(
+      i,
+      t,
+      o,
+      Promise.resolve(e.exitCode)
+    );
+    return a.parsedHeaders = Promise.resolve({
+      headers: e.headers,
+      httpStatusCode: e.httpStatusCode
+    }), a;
+  }
+  /**
+   * Creates a StreamedPHPResponse for a given HTTP status code.
+   * Shorthand for `StreamedPHPResponse.fromPHPResponse(PHPResponse.forHttpCode(...))`.
+   */
+  static forHttpCode(e, t = "") {
+    return D.fromPHPResponse(
+      PHPResponse.forHttpCode(e, t)
+    );
+  }
+  /**
+   * Returns the raw headers stream for serialization purposes.
+   * For parsed headers, use the `headers` property instead.
+   */
+  getHeadersStream() {
+    return u(this, C);
   }
   /**
    * True if the response is successful (HTTP status code 200-399),
@@ -685,9 +765,11 @@ class StreamedPHPResponse {
     return this.cachedStderrText || (this.cachedStderrText = streamToText(this.stderr)), this.cachedStderrText;
   }
   async getParsedHeaders() {
-    return this.parsedHeaders || (this.parsedHeaders = parseHeadersStream(this.headersStream)), await this.parsedHeaders;
+    return this.parsedHeaders || (this.parsedHeaders = parseHeadersStream(u(this, C))), await this.parsedHeaders;
   }
-}
+};
+C = new WeakMap();
+let StreamedPHPResponse = D;
 async function parseHeadersStream(r) {
   const e = await streamToText(r);
   let t;
@@ -961,7 +1043,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 M, R, b, S, T, H, w, h, V, G, J, Y, X, Q, K, Z, D, ee, W, j;
+var M, R, b, S, H, T, w, p, J, Y, X, Q, K, Z, ee, te, j, re, q, $;
 class PHP {
   /**
    * Initializes a PHP runtime.
@@ -971,7 +1053,7 @@ class PHP {
    * @param  requestHandlerOptions - Optional. Options for the PHPRequestHandler. If undefined, no request handler will be initialized.
    */
   constructor(r) {
-    y(this, h);
+    y(this, p);
     y(this, M);
     y(this, R, !1);
     y(this, b, null);
@@ -979,8 +1061,8 @@ class PHP {
       // Listen to all events
       ["*", /* @__PURE__ */ new Set()]
     ]));
-    y(this, T, []);
-    y(this, H, {});
+    y(this, H, []);
+    y(this, T, {});
     y(this, w, {
       enabled: !1,
       recreateRuntime: () => 0,
@@ -1058,8 +1140,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 u(this, H).push(r), async () => {
+      g(this, H, u(this, H).filter(
         (e) => e !== r
       ));
     };
@@ -1153,7 +1235,7 @@ class PHP {
 				}
 				`
     ), e.onMessage = async (t) => {
-      for (const s of u(this, T)) {
+      for (const s of u(this, H)) {
         const n = await s(t);
         if (n)
           return n;
@@ -1396,7 +1478,7 @@ class PHP {
   async runStream(r) {
     const e = await this.semaphore.acquire();
     let t;
-    const s = m(this, h, j).call(this, async () => {
+    const s = m(this, p, $).call(this, async () => {
       if (u(this, R) || (await this[__private__dont__use].ccall(
         "php_wasm_init",
         null,
@@ -1409,22 +1491,22 @@ class PHP {
         throw new Error(
           `The script path "${r.scriptPath}" does not exist.`
         );
-      m(this, h, G).call(this, r.relativeUri || ""), m(this, h, Q).call(this, r.method || "GET");
-      const i = normalizeHeaders(r.headers || {}), o = i.host || "example.com:443", a = m(this, h, X).call(this, o, r.protocol || "http");
-      if (m(this, h, J).call(this, o), m(this, h, Y).call(this, a), m(this, h, K).call(this, i), r.body && (t = m(this, h, Z).call(this, r.body)), typeof r.code == "string")
-        this.writeFile("/internal/eval.php", r.code), m(this, h, D).call(this, "/internal/eval.php");
+      m(this, p, Y).call(this, r.relativeUri || ""), m(this, p, Z).call(this, r.method || "GET");
+      const i = normalizeHeaders(r.headers || {}), o = i.host || "example.com:443", a = m(this, p, K).call(this, o, r.protocol || "http");
+      if (m(this, p, X).call(this, o), m(this, p, Q).call(this, a), m(this, p, ee).call(this, i), r.body && (t = m(this, p, te).call(this, r.body)), typeof r.code == "string")
+        this.writeFile("/internal/eval.php", r.code), m(this, p, j).call(this, "/internal/eval.php");
       else if (typeof r.scriptPath == "string")
-        m(this, h, D).call(this, r.scriptPath || "");
+        m(this, p, j).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, V).call(this, r.$_SERVER, i, a);
+      const c = m(this, p, J).call(this, r.$_SERVER, i, a);
       for (const d in c)
-        m(this, h, ee).call(this, d, c[d]);
+        m(this, p, re).call(this, d, c[d]);
       const l = r.env || {};
       for (const d in l)
-        m(this, h, W).call(this, d, l[d]);
+        m(this, p, q).call(this, d, l[d]);
       return await this[__private__dont__use].ccall(
         "wasm_sapi_handle_request",
         NUMBER,
@@ -1542,8 +1624,8 @@ class PHP {
    * Moves a file or directory in the PHP filesystem to a
    * new location.
    *
-   * @param oldPath The path to rename.
-   * @param newPath The new path.
+   * @param fromPath The path to rename.
+   * @param toPath The new path.
    */
   mv(r, e) {
     const t = FSHelpers.mv(
@@ -1553,6 +1635,21 @@ class PHP {
     );
     return this.dispatchEvent({ type: "filesystem.write" }), t;
   }
+  /**
+   * Copies a file or directory in the PHP filesystem to a
+   * new location.
+   *
+   * @param fromPath The source path.
+   * @param toPath The target path.
+   */
+  cp(r, e) {
+    const t = FSHelpers.copyRecursive(
+      this[__private__dont__use].FS,
+      r,
+      e
+    );
+    return this.dispatchEvent({ type: "filesystem.write" }), t;
+  }
   /**
    * Removes a directory from the PHP filesystem.
    *
@@ -1672,13 +1769,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(u(this, T)).map(
       ([c, l]) => ({
         mountHandler: l.mountHandler,
         vfsPath: c
       })
     ), o = Object.values(
-      u(this, H)
+      u(this, T)
     ).reverse();
     for (const c of o)
       await c.unmount();
@@ -1718,10 +1815,10 @@ class PHP {
     ), s = {
       mountHandler: e,
       unmount: async () => {
-        await t(), delete u(this, H)[r];
+        await t(), delete u(this, T)[r];
       }
     };
-    return u(this, H)[r] = s, () => {
+    return u(this, T)[r] = s, () => {
       s.unmount();
     };
   }
@@ -1743,10 +1840,10 @@ class PHP {
       return this.subProcess(r, e);
     u(this, R) && (u(this, w).needsRotating = !0);
     const t = await this.semaphore.acquire();
-    return await m(this, h, j).call(this, () => {
+    return await m(this, p, $).call(this, () => {
       const s = e.env || {};
       for (const [n, i] of Object.entries(s))
-        m(this, h, W).call(this, n, i);
+        m(this, p, q).call(this, n, i);
       r = [r[0], "-c", PHP_INI_PATH, ...r.slice(1)];
       for (const n of r)
         this[__private__dont__use].ccall(
@@ -1837,7 +1934,7 @@ class PHP {
     this.exit(0);
   }
 }
-M = new WeakMap(), R = new WeakMap(), b = new WeakMap(), S = new WeakMap(), T = new WeakMap(), H = new WeakMap(), w = new WeakMap(), h = new WeakSet(), /**
+M = new WeakMap(), R = new WeakMap(), b = new WeakMap(), S = new WeakMap(), H = new WeakMap(), T = new WeakMap(), w = new WeakMap(), p = new WeakSet(), /**
  * Prepares the $_SERVER entries for the PHP runtime.
  *
  * @param defaults Default entries to include in $_SERVER.
@@ -1846,7 +1943,7 @@ M = new WeakMap(), R = new WeakMap(), b = new WeakMap(), S = new WeakMap(), T =
  *             was provided.
  * @returns Computed $_SERVER entries.
  */
-V = function(r, e, t) {
+J = function(r, e, t) {
   const s = {
     ...r || {}
   };
@@ -1856,7 +1953,7 @@ V = function(r, e, t) {
     ["content-type", "content-length"].includes(n.toLowerCase()) && (i = ""), s[`${i}${n.toUpperCase().replace(/-/g, "_")}`] = e[n];
   }
   return s;
-}, G = function(r) {
+}, Y = function(r) {
   this[__private__dont__use].ccall(
     "wasm_set_request_uri",
     null,
@@ -1870,35 +1967,35 @@ V = function(r, e, t) {
     [STRING],
     [e]
   );
-}, J = function(r) {
+}, X = function(r) {
   this[__private__dont__use].ccall(
     "wasm_set_request_host",
     null,
     [STRING],
     [r]
   );
-}, Y = function(r) {
+}, Q = function(r) {
   this[__private__dont__use].ccall(
     "wasm_set_request_port",
     null,
     [NUMBER],
     [r]
   );
-}, X = function(r, e) {
+}, K = function(r, e) {
   let t;
   try {
     t = parseInt(new URL(r).port, 10);
   } catch {
   }
   return (!t || isNaN(t) || t === 80) && (t = e === "https" ? 443 : 80), t;
-}, Q = function(r) {
+}, Z = function(r) {
   this[__private__dont__use].ccall(
     "wasm_set_request_method",
     null,
     [STRING],
     [r]
   );
-}, K = function(r) {
+}, ee = function(r) {
   r.cookie && this[__private__dont__use].ccall(
     "wasm_set_cookies",
     null,
@@ -1915,7 +2012,7 @@ V = function(r, e, t) {
     [NUMBER],
     [parseInt(r["content-length"], 10)]
   );
-}, Z = function(r) {
+}, te = function(r) {
   let e, t;
   typeof r == "string" ? (logger.warn(
     "Passing a string as the request body is deprecated. Please use a Uint8Array instead. See https://github.com/WordPress/wordpress-playground/issues/997 for more details"
@@ -1938,54 +2035,54 @@ V = function(r, e, t) {
     [NUMBER],
     [t]
   ), s;
-}, D = function(r) {
+}, j = function(r) {
   this[__private__dont__use].ccall(
     "wasm_set_path_translated",
     null,
     [STRING],
     [r]
   );
-}, ee = function(r, e) {
+}, re = function(r, e) {
   this[__private__dont__use].ccall(
     "wasm_add_SERVER_entry",
     null,
     [STRING, STRING],
     [r, e]
   );
-}, W = function(r, e) {
+}, q = function(r, e) {
   this[__private__dont__use].ccall(
     "wasm_add_ENV_entry",
     null,
     [STRING, STRING],
     [r, e]
   );
-}, j = async function(r) {
+}, $ = 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);
   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;
+    var h;
     try {
       return await Promise.race([
         r(),
         new Promise((_, F) => {
           var z;
-          c = ($) => {
-            isExitCode($.error) || F($.error);
+          c = (V) => {
+            isExitCode(V.error) || F(V.error);
           }, (z = u(this, b)) == null || z.addEventListener(
             "error",
             c,
@@ -2005,27 +2102,27 @@ V = function(r, e, t) {
         });
       throw this.functionsMaybeMissingFromAsyncify = getFunctionsMaybeMissingFromAsyncify(), f;
     } finally {
-      a || (i.controller.close(), o.controller.close(), n(), a = !0), (p = u(this, b)) == null || p.removeEventListener(
+      a || (i.controller.close(), o.controller.close(), n(), a = !0), (h = u(this, b)) == 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 f = h.source ?? "php-wasm";
       throw this.dispatchEvent({
         type: "request.error",
-        error: p,
+        error: h,
         source: f
-      }), p;
+      }), h;
     }
   );
   return new StreamedPHPResponse(
@@ -2468,7 +2565,7 @@ const _default = "application/octet-stream", asx = "video/x-ms-asf", atom = "app
   xspf,
   zip
 };
-var v, C, N, L, I, E, A, k, O, P, te, U, re, se, ne;
+var v, I, O, L, A, E, N, k, U, P, se, B, ne, ie, oe;
 class PHPRequestHandler {
   /**
    * The request handler needs to decide whether to serve a static asset or
@@ -2484,14 +2581,14 @@ class PHPRequestHandler {
   constructor(e) {
     y(this, P);
     y(this, v);
-    y(this, C);
-    y(this, N);
-    y(this, L);
     y(this, I);
-    y(this, E);
+    y(this, O);
+    y(this, L);
     y(this, A);
+    y(this, E);
+    y(this, N);
     y(this, k);
-    y(this, O);
+    y(this, U);
     const {
       documentRoot: t = "/www/",
       absoluteUrl: s = typeof location == "object" ? location.href : DEFAULT_BASE_URL,
@@ -2508,11 +2605,11 @@ class PHPRequestHandler {
     else if (e.phpFactory)
       this.instanceManager = new PHPProcessManager({
         phpFactory: async (d) => {
-          const p = await e.phpFactory({
+          const h = await e.phpFactory({
             ...d,
             requestHandler: this
           });
-          return a(p), p;
+          return a(h), h;
         },
         maxPhpInstances: e.maxPhpInstances
       });
@@ -2522,16 +2619,16 @@ class PHPRequestHandler {
       );
     g(this, k, e.cookieStore === void 0 ? new HttpCookieStore() : e.cookieStore), g(this, v, t);
     const c = new URL(s);
-    g(this, N, c.hostname), g(this, L, c.port ? Number(c.port) : c.protocol === "https:" ? 443 : 80), g(this, C, (c.protocol || "").replace(":", ""));
+    g(this, O, 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, I, [
-      u(this, N),
+    g(this, A, [
+      u(this, O),
       l ? `:${u(this, L)}` : ""
-    ].join("")), g(this, E, c.pathname.replace(/\/+$/, "")), g(this, A, [
-      `${u(this, C)}://`,
-      u(this, I),
+    ].join("")), g(this, E, c.pathname.replace(/\/+$/, "")), g(this, N, [
+      `${u(this, I)}://`,
+      u(this, A),
       u(this, E)
-    ].join("")), this.rewriteRules = n, g(this, O, i), this.getFileNotFoundAction = o;
+    ].join("")), this.rewriteRules = n, g(this, U, i), this.getFileNotFoundAction = o;
   }
   async getPrimaryPhp() {
     return await this.instanceManager.getPrimaryPhp();
@@ -2561,7 +2658,7 @@ class PHPRequestHandler {
    * The absolute URL of this PHPRequestHandler instance.
    */
   get absoluteUrl() {
-    return u(this, A);
+    return u(this, N);
   }
   /**
    * The directory in the PHP filesystem where the server will look
@@ -2619,11 +2716,32 @@ class PHPRequestHandler {
    * @param  request - PHP Request data.
    */
   async request(e) {
+    const t = await this.requestStreamed(e), s = await PHPResponse.fromStreamedResponse(t);
+    return s.ok() && s.exitCode !== 0 ? new PHPResponse(
+      500,
+      s.headers,
+      s.bytes,
+      s.errors,
+      s.exitCode
+    ) : s;
+  }
+  /**
+   * Serves the request with streaming support – returns a StreamedPHPResponse
+   * that allows processing the response body incrementally without buffering
+   * the entire response in memory.
+   *
+   * This is useful for large file downloads (>2GB) that would otherwise
+   * exceed JavaScript's Uint8Array size limits.
+   *
+   * @param request - PHP Request data.
+   * @returns A StreamedPHPResponse.
+   */
+  async requestStreamed(e) {
     const t = looksLikeAbsoluteUrl(e.url), s = new URL(
       // Remove the hash part of the URL as it's not meant for the server.
       e.url.split("#")[0],
       t ? void 0 : DEFAULT_BASE_URL
-    ), n = m(this, P, te).call(this, s), i = await this.getPrimaryPhp(), o = removePathPrefix(
+    ), n = m(this, P, se).call(this, s), i = await this.getPrimaryPhp(), o = removePathPrefix(
       /**
        * URL.pathname returns a URL-encoded path. We need to decode it
        * before using it as a filesystem path.
@@ -2631,13 +2749,15 @@ class PHPRequestHandler {
       decodeURIComponent(n.pathname),
       u(this, E)
     );
-    let a = m(this, P, U).call(this, o);
+    let a = m(this, P, B).call(this, o);
     if (i.isDir(a)) {
       if (!o.endsWith("/"))
-        return new PHPResponse(
-          301,
-          { Location: [`${n.pathname}/`] },
-          new Uint8Array(0)
+        return StreamedPHPResponse.fromPHPResponse(
+          new PHPResponse(
+            301,
+            { Location: [`${n.pathname}/`] },
+            new Uint8Array(0)
+          )
         );
       for (const c of ["index.php", "index.html"]) {
         const l = joinPaths(a, c);
@@ -2654,10 +2774,10 @@ class PHPRequestHandler {
       let c = o;
       for (; c.startsWith("/") && c !== dirname(c); ) {
         c = dirname(c);
-        const l = m(this, P, U).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, U).call(this, c);
+          a = m(this, P, B).call(this, c);
           break;
         }
       }
@@ -2668,32 +2788,23 @@ class PHPRequestHandler {
       );
       switch (c.type) {
         case "response":
-          return c.response;
+          return StreamedPHPResponse.fromPHPResponse(
+            c.response
+          );
         case "internal-redirect":
           a = joinPaths(u(this, v), c.uri);
           break;
         case "404":
-          return PHPResponse.forHttpCode(404);
+          return StreamedPHPResponse.forHttpCode(404);
         default:
           throw new Error(
             `Unsupported file-not-found action type: '${c.type}'`
           );
       }
     }
-    if (i.isFile(a))
-      if (a.endsWith(".php")) {
-        const c = await m(this, P, se).call(this, e, s, n, a);
-        return c.ok() && c.exitCode !== 0 ? new PHPResponse(
-          500,
-          c.headers,
-          c.bytes,
-          c.errors,
-          c.exitCode
-        ) : c;
-      } else
-        return m(this, P, re).call(this, i, a);
-    else
-      return PHPResponse.forHttpCode(404);
+    return i.isFile(a) ? a.endsWith(".php") ? await m(this, P, ie).call(this, e, s, n, a) : StreamedPHPResponse.fromPHPResponse(
+      m(this, P, ne).call(this, i, a)
+    ) : StreamedPHPResponse.forHttpCode(404);
   }
   /**
    * Computes the essential $_SERVER entries for a request.
@@ -2787,7 +2898,7 @@ class PHPRequestHandler {
     const n = {
       REMOTE_ADDR: "127.0.0.1",
       DOCUMENT_ROOT: u(this, v),
-      HTTPS: u(this, A).startsWith("https://") ? "on" : ""
+      HTTPS: u(this, N).startsWith("https://") ? "on" : ""
     };
     return n.REQUEST_URI = e.pathname + e.search, s.startsWith(u(this, v)) && (n.SCRIPT_NAME = s.substring(
       u(this, v).length
@@ -2802,13 +2913,13 @@ class PHPRequestHandler {
     await this.instanceManager[Symbol.asyncDispose]();
   }
 }
-v = new WeakMap(), C = new WeakMap(), N = new WeakMap(), L = new WeakMap(), I = new WeakMap(), E = new WeakMap(), A = new WeakMap(), k = new WeakMap(), O = new WeakMap(), P = new WeakSet(), /**
+v = new WeakMap(), I = new WeakMap(), O = new WeakMap(), L = new WeakMap(), A = new WeakMap(), E = new WeakMap(), N = new WeakMap(), k = new WeakMap(), U = new WeakMap(), P = new WeakSet(), /**
  * Apply the rewrite rules to the original request URL.
  *
  * @param originalRequestUrl - The original request URL.
  * @returns The rewritten request URL.
  */
-te = function(e) {
+se = function(e) {
   const t = removePathPrefix(
     decodeURIComponent(e.pathname),
     u(this, E)
@@ -2831,8 +2942,8 @@ te = function(e) {
  * @param urlPath - The URL path to resolve (e.g., '/phpmyadmin/index.php')
  * @returns The resolved filesystem path
  */
-U = function(e) {
-  for (const t of u(this, O))
+B = function(e) {
+  for (const t of u(this, U))
     if (e === t.urlPrefix || e.startsWith(t.urlPrefix + "/")) {
       const s = e.slice(t.urlPrefix.length);
       return joinPaths(t.fsPath, s);
@@ -2844,7 +2955,7 @@ U = function(e) {
  * @param  fsPath - Absolute path of the static file to serve.
  * @returns The response.
  */
-re = function(e, t) {
+ne = function(e, t) {
   const s = e.readFileAsBuffer(t);
   return new PHPResponse(
     200,
@@ -2859,57 +2970,58 @@ re = function(e, t) {
     },
     s
   );
-}, se = async function(e, t, s, n) {
+}, ie = async function(e, t, s, n) {
   let i;
   try {
     i = await this.instanceManager.acquirePHPInstance();
-  } catch (o) {
-    return o instanceof MaxPhpInstancesError ? PHPResponse.forHttpCode(502) : PHPResponse.forHttpCode(500);
+  } catch (a) {
+    return a instanceof MaxPhpInstancesError ? StreamedPHPResponse.forHttpCode(502) : StreamedPHPResponse.forHttpCode(500);
   }
+  let o;
   try {
-    return await m(this, P, ne).call(this, i.php, e, t, s, n);
-  } finally {
-    i.reap();
-  }
-}, ne = async function(e, t, s, n, i) {
+    o = await m(this, P, oe).call(this, i.php, e, t, s, n);
+  } catch (a) {
+    throw i.reap(), a;
+  }
+  return o.finished.finally(() => {
+    i == null || i.reap();
+  }), o;
+}, oe = async function(e, t, s, n, i) {
   let o = "GET";
   const a = {
-    host: u(this, I),
+    host: u(this, A),
     ...normalizeHeaders(t.headers || {})
   };
   u(this, k) && (a.cookie = u(this, k).getCookieRequestHeader());
   let c = t.body;
   if (typeof c == "object" && !(c instanceof Uint8Array)) {
     o = "POST";
-    const { bytes: l, contentType: d } = await encodeAsMultipart(c);
-    c = l, a["content-type"] = d;
+    const { bytes: d, contentType: h } = await encodeAsMultipart(c);
+    c = d, a["content-type"] = h;
   }
-  try {
-    const l = await e.run({
-      relativeUri: ensurePathPrefix(
-        toRelativeUrl(new URL(n.toString())),
-        u(this, E)
-      ),
-      protocol: u(this, C),
-      method: t.method || o,
-      $_SERVER: this.prepare_$_SERVER_superglobal(
-        s,
-        n,
-        i
-      ),
-      body: c,
-      scriptPath: i,
-      headers: a
+  const l = await e.runStream({
+    relativeUri: ensurePathPrefix(
+      toRelativeUrl(new URL(n.toString())),
+      u(this, E)
+    ),
+    protocol: u(this, I),
+    method: t.method || o,
+    $_SERVER: this.prepare_$_SERVER_superglobal(
+      s,
+      n,
+      i
+    ),
+    body: c,
+    scriptPath: i,
+    headers: a
+  });
+  if (u(this, k)) {
+    const d = u(this, k);
+    l.headers.then((h) => {
+      d.rememberCookiesFromResponseHeaders(h);
     });
-    return u(this, k) && u(this, k).rememberCookiesFromResponseHeaders(
-      l.headers
-    ), l;
-  } catch (l) {
-    const d = l;
-    if (d != null && d.response)
-      return d.response;
-    throw l;
   }
+  return l;
 };
 function inferMimeType(r) {
   const e = r.split(".").pop();
@@ -2957,12 +3069,12 @@ function ensureProxyFSHasMmapSupport(r) {
     const d = t.malloc(o);
     if (!d)
       throw new n.ErrnoError(48);
-    const p = t.HEAPU8.subarray(d, d + o);
+    const h = t.HEAPU8.subarray(d, d + o);
     let f = 0;
     for (; f < o; ) {
       const _ = i.stream_ops.read(
         i,
-        p,
+        h,
         f,
         o - f,
         f
@@ -3253,18 +3365,18 @@ function expose(r, e = globalThis, t = ["*"], s) {
     }, l = (i.data.argumentList || []).map(fromWireValue);
     let d;
     try {
-      const p = c.slice(0, -1).reduce((_, F) => _[F], r), f = c.reduce((_, F) => _[F], r);
+      const h = c.slice(0, -1).reduce((_, F) => _[F], r), f = c.reduce((_, F) => _[F], r);
       switch (a) {
         case MessageType.GET:
           d = f;
           break;
         case MessageType.SET:
-          p[c.slice(-1)[0]] = fromWireValue(
+          h[c.slice(-1)[0]] = fromWireValue(
             i.data.value
           ), d = !0;
           break;
         case MessageType.APPLY:
-          d = f.apply(p, l);
+          d = f.apply(h, l);
           break;
         case MessageType.CONSTRUCT:
           {
@@ -3284,18 +3396,18 @@ function expose(r, e = globalThis, t = ["*"], s) {
         default:
           return;
       }
-    } catch (p) {
-      d = { value: p, [throwMarker]: 0 };
+    } catch (h) {
+      d = { value: h, [throwMarker]: 0 };
     }
-    Promise.resolve(d).catch((p) => ({ value: p, [throwMarker]: 0 })).then((p) => {
-      const [f, _] = toWireValue(p);
+    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]());
     }).catch(() => {
-      const [p, f] = toWireValue({
+      const [h, f] = toWireValue({
         value: new TypeError("Unserializable return value"),
         [throwMarker]: 0
       });
-      e.postMessage({ ...p, id: o }, f);
+      e.postMessage({ ...h, id: o }, f);
     }).finally(() => {
       s == null || s(i);
     });
@@ -3372,7 +3484,7 @@ function createProxy(r, e, t = [], s = function() {
         e,
         {
           type: MessageType.SET,
-          path: [...t, a].map((p) => p.toString()),
+          path: [...t, a].map((h) => h.toString()),
           value: l
         },
         d
@@ -3387,7 +3499,7 @@ 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 [d, h] = processArguments(c);
       return requestResponseMessage(
         r,
         e,
@@ -3396,7 +3508,7 @@ function createProxy(r, e, t = [], s = function() {
           path: t.map((f) => f.toString()),
           argumentList: d
         },
-        p
+        h
       ).then(fromWireValue);
     },
     construct(o, a) {
@@ -3792,25 +3904,33 @@ function setupTransferHandlers() {
   }, transferHandlers.set("StreamedPHPResponse", {
     canHandle: (t) => t instanceof StreamedPHPResponse,
     serialize(t) {
-      const s = supportsTransferableStreams(), n = promiseToPort(t.exitCode);
+      const s = supportsTransferableStreams(), n = promiseToPort(t.exitCode), i = t.getHeadersStream();
       if (s)
-        return [{
-          __type: "StreamedPHPResponse",
-          headers: t.headersStream,
-          stdout: t.stdout,
-          stderr: t.stderr,
-          exitCodePort: n
-        }, [n]];
-      const i = streamToPort(t.headersStream), o = streamToPort(t.stdout), a = streamToPort(t.stderr);
+        return [
+          {
+            __type: "StreamedPHPResponse",
+            headers: i,
+            stdout: t.stdout,
+            stderr: t.stderr,
+            exitCodePort: n
+          },
+          [
+            i,
+            t.stdout,
+            t.stderr,
+            n
+          ]
+        ];
+      const o = streamToPort(i), a = streamToPort(t.stdout), c = streamToPort(t.stderr);
       return [
         {
           __type: "StreamedPHPResponse",
-          headersPort: i,
-          stdoutPort: o,
-          stderrPort: a,
+          headersPort: o,
+          stdoutPort: a,
+          stderrPort: c,
           exitCodePort: n
         },
-        [i, o, a, n]
+        [o, a, c, n]
       ];
     },
     deserialize(t) {
@@ -4573,19 +4693,39 @@ function createObjectPoolProxy(r) {
         return new Proxy(function() {
         }, {
           apply(c, l, d) {
-            return i((p) => p[a](...d));
+            return i((h) => h[a](...d));
           },
           get(c, l) {
             if (l === "then")
-              return (d, p) => i((f) => f[a]).then(
+              return (d, h) => i((f) => f[a]).then(
                 d,
-                p
+                h
               );
           }
         });
     }
   });
 }
+const maxValueForSigned32BitInteger = 2 ** 31 - 1;
+class ProcessIdAllocator {
+  constructor(e = 1, t = maxValueForSigned32BitInteger) {
+    this.claimed = /* @__PURE__ */ new Set(), this.initialId = e, this.maxId = t, this.nextId = e;
+  }
+  claim() {
+    const e = this.maxId - this.initialId + 1;
+    for (let t = 0; t < e; t++)
+      if (this.claimed.has(this.nextId))
+        this.nextId++, this.nextId > this.maxId && (this.nextId = this.initialId);
+      else
+        return this.claimed.add(this.nextId), this.nextId;
+    throw new Error(
+      `Unable to find free process ID after ${e} tries.`
+    );
+  }
+  release(e) {
+    return this.claimed.has(e) ? (this.claimed.delete(e), !0) : !1;
+  }
+}
 export {
   DEFAULT_BASE_URL,
   FSHelpers,
@@ -4602,6 +4742,7 @@ export {
   PHPRequestHandler,
   PHPResponse,
   PHPWorker,
+  ProcessIdAllocator,
   SinglePHPInstanceManager,
   StreamedPHPResponse,
   SupportedPHPVersions,