* @link http://netmonsters.ru * @package Majestic * @subpackage Model * @since 2011-11-11 */ /** * @property SqlDbDriver $db */ abstract class SqlModel extends Model { const SELECT = 10; const DISTINCT = 11; const WHERE = 12; const ORDER = 13; const ORDER_TO_DESC = 14; const LIMIT = 15; const OFFSET = 16; protected static $criteria_data_keys = array( self::SELECT, self::DISTINCT, self::WHERE, self::ORDER, /** self::ORDER_TO_DESC, // no to be process in foreach criteria_data @see SqlModel::find() */ self::LIMIT, /** self::OFFSET // no to be process in foreach criteria_data @see SqlModel::find() */ ); /** * @param string $ident * @return string Quoted identifier. */ public function identify($ident) { return $this->db->quoteIdentifier($ident); } /** * @param mixed $value * @return string Quoted value. */ public function quote($value) { return $this->db->quote($value); } /** * @param int $id * @return object */ public function get($id) { $sql = 'SELECT * FROM :table WHERE :pk=?'; return $this->fetch($sql, $id); } /** * @param array $data * @param mixed $where * @return int Number of affected rows */ public function update($data, $where) { if (is_int($where) || $where === (string) (int) $where) { $where = $this->identify($this->key) . '=' . (int) $where; } return parent::update($data, $where); } /** * @param int $id Int id * @return int Number of affected rows */ public function delete($id) { $where = $this->identify($this->key) . '=' . (int) $id; return $this->db->delete($this->table(), $where); } /** * Creates order sql string * * @param array $params * @param array $sortable * @return string */ protected function order($params, $sortable = array('id')) { $sql = ''; if (isset($params['sort'])) { $order = (isset($params['order']) && $params['order'] == 'desc') ? 'DESC' : 'ASC'; if (in_array($params['sort'], $sortable)) { $sql = ' ORDER BY ' . $this->identify($params['sort']) . ' ' . $order; } } return $sql; } /** * Searches using like * * @param array $params * @param array $searchable * @param string $table_prefix * @return string */ protected function search($params, $searchable = array('id'), $table_prefix = '') { $sql = ''; if (isset($params['q']) && isset($params['qt']) && in_array($params['qt'], $searchable)) { if ($table_prefix) { $sql = $table_prefix . '.'; } $sql .= $this->identify($params['qt']) . ' LIKE ' . $this->quote('%' . $params['q'] . '%'); } return $sql; } /** * This method appends to params table and primary key. * So they can be accessed through `:table` and `:pk` placeholders. * * @param string $sql * @param array $params * @return DbStatement */ protected function query($sql, $params = array()) { if (!is_array($params)) { $params = array($params); } $params = array( 'table' => new DbExpr($this->identify($this->table())), 'pk' => new DbExpr($this->identify($this->key)), ) + $params; return $this->db->query($sql, $params); } /** * @param string $data Request * @param array $params Request parameters * @param string $field Requested field name * @param CacheKey $cache_key Key for caching in * @return mixed */ protected function fetchField($data, $params = array(), $field, $cache_key = null) { if (!$cache_key || !$result = $cache_key->get()) { $result = $this->query($data, $params)->fetchField($field); if ($cache_key) { $cache_key->set($result); } } return $result; } /** * @param string $data Request * @param array $params Request parameters * @param CacheKey $cache_key Key for caching in * @return mixed */ protected function fetch($data, $params = array(), $cache_key = null) { if (!$cache_key || !$result = $cache_key->get()) { $result = $this->query($data, $params)->fetch(); if ($cache_key) { $cache_key->set($result); } } return $result; } /** * @param string $data * @param array $params * @param CacheKey $cache_key * @return array */ protected function fetchAll($data, $params = array(), $cache_key = null) { if (!$cache_key || !$result = $cache_key->get()) { $result = $this->query($data, $params)->fetchAll(); if ($cache_key) { $cache_key->set($result); } } return $result; } /** * @param $criteria SqlCriteria * @return string Sql string expression */ protected function criteria($criteria) { foreach ($criteria->select as $field => &$term) { if (is_int($field)) { $term = $this->db->quoteIdentifier($term); } else { $term = $this->db->quoteIdentifier($field) . ' as ' . $this->db->quoteIdentifier($term); } } foreach ($criteria->where as $cond => &$term) { $term = $this->db->quoteInto($cond, $term); } foreach ($criteria->order as $field => $term) { if (!is_int($field) && $term == 'desc') { $term = $term = $this->db->quoteIdentifier($field) . ' DESC'; } else { $term = $this->db->quoteIdentifier($term); } } if ($criteria->distinct != '') { $criteria->distinct = 'DISTINCT ' . $this->db->quoteIdentifier($criteria->distinct); } return 'SELECT ' . (($criteria->distinct) ? $criteria->distinct : implode(',', $criteria->select)) . ' FROM ' . $this->db->quoteIdentifier($this->table) . (($criteria->where) ? (' WHERE ' . implode(' AND ', $criteria->where)) : '') . (($criteria->order) ? (' ORDER BY ' . implode(',', $criteria->order)) : '') . (($criteria->limit) ? (' LIMIT ' . implode(',',array_map(function($item){return intval($item);},explode(',',$criteria->limit)))) : ''); } /** * @param $criteria_data array * @ex array( * SqlModel::SELECT => '*', * SqlModel::WHERE => array('field=?', 1), * SqlModel::ORDER => array('last_name', 'first_name'), * SqlModel::ORDER_TO_DESC => array('last_name'), * SqlModel::LIMIT => 10) * @return mixed|DbStatement[] */ public function find($criteria_data) { $criteria = new SqlCriteria(); foreach (self::$criteria_data_keys as $criteria_data_key) { if (isset($criteria_data[$criteria_data_key])) { $value = $criteria_data[$criteria_data_key]; switch ($criteria_data_key) { case self::SELECT: $criteria->select($value); break; case self::DISTINCT: $criteria->distinct($value); break; case self::WHERE: $criteria->where($value); break; case self::ORDER: $criteria->order($value, ((isset($criteria_data[self::ORDER_TO_DESC])) ? $criteria_data[self::ORDER_TO_DESC] : null)); break; case self::LIMIT: $criteria->limit($value, ((isset($criteria_data[self::OFFSET])) ? $criteria_data[self::OFFSET] : null)); break; } } } return self::fetchAll($this->criteria($criteria)); } }