@php-wasm/universal 3.1.19 → 3.1.21

package/lib/index.d.ts

@@ -21,8 +21,9 @@ export type { MaxPhpInstancesError, PHPFactory, PHPFactoryOptions, ProcessManage
 export { PHPResponse, StreamedPHPResponse } from './php-response';
 export type { PHPResponseData } from './php-response';
 export type { ErrnoError } from './rethrow-file-system-error';
-export { LatestSupportedPHPVersion, SupportedPHPVersions, SupportedPHPVersionsList, } from './supported-php-versions';
-export type { SupportedPHPVersion } from './supported-php-versions';
+export { AllPHPVersions, isLegacyPHPVersion, LatestSupportedPHPVersion, LegacyPHPVersions, SupportedPHPVersions, SupportedPHPVersionsList, } from './supported-php-versions';
+export type { AllPHPVersion, LegacyPHPVersion, SupportedPHPVersion, } from './supported-php-versions';
+export { createLegacyPhpIniPreRunStep, LEGACY_PHP_INI_CONTENT, LEGACY_PHP_INI_PATH, } from './legacy-php-ini';
 export { PHP, __private__dont__use, PHPExecutionFailureError } from './php';
 export type { MountHandler, UnmountFunction } from './php';
 export { loadPHPRuntime, popLoadedRuntime } from './load-php-runtime';

package/lib/legacy-php-ini.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Pre-boot php.ini content for legacy PHP builds (currently 5.2).
+ *
+ * Why pre-create a php.ini before the SAPI starts:
+ *
+ * - ini_get_all() crashes on legacy PHP WASM (null function pointer in
+ *   the Asyncify instrumentation) so we disable it via
+ *   `disable_functions`, which PHP only reads during module startup.
+ * - OPcache's shared-memory allocator fails in our WASM environment,
+ *   so opcache must be disabled before php_module_startup runs.
+ *
+ * Both settings are processed by php_module_startup before PHP reads
+ * any user code, so setting them at runtime via `ini_set()` is too
+ * late. The Emscripten preRun hook below writes the ini file before
+ * PHP.initializeRuntime invokes __wasm_call_ctors, which in turn
+ * invokes wasm_sapi_module_startup → php_module_startup.
+ *
+ * PHP.initializeRuntime will skip writing its own default php.ini
+ * when the file already exists.
+ */
+export declare const LEGACY_PHP_INI_PATH = "/internal/shared/php.ini";
+export declare const LEGACY_PHP_INI_CONTENT: string;
+/**
+ * Returns an Emscripten preRun callback that writes
+ * {@link LEGACY_PHP_INI_CONTENT} to {@link LEGACY_PHP_INI_PATH}.
+ */
+export declare function createLegacyPhpIniPreRunStep(): (module: {
+    FS: {
+        mkdirTree: (path: string) => void;
+        writeFile: (path: string, content: string) => void;
+    };
+}) => void;

package/lib/proxy-file-system.d.ts

@@ -6,8 +6,20 @@ import type { PHP } from './php';
  * For example, mounting /wordpress from the parent instance into a child worker allows
  * both to access the same WordPress installation without copying the entire directory.
  *
- * The function automatically patches PROXYFS with mmap support before mounting, ensuring
- * libraries like ICU can memory-map data files through the proxied filesystem.
+ * The function automatically patches PROXYFS with mmap support before mounting on
+ * PHP 7+, so libraries like ICU can memory-map data files through the proxied
+ * filesystem.
+ *
+ * Legacy PHP (< 7) skips the mmap patch. PHP 5.x's zend_compile_file
+ * calls mmap() via zend_stream_fixup and trusts fstat() for the buffer
+ * size. When a file is pre-populated in MEMFS before PROXYFS is mounted
+ * over that path (e.g. php.ini written by preRun), fstat() can return
+ * the stale MEMFS size instead of the PROXYFS size, causing the parser
+ * to read past the real EOF and report spurious syntax errors. Without
+ * the mmap patch, Emscripten returns ENOSYS from mmap() and PHP falls
+ * back to a read-based path that handles size mismatches gracefully.
+ * PHP 7+ removed the mmap path from zend_stream_fixup entirely, so the
+ * patch is both safe and needed there (for ICU/intl).
  *
  * Mounts are registered via php.mount() so they survive runtime rotation.
  * When the replica's WASM module is hot-swapped, hotSwapPHPRuntime()

package/lib/supported-php-versions.d.ts

@@ -2,3 +2,13 @@ export declare const SupportedPHPVersions: readonly ["8.5", "8.4", "8.3", "8.2",
 export declare const LatestSupportedPHPVersion: "8.5";
 export declare const SupportedPHPVersionsList: string[];
 export type SupportedPHPVersion = (typeof SupportedPHPVersions)[number];
+export declare const LegacyPHPVersions: readonly ["5.2"];
+export type LegacyPHPVersion = (typeof LegacyPHPVersions)[number];
+/**
+ * Type guard for legacy PHP versions. Lets callers narrow a string
+ * to `LegacyPHPVersion` without the `as readonly string[]` cast that
+ * would otherwise be required to satisfy `Array.prototype.includes`.
+ */
+export declare function isLegacyPHPVersion(version: string | undefined): version is LegacyPHPVersion;
+export declare const AllPHPVersions: readonly ["8.5", "8.4", "8.3", "8.2", "8.1", "8.0", "7.4", "5.2"];
+export type AllPHPVersion = SupportedPHPVersion | LegacyPHPVersion;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@php-wasm/universal",
-  "version": "3.1.19",
+  "version": "3.1.21",
   "description": "PHP.wasm – emscripten bindings for PHP",
   "repository": {
     "type": "git",
@@ -37,18 +37,17 @@
   "module": "./index.js",
   "types": "index.d.ts",
   "license": "GPL-2.0-or-later",
-  "gitHead": "be542ee28a5966eeb28154cd8e3723db5ff9df07",
+  "gitHead": "5864051cbf4c2a55656112d99a3f1b076bcd67cd",
   "engines": {
     "node": ">=20.10.0",
     "npm": ">=10.2.3"
   },
   "dependencies": {
     "ini": "4.1.2",
-    "@php-wasm/node-polyfills": "3.1.19",
-    "@php-wasm/logger": "3.1.19",
-    "@php-wasm/util": "3.1.19",
-    "@php-wasm/stream-compression": "3.1.19",
-    "@php-wasm/progress": "3.1.19"
+    "@php-wasm/logger": "3.1.21",
+    "@php-wasm/util": "3.1.21",
+    "@php-wasm/stream-compression": "3.1.21",
+    "@php-wasm/progress": "3.1.21"
   },
   "packageManager": "npm@10.9.2",
   "overrides": {
@@ -60,6 +59,7 @@
     "tmp": "0.2.5",
     "form-data": "^4.0.4",
     "lodash": "^4.17.23",
-    "glob": "^9.3.0"
+    "glob": "^9.3.0",
+    "webpackbar": "^7.0.0"
   }
 }