# 快速入門（二十）：自動完成
自動完成是ThinkPHP提供用來完成數(shù)據(jù)自動處理和過濾的方法，使用create方法創(chuàng)建數(shù)據(jù)對象的時候會自動完成數(shù)據(jù)處理。
## 規(guī)則定義
自動完成通常用來完成默認字段寫入，安全字段過濾以及業(yè)務邏輯的自動處理等，和自動驗證的定義方式類似，自動完成的定義也支持靜態(tài)定義和動態(tài)定義兩種方式。
1. 靜態(tài)方式：在模型類里面通過$_auto屬性定義處理規(guī)則。
2. 動態(tài)方式：使用模型類的auto方法動態(tài)創(chuàng)建自動處理規(guī)則。
兩種方式的定義規(guī)則都采用：
~~~
array(
array(完成字段1,完成規(guī)則,[完成條件,附加規(guī)則]),
array(完成字段2,完成規(guī)則,[完成條件,附加規(guī)則]),
......
);
~~~
說明
**完成字段（必須）**
需要進行處理的數(shù)據(jù)表實際字段名稱。
**完成規(guī)則（必須）**
需要處理的規(guī)則，配合附加規(guī)則完成。
**完成時間（可選）**
設置自動完成的時間，包括：
| 設置 | 說明 |
| --- | --- |
| self::MODEL_INSERT或者1 | 新增數(shù)據(jù)的時候處理（默認） |
| self::MODEL_UPDATE或者2 | 更新數(shù)據(jù)的時候處理 |
| self::MODEL_BOTH或者3 | 所有情況都進行處理 |
**附加規(guī)則（可選）**
設置自動完成的附加規(guī)則，包括：
| 規(guī)則 | 說明 |
| --- | --- |
| function | 使用函數(shù)，表示填充的內(nèi)容是一個函數(shù)名 |
| callback | 回調(diào)方法 ，表示填充的內(nèi)容是一個當前模型的方法 |
| field | 用其它字段填充，表示填充的內(nèi)容是一個其他字段的值 |
| string | 字符串（默認方式） |
| ignore | 為空則忽略（3.1.2新增） |
預先在模型類里面定義好自動完成的規(guī)則，我們稱之為靜態(tài)定義。例如，我們在模型類定義`_auto`屬性：
~~~
namespace Home\Model;
use Think\Model;
class UserModel extends Model{
protected $_auto = array (
array('status','1'), // 新增的時候把status字段設置為1
array('password','md5',3,'function') , // 對password字段在新增和編輯的時候使md5函數(shù)處理
array('name','getName',3,'callback'), // 對name字段在新增和編輯的時候回調(diào)getName方法
array('update_time','time',2,'function'), // 對update_time字段在更新的時候?qū)懭氘斍皶r間戳
);
}
~~~
然后，就可以在使用create方法創(chuàng)建數(shù)據(jù)對象的時候自動處理：
~~~
$User = D("User"); // 實例化User對象
if (!$User->create()){ // 創(chuàng)建數(shù)據(jù)對象
// 如果創(chuàng)建失敗 表示驗證沒有通過 輸出錯誤提示信息
exit($User->getError());
}else{
// 驗證通過 寫入新增數(shù)據(jù)
$User->add();
}
~~~
如果你沒有定義任何自動驗證規(guī)則的話，則不需要判斷create方法的返回值：
~~~
$User = D("User"); // 實例化User對象
$User->create(); // 生成數(shù)據(jù)對象
$User->add(); // 新增用戶數(shù)據(jù)
~~~
或者更簡單的使用：
~~~
$User = D("User"); // 實例化User對象
$User->create(); // 生成數(shù)據(jù)對象
$User->add(); // 寫入數(shù)據(jù)
~~~
create方法默認情況下是根據(jù)表單提交的post數(shù)據(jù)生成數(shù)據(jù)對象，我們也可以根據(jù)其他的數(shù)據(jù)源來生成數(shù)據(jù)對象，你也可以明確指定當前創(chuàng)建的數(shù)據(jù)對象自動處理的時間是新增還是編輯數(shù)據(jù)，例如：
~~~
$User = D("User"); // 實例化User對象
$userData = getUserData(); // 通過方法獲取用戶數(shù)據(jù)
$User->create($userData,2); // 根據(jù)userData數(shù)據(jù)創(chuàng)建數(shù)據(jù)對象，并指定為更新數(shù)據(jù)
$User->add();
~~~
create方法的第二個參數(shù)就用于指定自動完成規(guī)則中的完成時間，也就是說create方法的自動處理規(guī)則只會處理符合完成時間的自動完成規(guī)則。 create方法在創(chuàng)建數(shù)據(jù)的時候，已經(jīng)自動過濾了非數(shù)據(jù)表字段數(shù)據(jù)信息，因此不需要擔心表單會提交其他的非法字段信息而導致數(shù)據(jù)對象寫入出錯，甚至還可以自動過濾不希望用戶在表單提交的字段信息（詳見字段合法性過濾）。
3.1.2版本開始新增了ignore完成規(guī)則，這一規(guī)則表示某個字段如果留空的話則忽略，通?？捎糜谛薷挠脩糍Y料時候密碼的輸入，定義如下：
~~~
array('password','',2,'ignore')
~~~
表示password字段編輯的時候留空則忽略。
## 動態(tài)完成
除了靜態(tài)定義之外，我們也可以采用動態(tài)設置自動完成規(guī)則的方式來解決不同的處理規(guī)則。
~~~
$rules = array (
array('status','1'), // 新增的時候把status字段設置為1
array('password','md5',3,'function') , // 對password字段在新增和編輯的時候使md5函數(shù)處理
array('update_time','time',2,'function'), // 對update_time字段在更新的時候?qū)懭氘斍皶r間戳
);
$User = M('User');
$User->auto($rules)->create();
$User->add();
~~~
## 修改數(shù)據(jù)對象
在使用create方法創(chuàng)建好數(shù)據(jù)對象之后，此時的數(shù)據(jù)對象保存在內(nèi)存中，因此仍然可以操作數(shù)據(jù)對象，包括修改或者增加數(shù)據(jù)對象的值，例如：
~~~
$User = D("User"); // 實例化User對象
$User->create(); // 生成數(shù)據(jù)對象
$User->status = 2; // 修改數(shù)據(jù)對象的status屬性
$User->register_time = NOW_TIME; // 增加register_time屬性
$User->add(); // 新增用戶數(shù)據(jù)
~~~
一旦調(diào)用了add方法（或者save方法），創(chuàng)建在內(nèi)存中的數(shù)據(jù)對象就會失效，如果希望創(chuàng)建好的數(shù)據(jù)對象在后面的數(shù)據(jù)處理中再次調(diào)用，可以保存數(shù)據(jù)對象先，例如：
~~~
$User = D("User"); // 實例化User對象
$data = $User->create(); // 保存生成的數(shù)據(jù)對象
$User->add();
~~~
不過要記得，如果你修改了內(nèi)存中的數(shù)據(jù)對象并不會自動更新保存的數(shù)據(jù)對象，因此下面的用法是錯誤的：
~~~
$User = D("User"); // 實例化User對象
$data = $User->create(); // 保存生成的數(shù)據(jù)對象
$User->status = 2; // 修改數(shù)據(jù)對象的status屬性
$User->register_time = NOW_TIME; // 增加register_time屬性
$User->add($data);
~~~
上面的代碼我們修改了數(shù)據(jù)對象，但是仍然寫入的是之前保存的數(shù)據(jù)對象，因此對數(shù)據(jù)對象的更改操作將會無效。
- 快速入門 1：基礎
- 快速入門 2：CURD
- 快速入門 3：查詢語言
- 快速入門 4：連貫操作
- 快速入門 5：變量
- 快速入門 6：路由
- 快速入門 7：視圖
- 快速入門 8：變量輸出
- 快速入門 9：循環(huán)和控制輸出
- 快速入門 10：公共模板和模板布局
- 快速入門 11：Action參數(shù)綁定
- 快速入門 12：空操作和空控制器
- 快速入門 13：初始化、前置和后置操作
- 快速入門 14：頁面跳轉(zhuǎn)和重定向
- 快速入門 15：頁面請求和AJAX
- 快速入門 16：偽靜態(tài)
- 快速入門 17：操作綁定到類
- 快速入門 18：多層控制器
- 快速入門 19：自動驗證
- 快速入門 20：自動完成