# 獲取器 ## 獲取器 獲取器的作用是對模型實例的（原始）數據做出自動處理。一個獲取器對應模型的一個特殊方法，方法格式為： > ### get**FieldName**Attr `FieldName`為數據表字段的駝峰轉換，定義了獲取器之后會在下列情況自動觸發： - 模型的數據對象取值操作（`$model->field_name`）； - 模型的序列化輸出操作（`$model->toArray()`及`toJson()`）； - 顯式調用`getAttr`方法（`$this->getAttr('field_name')`）； 獲取器的場景包括： - 時間日期字段的格式化輸出； - 集合或枚舉類型的輸出； - 數字狀態字段的輸出； - 組合字段的輸出； 例如，我們需要對狀態值進行轉換，可以使用： ``` <?php class User extends Model { public function getStatusAttr($value) { $status = [-1=>'刪除',0=>'禁用',1=>'正常',2=>'待審核']; return $status[$value]; } } ``` 數據表的字段會自動轉換為駝峰法，一般`status`字段的值采用數值類型，我們可以通過獲取器定義，自動轉換為字符串描述。 ``` $user = User::get(1); echo $user->status; // 例如輸出“正常” ``` 獲取器還可以定義數據表中不存在的字段，例如： ``` <?php class User extends Model { public function getStatusTextAttr($value,$data) { $status = [-1=>'刪除',0=>'禁用',1=>'正常',2=>'待審核']; return $status[$data['status']]; } } ``` > 獲取器方法的第二個參數傳入的是當前的所有數據數組。 我們就可以直接使用status\_text字段的值了，例如： ``` $user = User::get(1); echo $user->status_text; // 例如輸出“正常” ``` ## 獲取原始數據 如果你定義了獲取器的情況下，希望獲取數據表中的原始數據，可以使用： ``` $user = User::get(1); // 通過獲取器獲取字段 echo $user->status; // 獲取原始字段數據 echo $user->getData('status'); // 獲取全部原始數據 dump($user->getData()); ```