3 /***************************************************************************\
4 * SPIP, Systeme de publication pour l'internet *
6 * Copyright (c) 2001-2019 *
7 * Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James *
9 * Ce programme est un logiciel libre distribue sous licence GNU/GPL. *
10 * Pour plus de details voir le fichier COPYING.txt ou l'aide en ligne. *
11 \***************************************************************************/
14 * Création ou mise à jour des tables
16 * @package SPIP\Core\Installation
18 if (!defined('_ECRIRE_INC_VERSION')) {
22 include_spip('inc/acces');
23 include_spip('base/objets');
24 include_spip('base/typedoc');
25 include_spip('base/abstract_sql');
28 * Determiner le flag autoinc pour une table
29 * en fonction de si c'est une table principale
31 * @param string $table
35 function base_determine_autoinc($table, $desc = array()) {
36 if ($t = lister_tables_principales() and isset($t[$table])) {
38 } elseif ($t = lister_tables_auxiliaires() and isset($t[$table])) {
41 // essayer de faire au mieux !
42 $autoinc = (isset($desc['key']['PRIMARY KEY'])
43 and strpos($desc['key']['PRIMARY KEY'], ',') === false
44 and strpos($desc['field'][$desc['key']['PRIMARY KEY']], 'default') === false);
52 * ou ajouter les champs manquants si elle existe déjà
54 * @param string $table
56 * @param bool|string $autoinc
57 * 'auto' pour detecter automatiquement si le champ doit etre autoinc ou non
58 * en fonction de la table
59 * @param bool $upgrade
60 * @param string $serveur
63 function creer_ou_upgrader_table($table, $desc, $autoinc, $upgrade = false, $serveur = '') {
64 #spip_log("creer_ou_upgrader_table table=$table autoinc=$autoinc upgrade=$upgrade","dbinstall"._LOG_INFO_IMPORTANTE);
65 $sql_desc = $upgrade ?
sql_showtable($table, true, $serveur) : false;
66 #if (!$sql_desc) $sql_desc = false;
67 #spip_log("table=$table sql_desc:$sql_desc","dbinstall"._LOG_INFO_IMPORTANTE);
69 if ($autoinc === 'auto') {
70 $autoinc = base_determine_autoinc($table, $desc);
72 #spip_log("sql_create $table autoinc=$autoinc","dbinstall"._LOG_INFO_IMPORTANTE);
73 if (isset($desc['field']) and isset($desc['key'])) {
74 sql_create($table, $desc['field'], $desc['key'], $autoinc, false, $serveur);
76 // verifier la bonne installation de la table (php-fpm es-tu la ?)
77 $sql_desc = sql_showtable($table, true, $serveur);
78 #if (!$sql_desc) $sql_desc = false;
79 #spip_log("Resultat table=$table sql_desc:$sql_desc","dbinstall"._LOG_INFO_IMPORTANTE);
81 // on retente avec un sleep ?
83 sql_create($table, $desc['field'], $desc['key'], $autoinc, false, $serveur);
84 $sql_desc = sql_showtable($table, true, $serveur);
85 #if (!$sql_desc) $sql_desc = false;
86 #spip_log("Resultat table=$table sql_desc:$sql_desc","dbinstall"._LOG_INFO_IMPORTANTE);
88 spip_log("Echec creation table $table", "maj" . _LOG_CRITIQUE
);
92 #spip_log("sql_alter $table ... (on s'en fiche)","dbinstall"._LOG_INFO_IMPORTANTE);
93 // ajouter les champs manquants
94 // on ne supprime jamais les champs, car c'est dangereux
95 // c'est toujours a faire manuellement
97 if (isset($desc['field'])) {
98 foreach ($desc['field'] as $field => $type) {
99 if (!isset($sql_desc['field'][$field])) {
100 sql_alter("TABLE $table ADD $field $type" . ($last ?
" AFTER $last" : ""), $serveur);
105 if (isset($desc['key'])) {
106 foreach ($desc['key'] as $key => $type) {
107 // Ne pas oublier les cas des cles non nommees dans la declaration et qui sont retournees
108 // par le showtable sous la forme d'un index de tableau "KEY $type" et non "KEY"
109 if (!isset($sql_desc['key'][$key]) and !isset($sql_desc['key']["$key $type"])) {
110 sql_alter("TABLE $table ADD $key ($type)", $serveur);
120 * Creer ou mettre à jour un ensemble de tables
121 * en fonction du flag `$up`
123 * @uses creer_ou_upgrader_table()
125 * @param array $tables_inc
126 * tables avec autoincrement sur la cle primaire
127 * @param $tables_noinc
128 * tables sans autoincrement sur la cle primaire
129 * @param bool|array $up
130 * upgrader (true) ou creer (false)
131 * si un tableau de table est fournie, seules l'intersection de ces tables
132 * et des $tables_inc / $tables_noinc seront traitees
133 * @param string $serveur
137 function alterer_base($tables_inc, $tables_noinc, $up = false, $serveur = '') {
143 if (!is_array($up)) {
147 foreach ($tables_inc as $k => $v) {
148 if (!$old or in_array($k, $up)) {
149 creer_ou_upgrader_table($k, $v, true, $old, $serveur);
153 foreach ($tables_noinc as $k => $v) {
154 if (!$old or in_array($k, $up)) {
155 creer_ou_upgrader_table($k, $v, false, $old, $serveur);
161 * Créer une base de données
162 * à partir des tables principales et auxiliaires
164 * Lorsque de nouvelles tables ont été déclarées, cette fonction crée les tables manquantes.
165 * mais ne crée pas des champs manquant d'une table déjà présente.
166 * Pour cela, c’est `maj_tables()` qu’il faut appeler.
170 * @uses alterer_base()
172 * @param string $serveur
175 function creer_base($serveur = '') {
177 // Note: les mises a jour reexecutent ce code pour s'assurer
178 // de la conformite de la base
179 // pas de panique sur "already exists" et "duplicate entry" donc.
182 lister_tables_principales(),
183 lister_tables_auxiliaires(),
190 * Mettre à jour une liste de tables
192 * Fonction facilitatrice utilisée pour les maj de base
195 * Elle permet de créer les champs manquants d'une table déjà présente.
199 * @uses alterer_base()
201 * @param array $upgrade_tables
202 * @param string $serveur
205 function maj_tables($upgrade_tables = array(), $serveur = '') {
207 lister_tables_principales(),
208 lister_tables_auxiliaires(),