MySQL Proxy for SQLite

[JanJakes]

Implements a basic MySQL proxy that bridges the MySQL wire protocol to the SQLite driver, based on adamziel/mysql-sqlite-network-proxy#1.

This enables the usage of phpMyAdmin, Adminer, and other tools on top of SQLite.

The PR includes tests for PDO and mysqli connections and query commands.

See also the MySQL proxy package README.

CLI 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. Default: :memory:
  -p, --port=<port>     The port to listen on. Default: 3306

PHP usage:

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();

[akirk]

This is great! Just a little note, there is a typo in the directory packages/mysq-server-php

[JanJakes]

This is great! Just a little note, there is a typo in the directory packages/mysq-server-php

@akirk Ah, thanks for catching that!

I'm also thinking about whether to keep the -php suffix or drop it, as it's likely that all/most packages in the repo will be PHP anyway, and it doesn't make much sense to include that suffix everywhere. Or maybe it's more like a "proxy", I don't know. When we make the driver API PDO-like, this package will be a bit like "MySQL server on PDO client".

I guess in this repo, the naming will be generally hard 🙂

[JanJakes]

@adamziel I think this is ready for an initial review. The code needs more polishing, and we'll need some more functionality (prepared statements for mysqli, setting username and password, etc.), but I guess it's in a usable initial state.

[adamziel]

Warning: socket_bind(): Unable to bind address [48]: Address already in use in /Users/cloudnik/www/Automattic/core/plugins/sqlite-database-integration/packages/wp-mysql-proxy/src/class-mysql-proxy.php on line 22
MySQL PHP Proxy listening on port 3306...

Let's exit(1) on any and all errors

[adamziel]

Not a blocker for this PR, but something about the CLI client derails it:

> mysql -h 127.0.0.1 -P 3307                                                                                                                                                                                            ERROR 2027 (HY000): Malformed packet

If I send a password, it's fine:

> mysql -h 127.0.0.1 -P 3307 -p -u root                                                                                                                                                                             (base)
Enter password:
Welcome to the MySQL monitor.  Commands end with ; or \g.

[adamziel]

Hey, look at me using MySQL 🔥

> mysql -h 127.0.0.1 -P 3307 -p -u root                                                                                                                                                                             (base)
Enter password:
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 945
Server version: 5.7.30-php-mysql-server MySQL Community Server - GPL

Copyright (c) 2000, 2025, Oracle and/or its affiliates.

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql> create table books (id int auto_increment primary key, title varchar(255));
Query OK, 0 rows affected (0,00 sec)

mysql> insert into books (title) values ('How to train your dragon');
Query OK, 1 row affected (0,01 sec)

mysql> select * from books;
+----+--------------------------+
| id | title                    |
+----+--------------------------+
|  1 | How to train your dragon |
+----+--------------------------+
1 row in set (0,00 sec)