## 基本方法
DbModel在基本方法的基礎上封裝了一些便捷方法，以加速開發，方便使用。
* * * * *
#### getRowById 根據主鍵id獲取一條數據
~~~
DbModel::getRowById($id, $fields = '*')
~~~
根據主鍵id獲取一條數據。
參數表
| 參數名稱 | 必選 | 類型 | 說明 |
| --- | --- | --- | --- |
| id | 是 | int | 主鍵id |
| fields | 是 | string, array | 字段名列表 |
fields可以是逗號（,）分隔的字符串，也可以是數組。形如：'id, name, email, age' 或 ['id', 'name', 'email', 'age'] 均可，默認是全部。
用例：
~~~
/**
* 測試根據id獲取一行數據
*
* @return array
*/
public function testGetRowById()
{
return $this->getRowById(1);
}
~~~
* * * * *
#### getFieldById 根據主鍵id獲取某個字段值
~~~
DbModel::getFieldById($id, $field)
~~~
根據主鍵id獲取某個字段值。
參數表
| 參數名稱 | 必選 | 類型 | 說明 |
| --- | --- | --- | --- |
| id | 是 | int | 主鍵id |
| fields | 是 | string | 字段名 |
用例：
~~~
/**
* 測試根據id獲取一個字段的值
*
* @return mixed|string
*/
public function testGetFieldById()
{
return $this->getFieldById(1, 'name');
}
~~~
* * * * *
#### getCount 獲取滿足查詢條件的記錄數量
~~~
DbModel::getCount()
~~~
獲取滿足查詢條件的記錄數量。
參數表
無
用例：
~~~
/**
* 測試滿足查詢條件的數據行數
*
* @return int
*/
public function testGetCount()
{
$count = $this->where('name', '楊文杰')
->andWhere('id', '<=', 15)
->getCount();
return $count;
}
~~~
* * * * *
#### getRowsByIds 根據主鍵id列表取得多條記錄
~~~
DbModel::getRowsByIds($ids, $fields = '*')
~~~
根據主鍵id列表取得多條記錄。
參數表
| 參數名稱 | 必選 | 類型 | 說明 |
| --- | --- | --- | --- |
| id | 是 | int | 主鍵id |
| fields | 是 | string, array | 字段名列表 |
fields可以是逗號（,）分隔的字符串，也可以是數組。形如：'id, name, email, age' 或 ['id', 'name', 'email', 'age'] 均可，默認是全部。
用例：
~~~
/**
* 測試根據id列表獲取多行數據
*
* @return array
*/
public function testGetRowsByIds()
{
$ids = [1, 2, 3];
$fields = 'id, name, email';
return $this->getRowsByIds($ids, $fields);
}
~~~
* * * * *
#### updateById 根據主鍵id更新一條記錄
~~~
DbModel::updateById($id, $row)
~~~
根據主鍵id更新一條記錄。
參數表
| 參數名稱 | 必選 | 類型 | 說明 |
| --- | --- | --- | --- |
| id | 是 | int | 主鍵id |
| row | 是 | array | 要更新的數據數組，必須是鍵值對數組 |
row必須是鍵值對數組，以字段名為鍵名，以字段值為鍵值，一維數組。
用例：
~~~
/**
* 測試根據id更新一行數據
*
* @return int 返回影響行數
*/
public function testUpdateById()
{
$id = 9;
$row = ['name' => '李老四', 'email' => '99@qq.com'];
return $this->updateById($id, $row);
}
~~~
* * * * *
#### deleteById 根據主鍵id刪除一條記錄
~~~
DbModel::deleteById($id)
~~~
根據主鍵id刪除一條記錄。
參數表
| 參數名稱 | 必選 | 類型 | 說明 |
| --- | --- | --- | --- |
| id | 是 | int | 主鍵id |
用例：
~~~
/**
* 測試根據id刪除一行數據
*
* @return int 返回影響行數
*/
public function testDeleteById()
{
$id = 7;
return $this->deleteById($id);
}
~~~
* * * * *
#### pluck 獲取字段值列表
~~~
DbModel::pluck($field)
~~~
獲取字段值列表。
參數表
| 參數名稱 | 必選 | 類型 | 說明 |
| --- | --- | --- | --- |
| field | 是 | string | 字段名 |
用例：
~~~
/**
* 測試獲取字段值列表
*
* @return array
*/
public function testPluck()
{
return $this->pluck('name');
}
~~~
返回結果示例：
~~~
[
"楊文杰",
"張三",
"李老四",
"張三他媽"
]
~~~
