8.124 Fonctions SQLite
8 Référence des fonctions
Manuel PHP
. Introduction
. Installation
. Pré-requis
. Types de ressources
. Constantes pré-définies
. Classes pré-définies
. Configuration à l'exécution
. sqlite_array_query
. sqlite_busy_timeout
. sqlite_changes
. sqlite_close
. sqlite_column
. sqlite_create_aggregate
->sqlite_create_function
. sqlite_current
. sqlite_error_string
. sqlite_escape_string
. sqlite_exec
. sqlite_factory
. sqlite_fetch_all
. sqlite_fetch_array
. sqlite_fetch_column_types
. sqlite_fetch_object
. sqlite_fetch_single
. sqlite_fetch_string
. sqlite_field_name
. sqlite_has_more
. sqlite_has_prev
. sqlite_key
. sqlite_last_error
. sqlite_last_insert_rowid
. sqlite_libencoding
. sqlite_libversion
. sqlite_next
. sqlite_num_fields
. sqlite_num_rows
. sqlite_open
. sqlite_popen
. sqlite_prev
. sqlite_query
. sqlite_rewind
. sqlite_seek
. sqlite_single_query
. sqlite_udf_decode_binary
. sqlite_udf_encode_binary
. sqlite_unbuffered_query
. sqlite_valid
|
8.124.14 sqlite_create_function()SQLiteDatabase->createFunction()
Enregistre une fonction utilisateur "classique" UDF pour SQLite
[ Exemples avec sqlite_create_function ] PHP 5
void
sqlite_create_function (
resource
dbhandle
,
string
function_name
,
callback
callback
,
int
num_args
)
Style orienté objet (méthode)
SQLiteDatabase
void
createFunction (
string
function_name
,
callback
callback
,
int
num_args
)
sqlite_create_function
vous permet d'enregistrer une fonction
PHP dans SQLite comme
UDF
(Fonction Définie par l'Utilisateur,
User Defined Function), pour qu'elle soit accessible depuis les requêtes SQL.
Les UDF peuvent être utilisées dans n'importe quelle requête SQL qui peut
appeler des fonctions, telles que SELECT et UPDATE, ou même des triggers.
-
dbhandle
-
La ressource de base de données SQLite; retournée par
sqlite_open
lorsqu'utilisée de manière
procédurale. Ce paramètre n'est pas requis si vous utilisez la méthode
orientée objet.
-
function_name
-
Le nom de la fonction utilisée dans les requêtes SQL.
-
callback
-
Fonction de procédure de rappel pour gérer les fonctions SQL définies.
| Note | |
Les fonctions de procédure de rappel devraient retourner un type
compris par SQLite (c'est-à-dire, voir
type scalaire ).
|
-
num_args
-
Conseil à l'analyseur SQLite si la fonction de procédure de rappel
accepte un nombre prédéterminé d'arguments.
| Note | |
Deux syntaxes alternatives sont
supportées pour assurer la compatibilité avec les autres bases de données
(telles que MySQL) : La forme recommandée est la première, où le paramètre
dbhandle
est le premier dans la fonction.
|
| Exemple avec sqlite_create_function |
<?php
function md5_and_reverse($string)
{
return strrev(md5($string));
}
if ($dbhandle = sqlite_open('mysqlitedb', 0666, $sqliteerror)) {
sqlite_create_function($dbhandle, 'md5rev', 'md5_and_reverse', 1);
$sql = 'SELECT md5rev(filename) FROM files';
$rows = sqlite_array_query($dbhandle, $sql);
} else {
echo 'Erreur pendant l\'ouverture de la base db : ' . $sqliteerror;
exit;
}
?>
|
Dans cet exemple, nous avons une fonction qui calcule la somme de contrôle
MD5 d'une chaîne, et l'inverse. Lorsque la requête SQL s'exécute,
elle retourne le nom du fichier, transformé par cette opération.
Les données retournées dans
$rows
contiennent le
résultat.
La beauté de cette technique est que vous n'avez pas à traiter vous-même
les données avec une boucle, une fois que vous avez lu les données.
PHP enregistre une fonction spéciale appelée
php
lorsque
la base est ouverte. Cette fonction est utilisée pour appeler toute fonction
PHP sans avoir à l'enregistrer au préalable.
| Exemple d'utilisation d'une fonction PHP dans SQLite |
<?php
$rows = sqlite_array_query($db, "SELECT php('md5', filename) from files");
?>
|
| Note | |
Pour des raisons de performances, PHP ne va pas automatiquement
coder ou décoder les données binaires passées à votre UDF. Vous devez le faire
manuellement. Voyez les fonctions
sqlite_udf_encode_binary
et
sqlite_udf_decode_binary
pour plus de détails.
|
Array
Array
|
