@php-wasm/node 3.1.20 → 3.1.21

package/index.cjs

@@ -61,6 +61,8 @@ async function getPHPLoaderModule(version = import_universal.LatestSupportedPHPV
         return (await import("@php-wasm/node-8-0")).getPHPLoaderModule();
       case "7.4":
         return (await import("@php-wasm/node-7-4")).getPHPLoaderModule();
+      case "5.2":
+        return (await import("@php-wasm/node-5-2")).getPHPLoaderModule();
     }
     throw new Error(`Unsupported PHP version ${version}`);
   } catch (errorCandidate) {
@@ -1905,6 +1907,7 @@ async function loadNodeRuntime(phpVersion, options = {}) {
   // Otherwise, multiple workers with duplicate process IDs
   // could break file locking and lead to database corruption.
   (process.env.VITEST ? dangerousDefaultProcessIdAllocator.claim() : void 0);
+  const isLegacy = (0, import_universal12.isLegacyPHPVersion)(phpVersion);
   let emscriptenOptions = {
     /**
      * Emscripten default behavior is to kill the process when
@@ -1924,6 +1927,16 @@ async function loadNodeRuntime(phpVersion, options = {}) {
     },
     ...options.emscriptenOptions || {},
     processId,
+    // For legacy PHP: pre-create php.ini via a preRun step. See
+    // createLegacyPhpIniPreRunStep for why this must run before
+    // the PHP SAPI starts. Merge with any caller-provided preRun
+    // hooks (the spread above may have set them).
+    ...isLegacy ? {
+      preRun: [
+        (0, import_universal12.createLegacyPhpIniPreRunStep)(),
+        ...options.emscriptenOptions?.preRun ?? []
+      ]
+    } : {},
     onRuntimeInitialized: (phpRuntime) => {
       if (options?.followSymlinks === true) {
         phpRuntime.FS.filesystems.NODEFS.node_ops.readlink = (node) => {
@@ -1978,21 +1991,38 @@ async function loadNodeRuntime(phpVersion, options = {}) {
       phpRuntime.FS.root.mount.opts.root = ".";
     }
   };
-  if (options?.withXdebug) {
-    emscriptenOptions = await withXdebug(
-      phpVersion,
-      emscriptenOptions,
-      typeof options.withXdebug === "object" ? options.withXdebug : {}
+  if (isLegacy && (options?.withXdebug || options?.withIntl || options?.withRedis || options?.withMemcached)) {
+    throw new Error(
+      `Extensions (xdebug, intl, redis, memcached) are not available for legacy PHP ${phpVersion}.`
     );
   }
-  if (options?.withIntl === true) {
-    emscriptenOptions = await withIntl(phpVersion, emscriptenOptions);
-  }
-  if (options?.withRedis === true) {
-    emscriptenOptions = await withRedis(phpVersion, emscriptenOptions);
-  }
-  if (options?.withMemcached === true) {
-    emscriptenOptions = await withMemcached(phpVersion, emscriptenOptions);
+  if (!isLegacy) {
+    const modernVersion = phpVersion;
+    if (options?.withXdebug) {
+      emscriptenOptions = await withXdebug(
+        modernVersion,
+        emscriptenOptions,
+        typeof options.withXdebug === "object" ? options.withXdebug : {}
+      );
+    }
+    if (options?.withIntl === true) {
+      emscriptenOptions = await withIntl(
+        modernVersion,
+        emscriptenOptions
+      );
+    }
+    if (options?.withRedis === true) {
+      emscriptenOptions = await withRedis(
+        modernVersion,
+        emscriptenOptions
+      );
+    }
+    if (options?.withMemcached === true) {
+      emscriptenOptions = await withMemcached(
+        modernVersion,
+        emscriptenOptions
+      );
+    }
   }
   emscriptenOptions = await withNetworking(emscriptenOptions);
   const phpLoaderModule = await getPHPLoaderModule(phpVersion);

package/index.js

@@ -25,6 +25,8 @@ async function getPHPLoaderModule(version = LatestSupportedPHPVersion) {
         return (await import("@php-wasm/node-8-0")).getPHPLoaderModule();
       case "7.4":
         return (await import("@php-wasm/node-7-4")).getPHPLoaderModule();
+      case "5.2":
+        return (await import("@php-wasm/node-5-2")).getPHPLoaderModule();
     }
     throw new Error(`Unsupported PHP version ${version}`);
   } catch (errorCandidate) {
@@ -391,6 +393,8 @@ import {
   loadPHPRuntime,
   FSHelpers as FSHelpers5,
   FileLockManagerComposite,
+  createLegacyPhpIniPreRunStep,
+  isLegacyPHPVersion,
   ProcessIdAllocator
 } from "@php-wasm/universal";
 
@@ -1885,6 +1889,7 @@ async function loadNodeRuntime(phpVersion, options = {}) {
   // Otherwise, multiple workers with duplicate process IDs
   // could break file locking and lead to database corruption.
   (process.env.VITEST ? dangerousDefaultProcessIdAllocator.claim() : void 0);
+  const isLegacy = isLegacyPHPVersion(phpVersion);
   let emscriptenOptions = {
     /**
      * Emscripten default behavior is to kill the process when
@@ -1904,6 +1909,16 @@ async function loadNodeRuntime(phpVersion, options = {}) {
     },
     ...options.emscriptenOptions || {},
     processId,
+    // For legacy PHP: pre-create php.ini via a preRun step. See
+    // createLegacyPhpIniPreRunStep for why this must run before
+    // the PHP SAPI starts. Merge with any caller-provided preRun
+    // hooks (the spread above may have set them).
+    ...isLegacy ? {
+      preRun: [
+        createLegacyPhpIniPreRunStep(),
+        ...options.emscriptenOptions?.preRun ?? []
+      ]
+    } : {},
     onRuntimeInitialized: (phpRuntime) => {
       if (options?.followSymlinks === true) {
         phpRuntime.FS.filesystems.NODEFS.node_ops.readlink = (node) => {
@@ -1958,21 +1973,38 @@ async function loadNodeRuntime(phpVersion, options = {}) {
       phpRuntime.FS.root.mount.opts.root = ".";
     }
   };
-  if (options?.withXdebug) {
-    emscriptenOptions = await withXdebug(
-      phpVersion,
-      emscriptenOptions,
-      typeof options.withXdebug === "object" ? options.withXdebug : {}
+  if (isLegacy && (options?.withXdebug || options?.withIntl || options?.withRedis || options?.withMemcached)) {
+    throw new Error(
+      `Extensions (xdebug, intl, redis, memcached) are not available for legacy PHP ${phpVersion}.`
     );
   }
-  if (options?.withIntl === true) {
-    emscriptenOptions = await withIntl(phpVersion, emscriptenOptions);
-  }
-  if (options?.withRedis === true) {
-    emscriptenOptions = await withRedis(phpVersion, emscriptenOptions);
-  }
-  if (options?.withMemcached === true) {
-    emscriptenOptions = await withMemcached(phpVersion, emscriptenOptions);
+  if (!isLegacy) {
+    const modernVersion = phpVersion;
+    if (options?.withXdebug) {
+      emscriptenOptions = await withXdebug(
+        modernVersion,
+        emscriptenOptions,
+        typeof options.withXdebug === "object" ? options.withXdebug : {}
+      );
+    }
+    if (options?.withIntl === true) {
+      emscriptenOptions = await withIntl(
+        modernVersion,
+        emscriptenOptions
+      );
+    }
+    if (options?.withRedis === true) {
+      emscriptenOptions = await withRedis(
+        modernVersion,
+        emscriptenOptions
+      );
+    }
+    if (options?.withMemcached === true) {
+      emscriptenOptions = await withMemcached(
+        modernVersion,
+        emscriptenOptions
+      );
+    }
   }
   emscriptenOptions = await withNetworking(emscriptenOptions);
   const phpLoaderModule = await getPHPLoaderModule(phpVersion);

package/lib/get-php-loader-module.d.ts

@@ -1,4 +1,4 @@
-import type { PHPLoaderModule, SupportedPHPVersion } from '@php-wasm/universal';
+import type { AllPHPVersion, PHPLoaderModule } from '@php-wasm/universal';
 /**
  * Loads the PHP loader module for the given PHP version.
  *
@@ -11,4 +11,4 @@ import type { PHPLoaderModule, SupportedPHPVersion } from '@php-wasm/universal';
  * @param version The PHP version to load.
  * @returns The PHP loader module.
  */
-export declare function getPHPLoaderModule(version?: SupportedPHPVersion | string): Promise<PHPLoaderModule>;
+export declare function getPHPLoaderModule(version?: AllPHPVersion): Promise<PHPLoaderModule>;

package/lib/load-runtime.d.ts

@@ -1,4 +1,4 @@
-import { type SupportedPHPVersion, type EmscriptenOptions, type FileLockManager } from '@php-wasm/universal';
+import { type AllPHPVersion, type EmscriptenOptions, type FileLockManager } from '@php-wasm/universal';
 import type { WasmUserSpaceAPI, WasmUserSpaceContext } from './wasm-user-space';
 import { type XdebugOptions } from './extensions/xdebug/with-xdebug';
 export interface PHPLoaderOptions {
@@ -54,4 +54,4 @@ export type PHPLoaderOptionsForNode = PHPLoaderOptions & {
  *
  * @see load
  */
-export declare function loadNodeRuntime(phpVersion: SupportedPHPVersion, options?: PHPLoaderOptionsForNode): Promise<number>;
+export declare function loadNodeRuntime(phpVersion: AllPHPVersion, options?: PHPLoaderOptionsForNode): Promise<number>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@php-wasm/node",
-  "version": "3.1.20",
+  "version": "3.1.21",
   "description": "PHP.wasm for Node.js",
   "repository": {
     "type": "git",
@@ -38,7 +38,7 @@
   },
   "license": "GPL-2.0-or-later",
   "types": "index.d.ts",
-  "gitHead": "98cfca0a050ef1dacce25710d6ebdf816e80b764",
+  "gitHead": "5864051cbf4c2a55656112d99a3f1b076bcd67cd",
   "engines": {
     "node": ">=20.10.0",
     "npm": ">=10.2.3"
@@ -52,18 +52,19 @@
     "wasm-feature-detect": "1.8.0",
     "ws": "8.18.0",
     "yargs": "17.7.2",
-    "@php-wasm/universal": "3.1.20",
-    "@php-wasm/node-8-5": "3.1.20",
-    "@php-wasm/node-8-4": "3.1.20",
-    "@php-wasm/node-8-3": "3.1.20",
-    "@php-wasm/node-8-2": "3.1.20",
-    "@php-wasm/node-8-1": "3.1.20",
-    "@php-wasm/node-8-0": "3.1.20",
-    "@php-wasm/node-7-4": "3.1.20",
-    "@php-wasm/cli-util": "3.1.20",
-    "@php-wasm/logger": "3.1.20",
-    "@php-wasm/util": "3.1.20",
-    "@wp-playground/common": "3.1.20"
+    "@php-wasm/universal": "3.1.21",
+    "@php-wasm/node-8-5": "3.1.21",
+    "@php-wasm/node-8-4": "3.1.21",
+    "@php-wasm/node-8-3": "3.1.21",
+    "@php-wasm/node-8-2": "3.1.21",
+    "@php-wasm/node-8-1": "3.1.21",
+    "@php-wasm/node-8-0": "3.1.21",
+    "@php-wasm/node-7-4": "3.1.21",
+    "@php-wasm/cli-util": "3.1.21",
+    "@php-wasm/logger": "3.1.21",
+    "@php-wasm/node-5-2": "3.1.21",
+    "@php-wasm/util": "3.1.21",
+    "@wp-playground/common": "3.1.21"
   },
   "packageManager": "npm@10.9.2",
   "overrides": {