Installation
Table of Contents
Functions
- base_determine_autoinc() : bool
- Determiner le flag autoinc pour une table en fonction de si c'est une table principale
- creer_ou_upgrader_table() : void
- Créer une table, ou ajouter les champs manquants si elle existe déjà
- alterer_base() : void
- Creer ou mettre à jour un ensemble de tables en fonction du flag `$up`
- creer_base() : void
- Créer une base de données à partir des tables principales et auxiliaires
- maj_tables() : void
- Mettre à jour une liste de tables
- install_fichier_connexion() : void
- Écrit un fichier PHP nécessitant SPIP
- analyse_fichier_connection() : array<string|int, mixed>
- Analyse un fichier de connexion à une base de données
- bases_referencees() : array<string|int, mixed>
- Liste les connecteurs aux bases SQL disponibles
- install_mode_appel() : mixed
- tester_compatibilite_hebergement() : mixed
- info_etape() : mixed
- bouton_suivant() : string
- Retourne le code HTML d'un bouton `suivant>>` pour les phases d'installation
- info_progression_etape() : mixed
- fieldset() : mixed
- fieldset_champs() : mixed
- install_select_serveur() : mixed
- install_connexion_form() : mixed
- predef_ou_cache() : mixed
- install_etape_liste_bases() : mixed
- install_propager() : mixed
Functions
base_determine_autoinc()
Determiner le flag autoinc pour une table en fonction de si c'est une table principale
base_determine_autoinc(string $table[, array<string|int, mixed> $desc = [] ]) : bool
Parameters
- $table : string
- $desc : array<string|int, mixed> = []
Return values
boolcreer_ou_upgrader_table()
Créer une table, ou ajouter les champs manquants si elle existe déjà
creer_ou_upgrader_table(string $table, array<string|int, mixed> $desc, bool|string $autoinc[, bool $upgrade = false ][, string $serveur = '' ]) : void
Parameters
- $table : string
- $desc : array<string|int, mixed>
- $autoinc : bool|string
-
'auto' pour detecter automatiquement si le champ doit etre autoinc ou non en fonction de la table
- $upgrade : bool = false
- $serveur : string = ''
alterer_base()
Creer ou mettre à jour un ensemble de tables en fonction du flag `$up`
alterer_base(array<string|int, mixed> $tables_inc, $tables_noinc[, bool|array<string|int, mixed> $up = false ][, string $serveur = '' ]) : void
Parameters
- $tables_inc : array<string|int, mixed>
-
tables avec autoincrement sur la cle primaire
- $tables_noinc :
-
tables sans autoincrement sur la cle primaire
- $up : bool|array<string|int, mixed> = false
-
upgrader (true) ou creer (false) si un tableau de table est fournie, seules l'intersection de ces tables et des $tables_inc / $tables_noinc seront traitees
- $serveur : string = ''
-
serveur sql
Tags
creer_base()
Créer une base de données à partir des tables principales et auxiliaires
creer_base([string $serveur = '' ]) : void
Lorsque de nouvelles tables ont été déclarées, cette fonction crée les tables manquantes.
mais ne crée pas des champs manquant d'une table déjà présente.
Pour cela, c’est maj_tables()
qu’il faut appeler.
Parameters
- $serveur : string = ''
Tags
maj_tables()
Mettre à jour une liste de tables
maj_tables([array<string|int, mixed> $upgrade_tables = [] ][, string $serveur = '' ]) : void
Fonction facilitatrice utilisée pour les maj de base dans les plugins.
Elle permet de créer les champs manquants d'une table déjà présente.
Parameters
- $upgrade_tables : array<string|int, mixed> = []
- $serveur : string = ''
Tags
install_fichier_connexion()
Écrit un fichier PHP nécessitant SPIP
install_fichier_connexion(string $nom, string $texte) : void
Écrit le texte transmis dans un fichier PHP. Cette fonction ajoute les entêtes PHP et le test de sécurité vérifiant que SPIP est chargé.
Parameters
- $nom : string
-
Chemin du fichier à créer
- $texte : string
-
Code source du fichier (sans l'ouverture/fermeture PHP)
Tags
analyse_fichier_connection()
Analyse un fichier de connexion à une base de données
analyse_fichier_connection(string $file) : array<string|int, mixed>
Le fichier contient normalement le résultat de la fonction install_connexion(). L'analyse tient également compte des syntaxes des versions précédentes.
Parameters
- $file : string
-
Chemin du fichier de connexion à analyser
Return values
array<string|int, mixed> —Tableau des informations sur la connexion
bases_referencees()
Liste les connecteurs aux bases SQL disponibles
bases_referencees([string $exclu = '' ]) : array<string|int, mixed>
Dans le code SPIP ces connecteurs sont souvent appelés $connect ou $serveur
Parameters
- $exclu : string = ''
-
Exclure un connecteur particulier (nom du fichier)
Tags
Return values
array<string|int, mixed> —Liste des noms de connecteurs
install_mode_appel()
install_mode_appel(mixed $server_db[, mixed $tout = true ]) : mixed
Parameters
- $server_db : mixed
- $tout : mixed = true
tester_compatibilite_hebergement()
tester_compatibilite_hebergement() : mixed
info_etape()
info_etape(mixed $titre[, mixed $complement = '' ]) : mixed
Parameters
- $titre : mixed
- $complement : mixed = ''
bouton_suivant()
Retourne le code HTML d'un bouton `suivant>>` pour les phases d'installation
bouton_suivant([string $code = '' ]) : string
Parameters
- $code : string = ''
-
texte du bouton
Return values
string —Code HTML du bouton
info_progression_etape()
info_progression_etape(mixed $en_cours, mixed $phase, mixed $dir[, mixed $erreur = false ]) : mixed
Parameters
- $en_cours : mixed
- $phase : mixed
- $dir : mixed
- $erreur : mixed = false
fieldset()
fieldset(mixed $legend[, mixed $champs = [] ][, mixed $apres = '' ][, mixed $avant = '' ]) : mixed
Parameters
- $legend : mixed
- $champs : mixed = []
- $apres : mixed = ''
- $avant : mixed = ''
fieldset_champs()
fieldset_champs([mixed $champs = [] ]) : mixed
Parameters
- $champs : mixed = []
install_select_serveur()
install_select_serveur() : mixed
install_connexion_form()
install_connexion_form(mixed $db, mixed $login, mixed $pass, mixed $predef, mixed $hidden, mixed $etape[, mixed $jquery = true ]) : mixed
Parameters
- $db : mixed
- $login : mixed
- $pass : mixed
- $predef : mixed
- $hidden : mixed
- $etape : mixed
- $jquery : mixed = true
predef_ou_cache()
predef_ou_cache(mixed $adresse_db, mixed $login_db, mixed $pass_db, mixed $server_db) : mixed
Parameters
- $adresse_db : mixed
- $login_db : mixed
- $pass_db : mixed
- $server_db : mixed
install_etape_liste_bases()
install_etape_liste_bases(mixed $server_db, mixed $login_db[, mixed $disabled = [] ]) : mixed
Parameters
- $server_db : mixed
- $login_db : mixed
- $disabled : mixed = []
install_propager()
install_propager(mixed $hidden) : mixed
Parameters
- $hidden : mixed