phpmyadmin/libraries/bookmark.lib.php

   1 <?php
   2 /* vim: set expandtab sw=4 ts=4 sts=4: */
   3 /**
   4  * Set of functions used with the bookmark feature
   5  *
   6  * @package PhpMyAdmin
   7  */
   8 if (! defined('PHPMYADMIN')) {
   9     exit;
  10 }
  11
  12 /**
  13  * Defines the bookmark parameters for the current user
  14  *
  15  * @return array    the bookmark parameters for the current user
  16  * @access  public
  17  */
  18 function PMA_Bookmark_getParams()
  19 {
  20     static $cfgBookmark = null;
  21
  22     if (null !== $cfgBookmark) {
  23         return $cfgBookmark;
  24     }
  25
  26     $cfgRelation = PMA_getRelationsParam();
  27
  28     if ($cfgRelation['bookmarkwork']) {
  29         $cfgBookmark = array(
  30             'user'  => $GLOBALS['cfg']['Server']['user'],
  31             'db'    => $GLOBALS['cfg']['Server']['pmadb'],
  32             'table' => $GLOBALS['cfg']['Server']['bookmarktable'],
  33         );
  34     } else {
  35         $cfgBookmark = false;
  36     }
  37
  38     return $cfgBookmark;
  39 } // end of the 'PMA_Bookmark_getParams()' function
  40
  41
  42 /**
  43  * Gets the list of bookmarks defined for the current database
  44  *
  45  * @param string $db the current database name
  46  *
  47  * @return array the bookmarks list (key as index, label as value)
  48  *
  49  * @access public
  50  *
  51  * @global resource the controluser db connection handle
  52  */
  53 function PMA_Bookmark_getList($db)
  54 {
  55     global $controllink;
  56
  57     $cfgBookmark = PMA_Bookmark_getParams();
  58
  59     if (empty($cfgBookmark)) {
  60         return array();
  61     }
  62
  63     $query  = 'SELECT label, id FROM '. PMA_Util::backquote($cfgBookmark['db'])
  64         . '.' . PMA_Util::backquote($cfgBookmark['table'])
  65         . ' WHERE dbase = \'' . PMA_Util::sqlAddSlashes($db) . '\''
  66         . ' AND user = \'' . PMA_Util::sqlAddSlashes($cfgBookmark['user']) . '\''
  67         . ' ORDER BY label';
  68     $per_user = PMA_DBI_fetch_result(
  69         $query, 'id', 'label', $controllink, PMA_DBI_QUERY_STORE
  70     );
  71
  72     $query  = 'SELECT label, id FROM '. PMA_Util::backquote($cfgBookmark['db'])
  73         . '.' . PMA_Util::backquote($cfgBookmark['table'])
  74         . ' WHERE dbase = \'' . PMA_Util::sqlAddSlashes($db) . '\''
  75         . ' AND user = \'\''
  76         . ' ORDER BY label';
  77     $global = PMA_DBI_fetch_result(
  78         $query, 'id', 'label', $controllink, PMA_DBI_QUERY_STORE
  79     );
  80
  81     foreach ($global as $key => $val) {
  82         $global[$key] = $val . ' (' . __('shared') . ')';
  83     }
  84
  85     $ret = $global + $per_user;
  86
  87     asort($ret);
  88
  89     return $ret;
  90 } // end of the 'PMA_Bookmark_getList()' function
  91
  92
  93 /**
  94  * Gets the sql command from a bookmark
  95  *
  96  * @param string  $db                  the current database name
  97  * @param mixed   $id                  the id of the bookmark to get
  98  * @param string  $id_field            which field to look up the $id
  99  * @param boolean $action_bookmark_all true: get all bookmarks regardless
 100  *                                     of the owning user
 101  * @param boolean $exact_user_match    whether to ignore bookmarks with no user
 102  *
 103  * @return string    the sql query
 104  *
 105  * @access  public
 106  *
 107  * @global  resource  the controluser db connection handle
 108  *
 109  */
 110 function PMA_Bookmark_get($db, $id, $id_field = 'id', $action_bookmark_all = false,
 111     $exact_user_match = false
 112 ) {
 113     global $controllink;
 114
 115     $cfgBookmark = PMA_Bookmark_getParams();
 116
 117     if (empty($cfgBookmark)) {
 118         return '';
 119     }
 120
 121     $query = 'SELECT query FROM ' . PMA_Util::backquote($cfgBookmark['db'])
 122         . '.' . PMA_Util::backquote($cfgBookmark['table'])
 123         . ' WHERE dbase = \'' . PMA_Util::sqlAddSlashes($db) . '\'';
 124
 125     if (!$action_bookmark_all) {
 126         $query .= ' AND (user = \'' . PMA_Util::sqlAddSlashes($cfgBookmark['user']) . '\'';
 127         if (!$exact_user_match) {
 128             $query .= ' OR user = \'\'';
 129         }
 130         $query .= ')';
 131     }
 132
 133     $query .= ' AND ' . PMA_Util::backquote($id_field) . ' = ' . $id;
 134
 135     return PMA_DBI_fetch_value($query, 0, 0, $controllink);
 136 } // end of the 'PMA_Bookmark_get()' function
 137
 138 /**
 139  * Adds a bookmark
 140  *
 141  * @param array   $fields    the properties of the bookmark to add; here,
 142  *                           $fields['query'] is urlencoded
 143  * @param boolean $all_users whether to make the bookmark available for all users
 144  *
 145  * @return boolean   whether the INSERT succeeds or not
 146  *
 147  * @access  public
 148  *
 149  * @global  resource  the controluser db connection handle
 150  */
 151 function PMA_Bookmark_save($fields, $all_users = false)
 152 {
 153     global $controllink;
 154
 155     $cfgBookmark = PMA_Bookmark_getParams();
 156
 157     if (empty($cfgBookmark)) {
 158         return false;
 159     }
 160
 161     $query = 'INSERT INTO ' . PMA_Util::backquote($cfgBookmark['db'])
 162         . '.' . PMA_Util::backquote($cfgBookmark['table'])
 163         . ' (id, dbase, user, query, label)'
 164         . ' VALUES (NULL, \'' . PMA_Util::sqlAddSlashes($fields['dbase']) . '\', '
 165         . '\'' . ($all_users ? '' : PMA_Util::sqlAddSlashes($fields['user'])) . '\', '
 166         . '\'' . PMA_Util::sqlAddSlashes(urldecode($fields['query'])) . '\', '
 167         . '\'' . PMA_Util::sqlAddSlashes($fields['label']) . '\')';
 168     return PMA_DBI_query($query, $controllink);
 169 } // end of the 'PMA_Bookmark_save()' function
 170
 171
 172 /**
 173  * Deletes a bookmark
 174  *
 175  * @param string  $db the current database name
 176  * @param integer $id the id of the bookmark to get
 177  *
 178  * @return bool true if successful
 179  *
 180  * @access  public
 181  *
 182  * @global  resource  the controluser db connection handle
 183  */
 184 function PMA_Bookmark_delete($db, $id)
 185 {
 186     global $controllink;
 187
 188     $cfgBookmark = PMA_Bookmark_getParams();
 189
 190     if (empty($cfgBookmark)) {
 191         return false;
 192     }
 193
 194     $query  = 'DELETE FROM ' . PMA_Util::backquote($cfgBookmark['db'])
 195         . '.' . PMA_Util::backquote($cfgBookmark['table'])
 196         . ' WHERE (user = \'' . PMA_Util::sqlAddSlashes($cfgBookmark['user']) . '\''
 197         . '        OR user = \'\')'
 198         . ' AND id = ' . $id;
 199     return PMA_DBI_try_query($query, $controllink);
 200 } // end of the 'PMA_Bookmark_delete()' function
 201
 202
 203 /**
 204  * Bookmark Support
 205  */
 206 $GLOBALS['cfg']['Bookmark'] = PMA_Bookmark_getParams();
 207
 208 ?>