# CURD操作
[上一頁](66.html "上一頁")[下一頁](68.html "下一頁")
ThinkPHP提供了靈活和方便的數據操作方法,對數據庫操作的四個基本操作(CURD):創建、更新、讀取和刪除的實現是最基本的,也是必須掌握的,在這基礎之上才能熟悉更多實用的數據操作方法。CURD操作通常是可以和連貫操作配合完成的。下面來分析下各自的用法:
(下面的CURD操作我們均以M方法創建模型實例來說明,因為不涉及到具體的業務邏輯)### 創建(Create)
在ThinkPHP中使用add方法新增數據到數據庫(而并不是create方法)。add 寫入(新增)數據到數據庫 用法 add($data='',$options=array(),$replace=false) 參數 data(可選):要新增的數據,支持數組和對象,如果留空取當前數據對象
options(可選):操作表達式,通常由連貫操作完成,默認為空數組
replace(可選):是否允許寫入時更新,默認為false(個別數據庫支持)
回調接口 寫入前 \_before\_insert(&$data,$options)
寫入成功 \_after\_insert($data,$options)
返回值 如果數據非法或者查詢錯誤則返回false
如果是自增主鍵 則返回主鍵值,否則返回1
相關方法 通常和data、create方法配合使用 使用示例如下:`$User?=?M("User");?//?實例化User對象<br class="calibre5"></br>$data['name']?=?'ThinkPHP';<br class="calibre5"></br>$data['email']?=?'ThinkPHP@gmail.com';<br class="calibre5"></br>$User->add($data);`或者使用data方法連貫操作`$User->data($data)->add();`如果在add之前已經創建數據對象的話(例如使用了create或者data方法),add方法就不需要再傳入數據了。
使用create方法的例子:`$User?=?M("User");?//?實例化User對象<br class="calibre5"></br>//?根據表單提交的POST數據創建數據對象<br class="calibre5"></br>$User->create();<br class="calibre5"></br>$User->add();?//?根據條件保存修改的數據`如果你的主鍵是自動增長類型,并且如果插入數據成功的話,Add方法的返回值就是最新插入的主鍵值,可以直接獲取。
從2.1版開始恢復了批量插入數據的addAll方法(僅針對Mysql數據庫),如:`$User->addAll($data)`同時在數據插入時允許更新操作:`add($data='',$options=array(),$replace=false)`其中add方法增加$replace參數(是否添加數據時允許覆蓋),true表示覆蓋,默認為false### 讀取(Read)
在ThinkPHP中讀取數據的方式很多,通常分為讀取數據和讀取數據集。
讀取數據集使用select方法(新版已經廢除原來的findall方法):select 查詢數據集 用法 select($options=array()) 參數 options(可選):為數組的時候表示操作表達式,通常由連貫操作完成;如果是數字或者字符串,表示主鍵值。默認為空數組。 回調接口 查詢成功 \_after\_select(&$resultSet,$options) 返回值 查詢錯誤返回false
查詢結果為空返回null
查詢成功返回查詢的結果集(二維索引數組)
相關方法 通常配合連貫操作where、field、order、limit、join等一起使用 使用示例:`$User?=?M("User");?//?實例化User對象<br class="calibre5"></br>//?查找status值為1的用戶數據?以創建時間排序?返回10條數據<br class="calibre5"></br>$list?=?$User->where('status=1')->order('create_time')->limit(10)->select();`Select方法配合連貫操作方法可以完成復雜的數據查詢。而最復雜的連貫方法應該是where方法的使用,因為這部分涉及的內容較多,我們會在查詢語言部分就如何進行組裝查詢條件進行詳細的使用說明。基本的查詢暫時不涉及關聯查詢部分,而是統一采用關聯模型來進行數據操作,這一部分請參考關聯模型部分。讀取數據使用find方法:find 查詢數據 用法 find($options=array()) 參數 options(可選):為數組的時候表示操作表達式,通常由連貫操作完成;為數字或者字符串的時候表示主鍵值。默認為空數組。 回調接口 查詢后 \_after\_find(&$result,$options) 返回值 如果查詢錯誤返回false
如果查詢結果為空返回null
如果查詢成功返回查詢的結果(索引數組)
相關方法 通常配合連貫操作where、field、order、join等一起使用 讀取數據的操作其實和數據集的類似,select可用的所有連貫操作方法也都可以用于find方法,區別在于find方法最多只會返回一條記錄,因此limit方法對于find查詢操作是無效的。
下面是一些查詢的例子:`$User?=?M("User");?//?實例化User對象<br class="calibre5"></br>//?查找status值為1name值為think的用戶數據?<br class="calibre5"></br>$User->where('status=1?AND?name="think"')->find();`即使滿足條件的數據不止一條,find方法也只會返回第一條記錄。如果要讀取某個字段的值,可以使用getField方法getField 查詢某個字段的值 用法 getField($field,$sepa=null) 參數 field(必須):要獲取的字段字符串(多個用逗號分隔)
sepa(可選):字段數據間隔符號,如果是 NULL返回數組為數組。默認為null。
回調接口 查詢后 \_after\_find(&$result,$options) 返回值 如果查詢結果為空返回null
如果field是一個字段則返回該字段的值
如果field是多個字段,返回數組。數組的索引是第一個字段的值,sepa為null則返回二維數組。
相關方法 通常配合連貫操作where、limit、order等一起使用 示例如下:`$User?=?M("User");?//?實例化User對象<br class="calibre5"></br>//?獲取ID為3的用戶的昵稱?<br class="calibre5"></br>$nickname?=?$User->where('id=3')->getField('nickname');`當只有一個字段的時候,默認返回一個值。
如果需要返回數組,可以用:`$this->getField('id',true);?//?獲取id數組`如果傳入多個字段的話,默認返回一個關聯數組:`$User?=?M("User");?//?實例化User對象<br class="calibre5"></br>//?獲取所有用戶的ID和昵稱列表?<br class="calibre5"></br>$list?=?$User->getField('id,nickname');`返回的list是一個數組,鍵名是用戶的id, 鍵值是用戶的昵稱nickname。
如果傳入多個字段的名稱,例如:`$list?=?$User->getField('id,nickname,email');`返回的是一個二維數組,類似select方法的返回結果,區別的是這個二維數組的鍵名是用戶的id(準確的說是getField方法的第一個字段名)。
如果我們傳入一個字符串分隔符:`$list?=?$User->getField('id,nickname,email',':');`那么返回的結果就是一個數組,鍵名是用戶id,鍵值是 nickname:email的輸出字符串。
getField方法的sepa參數還可以支持限制數量,例如:`$this->getField('id,name',5);?//?限制返回5條記錄<br class="calibre5"></br>$this->getField('id',3);?//?獲取id數組?限制3條記錄`可以配合使用order方法使用。### 更新(Update)
在ThinkPHP中使用save方法更新數據庫,并且也支持連貫操作的使用。save 更新數據到數據庫 用法 save($data='',$options=array()) 參數 data:要保存的數據,如果為空,則取當前的數據對象。
options:為數組的時候表示操作表達式,通常由連貫操作完成;為數字或者字符串的時候表示主鍵值。默認為空數組。
回調接口 更新前\_before\_update(&$data,$options)
更新成功后 \_after\_update($data,$options)
返回值 如果查詢錯誤或者數據非法返回false
如果更新成功返回影響的記錄數
相關方法 通常配合連貫操作where、field、order等一起使用`$User?=?M("User");?//?實例化User對象<br class="calibre5"></br>//?要修改的數據對象屬性賦值<br class="calibre5"></br>$data['name']?=?'ThinkPHP';<br class="calibre5"></br>$data['email']?=?'ThinkPHP@gmail.com';<br class="calibre5"></br>$User->where('id=5')->save($data);?//?根據條件保存修改的數據`為了保證數據庫的安全,避免出錯更新整個數據表,如果沒有任何更新條件,數據對象本身也不包含主鍵字段的話,save方法不會更新任何數據庫的記錄。
因此下面的代碼不會更改數據庫的任何記錄`$User->save($data);?`除非使用下面的方式:`$User?=?M("User");?//?實例化User對象<br class="calibre5"></br>//?要修改的數據對象屬性賦值<br class="calibre5"></br>$data['id']?=?5;<br class="calibre5"></br>$data['name']?=?'ThinkPHP';<br class="calibre5"></br>$data['email']?=?'ThinkPHP@gmail.com';<br class="calibre5"></br>$User->save($data);?//?根據條件保存修改的數據`如果id是數據表的主鍵的話,系統自動會把主鍵的值作為更新條件來更新其他字段的值。
還有一種方法是通過create或者data方法創建要更新的數據對象,然后進行保存操作,這樣save方法的參數可以不需要傳入。`$User?=?M("User");?//?實例化User對象<br class="calibre5"></br>//?要修改的數據對象屬性賦值<br class="calibre5"></br>$data['name']?=?'ThinkPHP';<br class="calibre5"></br>$data['email']?=?'ThinkPHP@gmail.com';<br class="calibre5"></br>$User->where('id=5')->data($data)->save();?//?根據條件保存修改的數據`使用create方法的例子:`$User?=?M("User");?//?實例化User對象<br class="calibre5"></br>//?根據表單提交的POST數據創建數據對象<br class="calibre5"></br>$User->create();<br class="calibre5"></br>$User->save();?//?根據條件保存修改的數據`上面的情況,表單中必須包含一個以主鍵為名稱的隱藏域,才能完成保存操作。
如果只是更新個別字段的值,可以使用setField方法。setField 更新某個字段的值 用法 setField($field,$value='') 參數 options(可選):為數組的時候表示操作表達式,通常由連貫操作完成;為數字或者字符串的時候表示主鍵值。默認為空數組。 返回值 如果查詢錯誤返回false
如果更新成功返回影響的記錄數
相關方法 必須配合連貫操作where一起使用 使用示例:`$User?=?M("User");?//?實例化User對象<br class="calibre5"></br>//?更改用戶的name值<br class="calibre5"></br>$User->?where('id=5')->setField('name','ThinkPHP');`setField方法支持同時更新多個字段,只需要傳入數組即可,例如:`$User?=?M("User");?//?實例化User對象<br class="calibre5"></br>//?更改用戶的name和email的值<br class="calibre5"></br>$data?=?array('name'=>'ThinkPHP','email'=>'ThinkPHP@gmail.com');<br class="calibre5"></br>$User->?where('id=5')->setField($data);`而對于統計字段(通常指的是數字類型)的更新,系統還提供了setInc和setDec方法。setInc /setDec 字段增長/字段減少 用法 setInc($field,$step=1)字段值增長
setDec($field,$step=1)字段值減少
參數 field:要更新的字段名。
step:增長或者減少的數值,默認為1。
回調接口 如果查詢錯誤返回false
如果更新成功返回影響的記錄數
返回值 如果查詢錯誤返回false
如果更新成功返回影響的記錄數
相關方法 必須配合連貫操作where一起使用`$User?=?M("User");?//?實例化User對象<br class="calibre5"></br>$User->where('id=5')->setInc('score',3);?//?用戶的積分加3<br class="calibre5"></br>$User->where('id=5')->setInc('score');?//?用戶的積分加1<br class="calibre5"></br>$User->where('id=5')->setDec('score',5);?//?用戶的積分減5<br class="calibre5"></br>$User->where('id=5')->setDec('score');?//?用戶的積分減1`### 刪除(Delete)
在ThinkPHP中使用delete方法刪除數據庫中的記錄。用法 delete($options=array()) 參數 options:為數組的時候表示操作表達式,通常由連貫操作完成,如果沒有傳入任何刪除條件,則取當前數據對象的主鍵作為條件;為數字或者字符串的時候表示主鍵值。默認為空數組。 回調接口 刪除成功后 \_after\_delete($data,$options) 返回值 如果查詢錯誤返回false
如果刪除成功返回影響的記錄數
相關方法 通常配合連貫操作where、field、order等一起使用 示例如下:`$User?=?M("User");?//?實例化User對象<br class="calibre5"></br>$User->where('id=5')->delete();?//?刪除id為5的用戶數據<br class="calibre5"></br>$User->where('status=0')->delete();?//?刪除所有狀態為0的用戶數據`delete方法可以用于刪除單個或者多個數據,主要取決于刪除條件,也就是where方法的參數,也可以用order和limit方法來限制要刪除的個數,例如:`//?刪除所有狀態為0的5?個用戶數據?按照創建時間排序<br class="calibre5"></br>$User->where('status=0')->order('create_time')->limit('5')->delete();?`
[上一頁](66.html "上一頁")[下一頁](68.html "下一頁")
- 序言
- 1. 入門
- 1.1 簡介
- 1.2 基礎概念
- 1.3 獲取ThinkPHP
- 1.4 環境要求
- 1.5 許可協議
- 1.6 目錄結構
- 1.7 命名規范
- 1.8 MVC分層
- 1.9 CBD架構
- 1.10 特性概述
- 1.11 系統流程
- 1.12 開發流程
- 2. 入口
- 2.1 入口文件
- 2.2 項目目錄
- 2.3 部署目錄
- 2.4 項目編譯
- 2.5 調試模式
- 3. 配置
- 3.1 配置格式
- 3.2 慣例配置
- 3.3 項目配置
- 3.4 調試配置
- 3.5 分組配置
- 3.6 讀取配置
- 3.7 動態配置
- 3.8 擴展配置
- 4. 函數和類庫
- 4.1 函數庫
- 4.2 類庫
- 5. 控制器
- 5.1 URL模式
- 5.2 模塊和操作
- 5.3 定義控制器
- 5.4 空操作
- 5.5 空模塊
- 5.6 模塊分組
- 5.7 URL偽靜態
- 5.8 URL路由
- 5.9 URL重寫
- 5.10 URL生成
- 5.11 URL大小寫
- 5.12 前置和后置操作
- 5.13 跨模塊調用
- 5.14 頁面跳轉
- 5.15 重定向
- 5.16 獲取系統變量
- 5.17 判斷請求類型
- 5.18 獲取URL參數
- 5.19 AJAX返回
- 5.20 Action參數綁定
- 5.21 多層控制器支持
- 6. 模型
- 6.1 模型定義
- 6.2 模型實例化
- 6.3 字段定義
- 6.4 數據主鍵
- 6.5 屬性訪問
- 6.6 跨庫操作
- 6.7 連接數據庫
- 6.8 切換數據庫
- 6.9 分布式數據庫
- 6.10 創建數據
- 6.11 字段映射
- 6.12 連貫操作
- 6.13 CURD操作
- 6.14 ActiveRecord
- 6.15 自動驗證
- 6.16 命名范圍
- 6.17 自動完成
- 6.18 查詢語言
- 6.19 查詢鎖定
- 6.20 字段排除
- 6.21 事務支持
- 6.22 高級模型
- 6.23 視圖模型
- 6.24 關聯模型
- 6.25 Mongo模型
- 6.26 動態模型
- 6.27 虛擬模型
- 6.28 多層模型支持
- 7. 視圖
- 7.1 模板定義
- 7.2 模板賦值
- 7.3 模板輸出
- 7.4 模板替換
- 7.5 獲取內容
- 7.6 模板引擎
- 7.7 布局模板
- 8. 模板引擎
- 8.1 變量輸出
- 8.2 系統變量
- 8.3 使用函數
- 8.4 默認值輸出
- 8.5 使用運算符
- 8.6 內置標簽
- 8.7 包含文件
- 8.8 導入文件
- 8.9 Volist標簽
- 8.10 Foreach標簽
- 8.11 For標簽
- 8.12 Switch標簽
- 8.13 比較標簽
- 8.14 三元運算
- 8.15 范圍判斷標簽
- 8.16 Present標簽
- 8.17 Empty標簽
- 8.18 Defined標簽
- 8.19 Define標簽
- 8.20 Assign標簽
- 8.21 IF標簽
- 8.22 標簽嵌套
- 8.23 使用PHP代碼
- 8.24 模板布局
- 8.25 模板繼承
- 8.26 原樣輸出
- 8.27 模板注釋
- 8.28 引入標簽庫
- 8.29 修改定界符
- 8.30 避免JS混淆
- 9. 日志
- 9.1 日志級別
- 9.2 記錄方式
- 9.3 手動記錄
- 10. 錯誤
- 10.1 異常處理
- 10.2 異常模板
- 10.3 異常顯示
- 11. 調試
- 11.1 運行狀態
- 11.2 頁面Trace
- 11.3 調試方法
- 12. 緩存
- 12.1 緩存方式
- 12.2 動態緩存
- 12.3 緩存隊列
- 12.4 快捷緩存
- 12.5 快速緩存
- 12.6 查詢緩存
- 12.7 SQL解析緩存
- 12.8 靜態緩存
- 13. 擴展
- 13.1 行為擴展
- 13.2 類庫擴展
- 13.3 控制器擴展
- 13.4 模型擴展
- 13.5 驅動擴展
- 13.6 Widget擴展
- 13.7 模式擴展
- 13.8 引擎擴展
- 14. 安全
- 14.1 表單令牌
- 14.2 字段類型驗證
- 14.3 防止SQL注入
- 14.4 輸入過濾
- 14.5 上傳安全
- 14.6 防止XSS攻擊
- 14.7 其他安全建議
- 14.8 目錄安全文件
- 14.9 保護模板文件
- 15. 性能
- 15.1 關閉調試模式
- 15.2 開啟緩存
- 15.3 合并字段緩存
- 15.4 優化SQL
- 15.5 替換入口
- 15.6 前端優化
- 16. 部署
- 16.1 PATH_INFO支持
- 16.2 隱藏index.php
- 16.3 二級域名部署
- 16.4 定制錯誤頁面
- 16.5 設置時區
- 17. SAE支持
- 17.1 SAE介紹
- 17.2 獲取SAE
- 17.3 SAE開發
- 18. REST支持
- 18.1 REST介紹
- 18.2 REST模式
- 18.3 REST配置
- 18.4 REST路由
- 18.5 REST方法
- 19. 雜項
- 19.1 Session支持
- 19.2 Cookie支持
- 19.3 日期和時間
- 19.4 WML開發
- 19.5 多語言
- 19.6 數據分頁
- 19.7 文件上傳
- 19.8 驗證碼
- 19.9 圖片添加水印
- 19.10 IP獲取和定位
- 20. 附錄
- 20.1 常量參考
- 20.2 配置參考
- 20.3 關于升級
- 20.4 大事記
- 鳴謝
- 關于