La fonction
sql_insertq() permet de réaliser une insertion dans la base de données. Les valeurs transmises non numériques seront protégés par des fonctions adaptées à chaque gestionnaire de bases de données pour gérer les apostrophes. La fonction retourne si possible le numéro de l’identifiant de clé primaire inséré.
La fonction admet 5 paramètres :
-#
$table est le nom de la table SQL,
-#
$couples est un tableau associatif nom / valeur,
-#
$desc,
-#
$serveur,
-#
$option.
Elle s’utilise simplement comme ceci :
$id = sql_insertq('table', array('colonne'=>'valeur'));
Exemple
Les fonctions
insert_xx() tel que
insert_article() présente dans
ecrire/action/editer_article.php permettent de créer des insertions en base de données pour les objets concernés, en gérant les valeurs par défaut et en appelant le pipeline
pre_insertion concerné. Ces fonctions retournent l’identifiant alors créé.
Ces fonctions exécutent donc, après le pipeline
pre_insertion la fonction
sql_insertq(). Puis dans la foulée, si un auteur est identifié, l’article est lié à cet auteur :
$id_article = sql_insertq("spip_articles", $champs);
// controler si le serveur n'a pas renvoye une erreur
if ($id_article > 0 AND $GLOBALS['visiteur_session']['id_auteur']) {
sql_insertq('spip_auteurs_articles', array(
'id_auteur' => $GLOBALS['visiteur_session']['id_auteur'],
'id_article' => $id_article));
}