## 數組訪問 | 版本 | 新增功能 | | --- | --- | | 5.0.10 | 增加`removeRelation`方法去除所有的關聯屬性 | | 5.0.5 | `hidden`、`visible`和`append`方法支持關聯屬性 | | 5.0.4 | 增加`appendRelationAttr`方法追加關聯模型的屬性 | 模型對象支持數組方式訪問，例如： ~~~ $user = User::find(1); echo $user->name ; // 有效 echo $user['name'] // 同樣有效 $user->name = 'thinkphp'; // 有效 $user['name'] = 'thinkphp'; // 同樣有效 $user->save(); ~~~ ## 轉換為數組 可以使用`toArray`方法將當前的模型實例輸出為數組，例如： ~~~ $user = User::find(1); dump($user->toArray()); ~~~ 支持設置不輸出的字段屬性： ~~~ $user = User::find(1); dump($user->hidden(['create_time','update_time'])->toArray()); ~~~ 數組輸出的字段值會經過獲取器的處理，也可以支持追加其它獲取器定義（不在數據表字段列表中）的字段，例如： ~~~ $user = User::find(1); dump($user->append(['status_text'])->toArray()); ~~~ 支持設置允許輸出的屬性，例如： ~~~ $user = User::find(1); dump($user->visible(['id','name','email'])->toArray()); ~~~ 如果是數據集查詢的話有兩種情況，由于默認的數據集返回結果的類型是一個數組，因此無法調用`toArray`方法，必須先轉成數據集對象然后再使用`toArray`方法，系統提供了一個`collection`助手函數實現數據集對象的轉換，代碼如下： ~~~ $list = User::all(); if($list) { $list = collection($list)->toArray(); } ~~~ 如果設置了模型的數據集返回類型的話，則可以簡化使用 ~~~ <?php namespace app\index\model; use think\Model; class User extends Model { protected $resultSetType = 'collection'; } ~~~ 然后就可以直接使用 ~~~ $list = User::all(); $list = $list->toArray(); ~~~ ## 追加關聯模型的屬性（`V5.0.4+`） `V5.0.4+`版本開始，支持追加一對一關聯模型的屬性到當前模型，例如： ~~~ $user = User::find(1); dump($user->appendRelationAttr('profile',['email','nickname'])->toArray()); ~~~ `profile`是關聯定義方法名，`email`和`nickname`是`Profile`模型的屬性。 ## 支持關聯屬性（`V5.0.5+`） 模型的`visible`、`hidden`和`append`方法支持關聯屬性操作，例如： ~~~ $user = User::get(1,'profile'); // 隱藏profile關聯屬性的email屬性 dump($user->hidden(['profile'=>['email']])->toArray()); // 或者使用 dump($user->hidden(['profile.email'])->toArray()); ~~~ `hidden`、`visible`和`append`方法同樣支持數據集對象。