ThinkPHP的數據寫入操作使用**add方法**，使用示例如下： ~~~ $User = M("User"); // 實例化User對象 $data['name'] = 'ThinkPHP'; $data['email'] = 'ThinkPHP@gmail.com'; $User->add($data); ~~~ 如果是Mysql數據庫的話，還可以支持在數據插入時允許更新操作: ~~~ add($data='',$options=array(),$replace=false) ~~~ 其中add方法增加$replace參數(是否添加數據時允許覆蓋)，true表示覆蓋，默認為false 或者使用data方法連貫操作 ~~~ $User = M("User"); // 實例化User對象 $User->data($data)->add(); ~~~ 如果在add之前已經創建數據對象的話（例如使用了create或者data方法），add方法就不需要再傳入數據了。 使用create方法的例子： ~~~ $User = M("User"); // 實例化User對象 // 根據表單提交的POST數據創建數據對象 if($User->create()){ $result = $User->add(); // 寫入數據到數據庫 if($result){ // 如果主鍵是自動增長型 成功后返回值就是最新插入的值 $insertId = $result; } } ~~~ > create方法并不算是連貫操作，因為其返回值可能是布爾值，所以必須要進行嚴格判斷。 ## 支持的連貫操作 在執行add方法之前，我們可以調用相關的連貫操作方法，配合完成數據寫入操作。 寫入操作支持的連貫操作方法包括： | 連貫操作 | 作用 | 支持的參數類型 | |-----|-----|-----| | table | 用于定義要操作的數據表名稱 | 字符串和數組 | | data | 用于指定要寫入的數據對象 | 數組和對象 | | field | 用于定義要寫入的字段 | 字符串和數組 | | relation | 用于關聯查詢（需要關聯模型支持） | 字符串 | | validate | 用于數據自動驗證 | 數組 | | auto | 用于數據自動完成 | 數組 | | filter | 用于數據過濾 | 字符串 | | scope | 用于命名范圍 | 字符串、數組 | | bind | 用于數據綁定操作 | 數組 | | token | 用于令牌驗證 | 布爾值 | | comment | 用于SQL注釋 | 字符串 | | fetchSql | 不執行SQL而只是返回SQL | 布爾值 | 可以支持不執行SQL而只是返回SQL語句，例如： ~~~ $User = M("User"); // 實例化User對象 $data['name'] = 'ThinkPHP'; $data['email'] = 'ThinkPHP@gmail.com'; $sql = $User->fetchSql(true)->add($data); echo $sql; // 輸出結果類似于 // INSERT INTO think_user (name,email) VALUES ('ThinkPHP','ThinkPHP@gmail.com') ~~~ ##### 字段過濾 如果寫入了數據表中不存在的字段數據，則會被直接過濾，例如： ~~~ $data['name'] = 'thinkphp'; $data['email'] = 'thinkphp@gmail.com'; $data['test'] = 'test'; $User = M('User'); $User->data($data)->add(); ~~~ 其中test字段是不存在的，所以寫入數據的時候會自動過濾掉。 > 在3.2.2版本以上，如果開啟調試模式的話，則會拋出異常，提示：`非法數據對象：[test=>test]` 如果在add方法之前調用field方法，則表示只允許寫入指定的字段數據，其他非法字段將會被過濾，例如： ~~~ $data['name'] = 'thinkphp'; $data['email'] = 'thinkphp@gmail.com'; $data['test'] = 'test'; $User = M('User'); $User->field('name')->data($data)->add(); ~~~ 最終只有name字段的數據被允許寫入，email和test字段直接被過濾了，哪怕email也是數據表中的合法字段。 ##### 字段內容過濾 通過filter方法可以對數據的值進行過濾處理，例如： ~~~ $data['name'] = '<b>thinkphp</b>'; $data['email'] = 'thinkphp@gmail.com'; $User = M('User'); $User->data($data)->filter('strip_tags')->add(); ~~~ 寫入數據庫的時候會把name字段的值轉化為`thinkphp`。 > filter方法的參數是一個回調類型，支持函數或者閉包定義。 ## 批量寫入 在某些情況下可以支持數據的批量寫入，例如： ~~~ // 批量添加數據 $dataList[] = array('name'=>'thinkphp','email'=>'thinkphp@gamil.com'); $dataList[] = array('name'=>'onethink','email'=>'onethink@gamil.com'); $User->addAll($dataList); ~~~ > **該功能需要3.2.3以上版本，3.2.3以下版本僅對mysql數據庫支持**