sql_error_backtrace()

Retourne la pile de fonctions utilisée lors de la précence d'une erreur SQL

Parameters

$compil_info : bool = false

• false : Retourne un texte présentant les fonctions utilisées
• true : retourne un tableau indiquant un contexte de compilation à l'origine de la requête, utile pour présenter une erreur au débuggueur via erreur_squelette()

Tags

note

Ignore les fonctions include_once, include_spip, find_in_path

used-by

spip_mysql_error()

used-by

spip_sqlite_error()

sql_get_charset()

Demande si un charset est disponible

Parameters

$charset : string

Le charset souhaité

$serveur : string = ''

Le nom du connecteur

$option : bool = true

Inutilise

Tags

see

sql_set_charset()

pour utiliser un charset

sql_set_charset()

Regler le codage de connexion

Parameters

$charset : string

Le charset souhaite

$serveur : string = ''

Le nom du connecteur

$option : bool|string = true

Peut avoir 2 valeurs :

• true pour executer la requete.
• continue pour ne pas echouer en cas de serveur sql indisponible.

Tags

see

sql_get_charset()

pour tester l'utilisation d'un charset

sql_select()

Effectue une requête de selection

Parameters

$select : array<string|int, mixed>|string = []

Liste des champs a recuperer (Select)

$from : array<string|int, mixed>|string = []

Tables a consulter (From)

$where : array<string|int, mixed>|string = []

Conditions a remplir (Where)

$groupby : array<string|int, mixed>|string = []

critere de regroupement (Group by)

$orderby : array<string|int, mixed>|string = []

Tableau de classement (Order By)

$limit : string = ''

critere de limite (Limit)

$having : string|array<string|int, mixed> = []

Tableau ou chaine des des post-conditions à remplir (Having)

$serveur : string = ''

Le serveur sollicite (pour retrouver la connexion)

$option : bool|string = true

Peut avoir 3 valeurs :

• false -> ne pas l'exécuter mais la retourner,
• continue -> ne pas echouer en cas de serveur sql indisponible,
• true|array -> executer la requête. Le cas array est, pour une requete produite par le compilateur, un tableau donnnant le contexte afin d'indiquer le lieu de l'erreur au besoin

Tags

see

sql_fetch()

Pour boucler sur les resultats de cette fonction

used-by

sql_get_select()

used-by

sql_fetsel()

used-by

sql_allfetsel()

- Ressource SQL pour sql_fetch, si la requete est correcte
- false en cas d'erreur
- Chaine contenant la requete avec $option=false

sql_get_select()

Recupere la syntaxe de la requete select sans l'executer

Parameters

$select : array<string|int, mixed>|string = []

Liste des champs a recuperer (Select)

$from : array<string|int, mixed>|string = []

Tables a consulter (From)

$where : array<string|int, mixed>|string = []

Conditions a remplir (Where)

$groupby : array<string|int, mixed>|string = []

critere de regroupement (Group by)

$orderby : array<string|int, mixed>|string = []

Tableau de classement (Order By)

$limit : string = ''

critere de limite (Limit)

$having : string|array<string|int, mixed> = []

Tableau ou chaine des des post-conditions à remplir (Having)

$serveur : string = ''

Le serveur sollicite (pour retrouver la connexion)

Tags

uses

sql_select()

sql_countsel()

Retourne le nombre de lignes d'une sélection

Parameters

$from : array<string|int, mixed>|string = []

Tables a consulter (From)

$where : array<string|int, mixed>|string = []

Conditions a remplir (Where)

$groupby : array<string|int, mixed>|string = []

critere de regroupement (Group by)

$having : string|array<string|int, mixed> = []

Tableau ou chaine des des post-conditions à remplir (Having)

$serveur : string = ''

Le serveur sollicite (pour retrouver la connexion)

$option : bool|string = true

Peut avoir 3 valeurs :

• false -> ne pas l'executer mais la retourner,
• continue -> ne pas echouer en cas de serveur sql indisponible,
• true -> executer la requete.

Tags

see

sql_count()

example

if (sql_countsel('spip_mots_liens', array(
    "objet=".sql_quote('article'),
    "id_article=".sql_quote($id_article)) > 0) {
        // ...
}

sql_alter()

Modifie la structure de la base de données

Parameters

$q : string

La requête à exécuter (sans la préceder de 'ALTER ')

$serveur : string = ''

Le serveur sollicite (pour retrouver la connexion)

$option : bool|string = true

Peut avoir 2 valeurs :

• true : exécuter la requete
• 'continue' : ne pas échouer en cas de serveur sql indisponible

Tags

example

sql_alter('DROP COLUMN supprimer');

sql_fetch()

Retourne un enregistrement d'une selection

Parameters

$res : mixed

Ressource retournee par sql_select()

$serveur : string = ''

Le nom du connecteur

$option : bool|string = true

Peut avoir 2 valeurs :

• true -> executer la requete
• continue -> ne pas echouer en cas de serveur sql indisponible

sql_fetch_all()

Retourne tous les enregistrements d'une selection

Parameters

$res : mixed

Ressource retournee par sql_select()

$serveur : string = ''

Le nom du connecteur

$option : bool|string = true

Peut avoir 2 valeurs :

• true -> executer la requete
• continue -> ne pas echouer en cas de serveur sql indisponible

sql_seek()

Déplace le pointeur d'une ressource de sélection

Parameters

$res : mixed

Ressource issue de sql_select

$row_number : int

Numero de ligne sur laquelle placer le pointeur

$serveur : string = ''

Le nom du connecteur

$option : bool|string = true

Peut avoir 2 valeurs :

• true -> executer la requete
• continue -> ne pas echouer en cas de serveur sql indisponible

Tags

see

sql_skip()

Pour sauter des enregistrements

sql_listdbs()

Liste des bases de donnees accessibles

Parameters

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 2 valeurs :

• true -> executer la requete
• continue -> ne pas echouer en cas de serveur sql indisponible

sql_selectdb()

Demande d'utiliser d'une base de donnees

Parameters

$nom : string

Nom de la base a utiliser

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 2 valeurs :

• true -> executer la requete
• continue -> ne pas echouer en cas de serveur sql indisponible

sql_count()

Retourne le nombre de lignes d’une ressource de sélection obtenue avec `sql_select()`

Parameters

$res : object

Ressource SQL

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 2 valeurs :

• true -> executer la requete
• continue -> ne pas echouer en cas de serveur sql indisponible

Tags

see

sql_select()

see

sql_countsel()

sql_free()

Libère une ressource de résultat

Parameters

$res : object

Ressource de résultat

$serveur : string = ''

Nom de la connexion

$option : bool|string = true

Peut avoir 2 valeurs :

• true -> exécuter la requete
• continue -> ne pas échouer en cas de serveur SQL indisponible

sql_insert()

Insère une ligne dans une table

Parameters

$table : string

Nom de la table SQL

$noms : string

Liste des colonnes impactées,

$valeurs : string

Liste des valeurs,

$desc : array<string|int, mixed> = []

Tableau de description des colonnes de la table SQL utilisée (il sera calculé si nécessaire s'il n'est pas transmis).

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 3 valeurs :

• false : ne pas l'exécuter mais la retourner,
• true : exécuter la requête
• 'continue' : ne pas échouer en cas de serveur sql indisponible

Tags

see

sql_insertq()

see

sql_quote()

note

Cette fonction ne garantit pas une portabilité totale, et n'est là que pour faciliter des migrations de vieux scripts. Préférer sql_insertq.

sql_insertq()

Insère une ligne dans une table

Parameters

$table : string

Nom de la table SQL

$couples : array<string|int, mixed> = []

Tableau (nom => valeur)

$desc : array<string|int, mixed> = []

Tableau de description des colonnes de la table SQL utilisée (il sera calculé si nécessaire s'il n'est pas transmis).

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 3 valeurs :

• false : ne pas l'exécuter mais la retourner,
• true : exécuter la requête
• 'continue' : ne pas échouer en cas de serveur sql indisponible

Tags

see

sql_insert()

see

sql_insertq_multi()

see

sql_quote()

see

objet_inserer()

example

$titre = _request('titre');
$id = sql_insertq('spip_rubriques', array('titre' => $titre));

used-by

objet_inserer()

sql_insertq_multi()

Insère plusieurs lignes d'un coup dans une table

Parameters

$table : string

Nom de la table SQL

$couples : array<string|int, mixed> = []

Tableau de tableaux associatifs (nom => valeur)

$desc : array<string|int, mixed> = []

Tableau de description des colonnes de la table SQL utilisée (il sera calculé si nécessaire s'il n'est pas transmis).

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 3 valeurs :

• false : ne pas l'exécuter mais la retourner,
• true : exécuter la requête
• 'continue' : ne pas échouer en cas de serveur sql indisponible

Tags

see

sql_insertq()

sql_update()

Met à jour des enregistrements d'une table SQL

Parameters

$table : string

Nom de la table

$exp : array<string|int, mixed>

Couples (colonne => valeur)

$where : string|array<string|int, mixed> = ''

Conditions a remplir (Where)

$desc : array<string|int, mixed> = []

Tableau de description des colonnes de la table SQL utilisée (il sera calculé si nécessaire s'il n'est pas transmis).

$serveur : string = ''

Nom de la connexion

$option : bool|string = true

Peut avoir 3 valeurs :

• false : ne pas l'exécuter mais la retourner,
• true : exécuter la requête
• 'continue' : ne pas échouer en cas de serveur sql indisponible

Tags

see

sql_updateq()

sql_updateq()

Met à jour du contenu d’une table SQL

Parameters

$table : string

Nom de la table SQL

$exp : array<string|int, mixed>

Couples (colonne => valeur)

$where : array<string|int, mixed>|string = ''

Conditions à vérifier

$desc : array<string|int, mixed> = []

Tableau de description des colonnes de la table SQL utilisée (il sera calculé si nécessaire s'il n'est pas transmis).

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 3 valeurs :

• false : ne pas l'exécuter mais la retourner,
• true : exécuter la requête
• 'continue' : ne pas échouer en cas de serveur sql indisponible

Tags

see

sql_quote()

see

sql_update()

example

sql_updateq('table', array('colonne' => $valeur), 'id_table=' . intval($id_table));
sql_updateq("spip_auteurs", array("statut" => '6forum'), "id_auteur=$id_auteur") ;

note

sql_update() est presque toujours appelée sur des constantes ou des dates Cette fonction (sql_updateq) est donc plus utile que la précédente, d'autant qu'elle permet de gerer les différences de représentation des constantes.

sql_delete()

Supprime des enregistrements d'une table

Parameters

$table : string

Nom de la table SQL

$where : string|array<string|int, mixed> = ''

Conditions à vérifier

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 3 valeurs :

• false : ne pas l'exécuter mais la retourner,
• true : exécuter la requête
• 'continue' : ne pas échouer en cas de serveur sql indisponible

Tags

example

sql_delete('spip_articles', 'id_article='.sql_quote($id_article));

sql_replace()

Insère où met à jour une entrée d’une table SQL

Parameters

$table : string

Nom de la table SQL

$couples : array<string|int, mixed>

Couples colonne / valeur à modifier,

$desc : array<string|int, mixed> = []

Tableau de description des colonnes de la table SQL utilisée (il sera calculé si nécessaire s'il n'est pas transmis).

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 3 valeurs :

• false : ne pas l'exécuter mais la retourner,
• true : exécuter la requête
• 'continue' : ne pas échouer en cas de serveur sql indisponible

Tags

see

sql_insertq()

see

sql_updateq()

sql_replace_multi()

Insère où met à jour des entrées d’une table SQL

Parameters

$table : string

Nom de la table SQL

$tab_couples : array<string|int, mixed>

Tableau de tableau (colonne / valeur à modifier),

$desc : array<string|int, mixed> = []

Tableau de description des colonnes de la table SQL utilisée (il sera calculé si nécessaire s'il n'est pas transmis).

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 3 valeurs :

• false : ne pas l'exécuter mais la retourner,
• true : exécuter la requête
• 'continue' : ne pas échouer en cas de serveur sql indisponible

Tags

see

sql_insertq_multi()

see

sql_updateq()

see

sql_replace()

sql_drop_table()

Supprime une table SQL (structure et données)

Parameters

$table : string

Nom de la table

$exist : bool = false

true pour ajouter un test sur l'existence de la table, false sinon

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 3 valeurs :

• false : ne pas l'exécuter mais la retourner,
• true : exécuter la requête
• 'continue' : ne pas échouer en cas de serveur sql indisponible

Tags

see

sql_create()

see

sql_drop_view()

sql_drop_view()

Supprime une vue SQL

Parameters

$table : string

Nom de la vue SQL

$exist : bool = false

True pour ajouter un test d'existence avant de supprimer

$serveur : string = ''

Nom de la connexion

$option : bool|string = true

Peut avoir 3 valeurs :

• false : ne pas l'exécuter mais la retourner,
• true : exécuter la requête
• 'continue' : ne pas échouer en cas de serveur sql indisponible

Tags

see

sql_create_view()

see

sql_drop_table()

sql_showbase()

Retourne une ressource de la liste des tables de la base de données

Parameters

$spip : string = null

Filtre sur tables retournées

• NULL : retourne les tables SPIP uniquement (tables préfixées avec le préfixe de la connexion)
• '%' : retourne toutes les tables de la base

$serveur : string = ''

Le nom du connecteur

$option : bool|string = true

Peut avoir 3 valeurs :

• false -> ne pas l'executer mais la retourner,
• continue -> ne pas echouer en cas de serveur sql indisponible,
• true -> executer la requete.

Tags

see

sql_alltable()

used-by

sql_alltable()

sql_alltable()

Retourne la liste des tables SQL

Parameters

$spip : string = null

Filtre sur tables retournées

• NULL : retourne les tables SPIP uniquement (tables préfixées avec le préfixe de la connexion)
• '%' : retourne toutes les tables de la base

$serveur : string = ''

Le nom du connecteur

$option : bool|string = true

Peut avoir 3 valeurs :

• false -> ne pas l'executer mais la retourner,
• continue -> ne pas echouer en cas de serveur sql indisponible,
• true -> executer la requete.

Tags

uses

sql_showbase()

sql_showtable()

Retourne la liste (et description) des colonnes et key d’une table SQL

Parameters

$table : string

Nom de la table SQL

$table_spip : bool = false

true pour remplacer automatiquement « spip » par le vrai préfixe de table

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 3 valeurs :

• false : ne pas l'exécuter mais la retourner,
• 'continue' : ne pas échouer en cas de serveur SQL indisponible,
• true : exécuter la requete.

Tags

note

Dans la plupart des situations, il vaut mieux utiliser directement la fonction trouver_table() qui possède un cache.

see

base_trouver_table_dist()

sql_table_exists()

Teste si une table SQL existe ou non dans la base

Parameters

$table : string

Nom de la table

$table_spip : bool = true

true pour remplacer automatiquement « spip » par le vrai préfixe de table

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 3 valeurs :

• false : ne pas l'exécuter mais la retourner,
• true : exécuter la requête
• 'continue' : ne pas échouer en cas de serveur sql indisponible

sql_create()

Crée une table dans la base de données

Parameters

$nom : string

Nom de la table

$champs : array<string|int, mixed>

Couples (colonne => description)

$cles : array<string|int, mixed> = []

Clé (nomdelaclef => champ)

$autoinc : bool = false

Si un champ est clef primaire est numérique alors la propriété d’autoincrémentation sera ajoutée

$temporary : bool = false

true pour créer une table temporaire (au sens SQL)

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 3 valeurs :

• false : ne pas l'exécuter mais la retourner,
• 'continue' : ne pas échouer en cas de serveur SQL indisponible,
• true : exécuter la requete.

Tags

example

sql_create("spip_tables",
  array(
      "id_table" => "bigint(20) NOT NULL default '0'",
      "colonne1"=> "varchar(3) NOT NULL default 'oui'",
      "colonne2"=> "text NOT NULL default ''"
   ),
   array(
      'PRIMARY KEY' => "id_table",
      'KEY colonne1' => "colonne1"
   )
);

sql_create_base()

Crée une base de données

Parameters

$nom : string

Nom de la base (sans l'extension de fichier si gestionnaire SQLite)

$serveur : string = ''

Nom de la connexion

$option : bool|string = true

Peut avoir 3 valeurs :

• false : ne pas l'exécuter mais la retourner,
• true : exécuter la requête
• 'continue' : ne pas échouer en cas de serveur sql indisponible

sql_create_view()

Crée une vue SQL

Parameters

$nom : string

Nom de la vue

$select_query : string

Une requête SELECT, idéalement crée avec sql_get_select(...)

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 3 valeurs :

• false : ne pas l'exécuter mais la retourner,
• true : exécuter la requête
• 'continue' : ne pas échouer en cas de serveur sql indisponible

Tags

see

sql_drop_view()

see

sql_create()

see

sql_get_select()

Pour obtenir le texte de la requête SELECT pour créer la vue.

sql_multi()

Retourne l'instruction SQL pour obtenir le texte d'un champ contenant une balise `<multi>` dans la langue indiquée

Parameters

$sel : string

Colonne ayant le texte

$lang : string

Langue à extraire

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 2 valeurs :

• true : exécuter la requête
• 'continue' : ne pas échouer en cas de serveur sql indisponible

Tags

example

$t = sql_multi('chapo', 'fr');

sql_error()

Retourne la dernière erreur connue

Parameters

$serveur : string = ''

Nom du connecteur

sql_errno()

Retourne le numéro de la derniere erreur connue

Parameters

$serveur : string = ''

Nom du connecteur

sql_explain()

Retourne une explication de requête (Explain) SQL

Parameters

$q : string

texte de la requête

$serveur : string = ''

Nom de la connexion

$option : bool|string = true

Peut avoir 3 valeurs :

• false : ne pas l'exécuter mais la retourner,
• true : exécuter la requête
• 'continue' : ne pas échouer en cas de serveur sql indisponible

sql_optimize()

Optimise une table SQL

Parameters

$table : string

Nom de la table

$serveur : string = ''

Nom de la connexion

$option : bool = true

Peut avoir 3 valeurs :

• false : ne pas l'exécuter mais la retourner,
• true : exécuter la requête
• 'continue' : ne pas échouer en cas de serveur sql indisponible

sql_repair()

Répare une table SQL

Parameters

$table : string

Nom de la table SQL

$serveur : string = ''

Nom de la connexion

$option : bool|string = true

Peut avoir 3 valeurs :

• false : ne pas l'exécuter mais la retourner,
• true : exécuter la requête
• 'continue' : ne pas échouer en cas de serveur sql indisponible

sql_query()

Exécute une requête SQL

Parameters

$ins : string

Requête

$serveur : string = ''

Nom de la connexion

$option : bool|string = true

Peut avoir 3 valeurs :

• false : ne pas l'exécuter mais la retourner,
• true : exécuter la requête
• 'continue' : ne pas échouer en cas de serveur sql indisponible

sql_fetsel()

Retourne la première ligne d'une sélection

Parameters

$select : array<string|int, mixed>|string = []

Liste des champs a recuperer (Select)

$from : array<string|int, mixed>|string = []

Tables a consulter (From)

$where : array<string|int, mixed>|string = []

Conditions a remplir (Where)

$groupby : array<string|int, mixed>|string = []

critere de regroupement (Group by)

$orderby : array<string|int, mixed>|string = []

Tableau de classement (Order By)

$limit : string = ''

critere de limite (Limit)

$having : string|array<string|int, mixed> = []

Tableau ou chaine des des post-conditions à remplir (Having)

$serveur : string = ''

Le serveur sollicite (pour retrouver la connexion)

$option : bool|string = true

Peut avoir 3 valeurs :

• true -> executer la requete.
• continue -> ne pas echouer en cas de serveur sql indisponible.
• false -> ne pas l'executer mais la retourner.

Tags

example

$art = sql_fetsel(array('id_rubrique','id_secteur'), 'spip_articles', 'id_article='.sql_quote($id_article));
$id_rubrique = $art['id_rubrique'];

uses

sql_select()

uses

sql_fetch()

see

sql_getfetsel()

used-by

sql_getfetsel()

sql_allfetsel()

Retourne le tableau de toutes les lignes d'une selection

Parameters

$select : array<string|int, mixed>|string = []

Liste des champs a recuperer (Select)

$from : array<string|int, mixed>|string = []

Tables a consulter (From)

$where : array<string|int, mixed>|string = []

Conditions a remplir (Where)

$groupby : array<string|int, mixed>|string = []

critere de regroupement (Group by)

$orderby : array<string|int, mixed>|string = []

Tableau de classement (Order By)

$limit : string = ''

critere de limite (Limit)

$having : string|array<string|int, mixed> = []

Tableau ou chaine des des post-conditions à remplir (Having)

$serveur : string = ''

Le serveur sollicite (pour retrouver la connexion)

$option : bool|string = true

Peut avoir 3 valeurs :

• true -> executer la requete.
• continue -> ne pas echouer en cas de serveur sql indisponible.
• false -> ne pas l'executer mais la retourner.

Tags

example

$rubs = sql_allfetsel('id_rubrique', 'spip_articles', 'id_secteur='.sql_quote($id_secteur));
// $rubs = array(array('id_rubrique'=>1), array('id_rubrique'=>3, ...)

uses

sql_select()

uses

sql_fetch()

array(
  array('id_rubrique' => 1, 'id_secteur' => 2)
  array('id_rubrique' => 4, 'id_secteur' => 2)
  ...
)

sql_getfetsel()

Retourne un unique champ d'une selection

Parameters

$select : array<string|int, mixed>|string

Liste des champs à récupérer (Select)

$from : array<string|int, mixed>|string = []

Tables à consulter (From)

$where : array<string|int, mixed>|string = []

Conditions à remplir (Where)

$groupby : array<string|int, mixed>|string = []

Critère de regroupement (Group by)

$orderby : array<string|int, mixed>|string = []

Tableau de classement (Order By)

$limit : string = ''

Critère de limite (Limit)

$having : string|array<string|int, mixed> = []

Tableau ou chaine des des post-conditions à remplir (Having)

$serveur : string = ''

Le serveur sollicité (pour retrouver la connexion)

$option : bool|string = true

Peut avoir 3 valeurs :

• true -> executer la requete.
• continue -> ne pas echouer en cas de serveur sql indisponible.
• false -> ne pas l'executer mais la retourner.

Tags

example

$id_rubrique = sql_getfetsel('id_rubrique', 'spip_articles', 'id_article='.sql_quote($id_article));

uses

sql_fetsel()

sql_version()

Retourne le numero de version du serveur SQL

Parameters

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 2 valeurs :

• true pour executer la requete.
• continue pour ne pas echouer en cas de serveur sql indisponible.

sql_preferer_transaction()

Informe si le moteur SQL prefere utiliser des transactions

Parameters

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 2 valeurs :

• true pour executer la requete.
• continue pour ne pas echouer en cas de serveur sql indisponible.

Tags

example

if (sql_preferer_transaction()) {
  sql_demarrer_transaction();
}

see

sql_demarrer_transaction()

see

sql_terminer_transaction()

sql_demarrer_transaction()

Démarre une transaction

Parameters

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 3 valeurs :

• true pour executer la requete.
• continue pour ne pas echouer en cas de serveur sql indisponible.
• false pour obtenir le code de la requete

Tags

see

sql_terminer_transaction()

Pour cloturer la transaction

sql_terminer_transaction()

Termine une transaction

Parameters

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 3 valeurs :

• true pour executer la requete.
• continue pour ne pas echouer en cas de serveur sql indisponible.
• false pour obtenir le code de la requete

Tags

see

sql_demarrer_transaction()

Pour demarrer une transaction

sql_hex()

Prépare une chaine hexadécimale

Parameters

$val : string

Chaine hexadécimale

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 2 valeurs :

• true pour exécuter la demande.
• 'continue' pour ne pas échouer en cas de serveur SQL indisponible.

sql_quote()

Echapper du contenu

Parameters

$val : string

Chaine à echapper

$serveur : string = ''

Nom du connecteur

$type : string = ''

Peut contenir une declaration de type de champ SQL. Exemple : int NOT NULL qui sert alors aussi à calculer le type d'échappement

sql_date_proche()

Tester si une date est proche de la valeur d'un champ

Parameters

$champ : string

Nom du champ a tester

$interval : int

Valeur de l'intervalle : -1, 4, ...

$unite : string

Utité utilisée (DAY, MONTH, YEAR, ...)

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 2 valeurs :

• true pour exécuter la demande.
• 'continue' pour ne pas échouer en cas de serveur SQL indisponible.

sql_in_quote()

Retourne une expression IN pour le gestionnaire de base de données

Parameters

$champ : string

Colonne SQL sur laquelle appliquer le test

$valeurs : array<string|int, mixed>

Liste des valeurs possibles (séparés par des virgules si string) le format string est historique et n'est accepte que pour des ids numeriques car autrement la securite ne peut etre garantie

$not : string = ''

• '' sélectionne les éléments correspondant aux valeurs
• 'NOT' inverse en sélectionnant les éléments ne correspondant pas aux valeurs

$serveur : string = ''

Nom du connecteur

$type : string = ''

type du champ pour le sql_quote

$option : bool|string = true

Peut avoir 3 valeurs :

• 'continue' -> ne pas echouer en cas de serveur sql indisponible
• true ou false -> retourne l'expression

Tags

example

sql_in_quote('id_rubrique', array(3,4,5)) retourne approximativement «id_rubrique IN (3,4,5)» selon ce qu'attend le gestionnaire de base de donnée du connecteur en cours.

sql_in()

shorthand historique qui ne permet pas de specifier le type et qui accepte une string pour $valeurs

Parameters

$champ : string

$valeurs : array<string|int, mixed>|string

Liste des valeurs possibles (séparés par des virgules si string) le format string est historique et n'est accepte que pour des ids numeriques car autrement la securite ne peut etre garantie

$not : string = ''

$serveur : string = ''

$option : bool = true

Tags

see

sql_in_quote

sql_in_select()

Retourne une expression IN pour le gestionnaire de base de données à partir d'une sélection de données

Parameters

$in : string

Colonne SQL sur laquelle appliquer le test

$select : array<string|int, mixed>|string

Liste des champs à récupérer (Select). La donnée extraite est le premier élément de la sélection.

$from : array<string|int, mixed>|string = []

Tables a consulter (From)

$where : array<string|int, mixed>|string = []

Conditions a remplir (Where)

$groupby : array<string|int, mixed>|string = []

critere de regroupement (Group by)

$orderby : array<string|int, mixed>|string = []

Tableau de classement (Order By)

$limit : string = ''

critere de limite (Limit)

$having : string|array<string|int, mixed> = []

Tableau ou chaine des des post-conditions à remplir (Having)

$serveur : string = ''

Nom du connecteur

Tags

see

sql_select()

see

sql_in()

note

Penser à dire dans la description du serveur s'il accepte les requêtes imbriquées afin d'optimiser ca

sql_skip()

Implémentation sécurisée du saut en avant.

Parameters

$res : object

Ressource issue d'une selection sql_select

$pos : int

position courante

$saut : int

saut demande

$count : int

position maximale (nombre de resultat de la requete OU position qu'on ne veut pas depasser)

$serveur : string = ''

Nom du connecteur

$option : bool|string = true

Peut avoir 2 valeurs :

• true -> executer la requete
• continue -> ne pas echouer en cas de serveur sql indisponible

Tags

see

sql_seek()

sql_test_int()

Teste qu'une description de champ SQL est de type entier

Parameters

$type : string

Description de la colonne SQL

$serveur : string = ''

Nom du connecteur

$option : bool = true

Inutilisé

Tags

see

sql_test_date()

pour tester les champs de date

sql_test_date()

Teste qu'une description de champ SQL est de type entier

Parameters

$type : string

Description de la colonne SQL

$serveur : string = ''

Nom du connecteur

$option : bool = true

Inutilisé

Tags

see

sql_test_int()

pour tester les champs d'entiers

sql_format_date()

Formate une date

Parameters

$annee : int = 0

Annee

$mois : int = 0

Numero du mois

$jour : int = 0

Numero du jour dans le mois

$h : int = 0

Heures

$m : int = 0

Minutes

$s : int = 0

Secondes

$serveur : string = ''

Le serveur sollicite (pour retrouver la connexion)

prefixer_table_spip()

Corrige le nom d’une table SQL en utilisant le bon préfixe

Parameters

$table : string

$prefixe : string