Performance tweaks

Author: abnegate

.dockerignore

@@ -2,7 +2,6 @@
 .gitignore
 .idea
 vendor
-composer.lock
 *.md
 .dockerignore
 Dockerfile

.gitignore

@@ -1,6 +1,7 @@
 /vendor/
 /composer.lock
 /.phpunit.cache
+/.phpunit.result.cache
 /.php-cs-fixer.cache
 /phpstan.neon
 /.idea/

Dockerfile

@@ -6,6 +6,7 @@ RUN apk add --no-cache \
     make \
     linux-headers \
     libstdc++ \
+    brotli-dev \
     libzip-dev \
     openssl-dev
 
@@ -14,17 +15,23 @@ RUN docker-php-ext-install \
     sockets \
     zip
 
-RUN pecl install swoole-6.0.1 && \
+RUN pecl channel-update pecl.php.net && \
+    pecl install swoole-6.0.1 && \
     docker-php-ext-enable swoole
 
-RUN pecl install redis && \
+RUN pecl channel-update pecl.php.net && \
+    pecl install redis && \
     docker-php-ext-enable redis
 
 WORKDIR /app
 
 COPY composer.json composer.lock ./
 COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
-RUN composer install --no-dev --optimize-autoloader
+RUN composer install --no-dev --optimize-autoloader \
+    --ignore-platform-req=ext-mongodb \
+    --ignore-platform-req=ext-memcached \
+    --ignore-platform-req=ext-opentelemetry \
+    --ignore-platform-req=ext-protobuf
 
 COPY . .
 

PERFORMANCE.md

@@ -147,6 +147,12 @@ ab -n 100000 -c 1000 http://localhost:8080/
 # wrk
 wrk -t12 -c1000 -d30s http://localhost:8080/
 
+# wrk script (env configurable)
+benchmarks/wrk.sh
+
+# wrk2 script (env configurable)
+benchmarks/wrk2.sh
+
 # Custom benchmark
 php benchmarks/http.php
 ```

README.md

@@ -48,17 +48,23 @@ The protocol-proxy uses the **Adapter Pattern** - similar to [utopia-php/databas
 <?php
 require 'vendor/autoload.php';
 
-use Utopia\Proxy\Adapter\HTTP;
+use Utopia\Platform\Action;
+use Utopia\Proxy\Adapter\HTTP\Swoole as HTTPAdapter;
+use Utopia\Proxy\Server\HTTP\Swoole as HTTPServer;
+use Utopia\Proxy\Service\HTTP as HTTPService;
 
-$adapter = new HTTP($cache, $dbPool);
+$adapter = new HTTPAdapter();
+$service = $adapter->getService() ?? new HTTPService();
 
 // Required: Provide backend resolution logic
-$adapter->hook('resolve', function (string $hostname) {
-    // Your resolution logic here (database, K8s, config, etc.)
-    return $backend->getEndpoint($hostname);
-});
+$service->addAction('resolve', (new class extends Action {})
+    ->callback(function (string $hostname) use ($backend): string {
+        return $backend->getEndpoint($hostname);
+    }));
 
-$server = new HttpServer(
+$adapter->setService($service);
+
+$server = new HTTPServer(
     host: '0.0.0.0',
     port: 80,
     workers: swoole_cpu_num() * 2,
@@ -74,9 +80,9 @@ $server->start();
 <?php
 require 'vendor/autoload.php';
 
-use Utopia\Proxy\Tcp\TcpServer;
+use Utopia\Proxy\Server\TCP\Swoole as TCPServer;
 
-$server = new TcpServer(
+$server = new TCPServer(
     host: '0.0.0.0',
     ports: [5432, 3306], // PostgreSQL, MySQL
     workers: swoole_cpu_num() * 2
@@ -91,9 +97,9 @@ $server->start();
 <?php
 require 'vendor/autoload.php';
 
-use Utopia\Proxy\Smtp\SmtpServer;
+use Utopia\Proxy\Server\SMTP\Swoole as SMTPServer;
 
-$server = new SmtpServer(
+$server = new SMTPServer(
     host: '0.0.0.0',
     port: 25,
     workers: swoole_cpu_num() * 2
@@ -120,7 +126,7 @@ $config = [
     // Routing cache
     'cache_ttl' => 1, // 1 second
 
-    // Database connection (for cache and resolution hooks)
+    // Database connection (for cache and resolution actions)
     'db_host' => 'localhost',
     'db_port' => 3306,
     'db_user' => 'appwrite',
@@ -133,6 +139,24 @@ $config = [
 ];
 ```
 
+## ✅ Testing
+
+```bash
+composer test
+```
+
+Integration tests (Docker Compose):
+
+```bash
+composer test:integration
+```
+
+Coverage (requires Xdebug or PCOV):
+
+```bash
+vendor/bin/phpunit --coverage-text
+```
+
 ## 🎨 Architecture
 
 The protocol-proxy follows the **Adapter Pattern** used throughout utopia-php libraries (Database, Messaging, Storage), providing a clean and extensible architecture for protocol-specific implementations.

benchmarks/README.md

@@ -0,0 +1,100 @@
+# Benchmarks
+
+This folder contains high-load benchmark helpers for HTTP and TCP proxies.
+
+## Quick start (HTTP)
+
+Run the PHP benchmark:
+```bash
+php benchmarks/http.php
+```
+
+Run wrk:
+```bash
+benchmarks/wrk.sh
+```
+
+Run wrk2 (fixed rate):
+```bash
+benchmarks/wrk2.sh
+```
+
+## Quick start (TCP)
+
+Run the TCP benchmark:
+```bash
+php benchmarks/tcp.php
+```
+
+## Presets (HTTP)
+
+Max throughput, burst:
+```bash
+WRK_THREADS=16 WRK_CONNECTIONS=5000 WRK_DURATION=30s WRK_URL=http://127.0.0.1:8080/ benchmarks/wrk.sh
+```
+
+Fixed rate (wrk2):
+```bash
+WRK2_THREADS=16 WRK2_CONNECTIONS=5000 WRK2_DURATION=30s WRK2_RATE=200000 WRK2_URL=http://127.0.0.1:8080/ benchmarks/wrk2.sh
+```
+
+PHP benchmark, moderate:
+```bash
+BENCH_CONCURRENCY=500 BENCH_REQUESTS=50000 php benchmarks/http.php
+```
+
+## Presets (TCP)
+
+Connection rate only:
+```bash
+BENCH_PROTOCOL=mysql BENCH_PORT=15433 BENCH_PAYLOAD_BYTES=0 BENCH_CONCURRENCY=500 BENCH_CONNECTIONS=50000 php benchmarks/tcp.php
+```
+
+Throughput heavy (payload enabled):
+```bash
+BENCH_PROTOCOL=mysql BENCH_PORT=15433 BENCH_PAYLOAD_BYTES=65536 BENCH_TARGET_BYTES=17179869184 BENCH_CONCURRENCY=2000 php benchmarks/tcp.php
+```
+
+## Environment variables
+
+HTTP PHP benchmark (`benchmarks/http.php`):
+- `BENCH_HOST` (default `localhost`)
+- `BENCH_PORT` (default `8080`)
+- `BENCH_CONCURRENCY` (default `max(2000, cpu*500)`)
+- `BENCH_REQUESTS` (default `max(1000000, concurrency*500)`)
+- `BENCH_TIMEOUT` (default `10`)
+- `BENCH_KEEP_ALIVE` (default `true`)
+- `BENCH_SAMPLE_TARGET` (default `200000`)
+- `BENCH_SAMPLE_EVERY` (optional override)
+
+TCP PHP benchmark (`benchmarks/tcp.php`):
+- `BENCH_HOST` (default `localhost`)
+- `BENCH_PORT` (default `5432`)
+- `BENCH_PROTOCOL` (`postgres` or `mysql`, default based on port)
+- `BENCH_CONCURRENCY` (default `max(2000, cpu*500)`)
+- `BENCH_CONNECTIONS` (default derived from payload/target)
+- `BENCH_PAYLOAD_BYTES` (default `65536`)
+- `BENCH_TARGET_BYTES` (default `8GB`)
+- `BENCH_TIMEOUT` (default `10`)
+- `BENCH_SAMPLE_TARGET` (default `200000`)
+- `BENCH_SAMPLE_EVERY` (optional override)
+
+wrk (`benchmarks/wrk.sh`):
+- `WRK_THREADS` (default `cpu`)
+- `WRK_CONNECTIONS` (default `1000`)
+- `WRK_DURATION` (default `30s`)
+- `WRK_URL` (default `http://127.0.0.1:8080/`)
+- `WRK_EXTRA` (extra flags)
+
+wrk2 (`benchmarks/wrk2.sh`):
+- `WRK2_THREADS` (default `cpu`)
+- `WRK2_CONNECTIONS` (default `1000`)
+- `WRK2_DURATION` (default `30s`)
+- `WRK2_RATE` (default `50000`)
+- `WRK2_URL` (default `http://127.0.0.1:8080/`)
+- `WRK2_EXTRA` (extra flags)
+
+## Notes
+
+- For realistic max numbers, run on a tuned Linux host (see `PERFORMANCE.md`).
+- Running in Docker on macOS will be bottlenecked by the VM and host networking.