# 數據寫入 ThinkPHP的數據寫入操作使用add方法，使用示例如下： ```php $User = M("User"); // 實例化User對象 $data['name'] = 'ThinkPHP'; $data['email'] = 'ThinkPHP@gmail.com'; $User->add($data); ``` 如果是Mysql數據庫的話，還可以支持在數據插入時允許更新操作: ```php add($data='',$options=array(),$replace=false) ``` 其中add方法增加$replace參數(是否添加數據時允許覆蓋)，true表示覆蓋，默認為false 或者使用data方法連貫操作 ```php $User = M("User"); // 實例化User對象 $User->data($data)->add(); ``` 如果在add之前已經創建數據對象的話（例如使用了create或者data方法），add方法就不需要再傳入數據了。 使用create方法的例子： ```php $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語句，例如： ```php $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') ``` ### 字段過濾 如果寫入了數據表中不存在的字段數據，則會被直接過濾，例如： ```php $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方法，則表示只允許寫入指定的字段數據，其他非法字段將會被過濾，例如： ```php $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方法可以對數據的值進行過濾處理，例如： ```php $data['name'] = '<b>thinkphp</b>'; $data['email'] = 'thinkphp@gmail.com'; $User = M('User'); $User->data($data)->filter('strip_tags')->add(); ``` 寫入數據庫的時候會把name字段的值轉化為thinkphp。 filter方法的參數是一個回調類型，支持函數或者閉包定義。 ### 批量寫入 在某些情況下可以支持數據的批量寫入，例如： ```php // 批量添加數據 $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數據庫支持