3 /* *************************************************************************\
4 * SPIP, Systeme de publication pour l'internet *
6 * Copyright (c) 2001-2014 *
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 * Ce fichier contient les fonctions gerant
15 * les instructions SQL pour MySQL
17 * @package SPIP\SQL\MySQL
20 if (!defined('_ECRIRE_INC_VERSION')) return;
22 // fonction pour la premiere connexion a un serveur MySQL
24 // http://doc.spip.org/@req_mysql_dist
31 * @param string $prefixe
35 function req_mysql_dist($host, $port, $login, $pass, $db='', $prefixe='') {
36 if (!charger_php_extension('mysql')) return false;
37 if ($port > 0) $host = "$host:$port";
38 $link = @mysql_connect
($host, $login, $pass, true);
40 spip_log('Echec mysql_connect. Erreur : ' . mysql_error(),'mysql.'._LOG_HS
);
48 $ok = spip_mysql_selectdb($db);
49 if (defined('_MYSQL_SET_SQL_MODE')
50 OR defined('_MYSQL_SQL_MODE_TEXT_NOT_NULL') // compatibilite
52 mysql_query($last = "set sql_mode=''");
54 spip_log("Connexion vers $host, base $db, prefixe $prefixe " . ($ok ?
"operationnelle sur $link" : 'impossible'), _LOG_DEBUG
);
56 return !$ok ?
false : array(
59 'prefixe' => $prefixe ?
$prefixe : $db,
60 'link' => $GLOBALS['mysql_rappel_connexion'] ?
$link : false,
64 $GLOBALS['spip_mysql_functions_1'] = array(
65 'alter' => 'spip_mysql_alter',
66 'count' => 'spip_mysql_count',
67 'countsel' => 'spip_mysql_countsel',
68 'create' => 'spip_mysql_create',
69 'create_base' => 'spip_mysql_create_base',
70 'create_view' => 'spip_mysql_create_view',
71 'date_proche' => 'spip_mysql_date_proche',
72 'delete' => 'spip_mysql_delete',
73 'drop_table' => 'spip_mysql_drop_table',
74 'drop_view' => 'spip_mysql_drop_view',
75 'errno' => 'spip_mysql_errno',
76 'error' => 'spip_mysql_error',
77 'explain' => 'spip_mysql_explain',
78 'fetch' => 'spip_mysql_fetch',
79 'seek' => 'spip_mysql_seek',
80 'free' => 'spip_mysql_free',
81 'hex' => 'spip_mysql_hex',
82 'in' => 'spip_mysql_in',
83 'insert' => 'spip_mysql_insert',
84 'insertq' => 'spip_mysql_insertq',
85 'insertq_multi' => 'spip_mysql_insertq_multi',
86 'listdbs' => 'spip_mysql_listdbs',
87 'multi' => 'spip_mysql_multi',
88 'optimize' => 'spip_mysql_optimize',
89 'query' => 'spip_mysql_query',
90 'quote' => 'spip_mysql_quote',
91 'replace' => 'spip_mysql_replace',
92 'replace_multi' => 'spip_mysql_replace_multi',
93 'repair' => 'spip_mysql_repair',
94 'select' => 'spip_mysql_select',
95 'selectdb' => 'spip_mysql_selectdb',
96 'set_charset' => 'spip_mysql_set_charset',
97 'get_charset' => 'spip_mysql_get_charset',
98 'showbase' => 'spip_mysql_showbase',
99 'showtable' => 'spip_mysql_showtable',
100 'update' => 'spip_mysql_update',
101 'updateq' => 'spip_mysql_updateq',
103 // association de chaque nom http d'un charset aux couples MySQL
105 'cp1250'=>array('charset'=>'cp1250','collation'=>'cp1250_general_ci'),
106 'cp1251'=>array('charset'=>'cp1251','collation'=>'cp1251_general_ci'),
107 'cp1256'=>array('charset'=>'cp1256','collation'=>'cp1256_general_ci'),
108 'iso-8859-1'=>array('charset'=>'latin1','collation'=>'latin1_swedish_ci'),
109 //'iso-8859-6'=>array('charset'=>'latin1','collation'=>'latin1_swedish_ci'),
110 'iso-8859-9'=>array('charset'=>'latin5','collation'=>'latin5_turkish_ci'),
111 //'iso-8859-15'=>array('charset'=>'latin1','collation'=>'latin1_swedish_ci'),
112 'utf-8'=>array('charset'=>'utf8','collation'=>'utf8_general_ci'))
115 // http://doc.spip.org/@spip_mysql_set_charset
118 * @param string $serveur
119 * @param bool $requeter
120 * @param bool $requeter
123 function spip_mysql_set_charset($charset, $serveur='',$requeter=true,$requeter=true){
124 $connexion = &$GLOBALS['connexions'][$serveur ?
strtolower($serveur) : 0];
125 spip_log("changement de charset sql : "."SET NAMES "._q($charset), _LOG_DEBUG
);
126 return mysql_query($connexion['last'] = "SET NAMES "._q($charset));
129 // http://doc.spip.org/@spip_mysql_get_charset
132 * @param array $charset
133 * @param string $serveur
134 * @param bool $requeter
138 function spip_mysql_get_charset($charset=array(), $serveur='',$requeter=true){
139 $connexion = &$GLOBALS['connexions'][$serveur ?
strtolower($serveur) : 0];
140 $connexion['last'] = $c = "SHOW CHARACTER SET"
141 . (!$charset ?
'' : (" LIKE "._q($charset['charset'])));
143 return spip_mysql_fetch(mysql_query($c), NULL, $serveur);
146 // obsolete, ne plus utiliser
147 // http://doc.spip.org/@spip_query_db
148 function spip_query_db($query, $serveur='',$requeter=true) {
149 return spip_mysql_query($query, $serveur, $requeter);
152 // Fonction de requete generale, munie d'une trace a la demande
154 // http://doc.spip.org/@spip_mysql_query
158 * @param string $serveur
159 * @param bool $requeter
160 * @return array|null|resource|string
163 function spip_mysql_query($query, $serveur='',$requeter=true) {
165 $connexion = &$GLOBALS['connexions'][$serveur ?
strtolower($serveur) : 0];
166 $prefixe = $connexion['prefixe'];
167 $link = $connexion['link'];
168 $db = $connexion['db'];
170 $query = traite_query($query, $db, $prefixe);
172 // renvoyer la requete inerte si demandee
173 if (!$requeter) return $query;
175 if (isset($_GET['var_profile'])) {
176 include_spip('public/tracer');
177 $t = trace_query_start();
180 $connexion['last'] = $query;
182 // ajouter un debug utile dans log/mysql-slow.log ?
184 if (defined('_DEBUG_SLOW_QUERIES') AND _DEBUG_SLOW_QUERIES
){
185 if($GLOBALS['debug']['aucasou']){
186 list(,$id,, $infos) = $GLOBALS['debug']['aucasou'];
187 $debug .= " BOUCLE$id @ ".$infos[0] ." | ";
189 $debug .= " " . $_SERVER['REQUEST_URI'].' + '.$GLOBALS['ip'];
190 $debug = ' /*'.str_replace('*/','@/',$debug).' */';
193 $r = $link ?
mysql_query($query.$debug, $link) : mysql_query($query.$debug);
195 if ($e = spip_mysql_errno($serveur)) // Log de l'erreur eventuelle
196 $e .= spip_mysql_error($query, $serveur); // et du fautif
197 return $t ?
trace_query_end($query, $t, $r, $e, $serveur) : $r;
200 // http://doc.spip.org/@spip_mysql_alter
203 * @param string $serveur
204 * @param bool $requeter
205 * @return array|null|resource|string
207 function spip_mysql_alter($query, $serveur='',$requeter=true){
208 // ici on supprime les ` entourant le nom de table pour permettre
209 // la transposition du prefixe, compte tenu que les plugins ont la mauvaise habitude
210 // d'utiliser ceux-ci, copie-colle de phpmyadmin
211 $query = preg_replace(",^TABLE\s*`([^`]*)`,i","TABLE \\1",$query);
212 return spip_mysql_query("ALTER ".$query, $serveur, $requeter); # i.e. que PG se debrouille
215 // http://doc.spip.org/@spip_mysql_optimize
218 * @param string $serveur
219 * @param bool $requeter
222 function spip_mysql_optimize($table, $serveur='',$requeter=true){
223 spip_mysql_query("OPTIMIZE TABLE ". $table);
227 // http://doc.spip.org/@spip_mysql_explain
230 * @param string $serveur
231 * @param bool $requeter
234 function spip_mysql_explain($query, $serveur='',$requeter=true){
235 if (strpos(ltrim($query), 'SELECT') !== 0) return array();
236 $connexion = &$GLOBALS['connexions'][$serveur ?
strtolower($serveur) : 0];
237 $prefixe = $connexion['prefixe'];
238 $link = $connexion['link'];
239 $db = $connexion['db'];
241 $query = 'EXPLAIN ' . traite_query($query, $db, $prefixe);
242 $r = $link ?
mysql_query($query, $link) : mysql_query($query);
243 return spip_mysql_fetch($r, NULL, $serveur);
245 // fonction instance de sql_select, voir ses specs dans abstract.php
246 // traite_query pourrait y etre fait d'avance ce serait moins cher
247 // Les \n et \t sont utiles au debusqueur.
250 // http://doc.spip.org/@spip_mysql_select
254 * @param string $where
255 * @param string $groupby
256 * @param string $orderby
257 * @param string $limit
258 * @param string $having
259 * @param string $serveur
260 * @param bool $requeter
261 * @return array|null|resource|string
263 function spip_mysql_select($select, $from, $where='',
264 $groupby='', $orderby='', $limit='', $having='',
265 $serveur='',$requeter=true) {
268 $from = (!is_array($from) ?
$from : spip_mysql_select_as($from));
270 calculer_mysql_expression('SELECT', $select, ', ')
271 . calculer_mysql_expression('FROM', $from, ', ')
272 . calculer_mysql_expression('WHERE', $where)
273 . calculer_mysql_expression('GROUP BY', $groupby, ',')
274 . calculer_mysql_expression('HAVING', $having)
275 . ($orderby ?
("\nORDER BY " . spip_mysql_order($orderby)) :'')
276 . ($limit ?
"\nLIMIT $limit" : '');
278 // renvoyer la requete inerte si demandee
279 if ($requeter === false) return $query;
280 $r = spip_mysql_query($query, $serveur, $requeter);
281 return $r ?
$r : $query;
284 // 0+x avec un champ x commencant par des chiffres est converti par MySQL
285 // en le nombre qui commence x.
286 // Pas portable malheureusement, on laisse pour le moment.
288 // http://doc.spip.org/@spip_mysql_order
293 function spip_mysql_order($orderby)
295 return (is_array($orderby)) ?
join(", ", $orderby) : $orderby;
299 // http://doc.spip.org/@calculer_mysql_where
302 * @return array|mixed|string
304 function calculer_mysql_where($v)
309 $op = array_shift($v);
313 $arg = calculer_mysql_where(array_shift($v));
317 $arg2 = calculer_mysql_where(array_shift($v));
319 return "($arg $op $arg2)";
320 } else return "($arg $op ($arg2) : $v[0])";
325 // http://doc.spip.org/@calculer_mysql_expression
329 * @param string $join
332 function calculer_mysql_expression($expression, $v, $join = 'AND'){
336 $exp = "\n$expression ";
341 if (strtoupper($join) === 'AND')
342 return $exp . join("\n\t$join ", array_map('calculer_mysql_where', $v));
344 return $exp . join($join, $v);
348 // http://doc.spip.org/@spip_mysql_select_as
353 function spip_mysql_select_as($args)
356 foreach($args as $k => $v) {
357 if (substr($k,-1)=='@') {
358 // c'est une jointure qui se refere au from precedent
363 if (!is_numeric($k)) {
364 $p = strpos($v, " ");
366 $v = substr($v,0,$p) . " AS `$k`" . substr($v,$p);
367 else $v .= " AS `$k`";
373 return substr($res,2);
377 // Changer les noms des tables ($table_prefix)
378 // Quand tous les appels SQL seront abstraits on pourra l'ameliorer
380 define('_SQL_PREFIXE_TABLE', '/([,\s])spip_/S');
382 // http://doc.spip.org/@traite_query
386 * @param string $prefixe
387 * @return array|null|string
389 function traite_query($query, $db='', $prefixe='') {
391 if ($GLOBALS['mysql_rappel_nom_base'] AND $db)
392 $pref = '`'. $db.'`.';
396 $pref .= $prefixe . "_";
398 if (!preg_match('/\s(SET|VALUES|WHERE|DATABASE)\s/i', $query, $regs)) {
401 $suite = strstr($query, $regs[0]);
402 $query = substr($query, 0, -strlen($suite));
403 // propager le prefixe en cas de requete imbriquee
404 // il faut alors echapper les chaine avant de le faire, pour ne pas risquer de
405 // modifier une requete qui est en fait juste du texte dans un champ
406 if (stripos($suite,"SELECT")!==false) {
407 list($suite,$textes) = query_echappe_textes($suite);
408 if (preg_match('/^(.*?)([(]\s*SELECT\b.*)$/si', $suite, $r))
409 $suite = $r[1] . traite_query($r[2], $db, $prefixe);
410 $suite = query_reinjecte_textes($suite, $textes);
413 $r = preg_replace(_SQL_PREFIXE_TABLE
, '\1'.$pref, $query) . $suite;
415 #spip_log("traite_query: " . substr($r,0, 50) . ".... $db, $prefixe", _LOG_DEBUG);
420 * Selectionne une base de donnees
423 * Nom de la base a utiliser
426 * True cas de success.
427 * False en cas d'erreur.
429 function spip_mysql_selectdb($db) {
430 $ok = mysql_select_db($db);
432 spip_log('Echec mysql_selectdb. Erreur : ' . mysql_error(),'mysql.'._LOG_CRITIQUE
);
438 * Retourne les bases de donnees accessibles
440 * Retourne un tableau du nom de toutes les bases de donnees
441 * accessibles avec les permissions de l'utilisateur SQL
442 * de cette connexion.
443 * Attention on n'a pas toujours les droits !
445 * @param string $serveur
447 * @param bool $requeter
450 * Liste de noms de bases de donnees
452 function spip_mysql_listdbs($serveur='',$requeter=true) {
454 if ($res = spip_mysql_query("SHOW DATABASES")){
455 while($row = mysql_fetch_assoc($res))
456 $dbs[] = $row['Database'];
461 // Fonction de creation d'une table SQL nommee $nom
462 // a partir de 2 tableaux PHP :
463 // champs: champ => type
464 // cles: type-de-cle => champ(s)
465 // si $autoinc, c'est une auto-increment (i.e. serial) sur la Primary Key
466 // Le nom des caches doit etre inferieur a 64 caracteres
468 // http://doc.spip.org/@spip_mysql_create
473 * @param bool $autoinc
474 * @param bool $temporary
475 * @param string $serveur
476 * @param bool $requeter
477 * @return array|null|resource|string
479 function spip_mysql_create($nom, $champs, $cles, $autoinc=false, $temporary=false, $serveur='',$requeter=true) {
481 $query = ''; $keys = ''; $s = ''; $p='';
483 // certains plugins declarent les tables (permet leur inclusion dans le dump)
484 // sans les renseigner (laisse le compilo recuperer la description)
485 if (!is_array($champs) ||
!is_array($cles))
488 $res = spip_mysql_query("SELECT version() as v");
489 if ($row = mysql_fetch_array($res)
490 && (version_compare($row['v'],'5.0','>=')))
491 spip_mysql_query("SET sql_mode=''");
493 foreach($cles as $k => $v) {
494 $keys .= "$s\n\t\t$k ($v)";
495 if ($k == "PRIMARY KEY")
502 if (@$GLOBALS['meta']['charset_sql_base'])
503 $character_set .= " CHARACTER SET ".$GLOBALS['meta']['charset_sql_base'];
504 if (@$GLOBALS['meta']['charset_collation_sql_base'])
505 $character_set .= " COLLATE ".$GLOBALS['meta']['charset_collation_sql_base'];
507 foreach($champs as $k => $v) {
508 $v = _mysql_remplacements_definitions_table($v);
509 if (preg_match(',([a-z]*\s*(\(\s*[0-9]*\s*\))?(\s*binary)?),i',$v,$defs)){
510 if (preg_match(',(char|text),i',$defs[1])
511 AND !preg_match(',(binary|CHARACTER|COLLATE),i',$v) ){
512 $v = $defs[1] . $character_set . ' ' . substr($v,strlen($defs[1]));
516 $query .= "$s\n\t\t$k $v"
517 . (($autoinc && ($p == $k) && preg_match(',\b(big|small|medium)?int\b,i', $v))
523 $temporary = $temporary ?
'TEMPORARY':'';
524 $q = "CREATE $temporary TABLE IF NOT EXISTS $nom ($query" . ($keys ?
",$keys" : '') . ")".
525 ($character_set?
" DEFAULT $character_set":"")
527 return spip_mysql_query($q, $serveur);
532 * Adapte pour Mysql la declaration SQL d'une colonne d'une table
534 * @param string $query
535 * Definition SQL d'un champ de table
537 * Definition SQL adaptee pour MySQL d'un champ de table
539 function _mysql_remplacements_definitions_table($query){
540 // quelques remplacements
541 $num = "(\s*\([0-9]*\))?";
542 $enum = "(\s*\([^\)]*\))?";
545 '/VARCHAR(\s*[^\s\(])/is' => 'VARCHAR(255)\\1',
548 $query = preg_replace(array_keys($remplace), $remplace, $query);
554 * @param string $serveur
555 * @param bool $requeter
556 * @return array|null|resource|string
558 function spip_mysql_create_base($nom, $serveur='',$requeter=true) {
559 return spip_mysql_query("CREATE DATABASE `$nom`", $serveur, $requeter);
562 // Fonction de creation d'une vue SQL nommee $nom
563 // http://doc.spip.org/@spip_mysql_create_view
566 * @param $query_select
567 * @param string $serveur
568 * @param bool $requeter
569 * @return array|bool|null|resource|string
571 function spip_mysql_create_view($nom, $query_select, $serveur='',$requeter=true) {
572 if (!$query_select) return false;
574 if (sql_showtable($nom, false, $serveur)) {
575 spip_log("Echec creation d'une vue sql ($nom) car celle-ci existe deja (serveur:$serveur)", _LOG_ERREUR
);
579 $query = "CREATE VIEW $nom AS ". $query_select;
580 return spip_mysql_query($query, $serveur, $requeter);
584 // http://doc.spip.org/@spip_mysql_drop_table
587 * @param string $exist
588 * @param string $serveur
589 * @param bool $requeter
590 * @return array|null|resource|string
592 function spip_mysql_drop_table($table, $exist='', $serveur='',$requeter=true)
594 if ($exist) $exist =" IF EXISTS";
595 return spip_mysql_query("DROP TABLE$exist $table", $serveur, $requeter);
599 // http://doc.spip.org/@spip_mysql_drop_view
602 * @param string $exist
603 * @param string $serveur
604 * @param bool $requeter
605 * @return array|null|resource|string
607 function spip_mysql_drop_view($view, $exist='', $serveur='',$requeter=true) {
608 if ($exist) $exist =" IF EXISTS";
609 return spip_mysql_query("DROP VIEW$exist $view", $serveur, $requeter);
613 * Retourne une ressource de la liste des tables de la base de données
615 * @param string $match
616 * Filtre sur tables à récupérer
617 * @param string $serveur
618 * Connecteur de la base
619 * @param bool $requeter
620 * true pour éxecuter la requête
621 * false pour retourner le texte de la requête.
623 * Ressource à utiliser avec sql_fetch()
625 function spip_mysql_showbase($match, $serveur='',$requeter=true)
627 return spip_mysql_query("SHOW TABLES LIKE " . _q($match), $serveur, $requeter);
630 // http://doc.spip.org/@spip_mysql_repair
633 * @param string $serveur
634 * @param bool $requeter
635 * @return array|null|resource|string
637 function spip_mysql_repair($table, $serveur='',$requeter=true)
639 return spip_mysql_query("REPAIR TABLE `$table`", $serveur, $requeter);
642 // Recupere la definition d'une table ou d'une vue MySQL
643 // colonnes, indexes, etc.
644 // au meme format que la definition des tables de SPIP
645 // http://doc.spip.org/@spip_mysql_showtable
648 * @param string $serveur
649 * @param bool $requeter
650 * @return array|null|resource|string
652 function spip_mysql_showtable($nom_table, $serveur='',$requeter=true)
654 $s = spip_mysql_query("SHOW CREATE TABLE `$nom_table`", $serveur, $requeter);
656 if (!$requeter) return $s;
658 list(,$a) = mysql_fetch_array($s ,MYSQL_NUM
);
659 if (preg_match("/^[^(),]*\((([^()]*\([^()]*\)[^()]*)*)\)[^()]*$/", $a, $r)){
661 // extraction d'une KEY éventuelle en prenant garde de ne pas
662 // relever un champ dont le nom contient KEY (ex. ID_WHISKEY)
663 if (preg_match("/^(.*?),([^,]*KEY[ (].*)$/s", $desc, $r)) {
671 foreach(preg_split("/,\s*`/",$desc) as $v) {
672 preg_match("/^\s*`?([^`]*)`\s*(.*)/",$v,$r);
673 $fields[strtolower($r[1])] = $r[2];
677 foreach(preg_split('/\)\s*,?/',$namedkeys) as $v) {
678 if (preg_match("/^\s*([^(]*)\((.*)$/",$v,$r)) {
679 $k = str_replace("`", '', trim($r[1]));
680 $t = strtolower(str_replace("`", '', $r[2]));
681 if ($k && !isset($keys[$k])) $keys[$k] = $t; else $keys[] = $t;
685 return array('field' => $fields, 'key' => $keys);
688 $res = spip_mysql_query("SHOW COLUMNS FROM `$nom_table`", $serveur);
692 while($val = spip_mysql_fetch($res)) {
693 $nfields[$val["Field"]] = $val['Type'];
694 if($val['Null']=='NO') {
695 $nfields[$val["Field"]] .= ' NOT NULL';
697 if($val['Default'] === '0' ||
$val['Default']) {
698 if(preg_match('/[A-Z_]/',$val['Default'])) {
699 $nfields[$val["Field"]] .= ' DEFAULT '.$val['Default'];
701 $nfields[$val["Field"]] .= " DEFAULT '".$val['Default']."'";
705 $nfields[$val["Field"]] .= ' '.$val['Extra'];
706 if($val['Key'] == 'PRI') {
707 $nkeys['PRIMARY KEY'] = $val["Field"];
708 } else if($val['Key'] == 'MUL') {
709 $nkeys['KEY '.$val["Field"]] = $val["Field"];
710 } else if($val['Key'] == 'UNI') {
711 $nkeys['UNIQUE KEY '.$val["Field"]] = $val["Field"];
714 spip_mysql_free($res);
715 return array('field' => $nfields, 'key' => $nkeys);
721 // Recuperation des resultats
724 // http://doc.spip.org/@spip_mysql_fetch
728 * @param string $serveur
729 * @param bool $requeter
732 function spip_mysql_fetch($r, $t='', $serveur='',$requeter=true) {
733 if (!$t) $t = MYSQL_ASSOC
;
734 if ($r) return mysql_fetch_array($r, $t);
737 function spip_mysql_seek($r, $row_number, $serveur='',$requeter=true) {
738 if ($r and mysql_num_rows($r)) return mysql_data_seek($r,$row_number);
742 // http://doc.spip.org/@spip_mysql_countsel
746 * @param array $where
747 * @param string $groupby
748 * @param array $having
749 * @param string $serveur
750 * @param bool $requeter
751 * @return array|int|null|resource|string
754 function spip_mysql_countsel($from = array(), $where = array(),
755 $groupby = '', $having = array(), $serveur='',$requeter=true)
757 $c = !$groupby ?
'*' : ('DISTINCT ' . (is_string($groupby) ?
$groupby : join(',', $groupby)));
759 $r = spip_mysql_select("COUNT($c)", $from, $where,'', '', '', $having, $serveur, $requeter);
761 if (!$requeter) return $r;
762 if (!is_resource($r)) return 0;
763 list($c) = mysql_fetch_array($r, MYSQL_NUM
);
764 mysql_free_result($r);
768 // Bien specifier le serveur auquel on s'adresse,
769 // mais a l'install la globale n'est pas encore completement definie
770 // http://doc.spip.org/@spip_mysql_error
772 * @param string $query
773 * @param string $serveur
774 * @param bool $requeter
777 function spip_mysql_error($query='', $serveur='',$requeter=true) {
778 $link = $GLOBALS['connexions'][$serveur ?
strtolower($serveur) : 0]['link'];
779 $s = $link ?
mysql_error($link) : mysql_error();
780 if ($s) spip_log("$s - $query", 'mysql.'._LOG_ERREUR
);
784 // A transposer dans les portages
785 // http://doc.spip.org/@spip_mysql_errno
787 * @param string $serveur
788 * @param bool $requeter
791 function spip_mysql_errno($serveur='',$requeter=true) {
792 $link = $GLOBALS['connexions'][$serveur ?
$serveur : 0]['link'];
793 $s = $link ?
mysql_errno($link) : mysql_errno();
794 // 2006 MySQL server has gone away
795 // 2013 Lost connection to MySQL server during query
796 if (in_array($s, array(2006,2013)))
797 define('spip_interdire_cache', true);
798 if ($s) spip_log("Erreur mysql $s", _LOG_ERREUR
);
802 // Interface de abstract_sql
803 // http://doc.spip.org/@spip_mysql_count
806 * @param string $serveur
807 * @param bool $requeter
810 function spip_mysql_count($r, $serveur='',$requeter=true) {
811 if ($r) return mysql_num_rows($r);
815 // http://doc.spip.org/@spip_mysql_free
818 * @param string $serveur
819 * @param bool $requeter
822 function spip_mysql_free($r, $serveur='',$requeter=true) {
823 return (is_resource($r)?
mysql_free_result($r):false);
826 // http://doc.spip.org/@spip_mysql_insert
831 * @param string $desc
832 * @param string $serveur
833 * @param bool $requeter
836 function spip_mysql_insert($table, $champs, $valeurs, $desc='', $serveur='',$requeter=true) {
838 $connexion = &$GLOBALS['connexions'][$serveur ?
strtolower($serveur) : 0];
839 $prefixe = $connexion['prefixe'];
840 $link = $connexion['link'];
841 $db = $connexion['db'];
843 if ($prefixe) $table = preg_replace('/^spip/', $prefixe, $table);
845 $query ="INSERT INTO $table $champs VALUES $valeurs";
846 if (!$requeter) return $query;
848 if (isset($_GET['var_profile'])) {
849 include_spip('public/tracer');
850 $t = trace_query_start();
853 $connexion['last'] = $query;
854 #spip_log($query, 'mysql.'._LOG_DEBUG);
855 if (mysql_query($query, $link))
856 $r = mysql_insert_id($link);
858 if ($e = spip_mysql_errno($serveur)) // Log de l'erreur eventuelle
859 $e .= spip_mysql_error($query, $serveur); // et du fautif
861 return $t ?
trace_query_end($query, $t, $r, $e, $serveur) : $r;
863 // return $r ? $r : (($r===0) ? -1 : 0); pb avec le multi-base.
866 // http://doc.spip.org/@spip_mysql_insertq
869 * @param array $couples
871 * @param string $serveur
872 * @param bool $requeter
875 function spip_mysql_insertq($table, $couples=array(), $desc=array(), $serveur='',$requeter=true) {
877 if (!$desc) $desc = description_table($table, $serveur);
878 if (!$desc) $couples = array();
879 $fields = isset($desc['field'])?
$desc['field']:array();
881 foreach ($couples as $champ => $val) {
882 $couples[$champ]= spip_mysql_cite($val, $fields[$champ]);
885 return spip_mysql_insert($table, "(".join(',',array_keys($couples)).")", "(".join(',', $couples).")", $desc, $serveur, $requeter);
889 // http://doc.spip.org/@spip_mysql_insertq_multi
892 * @param array $tab_couples
894 * @param string $serveur
895 * @param bool $requeter
896 * @return bool|int|string
898 function spip_mysql_insertq_multi($table, $tab_couples=array(), $desc=array(), $serveur='',$requeter=true) {
900 if (!$desc) $desc = description_table($table, $serveur);
901 if (!$desc) $tab_couples = array();
902 $fields = isset($desc['field'])?
$desc['field']:array();
904 $cles = "(" . join(',',array_keys(reset($tab_couples))) . ')';
908 // Quoter et Inserer par groupes de 100 max pour eviter un debordement de pile
909 foreach ($tab_couples as $couples) {
910 foreach ($couples as $champ => $val){
911 $couples[$champ]= spip_mysql_cite($val, $fields[$champ]);
913 $valeurs[] = '(' .join(',', $couples) . ')';
914 if (count($valeurs)>=100){
915 $r = spip_mysql_insert($table, $cles, join(', ', $valeurs), $desc, $serveur, $requeter);
920 $r = spip_mysql_insert($table, $cles, join(', ', $valeurs), $desc, $serveur, $requeter);
922 return $r; // dans le cas d'une table auto_increment, le dernier insert_id
925 // http://doc.spip.org/@spip_mysql_update
929 * @param string $where
930 * @param string $desc
931 * @param string $serveur
932 * @param bool $requeter
933 * @return array|null|resource|string
935 function spip_mysql_update($table, $champs, $where='', $desc='', $serveur='',$requeter=true) {
937 foreach ($champs as $champ => $val)
938 $set[] = $champ . "=$val";
940 return spip_mysql_query(
941 calculer_mysql_expression('UPDATE', $table, ',')
942 . calculer_mysql_expression('SET', $set, ',')
943 . calculer_mysql_expression('WHERE', $where),
944 $serveur, $requeter);
947 // idem, mais les valeurs sont des constantes a mettre entre apostrophes
948 // sauf les expressions de date lorsqu'il s'agit de fonctions SQL (NOW etc)
949 // http://doc.spip.org/@spip_mysql_updateq
953 * @param string $where
955 * @param string $serveur
956 * @param bool $requeter
957 * @return array|null|resource|string
959 function spip_mysql_updateq($table, $champs, $where='', $desc=array(), $serveur='',$requeter=true) {
961 if (!$champs) return;
962 if (!$desc) $desc = description_table($table, $serveur);
963 if (!$desc) $champs = array(); else $fields = $desc['field'];
965 foreach ($champs as $champ => $val) {
966 $set[] = $champ . '=' . spip_mysql_cite($val, $fields[$champ]);
968 return spip_mysql_query(
969 calculer_mysql_expression('UPDATE', $table, ',')
970 . calculer_mysql_expression('SET', $set, ',')
971 . calculer_mysql_expression('WHERE', $where),
972 $serveur, $requeter);
975 // http://doc.spip.org/@spip_mysql_delete
978 * @param string $where
979 * @param string $serveur
980 * @param bool $requeter
981 * @return array|bool|int|null|resource|string
983 function spip_mysql_delete($table, $where='', $serveur='',$requeter=true) {
984 $res = spip_mysql_query(
985 calculer_mysql_expression('DELETE FROM', $table, ',')
986 . calculer_mysql_expression('WHERE', $where),
987 $serveur, $requeter);
988 if (!$requeter) return $res;
990 $connexion = &$GLOBALS['connexions'][$serveur ?
$serveur : 0];
991 $link = $connexion['link'];
992 return $link ?
mysql_affected_rows($link) : mysql_affected_rows();
998 // http://doc.spip.org/@spip_mysql_replace
1002 * @param array $desc
1003 * @param string $serveur
1004 * @param bool $requeter
1005 * @return array|null|resource|string
1007 function spip_mysql_replace($table, $couples, $desc=array(), $serveur='',$requeter=true) {
1008 return spip_mysql_query("REPLACE $table (" . join(',',array_keys($couples)) . ') VALUES (' .join(',',array_map('_q', $couples)) . ')', $serveur, $requeter);
1012 // http://doc.spip.org/@spip_mysql_replace_multi
1015 * @param $tab_couples
1016 * @param array $desc
1017 * @param string $serveur
1018 * @param bool $requeter
1019 * @return array|null|resource|string
1021 function spip_mysql_replace_multi($table, $tab_couples, $desc=array(), $serveur='',$requeter=true) {
1022 $cles = "(" . join(',',array_keys($tab_couples[0])). ')';
1024 foreach ($tab_couples as $couples) {
1025 $valeurs[] = '(' .join(',',array_map('_q', $couples)) . ')';
1027 $valeurs = implode(', ',$valeurs);
1028 return spip_mysql_query("REPLACE $table $cles VALUES $valeurs", $serveur, $requeter);
1032 // http://doc.spip.org/@spip_mysql_multi
1041 function spip_mysql_multi ($objet, $lang) {
1042 $lengthlang = strlen("[$lang]");
1043 $posmulti = "INSTR(".$objet.", '<multi>')";
1044 $posfinmulti = "INSTR(".$objet.", '</multi>')";
1045 $debutchaine = "LEFT(".$objet.", $posmulti-1)";
1046 $finchaine = "RIGHT(".$objet.", CHAR_LENGTH(".$objet.") -(7+$posfinmulti))";
1047 $chainemulti = "TRIM(SUBSTRING(".$objet.", $posmulti+7, $posfinmulti -(7+$posmulti)))";
1048 $poslang = "INSTR($chainemulti,'[".$lang."]')";
1049 $poslang = "IF($poslang=0,INSTR($chainemulti,']')+1,$poslang+$lengthlang)";
1050 $chainelang = "TRIM(SUBSTRING(".$objet.", $posmulti+7+$poslang-1,$posfinmulti -($posmulti+7+$poslang-1) ))";
1051 $posfinlang = "INSTR(".$chainelang.", '[')";
1052 $chainelang = "IF($posfinlang>0,LEFT($chainelang,$posfinlang-1),$chainelang)";
1053 //$chainelang = "LEFT($chainelang,$posfinlang-1)";
1054 $retour = "(TRIM(IF($posmulti = 0 , ".
1055 " TRIM(".$objet."), ".
1070 // http://doc.spip.org/@spip_mysql_hex
1075 function spip_mysql_hex($v)
1082 * @param string $type
1083 * @return array|int|string
1085 function spip_mysql_quote($v, $type='') {
1088 return spip_mysql_cite($v,$type);
1089 // si c'est un tableau, le parcourir en propageant le type
1090 foreach($v as $k=>$r)
1091 $v[$k] = spip_mysql_quote($r, $type);
1094 // si on ne connait pas le type, s'en remettre a _q :
1095 // on ne fera pas mieux
1106 function spip_mysql_date_proche($champ, $interval, $unite)
1110 . (($interval <= 0) ?
'>' : '<')
1111 . (($interval <= 0) ?
'DATE_SUB' : 'DATE_ADD')
1113 . sql_quote(date('Y-m-d H:i:s'))
1115 . (($interval > 0) ?
$interval : (0-$interval))
1122 // IN (...) est limite a 255 elements, d'ou cette fonction assistante
1124 // http://doc.spip.org/@spip_mysql_in
1128 * @param string $not
1129 * @param string $serveur
1130 * @param bool $requeter
1133 function spip_mysql_in($val, $valeurs, $not='', $serveur='',$requeter=true) {
1136 while ($n = strpos($valeurs, ',', $n+
1)) {
1137 if ((++
$i) >= 255) {
1138 $in_sql .= "($val $not IN (" .
1139 substr($valeurs, 0, $n) .
1141 ($not ?
"AND\t" : "OR\t");
1142 $valeurs = substr($valeurs, $n+
1);
1146 $in_sql .= "($val $not IN ($valeurs))";
1151 // pour compatibilite. Ne plus utiliser.
1152 // http://doc.spip.org/@calcul_mysql_in
1156 * @param string $not
1159 function calcul_mysql_in($val, $valeurs, $not='') {
1160 if (is_array($valeurs))
1161 $valeurs = join(',', array_map('_q', $valeurs));
1162 elseif ($valeurs[0]===',') $valeurs = substr($valeurs,1);
1163 if (!strlen(trim($valeurs))) return ($not ?
"0=0" : '0=1');
1164 return spip_mysql_in($val, $valeurs, $not);
1167 // http://doc.spip.org/@spip_mysql_cite
1171 * @return int|string
1173 function spip_mysql_cite($v, $type) {
1175 AND stripos($type,"NOT NULL")===false) return 'NULL'; // null php se traduit en NULL SQL
1176 if (sql_test_date($type) AND preg_match('/^\w+\(/', $v))
1178 if (sql_test_int($type)) {
1179 if (is_numeric($v) OR (ctype_xdigit(substr($v,2))
1180 AND $v[0]=='0' AND $v[1]=='x'))
1182 // si pas numerique, forcer le intval
1186 return ("'" . addslashes($v) . "'");
1189 // Ces deux fonctions n'ont pas d'equivalent exact PostGres
1190 // et ne sont la que pour compatibilite avec les extensions de SPIP < 1.9.3
1193 // Poser un verrou local a un SPIP donne
1194 // Changer de nom toutes les heures en cas de blocage MySQL (ca arrive)
1196 // http://doc.spip.org/@spip_get_lock
1199 * @param int $timeout
1202 function spip_get_lock($nom, $timeout = 0) {
1204 define('_LOCK_TIME', intval(time()/3600-316982));
1206 $connexion = &$GLOBALS['connexions'][0];
1207 $bd = $connexion['db'];
1208 $prefixe = $connexion['prefixe'];
1209 $nom = "$bd:$prefixe:$nom" . _LOCK_TIME
;
1211 $connexion['last'] = $q = "SELECT GET_LOCK(" . _q($nom) . ", $timeout) AS n";
1212 $q = @sql_fetch
(mysql_query($q));
1213 if (!$q) spip_log("pas de lock sql pour $nom", _LOG_ERREUR
);
1217 // http://doc.spip.org/@spip_release_lock
1221 function spip_release_lock($nom) {
1223 $connexion = &$GLOBALS['connexions'][0];
1224 $bd = $connexion['db'];
1225 $prefixe = $connexion['prefixe'];
1226 $nom = "$bd:$prefixe:$nom" . _LOCK_TIME
;
1228 $connexion['last'] = $q = "SELECT RELEASE_LOCK(" . _q($nom) . ")";
1232 // Renvoie false si on n'a pas les fonctions mysql (pour l'install)
1233 // http://doc.spip.org/@spip_versions_mysql
1237 function spip_versions_mysql() {
1238 charger_php_extension('mysql');
1239 return function_exists('mysql_query');
1242 // Tester si mysql ne veut pas du nom de la base dans les requetes
1244 // http://doc.spip.org/@test_rappel_nom_base_mysql
1249 function test_rappel_nom_base_mysql($server_db)
1251 $GLOBALS['mysql_rappel_nom_base'] = true;
1252 sql_delete('spip_meta', "nom='mysql_rappel_nom_base'", $server_db);
1253 $ok = spip_query("INSERT INTO spip_meta (nom,valeur) VALUES ('mysql_rappel_nom_base', 'test')", $server_db);
1256 sql_delete('spip_meta', "nom='mysql_rappel_nom_base'", $server_db);
1259 $GLOBALS['mysql_rappel_nom_base'] = false;
1260 return "\$GLOBALS['mysql_rappel_nom_base'] = false; ".
1261 "/* echec de test_rappel_nom_base_mysql a l'installation. */\n";
1265 // http://doc.spip.org/@test_sql_mode_mysql
1270 function test_sql_mode_mysql($server_db){
1271 $res = sql_select("version() as v",'','','','','','',$server_db);
1272 $row = sql_fetch($res,$server_db);
1273 if (version_compare($row['v'],'5.0.0','>=')){
1274 define('_MYSQL_SET_SQL_MODE',true);
1275 return "define('_MYSQL_SET_SQL_MODE',true);\n";