[TOC]
>[danger]取消`resultset_type`配置參數
數據集查詢結果不再受`resultset_type`配置參數影響,默認情況下,Db查詢統一返回數組,模型查詢統一返回模型對象和模型數據集對象。如果Db查詢的時候也需要返回數據集的話,可以顯式調用`fetchCollection`方法。
模型查詢單條數據的方法返回model,空數據使用`if($result)、if(empty($result))等是不會有效果的`我們需要將返回的空Model用toArray轉換為空數組在進行上面的判斷
tp5時數據返回的類型在配置文件設置:'resultset_type'=>'array' 返回類型改為數據集:'resultset_type'=>'collection'
tp6沒有統一規范返回數據的配置了(好像放在**database.php**配置文件還能用?)
## **最佳實踐**
>[info] 模型查詢的最佳實踐原則是:
> 在模型外部使用靜態方法進行查詢,
> 內部使用[動態方法](#index)查詢,包括使用數據庫的查詢構造器
# **獲取單個數據**
>[danger]`Model::find($idValue)` 返回的是模型對象實例或者null,如果不想返回null而是空模型對象則使用`Model::findOrEmpty($idValue)`
> 模型查詢除了使用自身的查詢方法(save、saveAll、delete、create、update、destroy)外,一樣可以使用數據庫的查詢構造器
> 如果你是在模型內部獲取數據,請不要使用`$this->name`的方式來獲取數據,請使用`$this->getAttr('name')`替代。
## **find($idValue)** 返回模型對象或者null
~~~
// 取出主鍵為1的數據,相當于select * from think_user where id=1;
$user = User::find(1);
echo $user->name;
// 取出主鍵為1,3的數據,相當于select * from think_user where id in(1,3) limit 1;
$user = User::find([1,3]);//既然是單條這里允許數組參數有什么用呢?
echo $user->name;
// 使用查詢構造器查詢滿足條件的數據
$user = User::where('name', 'thinkphp')->find();
echo $user->name;
~~~
## **findOrEmpty($idValue)** 返回模型對象,無數據頁返回空模型對象 轉成數組需要toArray方法
~~~
$user = User::where('name', 'thinkphp')->findOrEmpty();
//這種情況下,你可以用`isEmpty`方法來判斷當前是否為一個空模型。
if (!$user->isEmpty()) {
echo $user->name;
}
~~~
# **獲取多個數據select**
~~~
// 根據主鍵獲取多個數據
$list = User::select([1,2,3]);
查詢構造器:屬于BaseQuery類的數據庫查詢方法
// 使用查詢構造器查詢
$list = User::where('status', 1)->limit(3)->order('id', 'asc')->select();
foreach($list as $key=>$user){
echo $user->name;
}
~~~
# **獲取某個字段或者某個列的值column**
~~~
// 獲取某個用戶的積分
User::where('id',10)->value('score');
// 獲取某個列的所有值
User::where('status',1)->column('name');
// 以id為索引
User::where('status',1)->column('name','id');
~~~
>[danger] `value`和`column`方法返回的不再是一個模型對象實例,而是純粹的值或者某個列的數組。
# **<span id="index">動態查詢(getBy字段名)</span>**
支持數據庫的動態查詢方法,例如:
~~~
// 根據name字段查詢用戶
$user = User::getByName('thinkphp');
// 根據email字段查詢用戶
$user = User::getByEmail('thinkphp@qq.com');
~~~
# **聚合查詢count**
同樣在模型中也可以調用數據庫的聚合方法查詢,例如:
~~~
User::count();
User::where('status','>',0)->count();
User::where('status',1)->avg('score');
User::max('score');
~~~
注意,如果你的字段不是數字類型,是使用`max`/`min`的時候,需要加上第二個參數。
~~~
User::max('name', false);
~~~
# **數據分批處理**
模型也可以支持對返回的數據分批處理,這在處理大量數據的時候非常有用,例如:
~~~
User::chunk(100, function ($users) {
foreach($users as $user){
// 處理user模型對象
}
});
~~~
# **自定義數據集對象**
模型的`select`方法返回的是一個包含多個模型實例的數據集對象(默認為`\think\model\Collection`),支持在模型中單獨設置查詢數據集的返回對象的名稱,例如:
~~~
<?php
namespace app\index\model;
use think\Model;
class User extends Model
{
// 設置返回數據集的對象名
protected $resultSetType = '\app\common\Collection';
}
~~~
`resultSetType`屬性用于設置自定義的數據集使用的類名,該類應當繼承系統的`think\model\Collection`類。
>[danger]具體參閱數據集章節
# **使用游標查詢**
模型也可以使用數據庫的`cursor`方法進行游標查詢,返回生成器對象
~~~
foreach(User::where('status', 1)->cursor() as $user){
echo $user->name;
}
~~~
`user`變量是一個模型對象實例。
# **數組轉數據集collection**
collection(array)將數組轉為數據集后可以使用很多方法如hidden等這樣方便臨時隱藏字段等操作
# **隱藏不需要的字段 與 顯示指定的字段**
返回的數據如果是對象的化還可以使用hidden和visible方法 或者 定義hidden和visible屬性(推薦)
因為hidden和visible方法不能作用與關聯模型的數據,而定義在相關模型中的hidden和visible屬性則可以
不過hidden和visible方法可以用于臨時隱藏,將返回的對象轉為數據集,然后調用hidden方法就可以了
- 空白目錄
- php語法結構
- 安裝與更新
- 開啟調試模式及代碼跟蹤器
- 架構
- 源碼分析
- 應用初始化
- 請求流程
- 中間件源碼分析
- 請求處理源碼分析
- Request源碼分析
- 模板編譯流程
- 路由與請求流程
- 容器
- 獲取目錄位置
- 入口文件
- 多應用模式及URL訪問
- 依賴注入與容器
- 容器屬性及方法
- Container
- App
- facade
- 中間件(middleware)
- 系統服務
- extend 擴展類庫
- 筆記
- 配置
- env配置定義及獲取
- 配置文件的配置獲取
- 單應用模式-(配置)文件目錄結構(默認)
- 多應用模式(配置)文件目錄結構(配置文件)
- 配置文件
- 應用配置:app.php
- 緩存配置: cache.php
- 數據庫配置:database.php
- 路由和URL配置:route.php
- Cookie配置:cookie.php
- Session配置:session.php
- 命令行配置:console.php
- 多語言配置:lang.php
- 日志配置:log.php
- 頁面Trace配置:trace.php
- 磁盤配置: filesystem.php
- 中間件配置:middleware.php
- 視圖配置:view.php
- 改成用yaconf配置
- 事件
- 例子:省略事件類的demo
- 例子2:完整事件類
- 例子3:事件訂閱,監聽多個事件
- 解析
- 路由
- 路由定義
- 路由地址
- 變量規則
- MISS路由
- URL生成
- 閉包支持
- 路由參數
- 路由中間件
- 路由分組
- 資源路由
- 注解路由
- 路由綁定
- 域名路由
- 路由緩存
- 跨域路由
- 控制器
- 控制器定義
- 空控制器、空操作
- 空模塊處理
- RESTFul資源控制器
- 控制器中間件
- 請求對象Request(url參數)
- 請求信息
- 獲取輸入變量($_POST、$_GET等)
- 請求類型的獲取與偽裝
- HTTP頭信息
- 偽靜態
- 參數綁定
- 請求緩存
- 響應對象Response
- 響應輸出
- 響應參數
- 重定向
- 文件下載
- 錯誤頁面的處理辦法
- 應用公共文件common.php
- 模型
- 模型定義及常規屬性
- 模型數據獲取與模型賦值
- 查詢
- 數據集
- 增加
- 修改
- 刪除
- 條件
- 查詢范圍scope
- 獲取器
- 修改器
- 搜索器
- 軟刪除
- 模型事件
- 關聯預載入
- 模型關聯
- 一對一關聯
- 一對多關聯
- 多對多關聯
- 自動時間戳
- 事務
- 數據庫
- 查詢構造器
- 查詢合集
- 子查詢
- 聚合查詢
- 時間查詢
- 視圖查詢(比join簡單)
- 獲取查詢參數
- 快捷方法
- 動態查詢
- 條件查詢
- 打印sql語句
- 增
- 刪
- 改
- 查
- 鏈式操作
- 查詢表達式
- 分頁查詢
- 原生查詢
- JSON字段
- 鏈接數據庫配置
- 分布式數據庫
- 查詢事件
- Db獲取器
- 事務操作
- 存儲過程
- Db數據集
- 數據庫驅動
- 視圖
- 模板
- 模板配置
- 模板位置
- 模板渲染
- 模板變量與賦值(assign)
- 模板輸出替換
- url生成
- 模板詳解
- 內置標簽
- 三元運算
- 變量輸出
- 函數輸出
- Request請求參數
- 模板注釋及原樣輸出
- 模板繼承
- 模板布局
- 原生PHP
- 模板引擎
- 視圖過濾
- 視圖驅動
- 驗證
- 驗證進階之最終版
- 錯誤和日志
- 異常處理
- 日志處理
- 調試
- 調試模式
- Trace調試
- SQL調試
- 變量調試
- 遠程調試
- 雜項
- 緩存
- Session
- Cookie
- 多語言
- 上傳
- 擴展說明
- N+1查詢
- TP類庫
- 擴展類庫
- 數據庫遷移工具
- Workerman
- think助手工具庫
- 驗證碼
- Swoole
- request
- app
- Response
- View
- Validate
- Config
- 命令行
- 助手函數
- 升級指導(功能的添加與刪除說明)
- siyucms
- 開始
- 添加頁面流程
- 列表頁加載流程
- 彈出框
- 基礎控制器
- 基礎模型
- 快速構建
- 表單form構建
- 表格table構建
- MakeBuilder
- 前端組件
- 日期組件
- layer 彈層組件
- Moment.js 日期處理插件
- siyucms模板布局
- 函數即其變量
- 前端頁面
- $.operate.方法
- $.modal.方法:彈出層
- $.common.方法:通用方法
- 被cms重寫的表格options
- 自定義模板
- 搜索框
- 自定義form表單
- 獲取表單搜索參數并組裝為url字符串