feat: add PHPUnit testing infrastructure and initial unit tests

Author: mariuz

.github/workflows/phpunit.yml

@@ -0,0 +1,26 @@
+name: PHPUnit Tests
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Setup PHP
+      uses: shivammathur/setup-php@v2
+      with:
+        php-version: '8.3'
+        extensions: pdo_firebird, dom, xml, mbstring
+        coverage: none
+
+    - name: Install dependencies
+      run: composer install --prefer-dist --no-progress
+
+    - name: Run tests
+      run: vendor/bin/phpunit

.gitignore

@@ -13,3 +13,7 @@
 # Node dependencies
 
 node_modules/
+
+# PHP dependencies
+vendor/
+composer.lock

README.md

@@ -70,6 +70,18 @@ While there is no exhaustive manual, users familiar with Firebird will find the
 * **Ubuntu Guide:** [How to install Firebird on Ubuntu](https://help.ubuntu.com/community/Firebird3.0)
 * **Firebird Official Docs:** [Firebird Documentation](https://www.firebirdsql.org/en/documentation/)
 
+## 🧪 Testing
+
+### Unit Tests (PHPUnit)
+The project uses PHPUnit for unit testing core functions.
+1. Install dependencies: `composer install`
+2. Run tests: `./vendor/bin/phpunit`
+
+### End-to-End Tests (Playwright)
+The project uses Playwright for E2E testing.
+1. Install dependencies: `npm install`
+2. Run tests: `npx playwright test`
+
 ---
 
 ## 📄 ChangeLog

composer.json

@@ -0,0 +1,16 @@
+{
+    "name": "mariuz/firebirdwebadmin",
+    "description": "FirebirdWebAdmin is a web frontend for the Firebird database server",
+    "type": "project",
+    "license": "GPL-2.0",
+    "require-dev": {
+        "phpunit/phpunit": "^10.5"
+    },
+    "autoload": {
+        "files": [
+            "inc/configuration.inc.php",
+            "inc/functions.inc.php",
+            "inc/firebird.inc.php"
+        ]
+    }
+}

inc/configuration.inc.php

@@ -163,7 +163,7 @@
                                         // are not deleted when isql is finished
 
 
-if ('' != SESSION_NAME) {
+if ('' != SESSION_NAME && PHP_SAPI !== 'cli') {
     session_name(SESSION_NAME);
 }
 

phpunit.xml

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.5/phpunit.xsd"
+         bootstrap="tests/bootstrap.php"
+         colors="true">
+    <testsuites>
+        <testsuite name="Unit">
+            <directory>tests/Unit</directory>
+        </testsuite>
+    </testsuites>
+    <source>
+        <include>
+            <directory suffix=".php">inc</directory>
+        </include>
+    </source>
+</phpunit>

tests/Unit/FirebirdTest.php

@@ -0,0 +1,22 @@
+<?php
+
+use PHPUnit\Framework\TestCase;
+
+class FirebirdTest extends TestCase
+{
+    public function testGetPresetCharsets()
+    {
+        $charsets = get_preset_charsets();
+        $this->assertIsArray($charsets);
+        $this->assertContains('UTF8', $charsets);
+        $this->assertContains('NONE', $charsets);
+    }
+
+    public function testGetDatatypes()
+    {
+        $datatypes = get_datatypes();
+        $this->assertIsArray($datatypes);
+        $this->assertArrayHasKey(37, $datatypes); // VARCHAR
+        $this->assertEquals('VARCHAR', $datatypes[37]);
+    }
+}

tests/Unit/FunctionsTest.php

@@ -0,0 +1,27 @@
+<?php
+
+use PHPUnit\Framework\TestCase;
+
+class FunctionsTest extends TestCase
+{
+    protected function setUp(): void
+    {
+        // build_title depends on these globals
+        $GLOBALS['s_connected'] = false;
+        $GLOBALS['s_login'] = ['database' => 'test.fdb'];
+    }
+
+    public function testBuildTitleDisconnected()
+    {
+        $GLOBALS['s_connected'] = false;
+        $title = build_title('Database');
+        $this->assertEquals('Firebird Web Admin / Database', $title);
+    }
+
+    public function testBuildTitleConnected()
+    {
+        $GLOBALS['s_connected'] = true;
+        $title = build_title('Database');
+        $this->assertEquals('Firebird Web Admin / Database: test.fdb', $title);
+    }
+}

tests/bootstrap.php

@@ -0,0 +1,27 @@
+<?php
+
+// Define Firebird constants if the extension is not loaded
+if (!defined('IBASE_COMMITTED')) {
+    define('IBASE_COMMITTED', 1);
+}
+if (!defined('IBASE_NOWAIT')) {
+    define('IBASE_NOWAIT', 1);
+}
+if (!defined('IBASE_READ')) {
+    define('IBASE_READ', 1);
+}
+if (!defined('IBASE_WRITE')) {
+    define('IBASE_WRITE', 1);
+}
+if (!defined('IBASE_STS_HDR_PAGES')) {
+    define('IBASE_STS_HDR_PAGES', 1);
+}
+
+// Load Composer autoloader
+require_once __DIR__ . '/../vendor/autoload.php';
+
+// Load language file needed for some tests
+if (!defined('LANGUAGE')) {
+    define('LANGUAGE', 'english');
+}
+require_once __DIR__ . '/../lang/english.inc.php';