feat: add MySQL service to CI and support JTEST_DB env vars

CI now runs a MySQL 8.4 service container and imports the Proclaim
schema, enabling integration tests to run in CI alongside unit tests.
Bootstrap checks JTEST_DB_* env vars (CI) first, then falls back to
build.properties → Joomla configuration.php (local dev).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: bcordis

.github/workflows/ci.yml

@@ -21,6 +21,22 @@ jobs:
     name: PHP Lint & Tests
     runs-on: ubuntu-latest
 
+    services:
+      mysql:
+        image: mysql:8.4
+        env:
+          MYSQL_USER: proclaim_test
+          MYSQL_PASSWORD: proclaim_test
+          MYSQL_ROOT_PASSWORD: proclaim_test
+          MYSQL_DATABASE: proclaim_test
+        ports:
+          - 3306:3306
+        options: >-
+          --health-cmd "mysqladmin ping -h 127.0.0.1"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
@@ -29,7 +45,7 @@ jobs:
         uses: shivammathur/setup-php@v2
         with:
           php-version: '8.3'
-          extensions: mbstring, json, xml
+          extensions: mbstring, json, xml, mysqli
           coverage: none
 
       - name: Get Composer cache directory
@@ -49,13 +65,21 @@ jobs:
       - name: Install Composer dependencies
         run: composer install --dev --no-interaction --prefer-dist
 
+      - name: Import database schema
+        run: mysql -h 127.0.0.1 -u proclaim_test -pproclaim_test proclaim_test < admin/sql/install.mysql.utf8.sql
+
       - name: Check PHP syntax
         run: composer lint:syntax
 
-      - name: Run PHPUnit unit tests
-        run: composer test:unit
+      - name: Run PHPUnit tests
+        run: composer test
         env:
           JOOMLA_CMS_PATH: /home/runner/work/Proclaim/joomla-cms
+          JTEST_DB_HOST: 127.0.0.1
+          JTEST_DB_NAME: proclaim_test
+          JTEST_DB_USER: proclaim_test
+          JTEST_DB_PASSWORD: proclaim_test
+          JTEST_DB_PREFIX: ''
 
   js-checks:
     name: JS Lint & Tests

tests/unit/bootstrap.php

@@ -259,72 +259,76 @@
 require_once __DIR__ . '/ProclaimTestCase.php';
 
 // ---------------------------------------------------------------------------
-// Optional: Bootstrap a real database connection from build.properties
+// Optional: Bootstrap a real database connection
+// Sources: 1) JTEST_DB_* env vars (CI), 2) build.properties → Joomla config
 // ---------------------------------------------------------------------------
 
 (function () use ($componentRoot) {
-    $propsFile = $componentRoot . '/build.properties';
-
-    if (!file_exists($propsFile)) {
-        return;
+    $host   = '';
+    $dbName = '';
+    $user   = '';
+    $pass   = '';
+    $prefix = '';
+
+    // Source 1: JTEST_DB_* environment variables (CI)
+    if (getenv('JTEST_DB_HOST') && getenv('JTEST_DB_NAME')) {
+        $host   = getenv('JTEST_DB_HOST');
+        $dbName = getenv('JTEST_DB_NAME');
+        $user   = getenv('JTEST_DB_USER') ?: '';
+        $pass   = getenv('JTEST_DB_PASSWORD') ?: '';
+        $prefix = getenv('JTEST_DB_PREFIX') ?: '';
     }
 
-    // Parse build.properties
-    $props = [];
-    $lines = file($propsFile, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
-
-    foreach ($lines as $line) {
-        $trimmed = trim($line);
-
-        if ($trimmed === '' || str_starts_with($trimmed, '#')) {
-            continue;
-        }
+    // Source 2: build.properties → Joomla configuration.php
+    if ($dbName === '') {
+        $propsFile = $componentRoot . '/build.properties';
 
-        $eq = strpos($trimmed, '=');
+        if (file_exists($propsFile)) {
+            $props = [];
+            $lines = file($propsFile, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
 
-        if ($eq === false) {
-            continue;
-        }
+            foreach ($lines as $line) {
+                $trimmed = trim($line);
 
-        $props[trim(substr($trimmed, 0, $eq))] = trim(substr($trimmed, $eq + 1));
-    }
+                if ($trimmed === '' || str_starts_with($trimmed, '#')) {
+                    continue;
+                }
 
-    // Find the first Joomla installation path (for database config)
-    $joomlaPath = '';
+                $eq = strpos($trimmed, '=');
 
-    if (!empty($props['builder.joomla_paths'])) {
-        $paths      = array_map('trim', explode(',', $props['builder.joomla_paths']));
-        $joomlaPath = $paths[0] ?? '';
-    } elseif (!empty($props['builder.joomla_path'])) {
-        $joomlaPath = $props['builder.joomla_path'];
-    }
+                if ($eq !== false) {
+                    $props[trim(substr($trimmed, 0, $eq))] = trim(substr($trimmed, $eq + 1));
+                }
+            }
 
-    if ($joomlaPath === '' || !is_dir($joomlaPath)) {
-        return;
-    }
+            $joomlaPath = '';
 
-    $configFile = rtrim($joomlaPath, '/') . '/configuration.php';
+            if (!empty($props['builder.joomla_paths'])) {
+                $paths      = array_map('trim', explode(',', $props['builder.joomla_paths']));
+                $joomlaPath = $paths[0] ?? '';
+            } elseif (!empty($props['builder.joomla_path'])) {
+                $joomlaPath = $props['builder.joomla_path'];
+            }
 
-    if (!file_exists($configFile)) {
-        return;
-    }
+            $configFile = $joomlaPath !== '' && is_dir($joomlaPath)
+                ? rtrim($joomlaPath, '/') . '/configuration.php'
+                : '';
 
-    // Load Joomla's configuration
-    require_once $configFile;
+            if ($configFile !== '' && file_exists($configFile)) {
+                require_once $configFile;
 
-    if (!class_exists('JConfig', false)) {
-        return;
+                if (class_exists('JConfig', false)) {
+                    $config = new \JConfig();
+                    $host   = $config->host ?? 'localhost';
+                    $dbName = $config->db ?? '';
+                    $user   = $config->user ?? '';
+                    $pass   = $config->password ?? '';
+                    $prefix = $config->dbprefix ?? '';
+                }
+            }
+        }
     }
 
-    $config = new \JConfig();
-
-    // Create a real database connection
-    $host   = $config->host ?? 'localhost';
-    $dbName = $config->db ?? '';
-    $user   = $config->user ?? '';
-    $pass   = $config->password ?? '';
-    $prefix = $config->dbprefix ?? '';
-
     if ($dbName === '' || $user === '') {
         return;
     }
@@ -338,36 +342,21 @@
     }
 
     try {
-        $options = [
+        $db = \Joomla\Database\DatabaseDriver::getInstance([
             'driver'   => 'mysqli',
             'host'     => $host,
             'port'     => $port,
             'user'     => $user,
             'password' => $pass,
             'database' => $dbName,
             'prefix'   => $prefix,
-        ];
-
-        $db = \Joomla\Database\DatabaseDriver::getInstance($options);
+        ]);
         $db->connect();
 
-        // Register in DI container for Factory::getContainer()->get(DatabaseInterface::class)
-        try {
-            $container = \Joomla\CMS\Factory::getContainer();
-
-            if ($container instanceof \Joomla\DI\Container) {
-                $container->set(\Joomla\Database\DatabaseInterface::class, $db);
-            }
-        } catch (\Throwable) {
-            // Container not available or key protected — tests use direct DB access
-        }
-
-        // Store reference for tests that need direct access
         \define('PROCLAIM_TEST_DB_AVAILABLE', true);
 
         fwrite(STDERR, "Database connected: $dbName@$host:$port" . PHP_EOL);
     } catch (\Throwable $e) {
-        // Database not available — integration tests will skip gracefully
         \define('PROCLAIM_TEST_DB_AVAILABLE', false);
         fwrite(STDERR, "Database not available: " . $e->getMessage() . PHP_EOL);
     }