diff --git a/ecrire/req/sqlite_fonctions.php b/ecrire/req/sqlite_fonctions.php
index 349eddb4093e3d1b50e8cb67f2990281cd74c602..a8f5d70b9525f5749f2692e86d605aa1c7e92c83 100644
--- a/ecrire/req/sqlite_fonctions.php
+++ b/ecrire/req/sqlite_fonctions.php
@@ -10,19 +10,31 @@
* Pour plus de details voir le fichier COPYING.txt ou l'aide en ligne. *
\***************************************************************************/
-
+/**
+ * Ce fichier déclare des fonctions étendant les fonctions natives de SQLite
+ *
+ * @package SPIP\Core\SQL\SQLite\Fonctions
+ */
+
if (!defined('_ECRIRE_INC_VERSION')) {
return;
}
-/*
- * Des fonctions pour les requetes SQL
+/**
+ * Déclarer à SQLite des fonctions spécifiques utilisables dans les requêtes SQL
+ *
+ * SQLite ne supporte nativement que certaines fonctions dans les requêtes SQL.
+ * Cependant, il permet d'étendre très facilement celles-ci en déclarant de
+ * nouvelles fonctions.
*
- * Voir la liste des fonctions natives : http://www.sqlite.org/lang_corefunc.html
- * Et la liste des evolutions pour : http://sqlite.org/changes.html
+ * C'est ce qui est fait ici, en ajoutant des fonctions qui existent aussi
+ * dans d'autres moteurs, notamment en MySQL.
*
+ * @link http://www.sqlite.org/lang_corefunc.html Liste des fonctions natives
+ * @link http://sqlite.org/changes.html Liste des évolutions
+ *
+ * @param PDO|resource $sqlite Représente la connexion Sqlite
*/
-// http://code.spip.net/@_sqlite_init_functions
function _sqlite_init_functions(&$sqlite) {
if (!$sqlite) {
@@ -31,64 +43,69 @@ function _sqlite_init_functions(&$sqlite) {
$fonctions = array(
+
+ // C
+ 'CEIL' => array('_sqlite_func_ceil', 1),
'CONCAT' => array('_sqlite_func_concat', -1),
- 'CEIL' => array('_sqlite_func_ceil', 1),
- // absent de sqlite2
+ // D
'DATE_FORMAT' => array('_sqlite_func_strftime', 2),
- 'DAYOFMONTH' => array('_sqlite_func_dayofmonth', 1),
+ 'DAYOFMONTH' => array('_sqlite_func_dayofmonth', 1),
- 'EXTRAIRE_MULTI' => array('_sqlite_func_extraire_multi', 2),
- // specifique a SPIP/sql_multi()
- 'EXP' => array('exp', 1),
- //exponentielle
+ // E
+ 'EXTRAIRE_MULTI' => array('_sqlite_func_extraire_multi', 2), // specifique a SPIP/sql_multi()
+ 'EXP' => array('exp', 1),
+
+ // F
'FIND_IN_SET' => array('_sqlite_func_find_in_set', 2),
- 'FLOOR' => array('_sqlite_func_floor', 1),
- // absent de sqlite2
+ 'FLOOR' => array('_sqlite_func_floor', 1),
- 'IF' => array('_sqlite_func_if', 3),
+ // I
+ 'IF' => array('_sqlite_func_if', 3),
'INSERT' => array('_sqlite_func_insert', 4),
- 'INSTR' => array('_sqlite_func_instr', 2),
+ 'INSTR' => array('_sqlite_func_instr', 2),
- 'LEAST' => array('_sqlite_func_least', 3),
- '_LEFT' => array('_sqlite_func_left', 2),
-# 'LENGTH' => array( 'strlen' ,1), // present v1.0.4
-# 'LOWER' => array( 'strtolower' ,1), // present v2.4
-# 'LTRIM' => array( 'ltrim' ,1), // present en theorie
+ // L
+ 'LEAST' => array('_sqlite_func_least', 3),
+ '_LEFT' => array('_sqlite_func_left', 2),
+# 'LENGTH' => array('strlen', 1), // present v1.0.4
+# 'LOWER' => array('strtolower', 1), // present v2.4
+# 'LTRIM' => array('ltrim', 1), // present
+ // N
'NOW' => array('_sqlite_func_now', 0),
- 'MD5' => array('md5', 1),
+ // M
+ 'MD5' => array('md5', 1),
'MONTH' => array('_sqlite_func_month', 1),
+ // P
'PREG_REPLACE' => array('_sqlite_func_preg_replace', 3),
- 'RAND' => array('_sqlite_func_rand', 0),
- // sinon random() v2.4
- 'REGEXP' => array('_sqlite_func_regexp_match', 2),
- // critere REGEXP supporte a partir de v3.3.2
- //'REGEXP_MATCH' => array( '_sqlite_func_regexp_match' ,2), // critere REGEXP supporte a partir de v3.3.2
-
- 'RIGHT' => array('_sqlite_func_right', 2),
-# 'RTRIM' => array( 'rtrim' ,1), // present en theorie
-
- 'SETTYPE' => array('settype', 2),
- // CAST present en v3.2.3
- 'SQRT' => array('sqrt', 1),
- 'SUBSTRING' => array('_sqlite_func_substring' /*,3*/),
- // peut etre appelee avec 2 ou 3 arguments, index base 1 et non 0
+ // R
+ 'RAND' => array('_sqlite_func_rand', 0), // sinon random() v2.4
+ 'REGEXP' => array('_sqlite_func_regexp_match', 2), // critere REGEXP supporte a partir de v3.3.2
+ 'RIGHT' => array('_sqlite_func_right', 2),
+# 'RTRIM' => array('rtrim', 1), // present
- 'TO_DAYS' => array('_sqlite_func_to_days', 1),
-# 'TRIM' => array( 'trim' ,1), // present en theorie
+ // S
+ 'SETTYPE' => array('settype', 2), // CAST present en v3.2.3
+ 'SQRT' => array('sqrt', 1),
+ 'SUBSTRING' => array('_sqlite_func_substring' /*, 3*/), // peut etre appelee avec 2 ou 3 arguments, index base 1 et non 0
- 'TIMESTAMPDIFF' => array('_sqlite_timestampdiff' /*,3*/),
+ // T
+ 'TIMESTAMPDIFF' => array('_sqlite_timestampdiff' /*, 3*/),
+ 'TO_DAYS' => array('_sqlite_func_to_days', 1),
+# 'TRIM' => array('trim', 1), // present
+ // U
'UNIX_TIMESTAMP' => array('_sqlite_func_unix_timestamp', 1),
-# 'UPPER' => array( 'strtoupper' ,1), // present v2.4
+# 'UPPER' => array('strtoupper', 1), // present v2.4
- 'VIDE' => array('_sqlite_func_vide', 0),
- // du vide pour SELECT 0 as x ... ORDER BY x -> ORDER BY vide()
+ // V
+ 'VIDE' => array('_sqlite_func_vide', 0), // du vide pour SELECT 0 as x ... ORDER BY x -> ORDER BY vide()
+ // Y
'YEAR' => array('_sqlite_func_year', 1)
);
@@ -100,8 +117,23 @@ function _sqlite_init_functions(&$sqlite) {
#spip_log('functions sqlite chargees ','sqlite.'._LOG_DEBUG);
}
-// permet au besoin de charger des fonctions ailleurs par _sqlite_init_functions();
-// http://code.spip.net/@_sqlite_add_function
+
+/**
+ * Déclare une fonction à SQLite
+ *
+ * @note
+ * Permet au besoin de charger des fonctions
+ * ailleurs par _sqlite_init_functions();
+ *
+ * @uses _sqlite_is_version()
+ *
+ * @param PDO|resource $sqlite Représente la connexion Sqlite
+ * @param string $f Nom de la fonction à créer
+ * @param array $r Tableau indiquant :
+ * - le nom de la fonction à appeler,
+ * - le nombre de paramètres attendus de la fonction (-1 = infini, par défaut)
+ *
+**/
function _sqlite_add_function(&$sqlite, &$f, &$r) {
if (_sqlite_is_version(3, $sqlite)) {
isset($r[1])