Pdo\Sqlite::createFunction
Enregistre une fonction utilisateur pour une utilisation dans les instructions SQL
&reftitle.description;
publicboolPdo\Sqlite::createFunctionstringfunction_namecallablecallbackintnum_args-1intflags0
Cette méthode permet les fonctions PHP d'être enregistrées avec SQLite en tant que
fonction définie par l'utilisateur, de sorte qu'elles puissent être appelées dans les requêtes SQL.
La fonction définie peut être utilisée dans n'importe quelle requête SQL qui permet des appels de fonction,
par exemple SELECT, UPDATE, ou des déclencheurs.
En utilisant cette méthode, il est possible de remplacer les fonctions SQL natives.
&reftitle.parameters;
function_name
Le nom de la fonction utilisé dans les instructions SQL.
callback
La fonction de rappel pour gérer la fonction SQL définie.
La fonction de rappel doit retourner un type compris par SQLite (c'est-à-dire
type scalaire).
Cette fonction doit être définie comme :
mixedcallbackmixedvaluemixedvaluesvalue
Le premier argument passé à la fonction SQL.
values
Les arguments supplémentaires passés à la fonction SQL.
num_args
Le nombre d'arguments que la fonction SQL prend.
Si ce paramètre est -1,
alors la fonction SQL peut prendre n'importe quel nombre d'arguments.
flags
Un masque de bits de drapeaux.
Actuellement, seul Pdo\Sqlite::DETERMINISTIC est supporté,
ce qui spécifie que la fonction retourne toujours le même résultat
étant donné les mêmes entrées dans une seule instruction SQL.
&reftitle.returnvalues;
&return.success;
&reftitle.examples;
Pdo\Sqlite::createFunction example
Dans cet exemple, nous avons une fonction qui calcule la somme SHA256 d'une
chaîne, puis la renverse. Lorsque l'instruction SQL est exécutée, elle
retourne la valeur du nom de fichier transformé par notre fonction.
Les données retournées dans $rows contiennent le résultat traité.
La beauté de cette technique est qu'il n'est pas nécessaire de traiter le
résultat en utilisant une boucle &foreach; après l'exécution de la requête.
createFunction('sha256rev', 'sha256_and_reverse', 1);
$rows = $db->query('SELECT sha256rev(filename) FROM files')->fetchAll();
?>
]]>
&reftitle.seealso;
Pdo\Sqlite::createAggregatePdo\Sqlite::createCollationsqlite_create_functionsqlite_create_aggregate