wp-now: Add executeWPCli() function to download and execute WP-CLI

README.md

@@ -1,4 +1,4 @@
-# WordPress Playground and  PHP WASM (WebAssembly)
+# WordPress Playground and PHP WASM (WebAssembly)
 
 [Project Page](https://developer.wordpress.org/playground/) | [Live demo](https://playground.wordpress.net/) | [Documentation and API Reference](https://wordpress.github.io/wordpress-playground/)
 

packages/wp-now/src/constants.ts

@@ -31,3 +31,9 @@ export const DEFAULT_PHP_VERSION = '8.0';
  * The default WordPress version to use when running the WP Now server.
  */
 export const DEFAULT_WORDPRESS_VERSION = 'latest';
+
+/**
+ * The URL for downloading the "wp-cli" WordPress cli.
+ */
+export const WP_CLI_URL =
+	'https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar';

packages/wp-now/src/download.ts

@@ -4,12 +4,13 @@ import followRedirects from 'follow-redirects';
 import unzipper from 'unzipper';
 import os from 'os';
 import { IncomingMessage } from 'http';
-import { DEFAULT_WORDPRESS_VERSION, SQLITE_URL } from './constants';
+import { DEFAULT_WORDPRESS_VERSION, SQLITE_URL, WP_CLI_URL } from './constants';
 import { isValidWordPressVersion } from './wp-playground-wordpress';
 import { output } from './output';
 import getWpNowPath from './get-wp-now-path';
 import getWordpressVersionsPath from './get-wordpress-versions-path';
 import getSqlitePath from './get-sqlite-path';
+import getWpCliPath from './get-wp-cli-path';
 
 function getWordPressVersionUrl(version = DEFAULT_WORDPRESS_VERSION) {
 	if (!isValidWordPressVersion(version)) {
@@ -28,6 +29,55 @@ interface DownloadFileAndUnzipResult {
 followRedirects.maxRedirects = 5;
 const { https } = followRedirects;
 
+async function downloadFile({
+	url,
+	destinationFilePath,
+	itemName,
+}): Promise<DownloadFileAndUnzipResult> {
+	let statusCode = 0;
+	try {
+		if (fs.existsSync(destinationFilePath)) {
+			return { downloaded: false, statusCode: 0 };
+		}
+		fs.ensureDirSync(path.dirname(destinationFilePath));
+		const response = await new Promise<IncomingMessage>((resolve) =>
+			https.get(url, (response) => resolve(response))
+		);
+		statusCode = response.statusCode;
+		if (response.statusCode !== 200) {
+			throw new Error(
+				`Failed to download file (Status code ${response.statusCode}).`
+			);
+		}
+		await new Promise<void>((resolve, reject) => {
+			fs.ensureFileSync(destinationFilePath);
+			const file = fs.createWriteStream(destinationFilePath);
+			response.pipe(file);
+			file.on('finish', () => {
+				file.close();
+				resolve();
+			});
+			file.on('error', (error) => {
+				file.close();
+				reject(error);
+			});
+		});
+		output?.log(`Downloaded ${itemName} to ${destinationFilePath}`);
+		return { downloaded: true, statusCode };
+	} catch (error) {
+		output?.error(`Error downloading file ${itemName}`, error);
+		return { downloaded: false, statusCode };
+	}
+}
+
+export async function downloadWPCLI() {
+	return downloadFile({
+		url: WP_CLI_URL,
+		destinationFilePath: getWpCliPath(),
+		itemName: 'wp-cli',
+	});
+}
+
 async function downloadFileAndUnzip({
 	url,
 	destinationFolder,

packages/wp-now/src/execute-wp-cli.ts

@@ -0,0 +1,40 @@
+import startWPNow from './wp-now';
+import { downloadWPCLI } from './download';
+import { disableOutput } from './output';
+import getWpCliPath from './get-wp-cli-path';
+import getWpNowConfig from './config';
+import { DEFAULT_PHP_VERSION, DEFAULT_WORDPRESS_VERSION } from './constants';
+
+export async function executeWPCli(args: string[], emscriptenOptions = {}) {
+	await downloadWPCLI();
+	disableOutput();
+	const options = await getWpNowConfig({
+		php: DEFAULT_PHP_VERSION,
+		wp: DEFAULT_WORDPRESS_VERSION,
+		path: process.env.WP_NOW_PROJECT_PATH || process.cwd(),
+	});
+	const { phpInstances, options: wpNowOptions } = await startWPNow(
+		{
+			...options,
+			numberOfPhpInstances: 2,
+		},
+		emscriptenOptions
+	);
+	const [, php] = phpInstances;
+
+	try {
+		php.useHostFilesystem();
+		await php.cli([
+			'php',
+			getWpCliPath(),
+			`--path=${wpNowOptions.documentRoot}`,
+			...args,
+		]);
+	} catch (resultOrError) {
+		const success =
+			resultOrError.name === 'ExitStatus' && resultOrError.status === 0;
+		if (!success) {
+			throw resultOrError;
+		}
+	}
+}

packages/wp-now/src/get-wp-cli-path.ts

@@ -0,0 +1,12 @@
+import path from 'path';
+import getWpNowPath from './get-wp-now-path';
+
+/**
+ * The path for wp-cli phar file within the WP Now folder.
+ */
+export default function getWpCliPath() {
+	if (process.env.NODE_ENV !== 'test') {
+		return path.join(getWpNowPath(), 'wp-cli.phar');
+	}
+	return path.resolve('./wp-cli.phar');
+}

packages/wp-now/src/run-cli.ts

@@ -7,6 +7,7 @@ import getWpNowConfig from './config';
 import { spawn, SpawnOptionsWithoutStdio } from 'child_process';
 import { executePHPFile } from './execute-php-file';
 import { output } from './output';
+import { executeWPCli } from './execute-wp-cli';
 
 function startSpinner(message: string) {
 	process.stdout.write(`${message}...\n`);

packages/wp-now/src/tests/wp-now.spec.ts

@@ -1,5 +1,5 @@
 import startWPNow, { inferMode } from '../wp-now';
-import getWpNowConfig, { CliOptions, WPNowMode, WPNowOptions } from '../config';
+import getWpNowConfig, { CliOptions, WPNowMode } from '../config';
 import fs from 'fs-extra';
 import path from 'path';
 import {
@@ -11,11 +11,14 @@ import {
 } from '../wp-playground-wordpress';
 import {
 	downloadSqliteIntegrationPlugin,
+	downloadWPCLI,
 	downloadWordPress,
 } from '../download';
 import os from 'os';
 import crypto from 'crypto';
 import getWpNowTmpPath from '../get-wp-now-tmp-path';
+import { executeWPCli } from '../execute-wp-cli';
+import getWpCliPath from '../get-wp-cli-path';
 
 const exampleDir = __dirname + '/mode-examples';
 
@@ -506,3 +509,34 @@ describe('Test starting different modes', () => {
 		expect(themeName.text).toContain('Twenty Twenty-Three');
 	});
 });
+
+/**
+ * Test wp-cli command.
+ */
+describe('wp-cli command', () => {
+	beforeAll(async () => {
+		fs.rmSync(getWpNowTmpPath(), { recursive: true, force: true });
+		console.time('wp-cli');
+		await downloadWPCLI();
+		console.log('wp-cli downloaded.');
+		console.timeEnd('wp-cli');
+	});
+
+	afterAll(() => {
+		fs.removeSync(getWpCliPath());
+	});
+	/**
+	 * Test wp-cli displays the version.
+	 * We don't need the WordPress context for this test.
+	 */
+	test('wp-cli displays the version', async () => {
+		let output = '';
+		function collectOutput(outputLine: string) {
+			output += outputLine;
+		}
+		await executeWPCli(['--version'], {
+			print: collectOutput,
+		});
+		expect(output).toMatch('WP-CLI ');
+	});
+});

packages/wp-now/src/wp-now.ts

@@ -38,7 +38,8 @@ async function applyToInstances(phpInstances: NodePHP[], callback: Function) {
 }
 
 export default async function startWPNow(
-	options: Partial<WPNowOptions> = {}
+	options: Partial<WPNowOptions> = {},
+	emscriptenOptions = {}
 ): Promise<{ php: NodePHP; phpInstances: NodePHP[]; options: WPNowOptions }> {
 	const { documentRoot } = options;
 	const nodePHPOptions = {
@@ -59,6 +60,7 @@ export default async function startWPNow(
 				}
 			},
 		},
+		emscriptenOptions,
 	};
 
 	const phpInstances = [];