模块

Model_Product
继承自 Model

产品模型

package
BootCMS
category
模型
author
Tinsh
copyright
© 2005-2016 Kilofox Studio

该类在 APPPATH/classes/model/product.php 第 13 行声明。

属性

protected $_db

private $_loaded

private $_values

方法

public create( array $data ) (在 Model_Product 中定义)

创建新产品。

参数

  • array $data required - 键值对

返回值

  • mixed - 插入的数据ID 或 false

源代码

public function create($data)
{
	if (is_object($data))
	{
		// 对象转数组(将来将 Validation 改写成操作对象后,就可以省略此步)
		$values = array();
		foreach ($data as $key => $val)
		{
			$values[$key] = $val;
		}
		// 验证数据
		$validation = self::getValidation($values);
		if (!$validation->check())
		{
			throw new Validation_Exception('user', $validation);
		}
		return $this->_db->insert('products', $values);
	}
	return false;
}

public delete( ) (在 Model_Product 中定义)

删除产品。

返回值

  • mixed - 执行结果

源代码

public function delete()
{
	if ($this->_loaded)
	{
		$where = "`id` = {$this->_values->id}";
		return $this->_db->delete('products', $where);
	}
	return false;
}

public static factory( ) (在 Model_Product 中定义)

创建并返回一个新的模型对象

返回值

  • 对象

源代码

public static function factory($name)
{
	return parent::factory($name);
}

public findAll( ) (在 Model_Product 中定义)

取得所有产品。

返回值

  • array - 数据

源代码

public function findAll()
{
	$sql = "SELECT * FROM `" . $this->_db->tablePrefix . "products`";
	return $this->_db->selectArray($sql);
}

public findAllWithCategory( ) (在 Model_Product 中定义)

按分类取得产品。

返回值

  • array - 数据

源代码

public function findAllWithCategory()
{
	$sql = "SELECT p.* FROM `" . $this->_db->tablePrefix . "products` p LEFT JOIN `" . $this->_db->tablePrefix . "product_categories` c ON p.category = c.id WHERE `status` = 0 ORDER BY c.order, p.order";
	return $this->_db->selectArray($sql);
}

public findByCategory( ) (在 Model_Product 中定义)

根据分类取得产品

返回值

  • array - 数据

源代码

public function findByCategory($category = 0)
{
	$sql = "SELECT * FROM `" . $this->_db->tablePrefix . "products` WHERE `category` = $category";
	return $this->_db->selectArray($sql);
}

public findByPage( [ string $where = string(0) "" , string $orderBy = string(0) "" , integer $start = integer 0 , integer $limit = integer 10 ] ) (在 Model_Product 中定义)

按分页取得产品。

参数

  • string $where = string(0) "" - 查询条件
  • string $orderBy = string(0) "" - 排序方式
  • integer $start = integer 0 - 开始
  • integer $limit = integer 10 - 数量

返回值

  • array - 数据

源代码

public function findByPage($where = '', $orderBy = '', $start = 0, $limit = 10)
{
	$orderBy = $orderBy ? $orderBy : 'p.id';
	$sql = "SELECT p.*, c.name FROM `" . $this->_db->tablePrefix . "products` p LEFT JOIN `" . $this->_db->tablePrefix . "product_categories` c ON p.category = c.id WHERE 1 $where ORDER BY $orderBy LIMIT $start, $limit";
	$result = $this->_db->selectArray($sql);
	$sql = "SELECT COUNT(*) AS num FROM `" . $this->_db->tablePrefix . "products` p LEFT JOIN `" . $this->_db->tablePrefix . "product_categories` c ON p.category = c.id WHERE 1 $where";
	$total = $this->_db->select($sql)->num;
	return array($result, $total);
}

public static getValidation( array $values ) (在 Model_Product 中定义)

数据验证。

参数

  • array $values required - $values

返回值

  • Validation

源代码

public static function getValidation($values)
{
	return Validation::factory($values)
			->rule('category', 'not_empty')
			->rule('product_name', 'not_empty')
			->rule('commodity_price', 'not_empty')
			->rule('promotion_price', 'numeric');
}

public load( ) (在 Model_Product 中定义)

根据主键加载数据,并返回对象。

返回值

  • 对象

源代码

public function load($id = 0)
{
	if (is_numeric($id) && $id > 0)
	{
		$sql = "SELECT * FROM `" . $this->_db->tablePrefix . "products` WHERE `id` = $id";
		$this->_values = $this->_db->select($sql);
		$this->_loaded = true;
	}
	return $this->_values;
}

public loadByName( ) (在 Model_Product 中定义)

根据名称加载数据,并返回对象。

返回值

  • 对象

源代码

public function loadByName($name)
{
	if ($name)
	{
		$sql = "SELECT * FROM `" . $this->_db->tablePrefix . "products` WHERE `product_name` = '$name'";
		$this->_values = $this->_db->select($sql);
		$this->_loaded = true;
	}
	return $this->_values;
}

public sortProducts( array $orders ) (在 Model_Product 中定义)

对产品排序。

参数

  • array $orders required - 数据

返回值

  • integer - 影响的行数

源代码

public function sortProducts($orders)
{
	$count = 0;
	if (is_array($orders))
	{
		foreach ($orders as $p)
		{
			$p = explode('|', $p);
			if (count($p) == 2)
			{
				foreach ($p as $f)
				{
					if (!is_numeric($f))
						return 0;
				}
				$where = "`id` = {$p[0]}";
				$result = $this->_db->update('products', array('list_order' => $p[1]), $where);
				if ($result)
					$count++;
			}
		}
	}
	return $count;
}

public update( ) (在 Model_Product 中定义)

更新产品。

返回值

  • 执行结果

源代码

public function update()
{
	if ($this->_loaded)
	{
		// 对象转数组(将来将 Validation 改写成操作对象后,就可以省略此步)
		$values = array();
		foreach ($this->_values as $key => $val)
		{
			$values[$key] = $val;
		}
		// 验证数据
		$validation = self::getValidation($values);
		if (!$validation->check())
		{
			throw new Validation_Exception('user', $validation);
		}
		$where = "`id` = {$this->_values->id}";
		return $this->_db->update('products', $this->_values, $where);
	}
	return false;
}

public updatePrices( array $products ) (在 Model_Product 中定义)

更新产品价格。

参数

  • array $products required - 数据

返回值

  • integer - 影响的行数

源代码

public function updatePrices($products)
{
	$count = 0;
	if (is_array($products))
	{
		foreach ($products as $p)
		{
			$p = explode('|', substr($p, 0, -1));
			if (count($p) == 4)
			{
				foreach ($p as $f)
				{
					if (!is_numeric($f))
						return 0;
				}
				$set = array(
					'commodity_price' => $p[1],
					'promotion_price' => $p[2],
					'promote' => $p[3]
				);
				$where = "`id` = {$p[0]}";
				$result = $this->_db->update('products', $set, $where);
				if ($result)
					$count++;
			}
		}
	}
	return $count;
}

public __construct( ) (在 Model 中定义)

源代码

public function __construct()
{
	if (!is_object($this->_db))
	{
		$this->_db = Database::instance();
	}
}