Laravel的文檔里對(duì)于Model的動(dòng)態(tài)屬性講的比較簡(jiǎn)略肿仑，理解起來(lái)有些模糊谈撒，最近在偉大的蝦米的帶領(lǐng)下終于搞明白了腥泥，在此做一個(gè)比較詳細(xì)的總結(jié)。
一啃匿、引入
首先上Laravel文檔相關(guān)部分蛔外。一對(duì)一關(guān)聯(lián)是很基本的關(guān)聯(lián)。例如一個(gè)User模型也許會(huì)對(duì)應(yīng)一個(gè)Phone溯乒。要定義這種關(guān)聯(lián)夹厌，我們必須將phone方法放置于User模型上。phone方法應(yīng)該要返回基類Eloquent上的hasOne方法的結(jié)果：
<?phpnamespace App;
use Illuminate\Database\Eloquent\Model;
class User extends Model
{
/**
* 獲取與指定用戶互相關(guān)聯(lián)的電話紀(jì)錄橙数。
*/
public function phone() {
return $this->hasOne('App\Phone');
}
}
傳到hasOne方法里的第一個(gè)參數(shù)是關(guān)聯(lián)模型的類名稱尊流。定義好關(guān)聯(lián)之后，我們就可以使用Eloquent的動(dòng)態(tài)屬性來(lái)獲取關(guān)聯(lián)紀(jì)錄灯帮。動(dòng)態(tài)屬性讓你能夠訪問(wèn)關(guān)聯(lián)函數(shù)崖技，就像他們是在模型中定義的屬性：
$phone = User::find(1)->phone;
但這里只講了動(dòng)態(tài)屬性的最簡(jiǎn)單的一種形式，也就是調(diào)用的屬性不存在钟哥，但存在同名的方法時(shí)迎献，則會(huì)調(diào)用同名的方法，返回的類型是collection類型（Eloquent的集合）腻贰。下文讓我們走一遍Laravel的源代碼看看還有其他幾種不同種類的動(dòng)態(tài)屬性吁恍。
二、Laravel源代碼trace
1、對(duì)于動(dòng)態(tài)屬性疑問(wèn)的產(chǎn)生
蝦米在梅林項(xiàng)目的blade里用到了一個(gè)方法冀瓦，但是user的model里并不存在同名的avatar_src()方法伴奥，但是存在一個(gè)getAvatarSrcAttribute()名字有點(diǎn)像的方法，當(dāng)時(shí)就覺(jué)得很懵逼翼闽，看代碼的確是調(diào)用了這個(gè)方法拾徙，但不知是如何關(guān)聯(lián)起來(lái)的，所以想搞明白這里面的邏輯究竟是怎么回事感局。
<a href="#"><img src="{{ Auth::user()->avatar_src }}" alt=""></a>
2尼啡、__get()
那么問(wèn)題來(lái)了，如何追溯询微？這里需要的一個(gè)預(yù)備知識(shí)是關(guān)于PHP的魔術(shù)方法__get()崖瞭，當(dāng)讀取不可訪問(wèn)屬性的值時(shí)，__get()會(huì)被調(diào)用撑毛。所以決定從這個(gè)方法開(kāi)始進(jìn)行追溯书聚。具體的方法是在PhpStorm里打開(kāi)user模型的代碼，在菜單欄選擇Navigate-File Structure代态，彈出的框子里勾選Show inherited members寺惫，英文輸入狀態(tài)下輸入get可以找到我們想要的方法疹吃，點(diǎn)進(jìn)去可以看到__get()方法源代碼如下：
/**
* Dynamically retrieve attributes on the model.
*
* @param string $key
* @return mixed
*/
public function __get($key)
{
return $this->getAttribute($key);
}
3蹦疑、getAttribute($key)
/**
* Get an attribute from the model.
*
* @param string $key
* @return mixed
*/
public function getAttribute($key)
{
if (array_key_exists($key, $this->attributes) || $this->hasGetMutator($key)) {
return $this->getAttributeValue($key);
}
return $this->getRelationValue($key);
}
第一個(gè)if的左半邊，如果這個(gè)model有這個(gè)attribute那么就直接返回萨驶，沒(méi)什么可說(shuō)的歉摧。
第一個(gè)if的右半邊mutator是變異體的意思事實(shí)上處理了本節(jié)開(kāi)頭的疑問(wèn)，看一下源代碼：
/**
* Determine if a get mutator exists for an attribute.
*
* @param string $key
* @return bool
*/
public function hasGetMutator($key)
{
return method_exists($this, 'get'.Str::studly($key).'Attribute');
}
本方法的作用是判斷所調(diào)用的這個(gè)不存在的屬性是否存在“按照一定格式變形的類似名字的方法”腔呜。所謂的“一定格式”可以參考Studly caps命名法叁温，對(duì)應(yīng)的源代碼：
/**
* Convert a value to studly caps case.
*
* @param string $value
* @return string
*/
public static function studly($value)
{
$key = $value;
if (isset(static::$studlyCache[$key])) {
return static::$studlyCache[$key];
}
$value = ucwords(str_replace(['-', '_'], ' ', $value));
return static::$studlyCache[$key] = str_replace(' ', '', $value);
}
注意到經(jīng)studly caps處理過(guò)的-和_都會(huì)被去掉。再回到hasGetMutator($key)這個(gè)方法核畴，我們可以看到Laravel會(huì)嘗試去尋找名字形似getStudlyCapsNameAttribute()的方法膝但，如果有的話則會(huì)在getAttribute($key)里返回相關(guān)的值。第一小節(jié)提到的例子對(duì)應(yīng)的方法名我們可以知道當(dāng)調(diào)用這個(gè)不存在的屬性avatar_src時(shí)谤草，Laravel會(huì)嘗試調(diào)用getAvatarSrcAttribute()這個(gè)方法跟束，看了下代碼果然是存在這個(gè)方法的，開(kāi)始的疑問(wèn)解決啦~
4丑孩、getRelationValue($key)
回到getAttribute($key)這個(gè)方法冀宴，如果在第一個(gè)if里沒(méi)有返回則會(huì)調(diào)用getRelationValue($key)這個(gè)方法，源代碼如下：
/**
* Get a relationship.
*
* @param string $key
* @return mixed
*/
public function getRelationValue($key)
{
// If the key already exists in the relationships array, it just means the
// relationship has already been loaded, so we'll just return it out of
// here because there is no need to query within the relations twice.
if ($this->relationLoaded($key)) {
return $this->relations[$key];
}
// If the "attribute" exists as a method on the model, we will just assume
// it is a relationship and will load and return results from the query
// and hydrate the relationship's value on the "relationships" array.
if (method_exists($this, $key)) {
return $this->getRelationshipFromMethod($key);
}
}
第一個(gè)if注釋寫(xiě)得很清楚了温学，第二個(gè)if就是判斷是否存在和所調(diào)用屬性同名的方法略贮，如果存在則調(diào)用getRelationshipFromMethod($key)方法。
5、getRelationshipFromMethod($method)
這個(gè)方法比較關(guān)鍵逃延，我們看一下源代碼：
/**
* Get a relationship value from a method.
*
* @param string $method
* @return mixed
*
* @throws \LogicException
*/
protected function getRelationshipFromMethod($method)
{
$relations = $this->$method();
if (! $relations instanceof Relation) {
throw new LogicException('Relationship method must return an object of type '
.'Illuminate\Database\Eloquent\Relations\Relation');
}
$this->setRelation($method, $results = $relations->getResults());
return $results;
}
注意if語(yǔ)句塊那里的判斷览妖，意味著與屬性同名的方法的返回類型必須是Relation類型或者是它的子類，例如hasMany等揽祥。所以如果要另外做處理黄痪，返回的類型不為Relation的話可以參考第四小節(jié)那樣的命名法構(gòu)造相關(guān)方法名。另外盔然，setRelation那一行的意思是將沒(méi)有加載的relation進(jìn)行加載桅打，那么下次需要時(shí)就可以在getRelationValue($key)的第一個(gè)if中即返回需要的結(jié)果。還有值得注意的是此方法最后的返回值返回的$results是Collection類型愈案，也就是說(shuō)如果調(diào)用不存在的動(dòng)態(tài)屬性后返回的是Collection類型挺尾，而如果我們直接調(diào)用方法返回的則是Relation類型，可以在其上構(gòu)造查詢進(jìn)一步處理站绪，而再調(diào)用getResults()后才能再獲得Collection類型的返回值遭铺。
