PDO::sqliteCreateAggregate
4D (PDO)
SQLite (PDO)
PHP Manual

# PDO::sqliteCreateFunction

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

PDO::sqliteCreateFunction — Référence une fonction définie par l'utilisateur pour une utilisation dans les requêtes SQL

### Description

PDO
bool sqliteCreateFunction ( string `$function_name` , callback `$callback` [, int `$num_args` ] )
Avertissement

Cette fonction est EXPERIMENTALE. Cela signifie que le comportement de cette fonction, son nom et, concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS ! Soyez-en conscient, et utilisez cette fonction à vos risques et périls.

Cette méthode vous permet de référencer une fonction PHP avec SQLite comme étant un UDF (User Defined Function), de telle façon qu'elle puisse être appelée à l'intérieur de vos requêtes SQL.

Un UDF peut être utilisé dans n'importe quelle requête SQL qui peut appeler des fonctions, par exemple les requêtes SELECT et UPDATE mais aussi dans les marqueurs.

### Liste de paramètres

`function_name`

  Le nom de la fonction utilisé dans les requêtes SQL.

`callback`

  Fonction de rappel pour manipuler la fonction SQL définie.

  > Note: Les fonctions de rappel devraient retourner un type connu par SQLite (c'est-à-dire type scalaire).

`num_args`

  Conseil à l'analyseur SQLite si la fonction de rappel accepte un nombre prédéterminé d'arguments.

### Valeurs de retour

Cette fonction retourne `TRUE` en cas de succès ou `FALSE` si une erreur survient.

### Exemples

Exemple #1 Exemple avec PDO::sqliteCreateFunction()

`<?php
function md5_et_renverse($string)
{
return strrev(md5($string));
}
$db = new PDO('sqlite:sqlitedb');
$db->sqliteCreateFunction('md5rev', 'md5_et_renverse', 1);
$rows = $db->query('SELECT md5rev(filename) FROM files')->fetchAll();
?>`

Dans cet exemple, nous avons une fonction qui calcule la somme MD5 de la chaîne de caractères et la renverse ensuite. Lorsque la requête SQL s'exécute, elle retourne la valeur du nom du fichier transformée par notre fonction. Les données retournées dans `$rows` contiennent le résultat traité.

La beauté de cette technique est que vous n'avez pas à traiter le résultat en utilisant une boucle foreach après que vous ayez récupéré les données.

Astuce

Vous pouvez utiliser PDO::sqliteCreateFunction et PDO::sqliteCreateAggregate pour surcharger les fonctions natives de SQL.

> Note: Cette méthode n'est pas disponible avec les pilotes de SQLite2. Utilisez l'ancien style de l'API sqlite à la place.

### Voir aussi

- PDO::sqliteCreateAggregate
- sqlite_create_function() - Enregistre une fonction utilisateur "classique" UDF pour SQLite
- sqlite_create_aggregate() - Enregistre une UDF agrégeante pour les requêtes SQLite

PDO::sqliteCreateAggregate
4D (PDO)
SQLite (PDO)
PHP Manual