<?php /* vim: set expandtab sw=4 ts=4 sts=4: */ /** * Handles bookmarking SQL queries * * @package PhpMyAdmin */ namespace PhpMyAdmin; use PhpMyAdmin\DatabaseInterface; use PhpMyAdmin\Relation; use PhpMyAdmin\Util; /** * Handles bookmarking SQL queries * * @package PhpMyAdmin */ class Bookmark { /** * ID of the bookmark * * @var int */ private $_id; /** * Database the bookmark belongs to * * @var string */ private $_database; /** * The user to whom the bookmark belongs, empty for public bookmarks * * @var string */ private $_user; /** * Label of the bookmark * * @var string */ private $_label; /** * SQL query that is bookmarked * * @var string */ private $_query; /** * @var DatabaseInterface */ private $dbi; /** * Current user * * @var string */ private $user; public function __construct(DatabaseInterface $dbi, $user) { $this->dbi = $dbi; $this->user = $user; } /** * Returns the ID of the bookmark * * @return int */ public function getId() { return $this->_id; } /** * Returns the database of the bookmark * * @return string */ public function getDatabase() { return $this->_database; } /** * Returns the user whom the bookmark belongs to * * @return string */ public function getUser() { return $this->_user; } /** * Returns the label of the bookmark * * @return string */ public function getLabel() { return $this->_label; } /** * Returns the query * * @return string */ public function getQuery() { return $this->_query; } /** * Adds a bookmark * * @return boolean whether the INSERT succeeds or not * * @access public */ public function save() { $cfgBookmark = self::getParams($this->user); if (empty($cfgBookmark)) { return false; } $query = "INSERT INTO " . Util::backquote($cfgBookmark['db']) . "." . Util::backquote($cfgBookmark['table']) . " (id, dbase, user, query, label) VALUES (NULL, " . "'" . $this->dbi->escapeString($this->_database) . "', " . "'" . $this->dbi->escapeString($this->_user) . "', " . "'" . $this->dbi->escapeString($this->_query) . "', " . "'" . $this->dbi->escapeString($this->_label) . "')"; return $this->dbi->query($query, DatabaseInterface::CONNECT_CONTROL); } /** * Deletes a bookmark * * @return bool true if successful * * @access public */ public function delete() { $cfgBookmark = self::getParams($this->user); if (empty($cfgBookmark)) { return false; } $query = "DELETE FROM " . Util::backquote($cfgBookmark['db']) . "." . Util::backquote($cfgBookmark['table']) . " WHERE id = " . $this->_id; return $this->dbi->tryQuery($query, DatabaseInterface::CONNECT_CONTROL); } /** * Returns the number of variables in a bookmark * * @return number number of variables */ public function getVariableCount() { $matches = array(); preg_match_all("/\[VARIABLE[0-9]*\]/", $this->_query, $matches, PREG_SET_ORDER); return count($matches); } /** * Replace the placeholders in the bookmark query with variables * * @param array $variables array of variables * * @return string query with variables applied */ public function applyVariables(array $variables) { // remove comments that encloses a variable placeholder $query = preg_replace( '|/\*(.*\[VARIABLE[0-9]*\].*)\*/|imsU', '${1}', $this->_query ); // replace variable placeholders with values $number_of_variables = $this->getVariableCount(); for ($i = 1; $i <= $number_of_variables; $i++) { $var = ''; if (! empty($variables[$i])) { $var = $this->dbi->escapeString($variables[$i]); } $query = str_replace('[VARIABLE' . $i . ']', $var, $query); // backward compatibility if ($i == 1) { $query = str_replace('[VARIABLE]', $var, $query); } } return $query; } /** * Defines the bookmark parameters for the current user * * @param string $user Current user * @return array the bookmark parameters for the current user * @access public */ public static function getParams($user) { static $cfgBookmark = null; if (null !== $cfgBookmark) { return $cfgBookmark; } $relation = new Relation(); $cfgRelation = $relation->getRelationsParam(); if ($cfgRelation['bookmarkwork']) { $cfgBookmark = array( 'user' => $user, 'db' => $cfgRelation['db'], 'table' => $cfgRelation['bookmark'], ); } else { $cfgBookmark = false; } return $cfgBookmark; } /** * Creates a Bookmark object from the parameters * * @param DatabaseInterface $dbi DatabaseInterface object * @param string $user Current user * @param array $bkm_fields the properties of the bookmark to add; here, * $bkm_fields['bkm_sql_query'] is urlencoded * @param boolean $all_users whether to make the bookmark * available for all users * * @return Bookmark|false */ public static function createBookmark( DatabaseInterface $dbi, $user, array $bkm_fields, $all_users = false ) { if (!(isset($bkm_fields['bkm_sql_query']) && strlen($bkm_fields['bkm_sql_query']) > 0 && isset($bkm_fields['bkm_label']) && strlen($bkm_fields['bkm_label']) > 0) ) { return false; } $bookmark = new Bookmark($dbi, $user); $bookmark->_database = $bkm_fields['bkm_database']; $bookmark->_label = $bkm_fields['bkm_label']; $bookmark->_query = $bkm_fields['bkm_sql_query']; $bookmark->_user = $all_users ? '' : $bkm_fields['bkm_user']; return $bookmark; } /** * Gets the list of bookmarks defined for the current database * * @param DatabaseInterface $dbi DatabaseInterface object * @param string $user Current user * @param string|bool $db the current database name or false * * @return Bookmark[] the bookmarks list * * @access public */ public static function getList(DatabaseInterface $dbi, $user, $db = false) { $cfgBookmark = self::getParams($user); if (empty($cfgBookmark)) { return array(); } $query = "SELECT * FROM " . Util::backquote($cfgBookmark['db']) . "." . Util::backquote($cfgBookmark['table']) . " WHERE ( `user` = ''" . " OR `user` = '" . $dbi->escapeString($cfgBookmark['user']) . "' )"; if ($db !== false) { $query .= " AND dbase = '" . $dbi->escapeString($db) . "'"; } $query .= " ORDER BY label ASC"; $result = $dbi->fetchResult( $query, null, null, DatabaseInterface::CONNECT_CONTROL, DatabaseInterface::QUERY_STORE ); if (! empty($result)) { $bookmarks = array(); foreach ($result as $row) { $bookmark = new Bookmark($dbi, $user); $bookmark->_id = $row['id']; $bookmark->_database = $row['dbase']; $bookmark->_user = $row['user']; $bookmark->_label = $row['label']; $bookmark->_query = $row['query']; $bookmarks[] = $bookmark; } return $bookmarks; } return array(); } /** * Retrieve a specific bookmark * * @param DatabaseInterface $dbi DatabaseInterface object * @param string $user Current user * @param string $db the current database name * @param mixed $id an identifier of the bookmark to get * @param string $id_field which field to look up the identifier * @param boolean $action_bookmark_all true: get all bookmarks regardless * of the owning user * @param boolean $exact_user_match whether to ignore bookmarks with no user * * @return Bookmark the bookmark * * @access public * */ public static function get( DatabaseInterface $dbi, $user, $db, $id, $id_field = 'id', $action_bookmark_all = false, $exact_user_match = false ) { $cfgBookmark = self::getParams($user); if (empty($cfgBookmark)) { return null; } $query = "SELECT * FROM " . Util::backquote($cfgBookmark['db']) . "." . Util::backquote($cfgBookmark['table']) . " WHERE dbase = '" . $dbi->escapeString($db) . "'"; if (! $action_bookmark_all) { $query .= " AND (user = '" . $dbi->escapeString($cfgBookmark['user']) . "'"; if (! $exact_user_match) { $query .= " OR user = ''"; } $query .= ")"; } $query .= " AND " . Util::backquote($id_field) . " = '" . $dbi->escapeString($id) . "' LIMIT 1"; $result = $dbi->fetchSingleRow($query, 'ASSOC', DatabaseInterface::CONNECT_CONTROL); if (! empty($result)) { $bookmark = new Bookmark($dbi, $user); $bookmark->_id = $result['id']; $bookmark->_database = $result['dbase']; $bookmark->_user = $result['user']; $bookmark->_label = $result['label']; $bookmark->_query = $result['query']; return $bookmark; } return null; } }
Name | Type | Size | Permission | Actions |
---|---|---|---|---|
Config | Folder | 0755 |
|
|
Controllers | Folder | 0755 |
|
|
Database | Folder | 0755 |
|
|
Dbi | Folder | 0755 |
|
|
Di | Folder | 0755 |
|
|
Display | Folder | 0755 |
|
|
Engines | Folder | 0755 |
|
|
Gis | Folder | 0755 |
|
|
Navigation | Folder | 0755 |
|
|
Plugins | Folder | 0755 |
|
|
Properties | Folder | 0755 |
|
|
Rte | Folder | 0755 |
|
|
Server | Folder | 0755 |
|
|
Twig | Folder | 0755 |
|
|
Utils | Folder | 0755 |
|
|
Advisor.php | File | 18.79 KB | 0644 |
|
Bookmark.php | File | 10.37 KB | 0644 |
|
BrowseForeigners.php | File | 10.73 KB | 0644 |
|
CentralColumns.php | File | 53.12 KB | 0644 |
|
Charsets.php | File | 24.92 KB | 0644 |
|
CheckUserPrivileges.php | File | 11.58 KB | 0644 |
|
Config.php | File | 59.69 KB | 0644 |
|
Console.php | File | 3.58 KB | 0644 |
|
Core.php | File | 38.98 KB | 0644 |
|
CreateAddField.php | File | 17.97 KB | 0644 |
|
DatabaseInterface.php | File | 103.86 KB | 0644 |
|
Encoding.php | File | 8.25 KB | 0644 |
|
Error.php | File | 13.05 KB | 0644 |
|
ErrorHandler.php | File | 16.68 KB | 0644 |
|
ErrorReport.php | File | 8.37 KB | 0644 |
|
Export.php | File | 40.32 KB | 0644 |
|
File.php | File | 20.53 KB | 0644 |
|
FileListing.php | File | 2.83 KB | 0644 |
|
Font.php | File | 4.25 KB | 0644 |
|
Footer.php | File | 10.54 KB | 0644 |
|
Header.php | File | 25.81 KB | 0644 |
|
Import.php | File | 55.59 KB | 0644 |
|
Index.php | File | 24.63 KB | 0644 |
|
IndexColumn.php | File | 4.43 KB | 0644 |
|
InsertEdit.php | File | 129.29 KB | 0644 |
|
IpAllowDeny.php | File | 9.21 KB | 0644 |
|
Language.php | File | 4.3 KB | 0644 |
|
LanguageManager.php | File | 23.42 KB | 0644 |
|
Linter.php | File | 5.1 KB | 0644 |
|
ListAbstract.php | File | 3.15 KB | 0644 |
|
ListDatabase.php | File | 4.22 KB | 0644 |
|
Logging.php | File | 2.56 KB | 0644 |
|
Menu.php | File | 22.34 KB | 0644 |
|
Message.php | File | 19.19 KB | 0644 |
|
Mime.php | File | 891 B | 0644 |
|
MultSubmits.php | File | 23.19 KB | 0644 |
|
Normalization.php | File | 39.03 KB | 0644 |
|
OpenDocument.php | File | 8.5 KB | 0644 |
|
Operations.php | File | 79.06 KB | 0644 |
|
OutputBuffering.php | File | 3.63 KB | 0644 |
|
ParseAnalyze.php | File | 2.46 KB | 0644 |
|
Partition.php | File | 7.26 KB | 0644 |
|
Pdf.php | File | 4.07 KB | 0644 |
|
Plugins.php | File | 21.42 KB | 0644 |
|
RecentFavoriteTable.php | File | 12.13 KB | 0644 |
|
Relation.php | File | 78.19 KB | 0644 |
|
RelationCleanup.php | File | 14.7 KB | 0644 |
|
Replication.php | File | 5.37 KB | 0644 |
|
ReplicationGui.php | File | 41.79 KB | 0644 |
|
Response.php | File | 16.31 KB | 0644 |
|
Sanitize.php | File | 14.15 KB | 0644 |
|
SavedSearches.php | File | 11.95 KB | 0644 |
|
Scripts.php | File | 5.33 KB | 0644 |
|
Session.php | File | 7.82 KB | 0644 |
|
Sql.php | File | 88.22 KB | 0644 |
|
SqlQueryForm.php | File | 17.19 KB | 0644 |
|
StorageEngine.php | File | 13.47 KB | 0644 |
|
SubPartition.php | File | 3.53 KB | 0644 |
|
SysInfo.php | File | 1.54 KB | 0644 |
|
SysInfoBase.php | File | 801 B | 0644 |
|
SysInfoLinux.php | File | 1.96 KB | 0644 |
|
SysInfoSunOS.php | File | 1.87 KB | 0644 |
|
SysInfoWINNT.php | File | 3.25 KB | 0644 |
|
SystemDatabase.php | File | 3.84 KB | 0644 |
|
Table.php | File | 92.59 KB | 0644 |
|
Template.php | File | 3.91 KB | 0644 |
|
Theme.php | File | 10.53 KB | 0644 |
|
ThemeManager.php | File | 10.73 KB | 0644 |
|
Tracker.php | File | 29.72 KB | 0644 |
|
Tracking.php | File | 41.99 KB | 0644 |
|
Transformations.php | File | 16.12 KB | 0644 |
|
TwoFactor.php | File | 7.1 KB | 0644 |
|
Types.php | File | 22.75 KB | 0644 |
|
Url.php | File | 8.17 KB | 0644 |
|
UserPassword.php | File | 8.47 KB | 0644 |
|
UserPreferences.php | File | 8.52 KB | 0644 |
|
Util.php | File | 162.99 KB | 0644 |
|
VersionInformation.php | File | 6.34 KB | 0644 |
|
ZipExtension.php | File | 9.98 KB | 0644 |
|