Bring up to date

.github/docker/php-apache-firebird/Dockerfile

@@ -0,0 +1,27 @@
+FROM php:8.3-apache
+
+RUN apt-get update && apt-get install -y \
+    firebird-dev \
+    git \
+    autoconf \
+    build-essential \
+    && git clone https://github.com/FirebirdSQL/php-firebird.git /tmp/php-firebird \
+    && cd /tmp/php-firebird \
+    && phpize \
+    && ./configure \
+    && make \
+    && make install \
+    && docker-php-ext-install pdo_firebird \
+    && docker-php-ext-enable interbase \
+    && a2enmod rewrite \
+    && rm -rf /tmp/php-firebird \
+    && apt-get purge -y --auto-remove git autoconf build-essential \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN { \
+    echo 'error_reporting = E_ALL'; \
+    echo 'display_errors = Off'; \
+    echo 'display_startup_errors = Off'; \
+    echo 'log_errors = On'; \
+    echo 'error_log = /dev/stderr'; \
+    } > /usr/local/etc/php/conf.d/docker-php-logging.ini

.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

.github/workflows/playwright.yml

@@ -0,0 +1,83 @@
+name: Playwright Tests
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: 18
+
+    - name: Install dependencies
+      run: npm ci
+
+    - name: Install Playwright browsers
+      run: npx playwright install --with-deps
+
+    - name: Configure application for testing
+      run: |
+        cp inc/configuration.inc.php inc/configuration.inc.php.bak
+        sed -i "s/define('DEFAULT_HOST',    'localhost');/define('DEFAULT_HOST',    'firebird');/" inc/configuration.inc.php
+        sed -i "s/define('DEFAULT_DB',      'employee.fdb');/define('DEFAULT_DB',      'test.fdb');/" inc/configuration.inc.php
+        sed -i "s|define('DEFAULT_PATH',    '/var/lib/firebird/2.5/data/');|define('DEFAULT_PATH',    '/var/lib/firebird/data/');|" inc/configuration.inc.php
+
+    - name: Start services
+      run: |
+        docker compose up -d || {
+          echo "Docker compose up failed!"
+          docker compose ps
+          docker compose logs
+          exit 1
+        }
+
+    - name: Wait for services to be healthy
+      run: |
+        echo "Waiting for services to become healthy..."
+        max_wait=300
+        current_wait=0
+        while [ $current_wait -lt $max_wait ]; do
+          firebird_status=$(docker inspect --format='{{.State.Health.Status}}' $(docker compose ps -q firebird) 2>/dev/null || echo "starting")
+          web_status=$(docker inspect --format='{{.State.Health.Status}}' $(docker compose ps -q web) 2>/dev/null || echo "starting")
+
+          echo "Status: Firebird=$firebird_status, Web=$web_status (${current_wait}s)"
+
+          if [ "$firebird_status" = "healthy" ] && [ "$web_status" = "healthy" ]; then
+            echo "All services are healthy!"
+            exit 0
+          fi
+
+          sleep 10
+          current_wait=$((current_wait + 10))
+        done
+
+        echo "ERROR: Services did not become healthy in time."
+        echo "--- Firebird Detailed Status ---"
+        docker inspect $(docker compose ps -q firebird)
+        echo "--- Web Detailed Status ---"
+        docker inspect $(docker compose ps -q web)
+        echo "--- Container Logs ---"
+        docker compose logs
+        exit 1
+
+    - name: Run Playwright tests
+      run: npx playwright test
+      env:
+        BASE_URL: http://localhost:8080
+
+    - name: Stop services
+      if: always()
+      run: docker compose down
+
+    - name: Restore config file
+      if: always()
+      run: |
+        mv inc/configuration.inc.php.bak inc/configuration.inc.php

.gitignore

@@ -5,4 +5,15 @@
 #   git config --global core.excludesfile '~/.gitignore_global'
 
 # PhpStorm
-.idea/**/*
+
+.idea/**/*
+
+
+
+# Node dependencies
+
+node_modules/
+
+# PHP dependencies
+vendor/
+composer.lock

CHANGELOG.md

@@ -1,5 +1,10 @@
 # ChangeLog
 
+## Version 3.4.2 (24.02.2026)
+
+* [enhancement:] Refactored all AJAX calls to use the modern `fetch` API.
+* [enhancement:] Removed the outdated and insecure `XMLHttpRequestClient.js` library.
+
 ## Version 3.4.1 (27.02.2020)
 
 * [enhancement:] Adjust "Accessories" page UI.

README.md

@@ -1,85 +1,110 @@
-# FirebirdWebAdmin is a web frontend for the Firebird database server
+# FirebirdWebAdmin
+
+**FirebirdWebAdmin** is a lightweight, powerful web-based administration tool for the Firebird database server. It provides an intuitive interface for managing databases, tables, and other database objects directly from your browser.
 
 [![Crowdin](https://d322cqt584bo4o.cloudfront.net/firebirdwebadmin/localized.svg)](https://crowdin.com/project/firebirdwebadmin)
 [![Code Climate](https://codeclimate.com/github/mariuz/firebirdwebadmin/badges/gpa.svg)](https://codeclimate.com/github/mariuz/firebirdwebadmin)
+[![License: GPL v2](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://opensource.org/licenses/GPL-2.0)
+[![PHP Version](https://img.shields.io/badge/php-%3E%3D%205.5-8892bf.svg)](https://php.net)
+
+---
+
+## 🚀 Features
+
+### 🛠 Database & Object Management
+* **Database Operations:** Create, delete, and modify databases.
+* **Schema Management:** Manage tables, views, triggers, domains, indices, and generators.
+* **Business Logic:** Create and edit stored procedures and User Defined Functions (UDFs).
+* **Security:** Manage database users and roles.
+* **Exceptions:** Define and manage database exceptions.
+
+### 🔍 Data Manipulation
+* **SQL Console:** Execute SQL expressions and scripts with result display.
+* **Data Browsing:** Browse table and view contents with real-time updates.
+* **Editing:** Insert, edit, and delete data rows while browsing.
+* **Blob Support:** Handle BLOB fields (display and edit contents).
+* **Import/Export:** Seamlessly import and export data using CSV format.
+
+### 📈 Administration & Maintenance
+* **Maintenance:** Database backup and restore capabilities.
+* **Monitoring:** Display database metadata and browse system tables.
+* **Statistics:** Access database and server statistics (requires local access).
+* **Maintenance Tools:** Integrated database maintenance functions.
 
-By now it has the functionalities for
-
-* creating, deleting, modifying databases, tables, generators, views, triggers, domains, indices, stored procedures, udf's,     exceptions, roles and database users
-* performing sql expressions on databases and display the results
-* import and export of data through files in the csv format
-* browsing through the contents of tables and views, watching them growing while typing in data
-* selecting data for deleting and editing while browsing tables
-* inserting, deleting, displaying the contents of blob fields
-* diplaying database metadata, browsing the firebird system tables
-* database backup and restore, database maintenance
+> **Note:** Some administrative features (like backup/restore and statistics) require PHP to have access to Firebird command-line tools (`isql`, `gsec`, `gstat`, etc.) and may require the web server to run on the same machine as the database server.
 
-Some of the features are only available if the database- and the web-server are running on the same machine. The reason is that php   have to call the Firebird tools (isql, gsec, gstat, etc.) to perform certain actions.
+---
 
-## Overview
+## 📋 Requirements
 
-1. [Documentation](#documentation)
-2. [Requirements](#requirements)
-3. [ChangeLog](#requirements)
-4. [Contributing](#contributing)
-5. [Copyright notice](#copyright-notice)
+* **PHP:** Version 5.5 or higher (PHP 7.x and 8.x recommended).
+  * Must be compiled with `pdo_firebird` or `interbase` support.
+  * `pcre` support enabled.
+* **Database:** Firebird 2.x, 3.x, or 4.x.
+* **Web Server:** Apache 2.x, Nginx, or any server with PHP support.
+* **Operating System:** Linux (tested), Windows (compatible).
 
-## Documentation
+---
 
-There is no documentation available yet, but if you are familiar with Firebird  you will have no troubles using FirebirdWebAdmin.
+## ⚙️ Installation & Configuration
 
-For some basic configuration settings have a look to the file `./inc/configuration.inc.php` before you start the programm.
+1. **Download:** Clone this repository or download the source code.
+   ```bash
+   git clone https://github.com/mariuz/firebirdwebadmin.git
+   ```
+2. **Web Server Setup:** Place the directory in your web server's document root (e.g., `/var/www/html/`).
+3. **Configuration:**
+   * Open `inc/configuration.inc.php`.
+   * Configure the `BINPATH` to point to your Firebird binaries (e.g., `/usr/bin/`).
+   * Set `TMPPATH` to a directory writable by the web server.
+   * Adjust default connection settings if necessary.
+4. **Access:** Navigate to the directory in your browser (e.g., `http://localhost/firebirdwebadmin/`).
 
-Here is how to use and install on Ubuntu <https://help.ubuntu.com/community/Firebird3.0>
+---
 
-Firebird documentation is located on this page <https://www.firebirdsql.org/en/documentation/>
+## 📖 Documentation
 
-## Requirements
+While there is no exhaustive manual, users familiar with Firebird will find the interface intuitive.
 
-This is the environment I'm using for the development. Other components are not or less tested. So if you got problems make sure you are not using older software components.
+* **Configuration:** Check `inc/configuration.inc.php` for advanced settings.
+* **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/)
 
-PHP with compiled in support for Firebird/InterBase and pcre (but any version >= 5.5 should work)
+## 🧪 Testing
 
-Firebird 2.x.x for Linux,
-Apache 2.x or any server with php support
+### Unit Tests (PHPUnit)
+The project uses PHPUnit for unit testing core functions.
+1. Install dependencies: `composer install`
+2. Run tests: `./vendor/bin/phpunit`
 
-## ChangeLog
+### End-to-End Tests (Playwright)
+The project uses Playwright for E2E testing.
+1. Install dependencies: `npm install`
+2. Run tests: `npx playwright test`
 
-### Version 3.4.1 (27.02.2020)
+---
 
-* [enhancement:] Adjust "Accessories" page UI.
-* [enhancement:] Remove Crowdin badge from footer.
-* [enhancement:] Update debug_funcs.inc.php
-* [bugfix:] Don't warn if "isql" is "isql-fb" on Linux
-* [typo:] Correct typo: firebirid -> firebird
-* [bugfix] fix sql create database
-* [enhancement:] Add Character Sets
-* [enhancement:] Quiet PHP7.2 deprecation warning …
-* [enhancement:] Further create_function refactor
-* [enhancement:] Remove unused/outdated markableFbwaTable.
-* [enhancement:] cosmetics
+## 📄 ChangeLog
 
-#### Further informations
+See [CHANGELOG.md](CHANGELOG.md) for the full history of changes.
 
-* See [CHANGELOG.md][changelog] to get the full changelog.
+---
 
-## Contributing
+## 🤝 Contributing
 
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
+We welcome contributions! To contribute:
 
-## Copyright notice
+1. Fork the repository.
+2. Create a feature branch (`git checkout -b feature/amazing-feature`).
+3. Commit your changes (`git commit -m 'Add amazing feature'`).
+4. Push to the branch (`git push origin feature/amazing-feature`).
+5. Open a Pull Request.
 
- (C) 2000,2001,2002,2003,2004 Lutz Brueckner <irie@gmx.de>
-                              Kapellenstr. 1A
-                              22117 Hamburg, Germany
+---
 
-FirebirdWebAdmin is published under the terms of the [GNU GPL v.2][gnu_gpl_v2_license], please read the file LICENCE for details.
+## ⚖️ License
 
-This software is provided 'as-is', without any expressed or implied warranty.  In no event will the author be held liable for any damages arising from the use of this software.
+**FirebirdWebAdmin** is published under the terms of the [GNU GPL v.2](https://opensource.org/licenses/GPL-2.0).
+See the `LICENSE` file for details.
 
-[gnu_gpl_v2_license]: https://opensource.org/licenses/GPL-2.0
-[changelog]: CHANGELOG.md
+© 2000-2026 Lutz Brueckner and contributors.

accessories.php

@@ -506,9 +506,7 @@
 
     // modify the View
     if (isset($_POST['acc_modview_doit'])) {
-        $viewdefs['source'] = get_magic_quotes_gpc()
-            ? stripslashes(trim($_POST['def_view_source']))
-            : $_POST['def_view_source'];
+        $viewdefs['source'] = $_POST['def_view_source'];
         $viewdefs['check'] = (isset($_POST['def_view_check'])) ? 'yes' : 'no';
 
         if (drop_view($s_viewdefs['name'])) {

admin.php

@@ -163,9 +163,12 @@
 //
 if (have_panel_permissions($s_login['user'], 'adm_server')) {
     $exe = 'fb_lock_print';
+
+    // Construct database path with host if needed (required for Firebird 3+)
+    $db_path = !empty($s_login['host']) ? $s_login['host'].':'.$s_login['database'] : $s_login['database'];
 
     // get the LOCK_HEADER BLOCK 
-    list($iblockpr_output, $binary_error) = exec_command($exe, ' -o');
+    list($iblockpr_output, $binary_error) = exec_command($exe, ' -d ' . ibwa_escapeshellarg($db_path) . ' -o');
 
     $lock_header = '';
     unset($iblockpr_output[0]);
@@ -177,7 +180,7 @@
     }
 
     // get the server statistics
-    list($iblockpr_output, $binray_error) = exec_command($exe, ' -i');
+    list($iblockpr_output, $binary_error) = exec_command($exe, ' -d ' . ibwa_escapeshellarg($db_path) . ' -i');
 
     if (count($iblockpr_output) > 3) {
         $iblock['names'] = preg_split('/[\s,]+/', $iblockpr_output[0]);

composer.json

@@ -0,0 +1,11 @@
+{
+    "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": {
+    }
+}

database.php

@@ -282,14 +282,14 @@
 // determine the accessible databases for the login panel
 //
 $dbfiles = array();
-if (isset($ALLOWED_FILES)  && count($ALLOWED_FILES) > 0) {
+if (isset($ALLOWED_FILES) && is_array($ALLOWED_FILES) && count($ALLOWED_FILES) > 0) {
     foreach ($ALLOWED_FILES as $file) {
         if ((strpos($file, '/') === false  &&  strpos($file, '\\') === false)  ||
             is_file($file)) {
             $dbfiles[] = $file;
         }
     }
-} elseif (isset($ALLOWED_DIRS)  &&  count($ALLOWED_DIRS) > 0) {
+} elseif (isset($ALLOWED_DIRS) && is_array($ALLOWED_DIRS) &&  count($ALLOWED_DIRS) > 0) {
     foreach ($ALLOWED_DIRS as $dir) {
         if (!@is_readable($dir)) {
             $warning .= sprintf($WARNINGS['CAN_NOT_ACCESS_DIR'], $dir);