在ThinkPHP中讀取數據的方式很多,通常分為讀取數據、讀取數據集和讀取字段值。
數據查詢方法支持的連貫操作方法有:
| 連貫操作 | 作用 | 支持的參數類型 |
|-----|-----|-----|
| where | 用于查詢或者更新條件的定義 | 字符串、數組和對象 |
| table | 用于定義要操作的數據表名稱 | 字符串和數組 |
| alias | 用于給當前數據表定義別名 | 字符串 |
| field | 用于定義要查詢的字段(支持字段排除) | 字符串和數組 |
| order | 用于對結果排序 | 字符串和數組 |
| group | 用于對查詢的group支持 | 字符串 |
| having | 用于對查詢的having支持 | 字符串 |
| join | 用于對查詢的join支持 | 字符串和數組 |
| union | 用于對查詢的union支持 | 字符串、數組和對象 |
| distinct | 用于查詢的distinct支持 | 布爾值 |
| lock | 用于數據庫的鎖機制 | 布爾值 |
| cache | 用于查詢緩存 | 支持多個參數 |
| relation | 用于關聯查詢(需要關聯模型支持) | 字符串 |
| result | 用于返回數據轉換 | 字符串 |
| scope | 用于命名范圍 | 字符串、數組 |
| bind | 用于數據綁定操作 | 數組 |
| comment | 用于SQL注釋 | 字符串 |
| fetchSql | 不執行SQL而只是返回SQL | 布爾值 |
> 注意:某些情況下有些連貫操作是無效的,例如limit方法對find方法是無效的。
## 讀取數據
讀取數據是指讀取數據表中的一行數據(或者關聯數據),主要通過`find`方法完成,例如:
~~~
$User = M("User"); // 實例化User對象
// 查找status值為1name值為think的用戶數據
$data = $User->where('status=1 AND name="thinkphp"')->find();
dump($data);
~~~
find方法查詢數據的時候可以配合相關的連貫操作方法,其中最關鍵的則是where方法,如何使用where方法我們會在[查詢語言](#)章節中詳細描述。
如果查詢出錯,find方法返回false,如果查詢結果為空返回NULL,查詢成功則返回一個關聯數組(鍵值是字段名或者別名)。 如果上面的查詢成功的話,會輸出:
~~~
array (size=3)
'name' => string 'thinkphp' (length=8)
'email' => string 'thinkphp@gmail.com' (length=18)
'status'=> int 1
~~~
> 即使滿足條件的數據不止一個,find方法也只會返回第一條記錄(可以通過order方法排序后查詢)。
還可以用data方法獲取查詢后的數據對象(查詢成功后)
~~~
$User = M("User"); // 實例化User對象
// 查找status值為1name值為think的用戶數據
$User->where('status=1 AND name="thinkphp"')->find();
dump($User->data());
~~~
## 讀取數據集
讀取數據集其實就是獲取數據表中的多行記錄(以及關聯數據),使用`select`方法,使用示例:
~~~
$User = M("User"); // 實例化User對象
// 查找status值為1的用戶數據 以創建時間排序 返回10條數據
$list = $User->where('status=1')->order('create_time')->limit(10)->select();
~~~
如果查詢出錯,select的返回值是false,如果查詢結果為空,則返回NULL,否則返回二維數組。
## 讀取字段值
讀取字段值其實就是獲取數據表中的某個列的多個或者單個數據,最常用的方法是 `getField`方法。
示例如下:
~~~
$User = M("User"); // 實例化User對象
// 獲取ID為3的用戶的昵稱
$nickname = $User->where('id=3')->getField('nickname');
~~~
默認情況下,當只有一個字段的時候,返回滿足條件的數據表中的該字段的第一行的值。
如果需要返回整個列的數據,可以用:
~~~
$User->getField('id',true); // 獲取id數組
//返回數據格式如array(1,2,3,4,5)一維數組,其中value就是id列的每行的值
~~~
如果傳入多個字段的話,默認返回一個關聯數組:
~~~
$User = M("User"); // 實例化User對象
// 獲取所有用戶的ID和昵稱列表
$list = $User->getField('id,nickname');
//兩個字段的情況下返回的是array(`id`=>`nickname`)的關聯數組,以id的值為key,nickname字段值為value
~~~
這樣返回的list是一個數組,鍵名是用戶的id字段的值,鍵值是用戶的昵稱nickname。
如果傳入多個字段的名稱,例如:
~~~
$list = $User->getField('id,nickname,email');
//返回的數組格式是array(`id`=>array(`id`=>value,`nickname`=>value,`email`=>value))是一個二維數組,key還是id字段的值,但value是整行的array數組,類似于select()方法的結果遍歷將id的值設為數組key
~~~
返回的是一個二維數組,類似select方法的返回結果,區別的是這個二維數組的鍵名是用戶的id(準確的說是getField方法的第一個字段名)。
如果我們傳入一個字符串分隔符:
~~~
$list = $User->getField('id,nickname,email',':');
~~~
那么返回的結果就是一個數組,鍵名是用戶id,鍵值是 `nickname:email`的輸出字符串。
getField方法還可以支持限制數量,例如:
~~~
$this->getField('id,name',5); // 限制返回5條記錄
$this->getField('id',3); // 獲取id數組 限制3條記錄
~~~
可以配合使用order方法使用。更多的查詢方法可以參考[查詢語言](#)章節。
- 序言
- 基礎
- 獲取ThinkPHP
- 環境要求
- 目錄結構
- 入口文件
- 自動生成
- 模塊
- 控制器
- 開發規范
- 配置
- 配置格式
- 配置加載
- 讀取配置
- 動態配置
- 擴展配置
- 批量配置
- 架構
- 模塊化設計
- URL模式
- 多層MVC
- CBD模式
- 命名空間
- 自動加載
- 應用模式
- 項目編譯
- 系統流程
- 路由
- 路由定義
- 規則路由
- 正則路由
- 靜態路由
- 閉包支持
- 實例說明
- 控制器
- 控制器定義
- 前置和后置操作
- Action參數綁定
- 偽靜態
- URL大小寫
- URL生成
- AJAX返回
- 跳轉和重定向
- 輸入變量
- 請求類型
- 空操作
- 空控制器
- 插件控制器
- 操作綁定到類
- 模型
- 模型定義
- 模型實例化
- 字段定義
- 連接數據庫
- 切換數據庫
- 分布式數據庫支持
- 連貫操作
- WHERE
- TABLE
- ALIAS
- DATA
- FIELD
- ORDER
- LIMIT
- PAGE
- GROUP
- HAVING
- JOIN
- UNION
- DISTINCT
- LOCK
- CACHE
- COMMENT
- RELATION
- USING
- fetchSql
- TOKEN
- STRICT
- INDEX
- 命名范圍
- CURD操作
- 數據創建
- 數據寫入
- 數據讀取
- 數據更新
- 數據刪除
- ActiveRecord
- 字段映射
- 查詢語言
- 查詢方式
- 表達式查詢
- 快捷查詢
- 區間查詢
- 組合查詢
- 統計查詢
- SQL查詢
- 動態查詢
- 子查詢
- 自動驗證
- 自動完成
- 參數綁定
- 虛擬模型
- 模型分層
- 視圖模型
- 關聯模型
- 高級模型
- Mongo模型
- 視圖
- 模板定義
- 模板主題
- 模板賦值
- 模板渲染
- 獲取模板地址
- 獲取內容
- 模板引擎
- 模板
- 變量輸出
- 系統變量
- 使用函數
- 默認值輸出
- 使用運算符
- 標簽庫
- 模板繼承
- 修改定界符
- 三元運算
- 包含文件
- 內置標簽
- Volist標簽
- Foreach標簽
- For標簽
- Switch標簽
- 比較標簽
- 范圍判斷標簽
- IF標簽
- Present標簽
- Empty標簽
- Defined標簽
- Assign標簽
- Define標簽
- 標簽嵌套
- import標簽
- 使用PHP代碼
- 原樣輸出
- 模板注釋
- 模板布局
- 模板替換
- 調試
- 調試模式
- 異常處理
- 日志記錄
- 頁面Trace
- Trace方法
- 變量調試
- 性能調試
- 錯誤調試
- 模型調試
- 緩存
- 數據緩存
- 快速緩存
- 查詢緩存
- 靜態緩存
- 安全
- 輸入過濾
- 表單合法性檢測
- 表單令牌
- 防止SQL注入
- 目錄安全文件
- 保護模板文件
- 上傳安全
- 防止XSS攻擊
- 其他安全建議
- 擴展
- 類庫擴展
- 驅動擴展
- 緩存驅動
- 數據庫驅動
- 日志驅動
- Session驅動
- 存儲驅動
- 模板引擎驅動
- 標簽庫驅動
- 行為擴展
- 標簽擴展
- Widget擴展
- 應用模式
- 部署
- PATH_INFO支持
- URL重寫
- 模塊部署
- 域名部署
- 入口綁定
- 替換入口
- 專題
- SESSION支持
- Cookie支持
- 多語言支持
- 數據分頁
- 文件上傳
- 驗證碼
- 圖像處理
- RESTFul
- RPC
- SAE
- IP獲取和定位
- 附錄
- 常量參考
- 配置參考
- 升級指導
- 鳴謝