3bbd435f73bbfbe70bf0f1adefd25aed2699e826
3 /* *************************************************************************\
4 * SPIP, Systeme de publication pour l'internet *
6 * Copyright (c) 2001-2012 *
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 ?
183 $debug = (!defined('_DEBUG_SLOW_QUERIES') ||
!_DEBUG_SLOW_QUERIES
)
186 .str_replace('*/','@/',
187 $_SERVER['REQUEST_URI'].' + '.$GLOBALS['ip']
191 $r = $link ?
mysql_query($query.$debug, $link) : mysql_query($query.$debug);
193 if ($e = spip_mysql_errno($serveur)) // Log de l'erreur eventuelle
194 $e .= spip_mysql_error($query, $serveur); // et du fautif
195 return $t ?
trace_query_end($query, $t, $r, $e, $serveur) : $r;
198 // http://doc.spip.org/@spip_mysql_alter
201 * @param string $serveur
202 * @param bool $requeter
203 * @return array|null|resource|string
205 function spip_mysql_alter($query, $serveur='',$requeter=true){
206 // ici on supprime les ` entourant le nom de table pour permettre
207 // la transposition du prefixe, compte tenu que les plugins ont la mauvaise habitude
208 // d'utiliser ceux-ci, copie-colle de phpmyadmin
209 $query = preg_replace(",^TABLE\s*`([^`]*)`,i","TABLE \\1",$query);
210 return spip_mysql_query("ALTER ".$query, $serveur, $requeter); # i.e. que PG se debrouille
213 // http://doc.spip.org/@spip_mysql_optimize
216 * @param string $serveur
217 * @param bool $requeter
220 function spip_mysql_optimize($table, $serveur='',$requeter=true){
221 spip_mysql_query("OPTIMIZE TABLE ". $table);
225 // http://doc.spip.org/@spip_mysql_explain
228 * @param string $serveur
229 * @param bool $requeter
232 function spip_mysql_explain($query, $serveur='',$requeter=true){
233 if (strpos(ltrim($query), 'SELECT') !== 0) return array();
234 $connexion = &$GLOBALS['connexions'][$serveur ?
strtolower($serveur) : 0];
235 $prefixe = $connexion['prefixe'];
236 $link = $connexion['link'];
237 $db = $connexion['db'];
239 $query = 'EXPLAIN ' . traite_query($query, $db, $prefixe);
240 $r = $link ?
mysql_query($query, $link) : mysql_query($query);
241 return spip_mysql_fetch($r, NULL, $serveur);
243 // fonction instance de sql_select, voir ses specs dans abstract.php
244 // traite_query pourrait y etre fait d'avance ce serait moins cher
245 // Les \n et \t sont utiles au debusqueur.
248 // http://doc.spip.org/@spip_mysql_select
252 * @param string $where
253 * @param string $groupby
254 * @param string $orderby
255 * @param string $limit
256 * @param string $having
257 * @param string $serveur
258 * @param bool $requeter
259 * @return array|null|resource|string
261 function spip_mysql_select($select, $from, $where='',
262 $groupby='', $orderby='', $limit='', $having='',
263 $serveur='',$requeter=true) {
266 $from = (!is_array($from) ?
$from : spip_mysql_select_as($from));
268 calculer_mysql_expression('SELECT', $select, ', ')
269 . calculer_mysql_expression('FROM', $from, ', ')
270 . calculer_mysql_expression('WHERE', $where)
271 . calculer_mysql_expression('GROUP BY', $groupby, ',')
272 . calculer_mysql_expression('HAVING', $having)
273 . ($orderby ?
("\nORDER BY " . spip_mysql_order($orderby)) :'')
274 . ($limit ?
"\nLIMIT $limit" : '');
276 // renvoyer la requete inerte si demandee
277 if ($requeter === false) return $query;
278 $r = spip_mysql_query($query, $serveur, $requeter);
279 return $r ?
$r : $query;
282 // 0+x avec un champ x commencant par des chiffres est converti par MySQL
283 // en le nombre qui commence x.
284 // Pas portable malheureusement, on laisse pour le moment.
286 // http://doc.spip.org/@spip_mysql_order
291 function spip_mysql_order($orderby)
293 return (is_array($orderby)) ?
join(", ", $orderby) : $orderby;
297 // http://doc.spip.org/@calculer_mysql_where
300 * @return array|mixed|string
302 function calculer_mysql_where($v)
307 $op = array_shift($v);
311 $arg = calculer_mysql_where(array_shift($v));
315 $arg2 = calculer_mysql_where(array_shift($v));
317 return "($arg $op $arg2)";
318 } else return "($arg $op ($arg2) : $v[0])";
323 // http://doc.spip.org/@calculer_mysql_expression
327 * @param string $join
330 function calculer_mysql_expression($expression, $v, $join = 'AND'){
334 $exp = "\n$expression ";
339 if (strtoupper($join) === 'AND')
340 return $exp . join("\n\t$join ", array_map('calculer_mysql_where', $v));
342 return $exp . join($join, $v);
346 // http://doc.spip.org/@spip_mysql_select_as
351 function spip_mysql_select_as($args)
354 foreach($args as $k => $v) {
355 if (substr($k,-1)=='@') {
356 // c'est une jointure qui se refere au from precedent
361 if (!is_numeric($k)) {
362 $p = strpos($v, " ");
364 $v = substr($v,0,$p) . " AS `$k`" . substr($v,$p);
365 else $v .= " AS `$k`";
371 return substr($res,2);
375 // Changer les noms des tables ($table_prefix)
376 // Quand tous les appels SQL seront abstraits on pourra l'ameliorer
378 define('_SQL_PREFIXE_TABLE', '/([,\s])spip_/S');
380 // http://doc.spip.org/@traite_query
384 * @param string $prefixe
385 * @return array|null|string
387 function traite_query($query, $db='', $prefixe='') {
389 if ($GLOBALS['mysql_rappel_nom_base'] AND $db)
390 $pref = '`'. $db.'`.';
394 $pref .= $prefixe . "_";
396 if (!preg_match('/\s(SET|VALUES|WHERE|DATABASE)\s/i', $query, $regs)) {
399 $suite = strstr($query, $regs[0]);
400 $query = substr($query, 0, -strlen($suite));
401 // propager le prefixe en cas de requete imbriquee
402 // il faut alors echapper les chaine avant de le faire, pour ne pas risquer de
403 // modifier une requete qui est en fait juste du texte dans un champ
404 if (stripos($suite,"SELECT")!==false) {
405 list($suite,$textes) = query_echappe_textes($suite);
406 if (preg_match('/^(.*?)([(]\s*SELECT\b.*)$/si', $suite, $r))
407 $suite = $r[1] . traite_query($r[2], $db, $prefixe);
408 $suite = query_reinjecte_textes($suite, $textes);
411 $r = preg_replace(_SQL_PREFIXE_TABLE
, '\1'.$pref, $query) . $suite;
413 #spip_log("traite_query: " . substr($r,0, 50) . ".... $db, $prefixe", _LOG_DEBUG);
418 * Selectionne une base de donnees
421 * Nom de la base a utiliser
424 * True cas de success.
425 * False en cas d'erreur.
427 function spip_mysql_selectdb($db) {
428 $ok = mysql_select_db($db);
430 spip_log('Echec mysql_selectdb. Erreur : ' . mysql_error(),'mysql.'._LOG_CRITIQUE
);
436 * Retourne les bases de donnees accessibles
438 * Retourne un tableau du nom de toutes les bases de donnees
439 * accessibles avec les permissions de l'utilisateur SQL
440 * de cette connexion.
441 * Attention on n'a pas toujours les droits !
443 * @param string $serveur
445 * @param bool $requeter
448 * Liste de noms de bases de donnees
450 function spip_mysql_listdbs($serveur='',$requeter=true) {
452 if ($res = spip_mysql_query("SHOW DATABASES")){
453 while($row = mysql_fetch_assoc($res))
454 $dbs[] = $row['Database'];
459 // Fonction de creation d'une table SQL nommee $nom
460 // a partir de 2 tableaux PHP :
461 // champs: champ => type
462 // cles: type-de-cle => champ(s)
463 // si $autoinc, c'est une auto-increment (i.e. serial) sur la Primary Key
464 // Le nom des caches doit etre inferieur a 64 caracteres
466 // http://doc.spip.org/@spip_mysql_create
471 * @param bool $autoinc
472 * @param bool $temporary
473 * @param string $serveur
474 * @param bool $requeter
475 * @return array|null|resource|string
477 function spip_mysql_create($nom, $champs, $cles, $autoinc=false, $temporary=false, $serveur='',$requeter=true) {
479 $query = ''; $keys = ''; $s = ''; $p='';
481 // certains plugins declarent les tables (permet leur inclusion dans le dump)
482 // sans les renseigner (laisse le compilo recuperer la description)
483 if (!is_array($champs) ||
!is_array($cles))
486 $res = spip_mysql_query("SELECT version() as v");
487 if ($row = mysql_fetch_array($res)
488 && (version_compare($row['v'],'5.0','>=')))
489 spip_mysql_query("SET sql_mode=''");
491 foreach($cles as $k => $v) {
492 $keys .= "$s\n\t\t$k ($v)";
493 if ($k == "PRIMARY KEY")
500 if (@$GLOBALS['meta']['charset_sql_base'])
501 $character_set .= " CHARACTER SET ".$GLOBALS['meta']['charset_sql_base'];
502 if (@$GLOBALS['meta']['charset_collation_sql_base'])
503 $character_set .= " COLLATE ".$GLOBALS['meta']['charset_collation_sql_base'];
505 foreach($champs as $k => $v) {
506 $v = _mysql_remplacements_definitions_table($v);
507 if (preg_match(',([a-z]*\s*(\(\s*[0-9]*\s*\))?(\s*binary)?),i',$v,$defs)){
508 if (preg_match(',(char|text),i',$defs[1])
509 AND !preg_match(',(binary|CHARACTER|COLLATE),i',$v) ){
510 $v = $defs[1] . $character_set . ' ' . substr($v,strlen($defs[1]));
514 $query .= "$s\n\t\t$k $v"
515 . (($autoinc && ($p == $k) && preg_match(',\b(big|small|medium)?int\b,i', $v))
521 $temporary = $temporary ?
'TEMPORARY':'';
522 $q = "CREATE $temporary TABLE IF NOT EXISTS $nom ($query" . ($keys ?
",$keys" : '') . ")".
523 ($character_set?
" DEFAULT $character_set":"")
525 return spip_mysql_query($q, $serveur);
530 * Adapte pour Mysql la declaration SQL d'une colonne d'une table
532 * @param string $query
533 * Definition SQL d'un champ de table
535 * Definition SQL adaptee pour MySQL d'un champ de table
537 function _mysql_remplacements_definitions_table($query){
538 // quelques remplacements
539 $num = "(\s*\([0-9]*\))?";
540 $enum = "(\s*\([^\)]*\))?";
543 '/VARCHAR(\s*[^\s\(])/is' => 'VARCHAR(255)\\1',
546 $query = preg_replace(array_keys($remplace), $remplace, $query);
552 * @param string $serveur
553 * @param bool $requeter
554 * @return array|null|resource|string
556 function spip_mysql_create_base($nom, $serveur='',$requeter=true) {
557 return spip_mysql_query("CREATE DATABASE `$nom`", $serveur, $requeter);
560 // Fonction de creation d'une vue SQL nommee $nom
561 // http://doc.spip.org/@spip_mysql_create_view
564 * @param $query_select
565 * @param string $serveur
566 * @param bool $requeter
567 * @return array|bool|null|resource|string
569 function spip_mysql_create_view($nom, $query_select, $serveur='',$requeter=true) {
570 if (!$query_select) return false;
572 if (sql_showtable($nom, false, $serveur)) {
573 spip_log("Echec creation d'une vue sql ($nom) car celle-ci existe deja (serveur:$serveur)", _LOG_ERREUR
);
577 $query = "CREATE VIEW $nom AS ". $query_select;
578 return spip_mysql_query($query, $serveur, $requeter);
582 // http://doc.spip.org/@spip_mysql_drop_table
585 * @param string $exist
586 * @param string $serveur
587 * @param bool $requeter
588 * @return array|null|resource|string
590 function spip_mysql_drop_table($table, $exist='', $serveur='',$requeter=true)
592 if ($exist) $exist =" IF EXISTS";
593 return spip_mysql_query("DROP TABLE$exist $table", $serveur, $requeter);
597 // http://doc.spip.org/@spip_mysql_drop_view
600 * @param string $exist
601 * @param string $serveur
602 * @param bool $requeter
603 * @return array|null|resource|string
605 function spip_mysql_drop_view($view, $exist='', $serveur='',$requeter=true) {
606 if ($exist) $exist =" IF EXISTS";
607 return spip_mysql_query("DROP VIEW$exist $view", $serveur, $requeter);
611 * Retourne une ressource de la liste des tables de la base de données
613 * @param string $match
614 * Filtre sur tables à récupérer
615 * @param string $serveur
616 * Connecteur de la base
617 * @param bool $requeter
618 * true pour éxecuter la requête
619 * false pour retourner le texte de la requête.
621 * Ressource à utiliser avec sql_fetch()
623 function spip_mysql_showbase($match, $serveur='',$requeter=true)
625 return spip_mysql_query("SHOW TABLES LIKE " . _q($match), $serveur, $requeter);
628 // http://doc.spip.org/@spip_mysql_repair
631 * @param string $serveur
632 * @param bool $requeter
633 * @return array|null|resource|string
635 function spip_mysql_repair($table, $serveur='',$requeter=true)
637 return spip_mysql_query("REPAIR TABLE `$table`", $serveur, $requeter);
640 // Recupere la definition d'une table ou d'une vue MySQL
641 // colonnes, indexes, etc.
642 // au meme format que la definition des tables de SPIP
643 // http://doc.spip.org/@spip_mysql_showtable
646 * @param string $serveur
647 * @param bool $requeter
648 * @return array|null|resource|string
650 function spip_mysql_showtable($nom_table, $serveur='',$requeter=true)
652 $s = spip_mysql_query("SHOW CREATE TABLE `$nom_table`", $serveur, $requeter);
654 if (!$requeter) return $s;
656 list(,$a) = mysql_fetch_array($s ,MYSQL_NUM
);
657 if (preg_match("/^[^(),]*\((([^()]*\([^()]*\)[^()]*)*)\)[^()]*$/", $a, $r)){
659 // extraction d'une KEY éventuelle en prenant garde de ne pas
660 // relever un champ dont le nom contient KEY (ex. ID_WHISKEY)
661 if (preg_match("/^(.*?),([^,]*KEY[ (].*)$/s", $desc, $r)) {
669 foreach(preg_split("/,\s*`/",$desc) as $v) {
670 preg_match("/^\s*`?([^`]*)`\s*(.*)/",$v,$r);
671 $fields[strtolower($r[1])] = $r[2];
675 foreach(preg_split('/\)\s*,?/',$namedkeys) as $v) {
676 if (preg_match("/^\s*([^(]*)\((.*)$/",$v,$r)) {
677 $k = str_replace("`", '', trim($r[1]));
678 $t = strtolower(str_replace("`", '', $r[2]));
679 if ($k && !isset($keys[$k])) $keys[$k] = $t; else $keys[] = $t;
683 return array('field' => $fields, 'key' => $keys);
686 $res = spip_mysql_query("SHOW COLUMNS FROM `$nom_table`", $serveur);
690 while($val = spip_mysql_fetch($res)) {
691 $nfields[$val["Field"]] = $val['Type'];
692 if($val['Null']=='NO') {
693 $nfields[$val["Field"]] .= ' NOT NULL';
695 if($val['Default'] === '0' ||
$val['Default']) {
696 if(preg_match('/[A-Z_]/',$val['Default'])) {
697 $nfields[$val["Field"]] .= ' DEFAULT '.$val['Default'];
699 $nfields[$val["Field"]] .= " DEFAULT '".$val['Default']."'";
703 $nfields[$val["Field"]] .= ' '.$val['Extra'];
704 if($val['Key'] == 'PRI') {
705 $nkeys['PRIMARY KEY'] = $val["Field"];
706 } else if($val['Key'] == 'MUL') {
707 $nkeys['KEY '.$val["Field"]] = $val["Field"];
708 } else if($val['Key'] == 'UNI') {
709 $nkeys['UNIQUE KEY '.$val["Field"]] = $val["Field"];
712 spip_mysql_free($res);
713 return array('field' => $nfields, 'key' => $nkeys);
719 // Recuperation des resultats
722 // http://doc.spip.org/@spip_mysql_fetch
726 * @param string $serveur
727 * @param bool $requeter
730 function spip_mysql_fetch($r, $t='', $serveur='',$requeter=true) {
731 if (!$t) $t = MYSQL_ASSOC
;
732 if ($r) return mysql_fetch_array($r, $t);
735 function spip_mysql_seek($r, $row_number, $serveur='',$requeter=true) {
736 if ($r and mysql_num_rows($r)) return mysql_data_seek($r,$row_number);
740 // http://doc.spip.org/@spip_mysql_countsel
744 * @param array $where
745 * @param string $groupby
746 * @param array $having
747 * @param string $serveur
748 * @param bool $requeter
749 * @return array|int|null|resource|string
752 function spip_mysql_countsel($from = array(), $where = array(),
753 $groupby = '', $having = array(), $serveur='',$requeter=true)
755 $c = !$groupby ?
'*' : ('DISTINCT ' . (is_string($groupby) ?
$groupby : join(',', $groupby)));
757 $r = spip_mysql_select("COUNT($c)", $from, $where,'', '', '', $having, $serveur, $requeter);
759 if (!$requeter) return $r;
760 if (!is_resource($r)) return 0;
761 list($c) = mysql_fetch_array($r, MYSQL_NUM
);
762 mysql_free_result($r);
766 // Bien specifier le serveur auquel on s'adresse,
767 // mais a l'install la globale n'est pas encore completement definie
768 // http://doc.spip.org/@spip_mysql_error
770 * @param string $query
771 * @param string $serveur
772 * @param bool $requeter
775 function spip_mysql_error($query='', $serveur='',$requeter=true) {
776 $link = $GLOBALS['connexions'][$serveur ?
strtolower($serveur) : 0]['link'];
777 $s = $link ?
mysql_error($link) : mysql_error();
778 if ($s) spip_log("$s - $query", 'mysql.'._LOG_ERREUR
);
782 // A transposer dans les portages
783 // http://doc.spip.org/@spip_mysql_errno
785 * @param string $serveur
786 * @param bool $requeter
789 function spip_mysql_errno($serveur='',$requeter=true) {
790 $link = $GLOBALS['connexions'][$serveur ?
$serveur : 0]['link'];
791 $s = $link ?
mysql_errno($link) : mysql_errno();
792 // 2006 MySQL server has gone away
793 // 2013 Lost connection to MySQL server during query
794 if (in_array($s, array(2006,2013)))
795 define('spip_interdire_cache', true);
796 if ($s) spip_log("Erreur mysql $s", _LOG_ERREUR
);
800 // Interface de abstract_sql
801 // http://doc.spip.org/@spip_mysql_count
804 * @param string $serveur
805 * @param bool $requeter
808 function spip_mysql_count($r, $serveur='',$requeter=true) {
809 if ($r) return mysql_num_rows($r);
813 // http://doc.spip.org/@spip_mysql_free
816 * @param string $serveur
817 * @param bool $requeter
820 function spip_mysql_free($r, $serveur='',$requeter=true) {
821 return (is_resource($r)?
mysql_free_result($r):false);
824 // http://doc.spip.org/@spip_mysql_insert
829 * @param string $desc
830 * @param string $serveur
831 * @param bool $requeter
834 function spip_mysql_insert($table, $champs, $valeurs, $desc='', $serveur='',$requeter=true) {
836 $connexion = &$GLOBALS['connexions'][$serveur ?
strtolower($serveur) : 0];
837 $prefixe = $connexion['prefixe'];
838 $link = $connexion['link'];
839 $db = $connexion['db'];
841 if ($prefixe) $table = preg_replace('/^spip/', $prefixe, $table);
843 $query ="INSERT INTO $table $champs VALUES $valeurs";
844 if (!$requeter) return $query;
846 if (isset($_GET['var_profile'])) {
847 include_spip('public/tracer');
848 $t = trace_query_start();
851 $connexion['last'] = $query;
852 #spip_log($query, 'mysql.'._LOG_DEBUG);
853 if (mysql_query($query, $link))
854 $r = mysql_insert_id($link);
856 if ($e = spip_mysql_errno($serveur)) // Log de l'erreur eventuelle
857 $e .= spip_mysql_error($query, $serveur); // et du fautif
859 return $t ?
trace_query_end($query, $t, $r, $e, $serveur) : $r;
861 // return $r ? $r : (($r===0) ? -1 : 0); pb avec le multi-base.
864 // http://doc.spip.org/@spip_mysql_insertq
867 * @param array $couples
869 * @param string $serveur
870 * @param bool $requeter
873 function spip_mysql_insertq($table, $couples=array(), $desc=array(), $serveur='',$requeter=true) {
875 if (!$desc) $desc = description_table($table, $serveur);
876 if (!$desc) $couples = array();
877 $fields = isset($desc['field'])?
$desc['field']:array();
879 foreach ($couples as $champ => $val) {
880 $couples[$champ]= spip_mysql_cite($val, $fields[$champ]);
883 return spip_mysql_insert($table, "(".join(',',array_keys($couples)).")", "(".join(',', $couples).")", $desc, $serveur, $requeter);
887 // http://doc.spip.org/@spip_mysql_insertq_multi
890 * @param array $tab_couples
892 * @param string $serveur
893 * @param bool $requeter
894 * @return bool|int|string
896 function spip_mysql_insertq_multi($table, $tab_couples=array(), $desc=array(), $serveur='',$requeter=true) {
898 if (!$desc) $desc = description_table($table, $serveur);
899 if (!$desc) $tab_couples = array();
900 $fields = isset($desc['field'])?
$desc['field']:array();
902 $cles = "(" . join(',',array_keys(reset($tab_couples))) . ')';
906 // Quoter et Inserer par groupes de 100 max pour eviter un debordement de pile
907 foreach ($tab_couples as $couples) {
908 foreach ($couples as $champ => $val){
909 $couples[$champ]= spip_mysql_cite($val, $fields[$champ]);
911 $valeurs[] = '(' .join(',', $couples) . ')';
912 if (count($valeurs)>=100){
913 $r = spip_mysql_insert($table, $cles, join(', ', $valeurs), $desc, $serveur, $requeter);
918 $r = spip_mysql_insert($table, $cles, join(', ', $valeurs), $desc, $serveur, $requeter);
920 return $r; // dans le cas d'une table auto_increment, le dernier insert_id
923 // http://doc.spip.org/@spip_mysql_update
927 * @param string $where
928 * @param string $desc
929 * @param string $serveur
930 * @param bool $requeter
931 * @return array|null|resource|string
933 function spip_mysql_update($table, $champs, $where='', $desc='', $serveur='',$requeter=true) {
935 foreach ($champs as $champ => $val)
936 $set[] = $champ . "=$val";
938 return spip_mysql_query(
939 calculer_mysql_expression('UPDATE', $table, ',')
940 . calculer_mysql_expression('SET', $set, ',')
941 . calculer_mysql_expression('WHERE', $where),
942 $serveur, $requeter);
945 // idem, mais les valeurs sont des constantes a mettre entre apostrophes
946 // sauf les expressions de date lorsqu'il s'agit de fonctions SQL (NOW etc)
947 // http://doc.spip.org/@spip_mysql_updateq
951 * @param string $where
953 * @param string $serveur
954 * @param bool $requeter
955 * @return array|null|resource|string
957 function spip_mysql_updateq($table, $champs, $where='', $desc=array(), $serveur='',$requeter=true) {
959 if (!$champs) return;
960 if (!$desc) $desc = description_table($table, $serveur);
961 if (!$desc) $champs = array(); else $fields = $desc['field'];
963 foreach ($champs as $champ => $val) {
964 $set[] = $champ . '=' . spip_mysql_cite($val, $fields[$champ]);
966 return spip_mysql_query(
967 calculer_mysql_expression('UPDATE', $table, ',')
968 . calculer_mysql_expression('SET', $set, ',')
969 . calculer_mysql_expression('WHERE', $where),
970 $serveur, $requeter);
973 // http://doc.spip.org/@spip_mysql_delete
976 * @param string $where
977 * @param string $serveur
978 * @param bool $requeter
979 * @return array|bool|int|null|resource|string
981 function spip_mysql_delete($table, $where='', $serveur='',$requeter=true) {
982 $res = spip_mysql_query(
983 calculer_mysql_expression('DELETE FROM', $table, ',')
984 . calculer_mysql_expression('WHERE', $where),
985 $serveur, $requeter);
986 if (!$requeter) return $res;
988 $connexion = &$GLOBALS['connexions'][$serveur ?
$serveur : 0];
989 $link = $connexion['link'];
990 return $link ?
mysql_affected_rows($link) : mysql_affected_rows();
996 // http://doc.spip.org/@spip_mysql_replace
1000 * @param array $desc
1001 * @param string $serveur
1002 * @param bool $requeter
1003 * @return array|null|resource|string
1005 function spip_mysql_replace($table, $couples, $desc=array(), $serveur='',$requeter=true) {
1006 return spip_mysql_query("REPLACE $table (" . join(',',array_keys($couples)) . ') VALUES (' .join(',',array_map('_q', $couples)) . ')', $serveur, $requeter);
1010 // http://doc.spip.org/@spip_mysql_replace_multi
1013 * @param $tab_couples
1014 * @param array $desc
1015 * @param string $serveur
1016 * @param bool $requeter
1017 * @return array|null|resource|string
1019 function spip_mysql_replace_multi($table, $tab_couples, $desc=array(), $serveur='',$requeter=true) {
1020 $cles = "(" . join(',',array_keys($tab_couples[0])). ')';
1022 foreach ($tab_couples as $couples) {
1023 $valeurs[] = '(' .join(',',array_map('_q', $couples)) . ')';
1025 $valeurs = implode(', ',$valeurs);
1026 return spip_mysql_query("REPLACE $table $cles VALUES $valeurs", $serveur, $requeter);
1030 // http://doc.spip.org/@spip_mysql_multi
1039 function spip_mysql_multi ($objet, $lang) {
1040 $lengthlang = strlen("[$lang]");
1041 $posmulti = "INSTR(".$objet.", '<multi>')";
1042 $posfinmulti = "INSTR(".$objet.", '</multi>')";
1043 $debutchaine = "LEFT(".$objet.", $posmulti-1)";
1044 $finchaine = "RIGHT(".$objet.", CHAR_LENGTH(".$objet.") -(7+$posfinmulti))";
1045 $chainemulti = "TRIM(SUBSTRING(".$objet.", $posmulti+7, $posfinmulti -(7+$posmulti)))";
1046 $poslang = "INSTR($chainemulti,'[".$lang."]')";
1047 $poslang = "IF($poslang=0,INSTR($chainemulti,']')+1,$poslang+$lengthlang)";
1048 $chainelang = "TRIM(SUBSTRING(".$objet.", $posmulti+7+$poslang-1,$posfinmulti -($posmulti+7+$poslang-1) ))";
1049 $posfinlang = "INSTR(".$chainelang.", '[')";
1050 $chainelang = "IF($posfinlang>0,LEFT($chainelang,$posfinlang-1),$chainelang)";
1051 //$chainelang = "LEFT($chainelang,$posfinlang-1)";
1052 $retour = "(TRIM(IF($posmulti = 0 , ".
1053 " TRIM(".$objet."), ".
1068 // http://doc.spip.org/@spip_mysql_hex
1073 function spip_mysql_hex($v)
1080 * @param string $type
1081 * @return array|int|string
1083 function spip_mysql_quote($v, $type='') {
1086 return spip_mysql_cite($v,$type);
1087 // si c'est un tableau, le parcourir en propageant le type
1088 foreach($v as $k=>$r)
1089 $v[$k] = spip_mysql_quote($r, $type);
1092 // si on ne connait pas le type, s'en remettre a _q :
1093 // on ne fera pas mieux
1104 function spip_mysql_date_proche($champ, $interval, $unite)
1108 . (($interval <= 0) ?
'>' : '<')
1109 . (($interval <= 0) ?
'DATE_SUB' : 'DATE_ADD')
1111 . sql_quote(date('Y-m-d H:i:s'))
1113 . (($interval > 0) ?
$interval : (0-$interval))
1120 // IN (...) est limite a 255 elements, d'ou cette fonction assistante
1122 // http://doc.spip.org/@spip_mysql_in
1126 * @param string $not
1127 * @param string $serveur
1128 * @param bool $requeter
1131 function spip_mysql_in($val, $valeurs, $not='', $serveur='',$requeter=true) {
1134 while ($n = strpos($valeurs, ',', $n+
1)) {
1135 if ((++
$i) >= 255) {
1136 $in_sql .= "($val $not IN (" .
1137 substr($valeurs, 0, $n) .
1139 ($not ?
"AND\t" : "OR\t");
1140 $valeurs = substr($valeurs, $n+
1);
1144 $in_sql .= "($val $not IN ($valeurs))";
1149 // pour compatibilite. Ne plus utiliser.
1150 // http://doc.spip.org/@calcul_mysql_in
1154 * @param string $not
1157 function calcul_mysql_in($val, $valeurs, $not='') {
1158 if (is_array($valeurs))
1159 $valeurs = join(',', array_map('_q', $valeurs));
1160 elseif ($valeurs[0]===',') $valeurs = substr($valeurs,1);
1161 if (!strlen(trim($valeurs))) return ($not ?
"0=0" : '0=1');
1162 return spip_mysql_in($val, $valeurs, $not);
1165 // http://doc.spip.org/@spip_mysql_cite
1169 * @return int|string
1171 function spip_mysql_cite($v, $type) {
1173 AND stripos($type,"NOT NULL")===false) return 'NULL'; // null php se traduit en NULL SQL
1174 if (sql_test_date($type) AND preg_match('/^\w+\(/', $v))
1176 if (sql_test_int($type)) {
1177 if (is_numeric($v) OR (ctype_xdigit(substr($v,2))
1178 AND $v[0]=='0' AND $v[1]=='x'))
1180 // si pas numerique, forcer le intval
1184 return ("'" . addslashes($v) . "'");
1187 // Ces deux fonctions n'ont pas d'equivalent exact PostGres
1188 // et ne sont la que pour compatibilite avec les extensions de SPIP < 1.9.3
1191 // Poser un verrou local a un SPIP donne
1192 // Changer de nom toutes les heures en cas de blocage MySQL (ca arrive)
1194 // http://doc.spip.org/@spip_get_lock
1197 * @param int $timeout
1200 function spip_get_lock($nom, $timeout = 0) {
1202 define('_LOCK_TIME', intval(time()/3600-316982));
1204 $connexion = &$GLOBALS['connexions'][0];
1205 $bd = $connexion['db'];
1206 $prefixe = $connexion['prefixe'];
1207 $nom = "$bd:$prefixe:$nom" . _LOCK_TIME
;
1209 $connexion['last'] = $q = "SELECT GET_LOCK(" . _q($nom) . ", $timeout) AS n";
1210 $q = @sql_fetch
(mysql_query($q));
1211 if (!$q) spip_log("pas de lock sql pour $nom", _LOG_ERREUR
);
1215 // http://doc.spip.org/@spip_release_lock
1219 function spip_release_lock($nom) {
1221 $connexion = &$GLOBALS['connexions'][0];
1222 $bd = $connexion['db'];
1223 $prefixe = $connexion['prefixe'];
1224 $nom = "$bd:$prefixe:$nom" . _LOCK_TIME
;
1226 $connexion['last'] = $q = "SELECT RELEASE_LOCK(" . _q($nom) . ")";
1230 // Renvoie false si on n'a pas les fonctions mysql (pour l'install)
1231 // http://doc.spip.org/@spip_versions_mysql
1235 function spip_versions_mysql() {
1236 charger_php_extension('mysql');
1237 return function_exists('mysql_query');
1240 // Tester si mysql ne veut pas du nom de la base dans les requetes
1242 // http://doc.spip.org/@test_rappel_nom_base_mysql
1247 function test_rappel_nom_base_mysql($server_db)
1249 $GLOBALS['mysql_rappel_nom_base'] = true;
1250 sql_delete('spip_meta', "nom='mysql_rappel_nom_base'", $server_db);
1251 $ok = spip_query("INSERT INTO spip_meta (nom,valeur) VALUES ('mysql_rappel_nom_base', 'test')", $server_db);
1254 sql_delete('spip_meta', "nom='mysql_rappel_nom_base'", $server_db);
1257 $GLOBALS['mysql_rappel_nom_base'] = false;
1258 return "\$GLOBALS['mysql_rappel_nom_base'] = false; ".
1259 "/* echec de test_rappel_nom_base_mysql a l'installation. */\n";
1263 // http://doc.spip.org/@test_sql_mode_mysql
1268 function test_sql_mode_mysql($server_db){
1269 $res = sql_select("version() as v",'','','','','','',$server_db);
1270 $row = sql_fetch($res,$server_db);
1271 if (version_compare($row['v'],'5.0.0','>=')){
1272 define('_MYSQL_SET_SQL_MODE',true);
1273 return "define('_MYSQL_SET_SQL_MODE',true);\n";