@php-wasm/universal 3.1.30 → 3.1.32

package/lib/index.d.ts

@@ -36,7 +36,7 @@ export { rotatePHPRuntime } from './rotate-php-runtime';
 export { writeFiles } from './write-files';
 export type { FileTree } from './write-files';
 export { withResolvedPHPExtensions, installPHPExtensionFilesSync, PHP_EXTENSIONS_DIR, resolvePHPExtension, } from './load-extension';
-export type { InstallPHPExtensionFilesOptions, PHPExtensionIniDirective, ResolvedInstallOptions, ResolvedPHPExtension, PHPExtensionManifest, PHPExtensionManifestExtraFiles, PHPExtensionSource, } from './load-extension';
+export type { InstallPHPExtensionFilesOptions, PHPExtensionIniDirective, PHPExtensionLoadDirective, ResolvedInstallOptions, ResolvedPHPExtension, PHPExtensionManifest, PHPExtensionManifestExtraFiles, PHPExtensionSource, } from './load-extension';
 export { DEFAULT_BASE_URL, ensurePathPrefix, removePathPrefix, toRelativeUrl, } from './urls';
 export { isExitCode } from './is-exit-code';
 export { proxyFileSystem, isPathToSharedFS } from './proxy-file-system';

package/lib/load-extension.d.ts

@@ -10,6 +10,7 @@ export declare const PHP_EXTENSIONS_DIR = "/internal/shared/extensions";
  * regular PHP extensions and `zend_extension` for Zend extensions like Xdebug.
  */
 export type PHPExtensionIniDirective = 'extension' | 'zend_extension';
+export type PHPExtensionLoadDirective = PHPExtensionIniDirective | false;
 /**
  * Extension artifact manifest. Lets callers publish a matrix of `.so` files
  * and lets `resolvePHPExtension()` select the artifact matching the current
@@ -19,6 +20,21 @@ export interface PHPExtensionManifest {
     name: string;
     version?: string;
     mode?: 'php-extension';
+    /**
+     * The first directive of the generated startup `.ini` file. Defaults to
+     * `extension`; use `zend_extension` for Zend extensions like Xdebug.
+     * Use `false` to stage the `.so` without registering it in php.ini.
+     */
+    loadWithIniDirective?: PHPExtensionLoadDirective;
+    /** Additional `key=value` lines for the generated startup `.ini` file. */
+    iniEntries?: Record<string, string>;
+    /** Environment variables added before the extension is loaded. */
+    env?: Record<string, string>;
+    /**
+     * VFS directory where PHP.wasm writes the extension `.so` file and its
+     * per-extension ini file. Defaults to `PHP_EXTENSIONS_DIR`.
+     */
+    extensionDir?: string;
     artifacts: Array<{
         /** PHP major/minor version, e.g. `8.4`. */
         phpVersion: string;
@@ -85,7 +101,7 @@ export interface ResolvedInstallOptions {
      * extensions need `extension=...`; Zend extensions like Xdebug need
      * `zend_extension=...`.
      */
-    loadWithIniDirective?: PHPExtensionIniDirective;
+    loadWithIniDirective?: PHPExtensionLoadDirective;
     /** Additional `key=value` lines for the generated startup `.ini` file. */
     iniEntries?: Record<string, string>;
     /**
@@ -119,13 +135,13 @@ export interface ResolvedPHPExtension {
     /** Compiled extension bytes to write at `soPath`. */
     soBytes: Uint8Array;
     /** Absolute VFS path the generated per-extension ini file is staged at. */
-    iniPath: string;
+    iniPath?: string;
     /**
      * Contents of the generated per-extension ini file. The first line is the
      * `extension=` or `zend_extension=` directive; remaining lines are the
      * caller-supplied `iniEntries`.
      */
-    iniContent: string;
+    iniContent?: string;
     /** Sidecar files staged alongside the extension. Optional. */
     extraFiles?: ResolvedExtraFiles;
     /** Environment variables added before PHP startup. */
@@ -159,7 +175,7 @@ export interface InstallPHPExtensionFilesOptions {
      * extensions need `extension=...`; Zend extensions like Xdebug need
      * `zend_extension=...`.
      */
-    loadWithIniDirective?: PHPExtensionIniDirective;
+    loadWithIniDirective?: PHPExtensionLoadDirective;
     /** Additional `key=value` lines for the generated startup `.ini` file. */
     iniEntries?: Record<string, string>;
     /** Sidecar files to write into the PHP VFS before the extension is loaded. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@php-wasm/universal",
-  "version": "3.1.30",
+  "version": "3.1.32",
   "description": "PHP.wasm – emscripten bindings for PHP",
   "repository": {
     "type": "git",
@@ -37,17 +37,17 @@
   "module": "./index.js",
   "types": "index.d.ts",
   "license": "GPL-2.0-or-later",
-  "gitHead": "1034030cf2893113dfc0d3a3ff79b1c60906cabe",
+  "gitHead": "992e9bb9c6aa842bb646044f56491c10fcb82e46",
   "engines": {
     "node": ">=20.10.0",
     "npm": ">=10.2.3"
   },
   "dependencies": {
     "ini": "4.1.2",
-    "@php-wasm/logger": "3.1.30",
-    "@php-wasm/util": "3.1.30",
-    "@php-wasm/stream-compression": "3.1.30",
-    "@php-wasm/progress": "3.1.30"
+    "@php-wasm/logger": "3.1.32",
+    "@php-wasm/util": "3.1.32",
+    "@php-wasm/stream-compression": "3.1.32",
+    "@php-wasm/progress": "3.1.32"
   },
   "packageManager": "npm@10.9.2",
   "overrides": {