Query > preparefunction

In alcuni casi la query richiede, dapprima, una preparazione che, tipicamente, rende disponibile una tabella temporanea. Si pensi, ad esempio, al caso in cui la query debba consentire ricerche su dati di sintesi. La funzione di preparazione si fa carico di predisporre la tabella temporanea contenente i dati di sintesi, la query procede quindi ad interrogare la tabella temporanea.

Questa previsione richiede che esista, sul server, una classe (eventualmente inserita in un apposito file PHP) con un metodo pubblico (una public static function) che provveda alla realizzazione della preparazione.

Il tag preparefunction esplicita il nome della funzione mentre ai tag prepareinclude e prepareclass è demandato il compito di indicare il file PHP nel quale risiede la classe e il nome stesso della classe.

Un esempio di utilizzo dei tre tag è riportato qui di seguito:

<preparefunction>preparaprospetto</preparefunction>
<prepareinclude>utils_sp</prepareinclude>
<prepareclass>sp_utils</prepareclass>

il quale fa riferimento ad un file utils_sp.php che contiene la classe sp_utils la cui funzione preparaprospetto ha il compito di preparare i dati prima che sia eseguita la query.