FIELD · 文檔規范示例

# FIELD [上一頁](# "上一頁")[下一頁](# "下一頁") field方法屬于模型的連貫操作方法之一，主要目的是標識要返回或者操作的字段，可以用于查詢和寫入操作。 ### 1、用于查詢 ##### 指定字段在查詢操作中field方法是使用最頻繁的。 ~~~ $Model->field('id,title,content')->select(); ~~~ 這里使用field方法指定了查詢的結果集中包含id,title,content三個字段的值。執行的SQL相當于： ~~~ SELECT id,title,content FROM table ~~~ 可以給某個字段設置別名，例如： ~~~ $Model->field('id,nickname as name')->select(); ~~~ 執行的SQL語句相當于： ~~~ SELECT id,nickname as name FROM table ~~~ ##### 使用SQL函數可以在field方法中直接使用函數，例如： ~~~ $Model->field('id,SUM(score)')->select(); ~~~ 執行的SQL相當于： ~~~ SELECT id,SUM(score) FROM table ~~~ 當然，除了select方法之外，所有的查詢方法，包括find等都可以使用field方法，這里只是以select為例說明。 ##### 使用數組參數 field方法的參數可以支持數組，例如： ~~~ $Model->field(array('id','title','content'))->select(); ~~~ 最終執行的SQL和前面用字符串方式是等效的。數組方式的定義可以為某些字段定義別名，例如： ~~~ $Model->field(array('id','nickname'=>'name'))->select(); ~~~ 執行的SQL相當于： ~~~ SELECT id,nickname as name FROM table ~~~ 對于一些更復雜的字段要求，數組的優勢則更加明顯，例如： ~~~ $Model->field(array('id','concat(name,'-',id)'=>'truename','LEFT(title,7)'=>'sub_title'))->select(); ~~~ 執行的SQL相當于： ~~~ SELECT id,concat(name,'-',id) as truename,LEFT(title,7) as sub_title FROM table ~~~ ##### 獲取所有字段如果有一個表有非常多的字段，需要獲取所有的字段（這個也許很簡單，因為不調用field方法或者直接使用空的field方法都能做到）： ~~~ $Model->select(); $Model->field()->select(); $Model->field('*')->select(); ~~~ 上面三個用法是等效的，都相當于執行SQL： ~~~ SELECT * FROM table ~~~ 但是這并不是我說的獲取所有字段，我希望顯式的調用所有字段（對于對性能要求比較高的系統，這個要求并不過分，起碼是一個比較好的習慣），那么OK，仍然很簡單，下面的用法可以完成預期的作用： ~~~ $Model->field(true)->select(); ~~~ `fied(true)`的用法會顯式的獲取數據表的所有字段列表，哪怕你的數據表有100個字段。 ##### 字段排除如果我希望獲取排除數據表中的`content`字段（文本字段的值非常耗內存）之外的所有字段值，我們就可以使用field方法的排除功能，例如下面的方式就可以實現所說的功能： ~~~ $Model->field('content',true)->select(); ~~~ 則表示獲取除了content之外的所有字段，要排除更多的字段也可以： ~~~ $Model->field('user_id,content',true)->select(); //或者用 $Model->field(array('user_id','content'),true)->select(); ~~~ ### 2、用于寫入除了查詢操作之外，field方法還有一個非常重要的安全功能--字段合法性檢測（注意：該功能3.1版本開始才能支持）。field方法結合create方法使用就可以完成表單提交的字段合法性檢測，如果我們在表單提交的處理方法中使用了： ~~~ $Model->field('title,email,content')->create(); ~~~ 即表示表單中的合法字段只有`title`,`email`和`content`字段，無論用戶通過什么手段更改或者添加了瀏覽器的提交字段，都會直接屏蔽。因為，其他是所有字段我們都不希望由用戶提交來決定，你可以通過自動完成功能定義額外的字段寫入。 [上一頁](# "上一頁")[下一頁](# "下一頁")