# FIELD
field方法屬于模型的連貫操作方法之一,主要目的是標識要返回或者操作的字段,可以用于查詢和寫入操作。
## 用于查詢
### 指定字段
在查詢操作中field方法是使用最頻繁的。
```php
$Model->field('id,title,content')->select();
```
這里使用field方法指定了查詢的結果集中包含id,title,content三個字段的值。執行的SQL相當于:
```php
SELECT id,title,content FROM table
```
可以給某個字段設置別名,例如:
```php
$Model->field('id,nickname as name')->select();
```
執行的SQL語句相當于:
```php
SELECT id,nickname as name FROM table
```
### 使用SQL函數
可以在field方法中直接使用函數,例如:
```php
$Model->field('id,SUM(score)')->select();
```
執行的SQL相當于:
```php
SELECT id,SUM(score) FROM table
```
除了select方法之外,所有的查詢方法,包括find等都可以使用field方法。
### 使用數組參數
field方法的參數可以支持數組,例如:
```php
$Model->field(array('id','title','content'))->select();
```
最終執行的SQL和前面用字符串方式是等效的。
數組方式的定義可以為某些字段定義別名,例如:
```php
$Model->field(array('id','nickname'=>'name'))->select();
```
執行的SQL相當于:
```php
SELECT id,nickname as name FROM table
```
對于一些更復雜的字段要求,數組的優勢則更加明顯,例如:
```php
$Model->field(array('id','concat(name,'-',id)'=>'truename','LEFT(title,7)'=>'sub_title'))->select();
```
執行的SQL相當于:
```php
SELECT id,concat(name,'-',id) as truename,LEFT(title,7) as sub_title FROM table
```
### 獲取所有字段
如果有一個表有非常多的字段,需要獲取所有的字段(這個也許很簡單,因為不調用field方法或者直接使用空的field方法都能做到):
```php
$Model->select();
$Model->field()->select();
$Model->field('*')->select();
```
上面三個用法是等效的,都相當于執行SQL:
```php
SELECT * FROM table
```
但是這并不是我說的獲取所有字段,我希望顯式的調用所有字段(對于對性能要求比較高的系統,這個要求并不過分,起碼是一個比較好的習慣),那么OK,仍然很簡單,下面的用法可以完成預期的作用:
```php
$Model->field(true)->select();
```
field(true)的用法會顯式的獲取數據表的所有字段列表,哪怕你的數據表有100個字段。
### 字段排除
如果我希望獲取排除數據表中的content字段(文本字段的值非常耗內存)之外的所有字段值,我們就可以使用field方法的排除功能,例如下面的方式就可以實現所說的功能:
```php
$Model->field('content',true)->select();
```
則表示獲取除了content之外的所有字段,要排除更多的字段也可以:
```php
$Model->field('user_id,content',true)->select();
//或者用
$Model->field(array('user_id','content'),true)->select();
```
## 用于寫入
除了查詢操作之外,field方法還有一個非常重要的安全功能--字段合法性檢測。field方法結合create方法使用就可以完成表單提交的字段合法性檢測,如果我們在表單提交的處理方法中使用了:
```php
$Model->field('title,email,content')->create();
```
即表示表單中的合法字段只有title,email和content字段,無論用戶通過什么手段更改或者添加了瀏覽器的提交字段,都會直接屏蔽。因為,其他是所有字段我們都不希望由用戶提交來決定,你可以通過自動完成功能定義額外的字段寫入。
同樣的,field也可以結合add和save方法,進行字段過濾,例如:
```php
$Model->field('title,email,content')->save($data);
```
如果data數據中包含有title,email,content之外的字段數據的話,也會過濾掉。
- 前言
- 基礎
- 關于MuuCmf
- 獲取MuuCmf
- 環境要求
- 目錄結構
- 安裝
- 開發規范
- 控制器
- 控制器定義
- 前置和后置操作
- AJAX返回
- Action參數綁定
- 偽靜態
- URL大小寫
- Url生成
- 跳轉和重定向
- 輸入變量
- 請求類型
- 空操作
- 空控制器
- 插件控制器
- 操作綁定到類
- 模型
- 模型的定義
- 模型實例化
- 字段定義
- 連接數據庫
- 切換數據庫
- 分布式數據庫支持
- 連貫操作
- WHERE
- TABLE
- ALIAS
- DATA
- FIELD
- ORDER
- LIMIT
- PAGE
- GROUP
- HAVING
- JOIN
- UNION
- DISTINCT
- LOCK
- CACHE
- COMMENT
- RELATION
- USING
- fetchSql
- TOKEN
- STRICT
- INDEX
- 命名范圍
- CURD操作
- 數據創建
- 數據寫入
- 數據讀取
- 數據更新
- 數據刪除
- ActiveRecord
- 字段映射
- 查詢語言
- 查詢方式
- 表達式查詢
- 快捷查詢
- 區間查詢
- 組合查詢
- 統計查詢
- SQL查詢
- 動態查詢
- 子查詢
- 自動驗證
- 自動完成
- 參數綁定
- 虛擬模型
- 模型分層
- 視圖模型
- 關聯模型
- 高級模型
- Mongo模型
- 視圖
- 模板定義
- 模板主題
- 模板賦值
- 模板渲染
- 獲取模板地址
- 獲取內容
- 模板引擎
- 模板
- 變量輸出
- 系統變量
- 使用函數
- 默認值輸出
- 使用運算符
- 標簽庫
- 模板繼承
- 修改定界符
- 三元運算
- 包含文件
- 內置標簽
- Volist標簽
- Foreach標簽
- For標簽
- Switch標簽
- 比較標簽
- 范圍判斷標簽
- IF標簽
- Present標簽
- Empty標簽
- Defined標簽
- Assign標簽
- Define標簽
- 標簽嵌套
- import標簽
- 使用PHP代碼
- 原樣輸出
- 模板注釋
- 模板布局
- 模板替換
- 模塊開發
- 模塊的定義
- 開發規范
- 后臺構建器Builder
- 安裝與卸載
- 插件開發
- REST API
- RESTAPI定義
- 后臺使用指南
- 二次開發指南
- 官方模塊手冊