Add a CLI command to run the MySQL proxy

Author: JanJakes

packages/wp-mysql-proxy/README.md

@@ -0,0 +1,37 @@
+# WP MySQL Proxy
+A MySQL proxy that bridges the MySQL wire protocol to a PDO-like interface.
+
+This is a zero-dependency, pure PHP implementation of a MySQL proxy that acts as
+a MySQL server, accepts MySQL-native commands, and executes them using a configurable
+PDO-like driver. This allows MySQL-compatible clients to connect and run queries
+against alternative database backends over the MySQL wire protocol.
+
+Combined with the **WP SQLite Driver**, this allows MySQL-based projects to run
+on SQLite.
+
+## Usage
+
+### CLI:
+
+```bash
+$ php mysql-proxy.php [--database <path/to/db.sqlite>] [--port <port>]
+
+Options:
+  -h, --help            Show this help message and exit.
+  -d, --database=<path> The path to the SQLite database file. Default: :memory:
+  -p, --port=<port>     The port to listen on. Default: 3306
+```
+
+### PHP:
+```php
+use WP_MySQL_Proxy\MySQL_Proxy;
+use WP_MySQL_Proxy\Adapter\SQLite_Adapter;
+
+require_once __DIR__ . '/vendor/autoload.php';
+
+$proxy = new MySQL_Proxy(
+	new SQLite_Adapter( $db_path ),
+	array( 'port' => $port )
+);
+$proxy->start();
+```

packages/wp-mysql-proxy/bin/mysql-proxy.php renamed to packages/wp-mysql-proxy/bin/wp-mysql-proxy.php

@@ -5,8 +5,6 @@
 
 require_once __DIR__ . '/../vendor/autoload.php';
 
-
-
 define( 'WP_SQLITE_AST_DRIVER', true );
 
 // Process CLI arguments:
@@ -15,29 +13,28 @@
 $opts      = getopt( $shortopts, $longopts );
 
 $help = <<<USAGE
-Usage: php mysql-proxy.php --database <path/to/db.sqlite> [--port <port>]
+Usage: php mysql-proxy.php [--database <path/to/db.sqlite>] [--port <port>]
 
 Options:
   -h, --help            Show this help message and exit.
-  -d, --database=<path> The path to the SQLite database file.
-  -p, --port=<port>     The port to listen on.
+  -d, --database=<path> The path to the SQLite database file. Default: :memory:
+  -p, --port=<port>     The port to listen on. Default: 3306
 
 USAGE;
 
+// Help.
 if ( isset( $opts['h'] ) || isset( $opts['help'] ) ) {
 	fwrite( STDERR, $help );
 	exit( 0 );
 }
 
-$db_path = $opts['d'] ?? $opts['database'] ?? null;
-if ( null === $db_path || '' === $db_path ) {
-	fwrite( STDERR, "Error: --database <path/to/db.sqlite> is required. Use --help for usage.\n" );
-	exit( 1 );
-}
+// Database path.
+$db_path = $opts['d'] ?? $opts['database'] ?? ':memory:';
 
+// Port.
 $port = (int) ( $opts['p'] ?? $opts['port'] ?? 3306 );
 if ( $port < 1 || $port > 65535 ) {
-	fwrite( STDERR, "Error: --port must be an integer between 1 and 65535.\n" );
+	fwrite( STDERR, "Error: --port must be an integer between 1 and 65535. Use --help for more information.\n" );
 	exit( 1 );
 }
 

packages/wp-mysql-proxy/composer.json

@@ -1,6 +1,9 @@
 {
     "name": "wordpress/wp-mysql-proxy",
     "type": "library",
+	"bin": [
+		"bin/wp-mysql-proxy.php"
+	],
 	"scripts": {
 		"test": "phpunit"
 	},