@wp-playground/wordpress 3.0.19 → 3.0.21

package/boot.d.ts

@@ -74,6 +74,7 @@ export interface BootRequestHandlerOptions {
      */
     cookieStore?: CookieStore | false;
 }
+export type WordPressInstallMode = 'download-and-install' | 'install-from-existing-files' | 'install-from-existing-files-if-needed' | 'do-not-attempt-installing';
 export interface BootWordPressOptions {
     /**
      * Mounting and Copying is handled via hooks for starters.
@@ -85,6 +86,8 @@ export interface BootWordPressOptions {
     hooks?: Hooks;
     /** SQL file to load instead of installing WordPress. */
     dataSqlPath?: string;
+    /** How to handle WordPress installation. */
+    wordpressInstallMode?: WordPressInstallMode;
     /** Zip with the WordPress installation to extract in /wordpress. */
     wordPressZip?: File | Promise<File> | undefined;
     /** Preloaded SQLite integration plugin. */

package/index.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("@php-wasm/util"),p=require("@wp-playground/common"),c=require("@php-wasm/logger"),d=require("@php-wasm/universal"),R=`<?php
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("@php-wasm/util"),f=require("@wp-playground/common"),h=require("@php-wasm/logger"),u=require("@php-wasm/universal"),x=`<?php
 
 /**
  * Rewrites the wp-config.php file to ensure specific constants are defined
@@ -343,8 +343,8 @@ function skip_whitespace($tokens) {
     }
     return $output;
 }
-`;async function _(e,t,n,i="rewrite"){const r=o.phpVars({wpConfigPath:t,constants:n,whenAlreadyDefined:i});if((await e.run({code:`<?php ob_start(); ?>
-			${R}
+`;async function g(e,n,t,i="rewrite"){const r=a.phpVars({wpConfigPath:n,constants:t,whenAlreadyDefined:i});if((await e.run({code:`<?php ob_start(); ?>
+			${x}
 			$wp_config_path = ${r.wpConfigPath};
 			$wp_config = file_get_contents($wp_config_path);
 			$new_wp_config = rewrite_wp_config_to_define_constants($wp_config, ${r.constants}, ${r.whenAlreadyDefined});
@@ -352,7 +352,7 @@ function skip_whitespace($tokens) {
 			ob_clean();
 			echo false === $return_value ? '0' : '1';
 			ob_end_flush();
-		`})).text!=="1")throw new Error("Failed to rewrite constants in wp-config.php.")}async function h(e,t){const n=o.joinPaths(t,"wp-config.php"),i={DB_NAME:"wordpress"};!e.fileExists(n)&&e.fileExists(o.joinPaths(t,"wp-config-sample.php"))&&await e.writeFile(n,await e.readFileAsBuffer(o.joinPaths(t,"wp-config-sample.php"))),await _(e,n,i,"skip")}async function v(e){const t=await w(e);return await g(t,e),t}async function g(e,t){var i,r;const n=await e.getPrimaryPhp();if((i=t.hooks)!=null&&i.beforeWordPressFiles&&await t.hooks.beforeWordPressFiles(n),t.wordPressZip&&await E(n,await t.wordPressZip),t.constants)for(const a in t.constants)n.defineConstant(a,t.constants[a]);if(t.dataSqlPath&&(n.defineConstant("DB_DIR",o.dirname(t.dataSqlPath)),n.defineConstant("DB_FILE",o.basename(t.dataSqlPath))),n.defineConstant("WP_HOME",t.siteUrl),n.defineConstant("WP_SITEURL",t.siteUrl),await h(n,e.documentRoot),(r=t.hooks)!=null&&r.beforeDatabaseSetup&&await t.hooks.beforeDatabaseSetup(n),t.sqliteIntegrationPluginZip&&await k(n,await t.sqliteIntegrationPluginZip),t.wordPressZip&&!t.dataSqlPath&&(await f(n)||await S(n),!await f(n))){if(await L(n))throw new Error("WordPress installation has failed.");if(n.isFile("/internal/shared/preload/0-sqlite.php"))throw new Error("Error connecting to the SQLite database.");if(!t.sqliteIntegrationPluginZip){const l=o.joinPaths(e.documentRoot,"wp-content/mu-plugins/sqlite-database-integration");if(n.isDir(l))throw new Error("Error connecting to the SQLite database.")}throw new Error("Error connecting to the MySQL database.")}return e}async function w(e){const t=e.spawnHandler??d.sandboxedSpawnHandlerFactory;async function n(r,a){const l=await e.createPhpRuntime(a),s=new d.PHP(l);return e.sapiName&&s.setSapiName(e.sapiName),r&&(s.requestHandler=r),e.phpIniEntries&&d.setPhpIniEntries(s,e.phpIniEntries),s.defineConstant("WP_SQLITE_AST_DRIVER",!0),a&&!s.isFile("/internal/.boot-files-written")&&(await y(s),await d.writeFiles(s,"/",e.createFiles||{}),await P(s,o.joinPaths(new URL(e.siteUrl).pathname,"phpinfo.php")),await d.writeFiles(s,"/internal",{".boot-files-written":""})),t&&await s.setSpawnHandler(t(r.processManager)),s.enableRuntimeRotation({recreateRuntime:e.createPhpRuntime,maxRequests:400}),e.onPHPInstanceCreated&&await e.onPHPInstanceCreated(s,{isPrimary:a}),s}const i=new d.PHPRequestHandler({phpFactory:async({isPrimary:r})=>n(i,r),documentRoot:e.documentRoot||"/wordpress",absoluteUrl:e.siteUrl,rewriteRules:b,getFileNotFoundAction:e.getFileNotFoundAction??$,cookieStore:e.cookieStore});return i}async function f(e){return(await e.run({code:`<?php
+		`})).text!=="1")throw new Error("Failed to rewrite constants in wp-config.php.")}async function w(e,n){const t=a.joinPaths(n,"wp-config.php"),i={DB_NAME:"wordpress"};!e.fileExists(t)&&e.fileExists(a.joinPaths(n,"wp-config-sample.php"))&&await e.writeFile(t,await e.readFileAsBuffer(a.joinPaths(n,"wp-config-sample.php"))),await g(e,t,i,"skip")}async function L(e){const n=await m(e);return await $(n,e),n}async function $(e,n){var l,s;const t=await e.getPrimaryPhp();if((l=n.hooks)!=null&&l.beforeWordPressFiles&&await n.hooks.beforeWordPressFiles(t),n.wordPressZip&&await S(t,await n.wordPressZip),n.constants)for(const d in n.constants)t.defineConstant(d,n.constants[d]);n.dataSqlPath&&(t.defineConstant("DB_DIR",a.dirname(n.dataSqlPath)),t.defineConstant("DB_FILE",a.basename(n.dataSqlPath))),t.defineConstant("WP_HOME",n.siteUrl),t.defineConstant("WP_SITEURL",n.siteUrl),await w(t,e.documentRoot),(s=n.hooks)!=null&&s.beforeDatabaseSetup&&await n.hooks.beforeDatabaseSetup(t);let i=!1;n.sqliteIntegrationPluginZip&&(i=!0,await R(t,await n.sqliteIntegrationPluginZip));const r=n.wordpressInstallMode??"download-and-install",o=!!n.dataSqlPath;if(["download-and-install","install-from-existing-files"].includes(r)){await c(e,{usesSqlite:i,hasCustomDatabasePath:o});try{await _(t)}catch(d){throw o||await p(e),d}o||await p(e)}else if(r==="install-from-existing-files-if-needed"){if(await c(e,{usesSqlite:i,hasCustomDatabasePath:o}),!await b(t))try{await _(t)}catch(d){throw o||await p(e),d}o||await p(e)}return e}async function c(e,{usesSqlite:n,hasCustomDatabasePath:t}){const i=await e.getPrimaryPhp();if(i.isFile("/internal/shared/preload/0-sqlite.php"))return;const r=a.joinPaths(e.documentRoot,"wp-content/mu-plugins/sqlite-database-integration");if(!i.isDir(r)&&!n&&!t)throw new Error("Error connecting to the MySQL database.")}async function p(e){const n=await e.getPrimaryPhp();if(await I(n))return;if(n.isFile("/internal/shared/preload/0-sqlite.php"))throw new Error("Error connecting to the SQLite database.");const i=a.joinPaths(e.documentRoot,"wp-content/mu-plugins/sqlite-database-integration");throw n.isDir(i)?new Error("Error connecting to the SQLite database."):new Error("Error connecting to the MySQL database.")}async function m(e){const n=e.spawnHandler??u.sandboxedSpawnHandlerFactory;async function t(r,o){const l=await e.createPhpRuntime(o),s=new u.PHP(l);return e.sapiName&&s.setSapiName(e.sapiName),r&&(s.requestHandler=r),e.phpIniEntries&&u.setPhpIniEntries(s,e.phpIniEntries),s.defineConstant("WP_SQLITE_AST_DRIVER",!0),o&&!s.isFile("/internal/.boot-files-written")&&(await E(s),await u.writeFiles(s,"/",e.createFiles||{}),await T(s,a.joinPaths(new URL(e.siteUrl).pathname,"phpinfo.php")),await u.writeFiles(s,"/internal",{".boot-files-written":""})),n&&await s.setSpawnHandler(n(r.processManager)),s.enableRuntimeRotation({recreateRuntime:e.createPhpRuntime,maxRequests:400}),e.onPHPInstanceCreated&&await e.onPHPInstanceCreated(s,{isPrimary:o}),s}const i=new u.PHPRequestHandler({phpFactory:async({isPrimary:r})=>t(i,r),documentRoot:e.documentRoot||"/wordpress",absoluteUrl:e.siteUrl,rewriteRules:k,getFileNotFoundAction:e.getFileNotFoundAction??y,cookieStore:e.cookieStore});return i}async function b(e){return(await e.run({code:`<?php
 			ob_start();
 			$wp_load = getenv('DOCUMENT_ROOT') . '/wp-load.php';
 			if (!file_exists($wp_load)) {
@@ -363,7 +363,7 @@ function skip_whitespace($tokens) {
 			ob_clean();
 			echo is_blog_installed() ? '1' : '0';
 			ob_end_flush();
-		`,env:{DOCUMENT_ROOT:e.documentRoot}})).text==="1"}async function S(e){await d.withPHPIniValues(e,{disable_functions:"fsockopen",allow_url_fopen:"0"},async()=>await e.request({url:"/wp-admin/install.php?step=2",method:"POST",body:{language:"en",prefix:"wp_",weblog_title:"My WordPress Website",user_name:"admin",admin_password:"password",admin_password2:"password",Submit:"Install WordPress",pw_weak:"1",admin_email:"admin@localhost.com"}})),(await e.run({code:`<?php
+		`,env:{DOCUMENT_ROOT:e.documentRoot}})).text==="1"}async function _(e){var i;const n=await u.withPHPIniValues(e,{disable_functions:"fsockopen",allow_url_fopen:"0"},async()=>await e.request({url:"/wp-admin/install.php?step=2",method:"POST",body:{language:"en",prefix:"wp_",weblog_title:"My WordPress Website",user_name:"admin",admin_password:"password",admin_password2:"password",Submit:"Install WordPress",pw_weak:"1",admin_email:"admin@localhost.com"}}));if(!await b(e))throw new Error(`Failed to install WordPress – installer responded with "${(i=n.text)==null?void 0:i.substring(0,100)}"`);(await e.run({code:`<?php
 			ob_start();
 			$wp_load = getenv('DOCUMENT_ROOT') . '/wp-load.php';
 			if (!file_exists($wp_load)) {
@@ -378,7 +378,7 @@ function skip_whitespace($tokens) {
 			ob_clean();
 			echo $option_result ? '1' : '0';
 			ob_end_flush();
-		`,env:{DOCUMENT_ROOT:e.documentRoot}})).text!=="1"&&c.logger.warn("Failed to default to pretty permalinks after WP install.")}function $(e){return{type:"internal-redirect",uri:"/index.php"}}async function L(e){return(await e.run({code:`<?php
+		`,env:{DOCUMENT_ROOT:e.documentRoot}})).text!=="1"&&h.logger.warn("Failed to default to pretty permalinks after WP install.")}function y(e){return{type:"internal-redirect",uri:"/index.php"}}async function I(e){return(await e.run({code:`<?php
 			ob_start();
 			$wp_load = getenv('DOCUMENT_ROOT') . '/wp-load.php';
 			if (!file_exists($wp_load)) {
@@ -387,12 +387,12 @@ function skip_whitespace($tokens) {
 			}
 			require $wp_load;
 			ob_clean();
-			echo $wpdb->check_connection( false) ? '1' : '0';
+			echo $wpdb->check_connection( false ) ? '1' : '0';
 			ob_end_flush();
-		`,env:{DOCUMENT_ROOT:e.documentRoot}})).text==="1"}async function x(e){const{php:t,reap:n}=await e.processManager.acquirePHPInstance({considerPrimary:!0});try{const r=(await t.run({code:`<?php
+		`,env:{DOCUMENT_ROOT:e.documentRoot}})).text==="1"}async function W(e){const{php:n,reap:t}=await e.processManager.acquirePHPInstance({considerPrimary:!0});try{const r=(await n.run({code:`<?php
 				require '${e.documentRoot}/wp-includes/version.php';
 				echo $wp_version;
-			`})).text;if(!r)throw new Error("Unable to read loaded WordPress version.");return m(r)}finally{n()}}function m(e){if(/-(alpha|beta|RC)\d*-\d+$/.test(e))return"nightly";if(/-(beta|RC)\d*$/.test(e))return"beta";const i=e.match(/^(\d+\.\d+)(?:\.\d+)?$/);return i!==null?i[1]:e}const b=[{match:/^\/(.*?)(\/wp-(content|admin|includes)\/.*)/g,replacement:"$2"}];async function y(e){await e.mkdir("/internal/shared/mu-plugins"),await e.writeFile("/internal/shared/preload/env.php",`<?php
+			`})).text;if(!r)throw new Error("Unable to read loaded WordPress version.");return P(r)}finally{t()}}function P(e){if(/-(alpha|beta|RC)\d*-\d+$/.test(e))return"nightly";if(/-(beta|RC)\d*$/.test(e))return"beta";const i=e.match(/^(\d+\.\d+)(?:\.\d+)?$/);return i!==null?i[1]:e}const k=[{match:new RegExp("^(/[_0-9a-zA-Z-]+)?(/wp-(content|admin|includes)/.*)"),replacement:"$2"}];async function E(e){await e.mkdir("/internal/shared/mu-plugins"),await e.writeFile("/internal/shared/preload/env.php",`<?php
 
         // Allow adding filters/actions prior to loading WordPress.
         // $function_to_add MUST be a string.
@@ -663,18 +663,18 @@ function skip_whitespace($tokens) {
 				}
 				return false;
 			});
-		})();`)}async function P(e,t="/phpinfo.php"){await e.writeFile("/internal/shared/preload/phpinfo.php",`<?php
+		})();`)}async function T(e,n="/phpinfo.php"){await e.writeFile("/internal/shared/preload/phpinfo.php",`<?php
     // Render PHPInfo if the requested page is /phpinfo.php
-    if ( isset($_SERVER['REQUEST_URI']) && ${o.phpVar(t)} === $_SERVER['REQUEST_URI'] ) {
+    if ( isset($_SERVER['REQUEST_URI']) && ${a.phpVar(n)} === $_SERVER['REQUEST_URI'] ) {
         phpinfo();
         exit;
     }
-    `)}async function k(e,t){await e.isDir("/tmp/sqlite-database-integration")&&await e.rmdir("/tmp/sqlite-database-integration",{recursive:!0}),await e.mkdir("/tmp/sqlite-database-integration"),await p.unzipFile(e,t,"/tmp/sqlite-database-integration");const n="/internal/shared/sqlite-database-integration",i=`/tmp/sqlite-database-integration/${(await e.listFiles("/tmp/sqlite-database-integration"))[0]}`;await e.mv(i,n),await e.defineConstant("SQLITE_MAIN_FILE","1");const a=(await e.readFileAsText(o.joinPaths(n,"db.copy"))).replace("'{SQLITE_IMPLEMENTATION_FOLDER_PATH}'",o.phpVar(n)).replace("'{SQLITE_PLUGIN}'",o.phpVar(o.joinPaths(n,"load.php"))),l=o.joinPaths(await e.documentRoot,"wp-content/db.php"),s=`<?php
+    `)}async function R(e,n){await e.isDir("/tmp/sqlite-database-integration")&&await e.rmdir("/tmp/sqlite-database-integration",{recursive:!0}),await e.mkdir("/tmp/sqlite-database-integration"),await f.unzipFile(e,n,"/tmp/sqlite-database-integration");const t="/internal/shared/sqlite-database-integration",i=`/tmp/sqlite-database-integration/${(await e.listFiles("/tmp/sqlite-database-integration"))[0]}`;await e.mv(i,t),await e.defineConstant("SQLITE_MAIN_FILE","1");const o=(await e.readFileAsText(a.joinPaths(t,"db.copy"))).replace("'{SQLITE_IMPLEMENTATION_FOLDER_PATH}'",a.phpVar(t)).replace("'{SQLITE_PLUGIN}'",a.phpVar(a.joinPaths(t,"load.php"))),l=a.joinPaths(await e.documentRoot,"wp-content/db.php"),s=`<?php
 	// Do not preload this if WordPress comes with a custom db.php file.
-	if(file_exists(${o.phpVar(l)})) {
+	if(file_exists(${a.phpVar(l)})) {
 		return;
 	}
-	?>`,u="/internal/shared/mu-plugins/sqlite-database-integration.php";await e.writeFile(u,s+a),await e.writeFile("/internal/shared/preload/0-sqlite.php",s+`<?php
+	?>`,d="/internal/shared/mu-plugins/sqlite-database-integration.php";await e.writeFile(d,s+o),await e.writeFile("/internal/shared/preload/0-sqlite.php",s+`<?php
 
 /**
  * Loads the SQLite integration plugin before WordPress is loaded
@@ -724,7 +724,7 @@ class Playground_SQLite_Integration_Loader {
 		$GLOBALS['wpdb']->$name = $value;
 	}
     protected function load_sqlite_integration() {
-        require_once ${o.phpVar(u)};
+        require_once ${a.phpVar(d)};
     }
 }
 /**
@@ -755,5 +755,5 @@ if(!function_exists('mysqli_connect')) {
 			var_dump(isset($wpdb));
 			die("SQLite integration not loaded " . get_class($wpdb));
 		}
-		`)}async function E(e,t){e.mkdir("/tmp/unzipped-wordpress"),await p.unzipFile(e,t,"/tmp/unzipped-wordpress"),e.fileExists("/tmp/unzipped-wordpress/wordpress.zip")&&await p.unzipFile(e,"/tmp/unzipped-wordpress/wordpress.zip","/tmp/unzipped-wordpress");let n=e.fileExists("/tmp/unzipped-wordpress/wordpress")?"/tmp/unzipped-wordpress/wordpress":e.fileExists("/tmp/unzipped-wordpress/build")?"/tmp/unzipped-wordpress/build":"/tmp/unzipped-wordpress";if(!e.fileExists(o.joinPaths(n,"wp-config-sample.php"))){const r=e.listFiles(n);if(r.length){const a=r[0];e.fileExists(o.joinPaths(n,a,"wp-config-sample.php"))&&(n=o.joinPaths(n,a))}}const i=(r,a,l)=>{if(l.isDir(r)&&l.isDir(a))for(const s of l.listFiles(r)){const u=o.joinPaths(r,s),T=o.joinPaths(a,s);i(u,T,l)}else{if(l.fileExists(a)){const s=r.replace(/^\/tmp\/unzipped-wordpress\//,"/");c.logger.warn(`Cannot unzip WordPress files at ${a}: ${s} already exists.`);return}l.mv(r,a)}};i(n,e.documentRoot,e),e.fileExists(n)&&e.rmdir(n,{recursive:!0}),!e.fileExists(o.joinPaths(e.documentRoot,"wp-config.php"))&&e.fileExists(o.joinPaths(e.documentRoot,"wp-config-sample.php"))&&e.writeFile(o.joinPaths(e.documentRoot,"wp-config.php"),e.readFileAsText(o.joinPaths(e.documentRoot,"/wp-config-sample.php")))}const I=p.createMemoizedFetch(fetch);async function W(e="latest"){if(e.startsWith("https://")||e.startsWith("http://")){const i=await crypto.subtle.digest("SHA-1",new TextEncoder().encode(e)),r=Array.from(new Uint8Array(i)).map(a=>a.toString(16).padStart(2,"0")).join("");return{releaseUrl:e,version:"custom-"+r.substring(0,8),source:"inferred"}}else if(e==="trunk"||e==="nightly")return{releaseUrl:"https://wordpress.org/nightly-builds/wordpress-latest.zip",version:"nightly-"+new Date().toISOString().split("T")[0],source:"inferred"};let n=await(await I("https://api.wordpress.org/core/version-check/1.7/?channel=beta")).json();n=n.offers.filter(i=>i.response==="autoupdate");for(const i of n){if(e==="beta"&&i.version.includes("beta"))return{releaseUrl:i.download,version:i.version,source:"api"};if(e==="latest"&&!i.version.includes("beta"))return{releaseUrl:i.download,version:i.version,source:"api"};if(i.version.substring(0,e.length)===e)return{releaseUrl:i.download,version:i.version,source:"api"}}return e.match(/^\d+\.\d+\.0$/)&&(e=e.split(".").slice(0,2).join(".")),{releaseUrl:`https://wordpress.org/wordpress-${e}.zip`,version:e,source:"inferred"}}exports.bootRequestHandler=w;exports.bootWordPress=g;exports.bootWordPressAndRequestHandler=v;exports.defineWpConfigConstants=_;exports.ensureWpConfig=h;exports.getFileNotFoundActionForWordPress=$;exports.getLoadedWordPressVersion=x;exports.preloadPhpInfoRoute=P;exports.preloadSqliteIntegration=k;exports.resolveWordPressRelease=W;exports.setupPlatformLevelMuPlugins=y;exports.unzipWordPress=E;exports.versionStringToLoadedWordPressVersion=m;exports.wordPressRewriteRules=b;
+		`)}async function S(e,n){e.mkdir("/tmp/unzipped-wordpress"),await f.unzipFile(e,n,"/tmp/unzipped-wordpress"),e.fileExists("/tmp/unzipped-wordpress/wordpress.zip")&&await f.unzipFile(e,"/tmp/unzipped-wordpress/wordpress.zip","/tmp/unzipped-wordpress");let t=e.fileExists("/tmp/unzipped-wordpress/wordpress")?"/tmp/unzipped-wordpress/wordpress":e.fileExists("/tmp/unzipped-wordpress/build")?"/tmp/unzipped-wordpress/build":"/tmp/unzipped-wordpress";if(!e.fileExists(a.joinPaths(t,"wp-config-sample.php"))){const r=e.listFiles(t);if(r.length){const o=r[0];e.fileExists(a.joinPaths(t,o,"wp-config-sample.php"))&&(t=a.joinPaths(t,o))}}const i=(r,o,l)=>{if(l.isDir(r)&&l.isDir(o))for(const s of l.listFiles(r)){const d=a.joinPaths(r,s),v=a.joinPaths(o,s);i(d,v,l)}else{if(l.fileExists(o)){const s=r.replace(/^\/tmp\/unzipped-wordpress\//,"/");h.logger.warn(`Cannot unzip WordPress files at ${o}: ${s} already exists.`);return}l.mv(r,o)}};i(t,e.documentRoot,e),e.fileExists(t)&&e.rmdir(t,{recursive:!0}),!e.fileExists(a.joinPaths(e.documentRoot,"wp-config.php"))&&e.fileExists(a.joinPaths(e.documentRoot,"wp-config-sample.php"))&&e.writeFile(a.joinPaths(e.documentRoot,"wp-config.php"),e.readFileAsText(a.joinPaths(e.documentRoot,"/wp-config-sample.php")))}const U=f.createMemoizedFetch(fetch);async function C(e="latest"){if(e.startsWith("https://")||e.startsWith("http://")){const i=await crypto.subtle.digest("SHA-1",new TextEncoder().encode(e)),r=Array.from(new Uint8Array(i)).map(o=>o.toString(16).padStart(2,"0")).join("");return{releaseUrl:e,version:"custom-"+r.substring(0,8),source:"inferred"}}else if(e==="trunk"||e==="nightly")return{releaseUrl:"https://wordpress.org/nightly-builds/wordpress-latest.zip",version:"nightly-"+new Date().toISOString().split("T")[0],source:"inferred"};let t=await(await U("https://api.wordpress.org/core/version-check/1.7/?channel=beta")).json();t=t.offers.filter(i=>i.response==="autoupdate");for(const i of t){if(e==="beta"&&i.version.includes("beta"))return{releaseUrl:i.download,version:i.version,source:"api"};if(e==="latest"&&!i.version.includes("beta"))return{releaseUrl:i.download,version:i.version,source:"api"};if(i.version.substring(0,e.length)===e)return{releaseUrl:i.download,version:i.version,source:"api"}}return e.match(/^\d+\.\d+\.0$/)&&(e=e.split(".").slice(0,2).join(".")),{releaseUrl:`https://wordpress.org/wordpress-${e}.zip`,version:e,source:"inferred"}}exports.bootRequestHandler=m;exports.bootWordPress=$;exports.bootWordPressAndRequestHandler=L;exports.defineWpConfigConstants=g;exports.ensureWpConfig=w;exports.getFileNotFoundActionForWordPress=y;exports.getLoadedWordPressVersion=W;exports.preloadPhpInfoRoute=T;exports.preloadSqliteIntegration=R;exports.resolveWordPressRelease=C;exports.setupPlatformLevelMuPlugins=E;exports.unzipWordPress=S;exports.versionStringToLoadedWordPressVersion=P;exports.wordPressRewriteRules=k;
 //# sourceMappingURL=index.cjs.map

package/index.d.ts

@@ -1,6 +1,6 @@
 import type { PHP, UniversalPHP } from '@php-wasm/universal';
 export { bootWordPress, bootWordPressAndRequestHandler, bootRequestHandler, getFileNotFoundActionForWordPress, } from './boot';
-export type { PhpIniOptions, PHPInstanceCreatedHook } from './boot';
+export type { PhpIniOptions, PHPInstanceCreatedHook, WordPressInstallMode, } from './boot';
 export { defineWpConfigConstants, ensureWpConfig } from './rewrite-wp-config';
 export { getLoadedWordPressVersion } from './version-detect';
 export * from './version-detect';

package/index.js

@@ -1,8 +1,8 @@
-import { phpVars as g, joinPaths as s, dirname as $, basename as w, phpVar as l } from "@php-wasm/util";
-import { createMemoizedFetch as m, unzipFile as p } from "@wp-playground/common";
-import { logger as _ } from "@php-wasm/logger";
-import { sandboxedSpawnHandlerFactory as b, PHPRequestHandler as y, withPHPIniValues as k, PHP as P, setPhpIniEntries as E, writeFiles as f } from "@php-wasm/universal";
-const T = `<?php
+import { phpVars as m, joinPaths as s, dirname as b, basename as y, phpVar as u } from "@php-wasm/util";
+import { createMemoizedFetch as k, unzipFile as f } from "@wp-playground/common";
+import { logger as g } from "@php-wasm/logger";
+import { sandboxedSpawnHandlerFactory as P, PHPRequestHandler as E, withPHPIniValues as T, PHP as R, setPhpIniEntries as S, writeFiles as c } from "@php-wasm/universal";
+const v = `<?php
 
 /**
  * Rewrites the wp-config.php file to ensure specific constants are defined
@@ -348,11 +348,11 @@ function skip_whitespace($tokens) {
     return $output;
 }
 `;
-async function R(e, t, n, i = "rewrite") {
-  const r = g({ wpConfigPath: t, constants: n, whenAlreadyDefined: i });
+async function x(e, n, t, i = "rewrite") {
+  const r = m({ wpConfigPath: n, constants: t, whenAlreadyDefined: i });
   if ((await e.run({
     code: `<?php ob_start(); ?>
-			${T}
+			${v}
 			$wp_config_path = ${r.wpConfigPath};
 			$wp_config = file_get_contents($wp_config_path);
 			$new_wp_config = rewrite_wp_config_to_define_constants($wp_config, ${r.constants}, ${r.whenAlreadyDefined});
@@ -364,54 +364,92 @@ async function R(e, t, n, i = "rewrite") {
   })).text !== "1")
     throw new Error("Failed to rewrite constants in wp-config.php.");
 }
-async function v(e, t) {
-  const n = s(t, "wp-config.php"), i = {
+async function L(e, n) {
+  const t = s(n, "wp-config.php"), i = {
     DB_NAME: "wordpress"
   };
-  !e.fileExists(n) && e.fileExists(s(t, "wp-config-sample.php")) && await e.writeFile(
-    n,
+  !e.fileExists(t) && e.fileExists(s(n, "wp-config-sample.php")) && await e.writeFile(
+    t,
     await e.readFileAsBuffer(
-      s(t, "wp-config-sample.php")
+      s(n, "wp-config-sample.php")
     )
-  ), await R(e, n, i, "skip");
+  ), await x(e, t, i, "skip");
 }
-async function H(e) {
-  const t = await x(e);
-  return await S(t, e), t;
+async function Q(e) {
+  const n = await U(e);
+  return await I(n, e), n;
 }
-async function S(e, t) {
-  var i, r;
-  const n = await e.getPrimaryPhp();
-  if ((i = t.hooks) != null && i.beforeWordPressFiles && await t.hooks.beforeWordPressFiles(n), t.wordPressZip && await q(n, await t.wordPressZip), t.constants)
-    for (const a in t.constants)
-      n.defineConstant(a, t.constants[a]);
-  if (t.dataSqlPath && (n.defineConstant("DB_DIR", $(t.dataSqlPath)), n.defineConstant("DB_FILE", w(t.dataSqlPath))), n.defineConstant("WP_HOME", t.siteUrl), n.defineConstant("WP_SITEURL", t.siteUrl), await v(n, e.documentRoot), (r = t.hooks) != null && r.beforeDatabaseSetup && await t.hooks.beforeDatabaseSetup(n), t.sqliteIntegrationPluginZip && await A(
-    n,
-    await t.sqliteIntegrationPluginZip
-  ), t.wordPressZip && !t.dataSqlPath && (await c(n) || await L(n), !await c(n))) {
-    if (await U(n))
-      throw new Error("WordPress installation has failed.");
-    if (n.isFile("/internal/shared/preload/0-sqlite.php"))
-      throw new Error("Error connecting to the SQLite database.");
-    if (!t.sqliteIntegrationPluginZip) {
-      const d = s(
-        e.documentRoot,
-        "wp-content/mu-plugins/sqlite-database-integration"
-      );
-      if (n.isDir(d))
-        throw new Error(
-          "Error connecting to the SQLite database."
-        );
+async function I(e, n) {
+  var l, o;
+  const t = await e.getPrimaryPhp();
+  if ((l = n.hooks) != null && l.beforeWordPressFiles && await n.hooks.beforeWordPressFiles(t), n.wordPressZip && await q(t, await n.wordPressZip), n.constants)
+    for (const d in n.constants)
+      t.defineConstant(d, n.constants[d]);
+  n.dataSqlPath && (t.defineConstant("DB_DIR", b(n.dataSqlPath)), t.defineConstant("DB_FILE", y(n.dataSqlPath))), t.defineConstant("WP_HOME", n.siteUrl), t.defineConstant("WP_SITEURL", n.siteUrl), await L(t, e.documentRoot), (o = n.hooks) != null && o.beforeDatabaseSetup && await n.hooks.beforeDatabaseSetup(t);
+  let i = !1;
+  n.sqliteIntegrationPluginZip && (i = !0, await N(
+    t,
+    await n.sqliteIntegrationPluginZip
+  ));
+  const r = n.wordpressInstallMode ?? "download-and-install", a = !!n.dataSqlPath;
+  if (["download-and-install", "install-from-existing-files"].includes(
+    r
+  )) {
+    await _(e, {
+      usesSqlite: i,
+      hasCustomDatabasePath: a
+    });
+    try {
+      await h(t);
+    } catch (d) {
+      throw a || await p(e), d;
     }
-    throw new Error("Error connecting to the MySQL database.");
+    a || await p(e);
+  } else if (r === "install-from-existing-files-if-needed") {
+    if (await _(e, {
+      usesSqlite: i,
+      hasCustomDatabasePath: a
+    }), !await w(t))
+      try {
+        await h(t);
+      } catch (d) {
+        throw a || await p(e), d;
+      }
+    a || await p(e);
   }
   return e;
 }
-async function x(e) {
-  const t = e.spawnHandler ?? b;
-  async function n(r, a) {
-    const d = await e.createPhpRuntime(a), o = new P(d);
-    return e.sapiName && o.setSapiName(e.sapiName), r && (o.requestHandler = r), e.phpIniEntries && E(o, e.phpIniEntries), o.defineConstant("WP_SQLITE_AST_DRIVER", !0), a && /**
+async function _(e, {
+  usesSqlite: n,
+  hasCustomDatabasePath: t
+}) {
+  const i = await e.getPrimaryPhp();
+  if (i.isFile("/internal/shared/preload/0-sqlite.php"))
+    return;
+  const r = s(
+    e.documentRoot,
+    "wp-content/mu-plugins/sqlite-database-integration"
+  );
+  if (!i.isDir(r) && !n && !t)
+    throw new Error("Error connecting to the MySQL database.");
+}
+async function p(e) {
+  const n = await e.getPrimaryPhp();
+  if (await C(n))
+    return;
+  if (n.isFile("/internal/shared/preload/0-sqlite.php"))
+    throw new Error("Error connecting to the SQLite database.");
+  const i = s(
+    e.documentRoot,
+    "wp-content/mu-plugins/sqlite-database-integration"
+  );
+  throw n.isDir(i) ? new Error("Error connecting to the SQLite database.") : new Error("Error connecting to the MySQL database.");
+}
+async function U(e) {
+  const n = e.spawnHandler ?? P;
+  async function t(r, a) {
+    const l = await e.createPhpRuntime(a), o = new R(l);
+    return e.sapiName && o.setSapiName(e.sapiName), r && (o.requestHandler = r), e.phpIniEntries && S(o, e.phpIniEntries), o.defineConstant("WP_SQLITE_AST_DRIVER", !0), a && /**
     * Only the first PHP instance of the first worker created
     * during WordPress boot writes these files – otherwise we'll keep
     * overwriting them with concurrent writers living in other worker
@@ -421,29 +459,29 @@ async function x(e) {
     * mechanism. It works, because secondary workers are only booted
     * once the primary worker has fully booted.
     */
-    !o.isFile("/internal/.boot-files-written") && (await C(o), await f(o, "/", e.createFiles || {}), await D(
+    !o.isFile("/internal/.boot-files-written") && (await A(o), await c(o, "/", e.createFiles || {}), await F(
       o,
       s(new URL(e.siteUrl).pathname, "phpinfo.php")
-    ), await f(o, "/internal", {
+    ), await c(o, "/internal", {
       ".boot-files-written": ""
-    })), t && await o.setSpawnHandler(
-      t(r.processManager)
+    })), n && await o.setSpawnHandler(
+      n(r.processManager)
     ), o.enableRuntimeRotation({
       recreateRuntime: e.createPhpRuntime,
       maxRequests: 400
     }), e.onPHPInstanceCreated && await e.onPHPInstanceCreated(o, { isPrimary: a }), o;
   }
-  const i = new y({
-    phpFactory: async ({ isPrimary: r }) => n(i, r),
+  const i = new E({
+    phpFactory: async ({ isPrimary: r }) => t(i, r),
     documentRoot: e.documentRoot || "/wordpress",
     absoluteUrl: e.siteUrl,
-    rewriteRules: O,
-    getFileNotFoundAction: e.getFileNotFoundAction ?? I,
+    rewriteRules: D,
+    getFileNotFoundAction: e.getFileNotFoundAction ?? W,
     cookieStore: e.cookieStore
   });
   return i;
 }
-async function c(e) {
+async function w(e) {
   return (await e.run({
     code: `<?php
 			ob_start();
@@ -462,8 +500,9 @@ async function c(e) {
     }
   })).text === "1";
 }
-async function L(e) {
-  await k(
+async function h(e) {
+  var i;
+  const n = await T(
     e,
     {
       disable_functions: "fsockopen",
@@ -485,7 +524,15 @@ async function L(e) {
         admin_email: "admin@localhost.com"
       }
     })
-  ), (await e.run({
+  );
+  if (!await w(e))
+    throw new Error(
+      `Failed to install WordPress – installer responded with "${(i = n.text) == null ? void 0 : i.substring(
+        0,
+        100
+      )}"`
+    );
+  (await e.run({
     code: `<?php
 			ob_start();
 			$wp_load = getenv('DOCUMENT_ROOT') . '/wp-load.php';
@@ -505,15 +552,15 @@ async function L(e) {
     env: {
       DOCUMENT_ROOT: e.documentRoot
     }
-  })).text !== "1" && _.warn("Failed to default to pretty permalinks after WP install.");
+  })).text !== "1" && g.warn("Failed to default to pretty permalinks after WP install.");
 }
-function I(e) {
+function W(e) {
   return {
     type: "internal-redirect",
     uri: "/index.php"
   };
 }
-async function U(e) {
+async function C(e) {
   return (await e.run({
     code: `<?php
 			ob_start();
@@ -524,7 +571,7 @@ async function U(e) {
 			}
 			require $wp_load;
 			ob_clean();
-			echo $wpdb->check_connection( false) ? '1' : '0';
+			echo $wpdb->check_connection( false ) ? '1' : '0';
 			ob_end_flush();
 		`,
     env: {
@@ -532,12 +579,12 @@ async function U(e) {
     }
   })).text === "1";
 }
-async function z(e) {
-  const { php: t, reap: n } = await e.processManager.acquirePHPInstance({
+async function V(e) {
+  const { php: n, reap: t } = await e.processManager.acquirePHPInstance({
     considerPrimary: !0
   });
   try {
-    const r = (await t.run({
+    const r = (await n.run({
       code: `<?php
 				require '${e.documentRoot}/wp-includes/version.php';
 				echo $wp_version;
@@ -545,12 +592,12 @@ async function z(e) {
     })).text;
     if (!r)
       throw new Error("Unable to read loaded WordPress version.");
-    return W(r);
+    return O(r);
   } finally {
-    n();
+    t();
   }
 }
-function W(e) {
+function O(e) {
   if (/-(alpha|beta|RC)\d*-\d+$/.test(e))
     return "nightly";
   if (/-(beta|RC)\d*$/.test(e))
@@ -558,13 +605,23 @@ function W(e) {
   const i = e.match(/^(\d+\.\d+)(?:\.\d+)?$/);
   return i !== null ? i[1] : e;
 }
-const O = [
+const D = [
+  /**
+   * Substitutes the multisite WordPress rewrite rule:
+   *
+   * RewriteBase /
+   * RewriteRule ^([_0-9a-zA-Z-]+/)?(wp-(content|admin|includes).*) $2 [L]
+   */
   {
-    match: /^\/(.*?)(\/wp-(content|admin|includes)\/.*)/g,
+    match: new RegExp(
+      /* The .htaccess rule does not have an explicit initial slash,
+      	but it's still implied by `RewriteBase /` */
+      "^(/[_0-9a-zA-Z-]+)?(/wp-(content|admin|includes)/.*)"
+    ),
     replacement: "$2"
   }
 ];
-async function C(e) {
+async function A(e) {
   await e.mkdir("/internal/shared/mu-plugins"), await e.writeFile(
     "/internal/shared/preload/env.php",
     `<?php
@@ -850,13 +907,13 @@ async function C(e) {
 		})();`
   );
 }
-async function D(e, t = "/phpinfo.php") {
+async function F(e, n = "/phpinfo.php") {
   await e.writeFile(
     "/internal/shared/preload/phpinfo.php",
     `<?php
     // Render PHPInfo if the requested page is /phpinfo.php
-    if ( isset($_SERVER['REQUEST_URI']) && ${l(
-      t
+    if ( isset($_SERVER['REQUEST_URI']) && ${u(
+      n
     )} === $_SERVER['REQUEST_URI'] ) {
         phpinfo();
         exit;
@@ -864,27 +921,27 @@ async function D(e, t = "/phpinfo.php") {
     `
   );
 }
-async function A(e, t) {
+async function N(e, n) {
   await e.isDir("/tmp/sqlite-database-integration") && await e.rmdir("/tmp/sqlite-database-integration", {
     recursive: !0
-  }), await e.mkdir("/tmp/sqlite-database-integration"), await p(e, t, "/tmp/sqlite-database-integration");
-  const n = "/internal/shared/sqlite-database-integration", i = `/tmp/sqlite-database-integration/${(await e.listFiles("/tmp/sqlite-database-integration"))[0]}`;
-  await e.mv(i, n), await e.defineConstant("SQLITE_MAIN_FILE", "1");
+  }), await e.mkdir("/tmp/sqlite-database-integration"), await f(e, n, "/tmp/sqlite-database-integration");
+  const t = "/internal/shared/sqlite-database-integration", i = `/tmp/sqlite-database-integration/${(await e.listFiles("/tmp/sqlite-database-integration"))[0]}`;
+  await e.mv(i, t), await e.defineConstant("SQLITE_MAIN_FILE", "1");
   const a = (await e.readFileAsText(
-    s(n, "db.copy")
+    s(t, "db.copy")
   )).replace(
     "'{SQLITE_IMPLEMENTATION_FOLDER_PATH}'",
-    l(n)
+    u(t)
   ).replace(
     "'{SQLITE_PLUGIN}'",
-    l(s(n, "load.php"))
-  ), d = s(await e.documentRoot, "wp-content/db.php"), o = `<?php
+    u(s(t, "load.php"))
+  ), l = s(await e.documentRoot, "wp-content/db.php"), o = `<?php
 	// Do not preload this if WordPress comes with a custom db.php file.
-	if(file_exists(${l(d)})) {
+	if(file_exists(${u(l)})) {
 		return;
 	}
-	?>`, u = "/internal/shared/mu-plugins/sqlite-database-integration.php";
-  await e.writeFile(u, o + a), await e.writeFile(
+	?>`, d = "/internal/shared/mu-plugins/sqlite-database-integration.php";
+  await e.writeFile(d, o + a), await e.writeFile(
     "/internal/shared/preload/0-sqlite.php",
     o + `<?php
 
@@ -936,7 +993,7 @@ class Playground_SQLite_Integration_Loader {
 		$GLOBALS['wpdb']->$name = $value;
 	}
     protected function load_sqlite_integration() {
-        require_once ${l(u)};
+        require_once ${u(d)};
     }
 }
 /**
@@ -973,51 +1030,51 @@ if(!function_exists('mysqli_connect')) {
 		`
   );
 }
-async function q(e, t) {
-  e.mkdir("/tmp/unzipped-wordpress"), await p(e, t, "/tmp/unzipped-wordpress"), e.fileExists("/tmp/unzipped-wordpress/wordpress.zip") && await p(
+async function q(e, n) {
+  e.mkdir("/tmp/unzipped-wordpress"), await f(e, n, "/tmp/unzipped-wordpress"), e.fileExists("/tmp/unzipped-wordpress/wordpress.zip") && await f(
     e,
     "/tmp/unzipped-wordpress/wordpress.zip",
     "/tmp/unzipped-wordpress"
   );
-  let n = e.fileExists("/tmp/unzipped-wordpress/wordpress") ? "/tmp/unzipped-wordpress/wordpress" : e.fileExists("/tmp/unzipped-wordpress/build") ? "/tmp/unzipped-wordpress/build" : "/tmp/unzipped-wordpress";
-  if (!e.fileExists(s(n, "wp-config-sample.php"))) {
-    const r = e.listFiles(n);
+  let t = e.fileExists("/tmp/unzipped-wordpress/wordpress") ? "/tmp/unzipped-wordpress/wordpress" : e.fileExists("/tmp/unzipped-wordpress/build") ? "/tmp/unzipped-wordpress/build" : "/tmp/unzipped-wordpress";
+  if (!e.fileExists(s(t, "wp-config-sample.php"))) {
+    const r = e.listFiles(t);
     if (r.length) {
       const a = r[0];
       e.fileExists(
-        s(n, a, "wp-config-sample.php")
-      ) && (n = s(n, a));
+        s(t, a, "wp-config-sample.php")
+      ) && (t = s(t, a));
     }
   }
-  const i = (r, a, d) => {
-    if (d.isDir(r) && d.isDir(a))
-      for (const o of d.listFiles(r)) {
-        const u = s(r, o), h = s(a, o);
-        i(u, h, d);
+  const i = (r, a, l) => {
+    if (l.isDir(r) && l.isDir(a))
+      for (const o of l.listFiles(r)) {
+        const d = s(r, o), $ = s(a, o);
+        i(d, $, l);
       }
     else {
-      if (d.fileExists(a)) {
+      if (l.fileExists(a)) {
         const o = r.replace(
           /^\/tmp\/unzipped-wordpress\//,
           "/"
         );
-        _.warn(
+        g.warn(
           `Cannot unzip WordPress files at ${a}: ${o} already exists.`
         );
         return;
       }
-      d.mv(r, a);
+      l.mv(r, a);
     }
   };
-  i(n, e.documentRoot, e), e.fileExists(n) && e.rmdir(n, { recursive: !0 }), !e.fileExists(s(e.documentRoot, "wp-config.php")) && e.fileExists(s(e.documentRoot, "wp-config-sample.php")) && e.writeFile(
+  i(t, e.documentRoot, e), e.fileExists(t) && e.rmdir(t, { recursive: !0 }), !e.fileExists(s(e.documentRoot, "wp-config.php")) && e.fileExists(s(e.documentRoot, "wp-config-sample.php")) && e.writeFile(
     s(e.documentRoot, "wp-config.php"),
     e.readFileAsText(
       s(e.documentRoot, "/wp-config-sample.php")
     )
   );
 }
-const F = m(fetch);
-async function Q(e = "latest") {
+const G = k(fetch);
+async function j(e = "latest") {
   if (e.startsWith("https://") || e.startsWith("http://")) {
     const i = await crypto.subtle.digest(
       "SHA-1",
@@ -1034,13 +1091,13 @@ async function Q(e = "latest") {
       version: "nightly-" + (/* @__PURE__ */ new Date()).toISOString().split("T")[0],
       source: "inferred"
     };
-  let n = await (await F(
+  let t = await (await G(
     "https://api.wordpress.org/core/version-check/1.7/?channel=beta"
   )).json();
-  n = n.offers.filter(
+  t = t.offers.filter(
     (i) => i.response === "autoupdate"
   );
-  for (const i of n) {
+  for (const i of t) {
     if (e === "beta" && i.version.includes("beta"))
       return {
         releaseUrl: i.download,
@@ -1067,19 +1124,19 @@ async function Q(e = "latest") {
   };
 }
 export {
-  x as bootRequestHandler,
-  S as bootWordPress,
-  H as bootWordPressAndRequestHandler,
-  R as defineWpConfigConstants,
-  v as ensureWpConfig,
-  I as getFileNotFoundActionForWordPress,
-  z as getLoadedWordPressVersion,
-  D as preloadPhpInfoRoute,
-  A as preloadSqliteIntegration,
-  Q as resolveWordPressRelease,
-  C as setupPlatformLevelMuPlugins,
+  U as bootRequestHandler,
+  I as bootWordPress,
+  Q as bootWordPressAndRequestHandler,
+  x as defineWpConfigConstants,
+  L as ensureWpConfig,
+  W as getFileNotFoundActionForWordPress,
+  V as getLoadedWordPressVersion,
+  F as preloadPhpInfoRoute,
+  N as preloadSqliteIntegration,
+  j as resolveWordPressRelease,
+  A as setupPlatformLevelMuPlugins,
   q as unzipWordPress,
-  W as versionStringToLoadedWordPressVersion,
-  O as wordPressRewriteRules
+  O as versionStringToLoadedWordPressVersion,
+  D as wordPressRewriteRules
 };
 //# sourceMappingURL=index.js.map

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-playground/wordpress",
-  "version": "3.0.19",
+  "version": "3.0.21",
   "description": "WordPress-related plumbing for WordPress Playground",
   "repository": {
     "type": "git",
@@ -35,18 +35,18 @@
     "access": "public",
     "directory": "../../../dist/packages/playground/wordpress"
   },
-  "gitHead": "5d6cbf03fb33b4c58c587c43a4a7793d4b050885",
+  "gitHead": "8d3a2da8f91ca792ba8f6fe7e92fdb658f4075ee",
   "dependencies": {
     "express": "4.21.2",
     "ini": "4.1.2",
     "wasm-feature-detect": "1.8.0",
     "ws": "8.18.3",
     "yargs": "17.7.2",
-    "@php-wasm/universal": "3.0.19",
-    "@php-wasm/util": "3.0.19",
-    "@php-wasm/logger": "3.0.19",
-    "@wp-playground/common": "3.0.19",
-    "@php-wasm/node": "3.0.19"
+    "@php-wasm/universal": "3.0.21",
+    "@php-wasm/util": "3.0.21",
+    "@php-wasm/logger": "3.0.21",
+    "@wp-playground/common": "3.0.21",
+    "@php-wasm/node": "3.0.21"
   },
   "packageManager": "npm@10.9.2",
   "overrides": {

package/rewrite-rules.d.ts

@@ -1,5 +1,141 @@
 import type { RewriteRule } from '@php-wasm/universal';
 /**
- * The default rewrite rules for WordPress.
+ * WordPress rewrite rules adapted for Playground.
+ *
+ * These rules are matched against the requested path without the site path prefix.
+ *
+ * For example:
+ *
+ *     * The site URL is `https://playground.wordpress.net/scope:ambitious-chic-country/`.
+ *     * The site path prefix is `/scope:ambitious-chic-country/`.
+ *     * The requested URL is `https://playground.wordpress.net/scope:ambitious-chic-country/wp-admin/index.php`,
+ *     * The requested path without the site path prefix is `/wp-admin/index.php`.
+ *
+ * And so, the rewrite rules are matched against `/wp-admin/index.php`.
+ * This is similar to setting the `RewriteBase` to `/scope:ambitious-chic-country`.
+ *
+ * ## Rationale
+ *
+ * WordPress does not use a single, static set of rewrite rules. Rather, it generates
+ * its own .htaccess file based on the current configuration using the save_mod_rewrite_rules()
+ * function:
+ *
+ * https://developer.wordpress.org/reference/functions/save_mod_rewrite_rules/
+ *
+ * Here's a few examples of what that .htaccess might look like for different
+ * WordPress configurations:
+ *
+ * ### Vanilla WordPress single-site installation
+ *
+ * ```apache
+ * RewriteBase /
+ * RewriteRule ^index\.php$ - [L]
+ * RewriteCond %{REQUEST_FILENAME} !-f
+ * RewriteCond %{REQUEST_FILENAME} !-d
+ * RewriteRule . /index.php [L]
+ * ```
+ *
+ * ### Single-site installation living at a /subdirectory/
+ *
+ * ```apache
+ * # https://developer.wordpress.org/advanced-administration/server/wordpress-in-directory/:
+ * RewriteCond %{REQUEST_URI} !^/subdirectory/
+ * RewriteCond %{REQUEST_FILENAME} !-f
+ * RewriteCond %{REQUEST_FILENAME} !-d
+ * RewriteRule ^(.*)$ /subdirectory/$1
+ * RewriteRule ^(/)?$ subdirectory/index.php [L]
+ * ```
+ *
+ * Some sources also set the RewriteBase to `/subdirectory/`.
+ *
+ * ### Multisite installation using subfolder network type
+ *
+ * ```apache
+ * # https://wordpress.org/documentation/article/htaccess/#multisite
+ *
+ * RewriteBase /
+ * RewriteRule ^index\.php$ - [L]
+ *
+ * // add a trailing slash to /wp-admin
+ * RewriteRule ^([_0-9a-zA-Z-]+/)?wp-admin$ $1wp-admin/ [R=301,L]
+ *
+ * RewriteCond %{REQUEST_FILENAME} -f [OR]
+ * RewriteCond %{REQUEST_FILENAME} -d
+ * RewriteRule ^ - [L]
+ * RewriteRule ^([_0-9a-zA-Z-]+/)?(wp-(content|admin|includes).*) $2 [L]
+ * RewriteRule ^([_0-9a-zA-Z-]+/)?(.*\.php)$ $2 [L]
+ * RewriteRule . index.php [L]
+ * ```
+ *
+ * # Multisite living at /scope:ambitious-chic-country/
+ *
+ * ```apache
+ * RewriteBase /scope:ambitious-chic-country/
+ * RewriteRule ^index\.php$ - [L]
+ *
+ * // Add a trailing slash to /wp-admin
+ * RewriteRule ^([_0-9a-zA-Z-]+/)?wp-admin$ $1wp-admin/ [R=301,L]
+ *
+ * RewriteCond %{REQUEST_FILENAME} -f [OR]
+ * RewriteCond %{REQUEST_FILENAME} -d
+ * RewriteRule ^ - [L]
+ *
+ * // The `wordpress/` prefix matches the document root, but seeing
+ * // it here is unexpected. @TODO: Why is it being added by WordPress?
+ * RewriteRule ^([_0-9a-zA-Z-]+/)?(wp-(content|admin|includes).*) wordpress/$2 [L]
+ * RewriteRule ^([_0-9a-zA-Z-]+/)?(.*\.php)$ wordpress/$2 [L]
+ * RewriteRule . index.php [L]
+ * ```
+ *
+ * ## .htaccess syntax
+ *
+ * Here's an excerpt/summary from the .htaccess documentation [^1][^2] for
+ * convenience:
+ *
+ *     The mod_rewrite module uses a rule-based rewriting engine, based
+ *     on a PCRE regular-expression parser, to rewrite requested URLs on
+ *     the fly. By default, mod_rewrite maps a URL to a filesystem path.
+ *     However, it can also be used to redirect one URL to another URL,
+ *     or to invoke an internal proxy fetch.
+ *
+ *     ## RewriteBase Directive
+ *
+ *     The RewriteBase directive specifies the URL prefix to be used for
+ *     per-directory (htaccess) RewriteRule directives that substitute a
+ *     relative path.
+ *
+ *     Syntax:
+ *          RewriteBase URL-path
+ *
+ *     (Setting RewriteBase to "/" makes it possible to use RewriteRule
+ *      patterns that **do not** start with a slash.)
+ *
+ *     ## RewriteRule Directive
+ *
+ *     Defines rules for the rewriting engine.
+ *
+ *     Syntax:
+ *          RewriteRule Pattern Substitution [flags]
+ *
+ *     ## Flags
+ *
+ *        - L|Last
+ *            Stop processing the rule set. In most contexts, this means
+ *            that if the rule matches, no further rules will be processed
+ *
+ *        - NC|No Case
+ *            Ignore case when matching.
+ *
+ *        - R|Redirect
+ *            Causes a HTTP redirect to be issued to the browser.
+ *
+ *        (Note that Playground does not implement analogs of these flags as
+ *         there was no need for them yet. They're only described here for
+ *         convenience to help you read the original .htaccess rules.)
+ *
+ * ## Differences with .htaccess
+ *
+ * [1] https://httpd.apache.org/docs/current/rewrite/intro.html
+ * [2] https://httpd.apache.org/docs/current/rewrite/flags.html
  */
 export declare const wordPressRewriteRules: RewriteRule[];