Fichier ecrire/base/connect_sql.php
Utilitaires indispensables autour des serveurs SQL
Source
Liste des constantes
Liste des fonctions
Échappe une valeur (num, string, array) pour en faire une chaîne pour PHP.
Un array(1,'a',"a'")
renvoie la chaine "'1','a','a\''"
Paramètres
-
\num | string | array $a
Valeur à échapper
Retour
-
string
Valeur échappée.
Note
-
L'usage comme échappement SQL est déprécié, à remplacer par sql_quote().
Source
On renvoi la query sans textes et les textes séparés, dans leur ordre d'apparition dans la query
Paramètres
-
string $query
Retour
-
array
Voir également
Source
Paramètres
-
string $query
-
array $textes
Retour
-
string
Voir également
Source
On charge le fichier config/$serveur
($serveur='connect'
pour le principal)
qui est censé initaliser la connexion en appelant la fonction spip_connect_db
laquelle met dans la globale db_ok
la description de la connexion.
On la mémorise dans un tableau pour permettre plusieurs serveurs.
À l'installation, il faut simuler l'existence de ce fichier.
Paramètres
-
string $serveur = ''
Nom du connecteur
-
string $version = ''
Version de l'API SQL
Retour
-
boolean | array
- false si la connexion a échouée,
- tableau décrivant la connexion sinon
Utilise
Source
Il contient un appel direct à cette fonction avec comme arguments les identifants de connexion.
Si la connexion reussit, la globale db_ok
mémorise sa description.
C'est un tableau également retourné en valeur, pour les appels
lors de l'installation.
Paramètres
-
string $host
Adresse du serveur de base de données
-
string $port
Port utilisé pour la connexion
-
string $login
Identifiant de connexion à la base de données
-
string $pass
Mot de passe pour cet identifiant
-
string $db = ''
Nom de la base de données à utiliser
-
string $type = 'mysql'
Type de base de données tel que 'mysql', 'sqlite3' (cf ecrire/req/)
-
string $prefixe = ''
Préfixe des tables SPIP
-
string $auth = ''
Type d'authentification (cas si 'ldap')
-
string $charset = ''
Charset de la connexion SQL (optionnel)
Retour
-
array
Description de la connexion
Source
Retourner le charset donnée par la table principale mais vérifier que le fichier de connexion n'est pas trop vieux
Paramètres
-
array $connexion
Description de la connexion
-
string $charset_sql_connexion = ''
charset de connexion fourni dans l'appal a spip_connect_db
Retour
-
string | boolean | integer
- false si pas de charset connu pour la connexion
- -1 charset non renseigné
- nom du charset sinon
Utilisé par
Note
-
Version courante = 0.8
- La version 0.8 indique un charset de connexion comme 9e arg
- La version 0.7 indique un serveur d'authentification comme 8e arg
- La version 0.6 indique le prefixe comme 7e arg
-
La version 0.5 indique le serveur comme 6e arg
La version 0.0 (non numerotée) doit être refaite par un admin. Les autres fonctionnent toujours, même si : - la version 0.1 est moins performante que la 0.2
- la 0.2 fait un include_ecrire('inc_db_mysql.php3').
Source
Cette fonction ne doit être appelée qu'à travers la fonction sql_serveur définie dans base/abstract_sql
Elle existe en tant que gestionnaire de versions, connue seulement des convertisseurs automatiques
Paramètres
-
string $version
Numéro de version de l'API SQL
-
string $ins = ''
Instruction de l'API souhaitée, tel que 'allfetsel'
-
string $serveur = ''
Nom du connecteur
-
boolean $continue = false
true pour continuer même si le serveur SQL ou l'instruction est indisponible
Retour
-
array | boolean | string
- string : nom de la fonction à utiliser,
- false : si la connexion a échouée
- array : description de la connexion, si l'instruction sql est indisponible pour cette connexion
Source
Paramètres
-
string $serveur = ''
Nom du connecteur de bdd utilisé
Source
Dépréciées
Fonction présente pour compatibilité
Paramètres
-
string $serveur = ''
Nom du connecteur
Retour
-
array
Utilise
Deprecated
-
Utiliser l'authentification LDAP de auth/ldap
Source
Paramètres
-
string $query
Texte de la requête
-
string $serveur = ''
Nom du connecteur pour la base de données
Retour
-
boolean | mixed
- false si on ne peut pas exécuter la requête
- indéfini sinon.
Voir également
Note
-
Ne génère pas d’erreur fatale si la connexion à la BDD n’existe pas
Deprecated
-
Pour compatibilité. Utiliser
sql_query()
ou l'APIsql_*
.
Source
Paramètres
-
string $x
Table de destination
-
string $y
Objet source
Retour
-
array | string
- array : Description de la table de jointure si connue
- chaîne vide si non trouvé.
Deprecated
-
Utiliser l'API editer_liens ou les tables de liaisons spip_xx_liens ou spip_yy_liens selon.