PDO::sqliteCreateFunction

(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo_sqlite >= 1.0.0)

PDO::sqliteCreateFunction Registriert eine benutzerdefinierte Funktion (UDF) zur Nutzung in SQL-Anweisungen

Beschreibung

public PDO::sqliteCreateFunction(
    string $function_name,
    callable $callback,
    int $num_args = -1,
    int $flags = 0
): bool
Warnung

Diese Funktion ist EXPERIMENTELL. Das Verhalten, der Funktionsname und die die zugehörige Dokumentation, können sich in zukünftigen PHP-Versionen ohne Ankündigung ändern. Seien Sie gewarnt und verwenden Sie diese Funktion auf eigenes Risiko.

Diese Methode ermöglicht es, in SQLite eine PHP-Funktion als eine benutzerdefinierte Funktion (UDF) zu registrieren, die dann in einer SQL-Anweisung aufgerufen werden kann.

Die UDF kann nun in jeder SQL-Anweisung genutzt werden, die Funktionen aufrufen kann, wie SELECT und UPDATE und auch in Triggern.

Parameter-Liste

function_name

Der Name der Funktion, der in SQL-Anweisungen genutzt wird.

callback

Die Callback-Funktion, die die definierte SQL-Funktion verarbeitet.

Hinweis: Die Callback-Funktionen sollten einen Typ zurückgeben, der von SQLite verstanden wird, z.B. den Skalar-Typ.

Diese Funktion muss wie folgt definiert werden:

callback(mixed $value, mixed ...$values): mixed
value

Das erste Argument, das an die SQL-Funktion übergeben wurde.

values

Weitere Argumente, die an die SQL-Funktion übergeben wurden.

num_args

Die Anzahl von Argumenten, die die SQL-Funktion erwartet. Ist dieser Parameter -1, dann kann die SQL-Funktion eine beliebige Anzahl von Argumenten annehmen.

flags

Eine bitweise Verknüpfung von Flags. Zurzeit wird nur PDO::SQLITE_DETERMINISTIC unterstützt, das angibt, dass die Funktion für dieselbe Eingabe immer dasselbe Ergebnis innerhalb einer einzelnen SQL-Anweisung zurückgibt.

Rückgabewerte

Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

Changelog

Version Beschreibung
7.1.4 Der Parameter flags wurde hinzugefügt.

Beispiele

Beispiel #1 PDO::sqliteCreateFunction()-Beispiel

<?php
function md5_und_umkehren($string
{
    return 
strrev(md5($string));
}

$db = new PDO('sqlite:sqlitedb');
$db->sqliteCreateFunction('md5rev''md5_und_umkehren'1);
$zeilen $db->query('SELECT md5rev(dateiname) FROM dateien')->fetchAll();
?>

In diesem Beispiel wird eine Funktion verwendet, die die md5-Checksumme einer Zeichenkette berechnet und anschließend umgekehrt. Wenn die SQL-Anweisung ausgeführt wird, gibt sie gibt sie den Wert des Dateinamens zurück, der von unserer Funktion umgewandelt wurde. Die Rückgabewerte der Funktion werden in $zeilen gespeichert.

Das Praktische an dieser Technik ist, dass das Ergebnis der Abfrage nicht in einer foreach-Schleife nachbearbeitet werden muss.

Tipp

Sie können PDO::sqliteCreateFunction und PDO::sqliteCreateAggregate nutzen, um native SQLite-SQL-Funktionen zu überschreiben.

Siehe auch

Hier Kannst Du einen Kommentar verfassen


Bitte gib mindestens 10 Zeichen ein.
Wird geladen... Bitte warte.
* Pflichtangabe
Es sind noch keine Kommentare vorhanden.

Was genau bedeutet "Vibe Coding"? Ein tiefgehender Blick für Entwickler

In der Welt der Softwareentwicklung gibt es unzählige Wege, wie man an ein Projekt herangeht. Manche schwören auf strikte Planung, andere auf bewährte Algorithmen und wieder andere lassen sich von etwas ganz anderem leiten: ihrem Gefühl. ...

admin

Autor : admin
Kategorie: Software & Web-Development

PHP cURL-Tutorial: Verwendung von cURL zum Durchführen von HTTP-Anfragen

cURL ist eine leistungsstarke PHP-Erweiterung, die es Ihnen ermöglicht, mit verschiedenen Servern über verschiedene Protokolle wie HTTP, HTTPS, FTP und mehr zu kommunizieren. ...

TheMax

Autor : TheMax
Kategorie: PHP-Tutorials

Midjourney Tutorial - Anleitung für Anfänger

Über Midjourney, dem Tool zur Erstellung digitaler Bilder mithilfe von künstlicher Intelligenz, gibt es ein informatives Video mit dem Titel "Midjourney Tutorial auf Deutsch - Anleitung für Anfänger" ...

Mike94

Autor : Mike94
Kategorie: KI Tutorials

Tutorial veröffentlichen

Tutorial veröffentlichen

Teile Dein Wissen mit anderen Entwicklern weltweit

Du bist Profi in deinem Bereich und möchtest dein Wissen teilen, dann melde dich jetzt an und teile es mit unserer PHP-Community

mehr erfahren

Tutorial veröffentlichen

If you're looking for a baby horror game, this is it.

Playing "the baby in yellow (https://babyyellow.io)" can make you reconsider hiring a babysitter after you've experienced its unsettling gameplay. ...

Geschrieben von marryhile am 18.09.2025 16:44:39
Forum: Apps und PHP Script Gesuche
db Abfrage mit mehreren ids im WHERE

Ich stelle gerade alle meine Abfragen auf PDO um. Dabei stellt mich dieses Skript vor Probleme. Als erstes wird die Datenbank nach 10 zutreffende ...

Geschrieben von alfonso am 18.09.2025 11:14:58
Forum: PHP Developer Forum
DisavowHelper.com - Gratis Tool für die Backlink-Analyse

Hey, that's a really cool tool! I can definitely see how this would be helpful for managing large backlink profiles. The ability to filter and gro ...

Geschrieben von Theres4 am 17.09.2025 09:09:25
Forum: User pages
Suche nach Best Practices zur Leistungsoptimierung von PHP-Skripten!!

Am besten nutzt du die neueste PHP-Version, OPCache, (https://youtubevanced.org/) Caching und sauberen Code – so laufen deine Skripte spürbar s ...

Geschrieben von miloz am 15.09.2025 13:24:00
Forum: PHP Developer Forum