sqlite_create_aggregate
<<<		 sqlite_create_function sqlite_current
>>>
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

<< sqlite_create_function >>
sqlite_create_aggregate Fonctions SQLite sqlite_current