## 多行數據處理
> 說明:
導入多行數據的事件處理。數據量多推薦使用此方法
注意:`rows` 優先級小于 `row`
方法:`rows($callable)`
* 參數 **callable** (必須),為 callable 閉包。
```php
rows(function($rowsData){...});
```
* 參數
* **rowsData** array 類型
當前導入的多行數據,固定參數如下:
```php
rows(function($rowsData){
// id 為導入數據行唯一標識
foreach($rowsData as $id=>$data){
// 當前導入數據行對應工作表。sheet設置時存在
$sheet = $data["sheet"];
// 當前導入數據行唯一標識
$id = $data["id"];
// 當前導入數據行數據
$row = $data["row"];
...
}
...
});
```
* 返回值:mixed|string|array 類型
* 失敗:
返回 array。例:id=4和5 的數據導入失敗了,代碼如下:
```php
rows(function($rowsData){
....
$error = [
4=>"姓名格式錯誤",
5=>"年齡錯誤",
];
return $error;
});
```
返回 string。表示整批導入失敗原因
```php
rows(function($rowsData){
....
return "服務異常";
});
```
* 成功:不返回結果或返回其他
> 示例
代碼如下:
```php
$builder=YI('demo')
->sheets(["一年級","二年級","三年級","四年級"])
->rows(function ($rowsData){
$datas = [];
for($rowsData as $id=>$data){
$sheet = $data["sheet"];
$row = $data["row"];
$datas[] = ["grade"=>$sheet]+$row;
}
Db::name('example')->insertAll($datas);
})
```
- 序言
- 基礎
- 安裝
- 目錄結構
- 配置
- 版本
- 控制器
- 使用說明
- 視圖模板
- 使用說明
- 區塊重寫
- seo
- headStyle
- headScript
- content
- script
- 驗證器
- TP驗證器
- 使用說明
- 自動處理
- 數據處理
- 前端驗證器
- 概述
- 調用示例
- 通用驗證規則
- 表單構建器
- 基礎示例
- 初始化
- 鏈式操作
- tab
- url
- field
- fieldValidate
- button
- load
- submit
- 渲染輸出
- 字段配置
- 使用說明
- 隱藏域(hidden)
- 文本框(text)
- 文本域(textarea)
- 密碼框(password)
- 富文本(editor)
- 文檔編輯(markdown)
- 下拉選框(select)
- 單選框(radio)
- 復選框(checkbox)
- 開關(switch)
- 日期(date)
- 時間日期(datetime)
- 年份(year)
- 月份(month)
- 時間(time)
- 單圖(img)
- 多圖(imgs)
- 單文件(file)
- 多文件(files)
- 取色器(color)
- 地區聯動(area)
- 下拉搜索(dropdownSearch)
- 樹(tree)
- 自定義字段
- 單一字段調用
- 概述
- 示例
- 表格構建器
- 基礎示例
- 初始化
- 鏈式操作
- state
- url
- page
- limit
- limits
- filter
- filterValidate
- toolbar
- defaultToolbar
- import
- cols
- count
- items
- event
- 渲染輸出
- 表頭配置
- 使用說明
- 枚舉(enum)
- 時間日期(datetime)
- 單圖(img)
- 多圖(imgs)
- 單文件(file)
- 多文件(files)
- 拖拽排序(dragSort)
- 顏色呈現(color)
- 地區呈現(area)
- 操作欄(action)
- 自定義表頭
- JS事件
- 異步事件監聽
- 導入構建器
- 基礎示例
- 初始化
- 鏈式操作
- sheet
- cols
- colsValidate
- limit
- tips
- row
- rows
- 渲染輸出
- 主題開發
- 實現步驟
- 系統主題
- 注意
- PHP公共方法庫
- 配置
- yunj_config
- 構建器
- YF
- YT
- YI
- 重定向
- url_tips
- redirect_tips
- throw_redirect
- 響應輸出
- response_msg
- response_json
- success_json
- error_json
- throw_json
- throw_success_json
- throw_error_json
- 數組
- array_eq
- array_in
- array_supp
- array_depth
- array_insert
- array_key_prefix
- 驗證
- is_mobile
- is_positive_int
- is_positive_integer
- is_json
- is_datetime
- is_md5_result
- 時間日期
- msectime
- 字符串
- rand_char
- filter_sql
- start_with
- exception_to_str
- 數據加解密
- aes_encrypt
- aes_decrypt
- rsa_encrypt
- rsa_decrypt
- rsa_sign
- rsa_sign_verify
- JS公共方法庫
- 調用說明
- 數據類型
- varType
- 判斷
- isMobile
- isObj
- isEmptyObj
- isArray
- isEmptyArray
- isString
- isEmptyString
- isBool
- isNumber
- isFloat
- isFunction
- isUndefined
- isJson
- isCsv
- isXls
- isXlsx
- 字符串
- fileExt
- fileNameExt
- currTimestamp
- currDatetime
- timestampFormat
- 對象
- objSupp
- 圖片
- previewImg
- url
- url
- urlParam
- urlPushParam
- 頁面
- openNewPage
- openTab
- openPopup
- rawPageWin
- redirectTab
- redirectLogin
- isPopupPage
- isTabPage
- currPageId
- close
- closeCurr
- closeAll
- 網絡
- request
- 數據加解密
- aesEncrypt
- aesDecrypt
- rsaEncrypt
- rsaDecrypt
- rsaSign
- rsaSignVerify
- 附錄
- 升級指導
- 更新日志