@php-wasm/universal 2.0.15 → 2.0.16

package/lib/php-worker.d.ts

@@ -1,9 +1,9 @@
 import type { EmscriptenDownloadMonitor } from '@php-wasm/progress';
+import type { ListFilesOptions, RmDirOptions } from './fs-helpers';
 import type { PHP } from './php';
 import type { PHPRequestHandler } from './php-request-handler';
-import type { PHPResponse } from './php-response';
-import type { PHPRequest, PHPRunOptions, MessageListener, PHPEvent, PHPEventListener } from './universal-php';
-import type { RmDirOptions, ListFilesOptions } from './fs-helpers';
+import type { PHPResponse, StreamedPHPResponse } from './php-response';
+import type { MessageListener, PHPEvent, PHPEventListener, PHPRequest, PHPRunOptions } from './universal-php';
 export type LimitedPHPApi = Pick<PHP, 'request' | 'defineConstant' | 'addEventListener' | 'removeEventListener' | 'mkdir' | 'mkdirTree' | 'readFileAsText' | 'readFileAsBuffer' | 'writeFile' | 'unlink' | 'mv' | 'rmdir' | 'listFiles' | 'isDir' | 'fileExists' | 'chdir' | 'run' | 'onMessage'> & {
     documentRoot: PHP['documentRoot'];
     absoluteUrl: PHP['absoluteUrl'];
@@ -52,6 +52,10 @@ export declare class PHPWorker implements LimitedPHPApi, AsyncDisposable {
     request(request: PHPRequest): Promise<PHPResponse>;
     /** @inheritDoc @php-wasm/universal!/PHP.run */
     run(request: PHPRunOptions): Promise<PHPResponse>;
+    /** @inheritDoc @php-wasm/universal!/PHP.cli */
+    cli(argv: string[], options?: {
+        env?: Record<string, string>;
+    }): Promise<StreamedPHPResponse>;
     /** @inheritDoc @php-wasm/universal!/PHP.chdir */
     chdir(path: string): void;
     /** @inheritDoc @php-wasm/universal!/PHP.setSapiName */

package/lib/php.d.ts

@@ -1,10 +1,10 @@
-import { PHPResponse, StreamedPHPResponse } from './php-response';
-import type { PHPRuntimeId } from './load-php-runtime';
-import type { MessageListener, PHPRequest, PHPRequestHeaders, PHPRunOptions, SpawnHandler, PHPEventListener, PHPEvent } from './universal-php';
-import type { RmDirOptions, ListFilesOptions } from './fs-helpers';
 import { Semaphore } from '@php-wasm/util';
-import type { PHPRequestHandler } from './php-request-handler';
 import type { Emscripten } from './emscripten-types';
+import type { ListFilesOptions, RmDirOptions } from './fs-helpers';
+import type { PHPRuntimeId } from './load-php-runtime';
+import type { PHPRequestHandler } from './php-request-handler';
+import { PHPResponse, StreamedPHPResponse } from './php-response';
+import type { MessageListener, PHPEvent, PHPEventListener, PHPRequest, PHPRequestHeaders, PHPRunOptions, SpawnHandler } from './universal-php';
 export declare const __private__dont__use: unique symbol;
 type ErrorSource = 'request' | 'php-wasm';
 export declare class PHPExecutionFailureError extends Error {
@@ -28,8 +28,6 @@ export declare class PHP implements Disposable {
     #private;
     protected [__private__dont__use]: any;
     requestHandler?: PHPRequestHandler;
-    private cliCalled;
-    private runStreamCalled;
     /**
      * An exclusive lock that prevent multiple requests from running at
      * the same time.
@@ -412,6 +410,16 @@ export declare class PHP implements Disposable {
      * @returns True if the file exists, false otherwise.
      */
     fileExists(path: string): boolean;
+    /**
+     * Enables inline PHP runtime rotation after a certain number of requests
+     * or an internal crash.
+     */
+    enableRuntimeRotation(options: {
+        recreateRuntime: () => Promise<number> | number;
+        maxRequests?: number;
+        cwd?: string;
+    }): void;
+    private rotateRuntime;
     /**
      * Hot-swaps the PHP runtime for a new one without
      * interrupting the operations of this PHP instance.

package/lib/rotate-php-runtime.d.ts

@@ -1,24 +1,14 @@
 import type { PHP } from './php';
 export interface RotateOptions {
     php: PHP;
-    cwd: string;
+    cwd?: string;
     recreateRuntime: () => Promise<number> | number;
-    maxRequests: number;
+    maxRequests?: number;
 }
 /**
- * Listens to PHP events and swaps the internal PHP Runtime for a fresh one
- * after a certain number of run() calls (which are responsible for handling
- * HTTP requests).
+ * Configures inline runtime rotation on the provided PHP instance.
+ * Returns a cleanup function that disables rotation.
  *
- * Why? Because PHP and PHP extension have a memory leak. Each request leaves
- * the memory a bit more fragmented and with a bit less available space than
- * before. Eventually, new allocations start failing.
- *
- * Rotating the PHP instance may seem like a workaround, but it's actually
- * what PHP-FPM does natively:
- *
- * https://www.php.net/manual/en/install.fpm.configuration.php#pm.max-tasks
- *
- * @return cleanup function to restore
+ * @deprecated Use `php.enableRuntimeRotation()` instead.
  */
-export declare function rotatePHPRuntime({ php, cwd, recreateRuntime, maxRequests, }: RotateOptions): () => void;
+export declare function rotatePHPRuntime({ php, cwd, recreateRuntime, maxRequests, }: RotateOptions): void;

package/lib/universal-php.d.ts

@@ -21,17 +21,17 @@ export interface PHPRuntimeInitializedEvent {
     type: 'runtime.initialized';
 }
 /**
- * Represents a PHP runtime destruction event.
+ * Emitted before the exit() method of the PHP Emscripten runtime is called.
  */
-export interface PHPRuntimeBeforeDestroyEvent {
-    type: 'runtime.beforedestroy';
+export interface PHPRuntimeBeforeExitEvent {
+    type: 'runtime.beforeExit';
 }
 /**
  * Represents an event related to the PHP instance.
  * This is intentionally not an extension of CustomEvent
  * to make it isomorphic between different JavaScript runtimes.
  */
-export type PHPEvent = PHPRequestEndEvent | PHPRequestErrorEvent | PHPRuntimeInitializedEvent | PHPRuntimeBeforeDestroyEvent;
+export type PHPEvent = PHPRequestEndEvent | PHPRequestErrorEvent | PHPRuntimeInitializedEvent | PHPRuntimeBeforeExitEvent;
 /**
  * A callback function that handles PHP events.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@php-wasm/universal",
-  "version": "2.0.15",
+  "version": "2.0.16",
   "description": "PHP.wasm – emscripten bindings for PHP",
   "repository": {
     "type": "git",
@@ -37,18 +37,18 @@
   "module": "./index.js",
   "types": "index.d.ts",
   "license": "GPL-2.0-or-later",
-  "gitHead": "f3f73a4fc48bbe3ae099da4c1418d2f125d16d0a",
+  "gitHead": "3587b829420250e2de23d2643151da75c0ccdbec",
   "engines": {
     "node": ">=20.18.3",
     "npm": ">=10.1.0"
   },
   "dependencies": {
     "ini": "4.1.2",
-    "@php-wasm/node-polyfills": "2.0.15",
-    "@php-wasm/logger": "2.0.15",
-    "@php-wasm/util": "2.0.15",
-    "@php-wasm/stream-compression": "2.0.15",
-    "@php-wasm/progress": "2.0.15"
+    "@php-wasm/node-polyfills": "2.0.16",
+    "@php-wasm/logger": "2.0.16",
+    "@php-wasm/util": "2.0.16",
+    "@php-wasm/stream-compression": "2.0.16",
+    "@php-wasm/progress": "2.0.16"
   },
   "overrides": {
     "rollup": "^4.34.6",