KSQL-Treiber

Eigene Treiber für den KSQL-Port (TDS 7.4 mit dem KSQL-Profil) in acht Sprachen, je nach dem Vorbild des Microsoft-Treibers: dieselbe Schnittstelle, dieselben Schlüssel der Verbindungszeichenfolge, dieselbe Abbildung der Typen und Fehler — und dazu, was KSQL über SQL Server hinaus kann. Jeder arbeitet auch an SQL Server. Jeder Treiber spielt denselben sprachneutralen Prüfkatalog ab (KuonenSQL/tools/ksql-konformitaet/faelle.json, D36.1), einmal gegen den KSQL-Port und einmal gegen SQL Server 2025.

Vorbild: sqlsrv und pdo_sqlsrv · Erweiterung ksql: Funktionen sqlsrv_* und PDO-Treiber ksql: · PHP 8.2+ (gebaut und geprüft mit PHP 8.3 auf Linux), OpenSSL · Quelle: Data/src/Kuonen.Data.Ksql.Php · Roadmap D36.4 ✅

Herunterladen und einbinden

Kein Download: die PHP-Erweiterung wird aus dem Quellcode gebaut, und der Code bleibt geschlossen (ein PECL-Paket wäre Quelltext). Auf Anfrage bei Marc Kuonen.

Aus dem Quellcode bauen

cd Data/src/Kuonen.Data.Ksql.Php && phpize && ./configure --enable-ksql && make && make install
echo extension=ksql > /etc/php/conf.d/ksql.ini

configure kopiert den Kern aus ../Kuonen.Data.Ksql.C nach kern/; der Port folgt darum dem Kern (ohne Angabe 1433). Die Fassung folgt der des Servers.

Verbindungszeichenfolge

ksql:Server=server,1333;Database=master;TrustServerCertificate=yes

Ohne Port gilt 1433 wie beim Vorbild; den KSQL-Port 1333 nennt man.

Beispiel: verbinden, abfragen, Parameter, Transaktion

$c = sqlsrv_connect('tcp:server,1333', ['Database' => 'master', 'UID' => 'sa', 'PWD' => $pw, 'TrustServerCertificate' => true]);
$s = sqlsrv_query($c, 'SELECT name FROM sys.tables WHERE name LIKE ?', ['kk_%']);
while ($z = sqlsrv_fetch_array($s, SQLSRV_FETCH_ASSOC)) { echo $z['name'], "\n"; }

sqlsrv_begin_transaction($c);
sqlsrv_query($c, 'UPDATE konto SET saldo = saldo - ? WHERE id = ?', [1, 7]);
sqlsrv_commit($c);

if (sqlsrv_query($c, 'SELECT 1 / 0') === false) {
    print_r(sqlsrv_errors());              // SQLSTATE 22012, code 8134
}

// PDO
$pdo = new PDO('ksql:Server=server,1333;Database=master;TrustServerCertificate=yes', 'sa', $pw,
               [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$s = $pdo->prepare('SELECT :a + 1 AS r');
$s->execute(['a' => 41]);

Typen

Fehler und SQLSTATE

Unterschiede zu sqlsrv und pdo_sqlsrv

• Eine Erweiterung für beide Schnittstellen: die sqlsrv_*-Funktionen und der PDO-Treiber mit DSN ksql: statt sqlsrv:.
• Die Werte von SQLSRV_SQLTYPE_* und SQLSRV_PHPTYPE_* sind eigene Kodierungen; Programme, die die Namen nutzen, merken nichts.
• SQLSRV_SQLTYPE_TIME(s), _DATETIME2(s), _DATETIMEOFFSET(s) mit Skala.
• Eigene Massenkopie ksql_bulk_copy bzw. $pdo->ksqlBulkCopy(…) und $pdo->ksqlMeldungen() für PRINT und RAISERROR bis Klasse 10.
• PHP hat keinen zweiten Faden für sqlsrv_cancel: dafür KsqlCancelAfterMs.
• PDO::PARAM_STR geht als nvarchar, der Server wandelt in den deklarierten Typ (wie pdo_sqlsrv).

Was fehlt

• Rollbare Cursor (Scrollable nur forward; sqlsrv_num_rows meldet das), Ströme (SQLSRV_PHPTYPE_STREAM liefert den ganzen Wert).
• MARS, Verbindungspool, Windows- und Entra-Anmeldung, CharacterSet (immer UTF-8), Always Encrypted.
• Verteilung: kein PECL-Paket (package.xml), kein Bau für Windows (config.w32) oder macOS; PHP 8.2 und 8.4 nicht gebaut.

Herkunft und Lizenz

Eigenbau: übernommen sind nur die Schnittstelle des Microsoft-Treibers und das am Orakel (SQL Server 2025) gemessene Verhalten, kein Code – auch nicht aus MIT- oder BSD-lizenzierten Quellen –, damit der Treiber uneingeschränkt KuonenSQL gehört. Der Code bleibt geschlossen; eine Veröffentlichung gibt es nur als eigenständigen Fork, den Marc Kuonen selbst anlegt.

Eigener Code ohne fremde Quellen; fremd sind nur PHP und OpenSSL. Kein PECL-Paket.