php model get set,分解：PHP 魔术方法在 Laravel 中的应用

Laravel

Laravel将PHP应用到了一个全新的水平，为您打造下一个项目提供了出色的开发体验(DX)。因此，一些人将其称为“魔术”。

今天，我将向您展示Laravel的一个技巧，魔术方法。

什么是魔术方法？

重要的是，要了解魔术方法并不是Laravel独有的，而是可以在任何PHP应用中使用。Laravel恰好有一些最有趣的魔术方法用例。

魔术方法是在PHP中声明的任何类中都可以使用的方法，它提供了在类中实现附加功能的方法。

这里有一个很好的定义：

魔术方法永远不会被程序员调用——实际上，PHP将在后台调用该方法。这就是为什么它们被称为“魔术”方法——因为它们从来没有被直接调用，它们允许程序员做一些非常强大的是事情。

总共有15中魔术方法：

class MyClass

{

public function __construct() {}

public function __destruct() {}

public function __call() {}

public function __callStatic() {}

public function __get() {}

public function __set() {}

public function __isset() {}

public function __unset() {}

public function __sleep() {}

public function __wakeup() {}

public function __toString() {}

public function __invoke() {}

public function __set_state() {}

public function __clone() {}

public function __debuginfo() {}

}

如果您用PHP做过一些面向对象的编程，那么您一定知道 __construct 方法，这是一个魔术方法。所以您一直在使用魔术方法。

您还注意到，所有的魔术的方法都是以“__”为前缀的。

今天，我们不会深入研究这些方法，而只会深入了解整个Laravel代码库中使用的那些有趣的方法。如果其他人对此感兴趣，请随时查看下面的文档👇

Laravel是如何使用的魔术方法

__get()

Laravel中的模型非常特别。它们不将属性数据存储为类的直接属性，而是存储在protected $attributes 属性中，该属性是模型所保存的所有数据的相关数组。

让我们看看简单的PHP类和Laravel模型访问属性的区别。

/**

* PHP中的普通用户类(非Laravel)将只是一个具有上述属性的类

*/

class NormalUser

{

public $firstName = 'Alice';

}

$normalUser = new NormalUser;

$normalUser->firstName; // 将返回'Alice'

namespace App;

use Illuminate\Database\Eloquent\Model;

/**

* Laravel中的一个user类

*/

class LaravelUser extends Model

{

/**

* 注意，我们将所有属性数据存储在一个单独的数组中

*/

protected $attributes = [

'firstName' => 'Alice',

];

}

$laravelUser = new LaravelUser;

$laravelUser->firstName; // 依然返回'Alice'

我们可以看到，上面的PHP和Laravel类的行为完全相同。

然而，在Laravel的例子中，属性不像普通PHP那样存储，而是集中在一个名为$attributes的属性中。我们仍然设法访问正确的数据，但是如何访问呢?

这一切都是可能的，这是因为_get魔术方法。让我们自己尝试实现一个简单的例子。

class NormalUser

{

/**

* 像在Laravel中那样声明属性

*/

protected $attributes = [

'firstName' => 'Alice',

];

/**

* __get 函数接收一个参数

* 它将会是你想要访问的属性名

* 在这个例子中是 $key = "firstName"

*/

public function __get(string $key)

{

return $this->attributes[$key];

}

}

$normalUser = new NormalUser;

$normalUser->firstName; // 将会返回 'Alice'

我们做到了！ 🎉

我们需要注意，只有在类中找不到具有匹配名称的属性时，才会调用魔术方法_get。这是一种后备方法，当PHP在类中找不到所访问的属性时调用。因此，在下面的示例中，根本不会调用魔术方法_get。

class NormalUser

{

public $firstName = 'Bob';

protected $attributes = [

'firstName' => 'Alice',

];

public function __get($key)

{

return $this->attributes[$key];

}

}

$normalUser = new NormalUser;

/**

* 由于类中存在该属性，将会返回 Bob

* 所以该例子中没有调用到魔术方法__get

*/

$normalUser->firstName;

有更多的事情在幕后发生。如果你想更多地了解 Laravel 的模型是如何确切地使用 __get 的，你可以查看下面的源代码。

__set()

当试图设置的属性没有在类中声明时，使用魔术方法_set。让我们再次看看normal PHP类和Laravel中model模型的区别。

class NormalUser

{

public $firstName = 'Alice';

}

$normalUser = new NormalUser;

$normalUser->firstName = 'Bob';

$normalUser->firstName; // Will return 'Bob'

namespace App;

use Illuminate\Database\Eloquent\Model;

class LaravelUser extends Model

{

protected $attributes = [

'firstName' => 'Alice',

];

}

$laravelUser = new LaravelUser;

$laravelUser->firstName = 'Bob';

$laravelUser->firstName; // Will return 'Bob' as well

如我们所见，在此示例中，我们仍然尝试影响Bob的值，该值在类中实际上不存在但位于属性$ attributes中。让我们尝试使用魔术方法__ set

class NormalUser

{

public $attributes = [

'firstName' => 'Alice',

];

/**

* The magic method __set receives the $name you want to affect the value on

* and the value

*/

public function __set($key, $value)

{

$this->attributes[$key] = $value;

}

}

$normalUser = new NormalUser;

$normalUser->firstName = 'Bob';

/**

* As we don't have the __get magic method define in this example for simplicity sake,

* we will access the $attributes directly

*/

$normalUser->attributes['firstName']; // Will return 'Bob'

现在我们开始！我们在Laravel中成功实施了__ get和__ set魔术方法的基本用法！他们只需几行代码就能完成！

请记住，这些魔术方法尽可能简单，而不必涉及太多细节，因为除了那些还有更多而不仅仅是用例，如果您对它的工作原理感到好奇，我邀请您亲自做一些探索！ (如果您有任何疑问，也可以随时在Twitter上与我联系)

同样，如果您想进一步挖掘，请在此处链接到源代码

让我们继续最后一个也是最有趣的一个事！ 🙌

__call() & __callStatic()

当调用的方法在类中找不到时，__call()会被调用。 在laravel中，该魔术方法方法使宏在 php 中成为可能。

我不会深入讨论宏的所有细节，但如果您感兴趣，这里有一篇很好的文章解释了如何在 Laravel 应用程序中使用它们👇

让我们试着看看如何编写一个简单的宏示例。

class NormalUser

{

public $firstName = 'Alice';

public $lastName = 'Bob';

}

$normalUser = new NormalUser;

$normalUser->fullName(); // 由于没有声明 "fullName" 方法，这将会抛出错误

使用 __call ，可以定义一个包含闭包函数的数组，在我们开发时可以程序化地添加到应用里。

class NormalUser

{

public $firstName = 'Alice';

public $lastName = 'Bob';

/**

* 将我们的宏初始化为一个空数组，后面再赋值

*/

public static $macros = [];

/**

* 定义一个添加新宏的方法

* 第一个参数是我们想要定义的宏的名字

* 第二个参数是调用宏时将会被执行的闭包函数

*/

public static function addMacro($name, $macro) {

static::$macros[$name] = $macro;

}

/**

* "__call" 接收两个参数,

* $name 是被调用的函数名称，比如 “fullName”

* $arguments 是传递给函数的所有参数，这里我们使用了一个空数组，因为我们的函数不用传参

*/

public function __call(string $name, array $arguments) {

/**

* 通过名称获取到宏

*/

$macro = static::$macros[$name];

/**

* 然后通过参数执行宏

* 备注：调用之前，我们需要将闭包绑定到 “$this”，从而使宏方法在同样的上下文中执行

*/

return call_user_func_array($macro->bindTo($this, static::class), $arguments);

}

}

$normalUser = new NormalUser;

$normalUser->fullName(); // 这里会中断，因为我们既没有定义 “fullName” 宏，也没有 “fullName” 方法存在。

/**

* 添加 “fullName” 宏方法

*/

NormalUser::addMacro('fullName', function () {

return $this->firstName.' '.$this->lastName;

});

$normalUser->fullName(); // 现在，返回 “Alice Bob”

宏要比那个复杂一些，但是我们设法使用 __call 魔术方法来创建一个宏的简单工作版本。

除了对于静态方法， __callStatic 和 __call 是完全一样的。

如果你打算自己再深入研究，这里有宏的特性源代码。

总结

所以说码农们，当你第一次用 Laravel 会感觉它神奇是对的，但是通过深入查看源代码，你会理解魔法是如何在场景背后施展的。

就像现实生活中的魔法，没有道理的事情是不会发生的，在代码中就更加是了。程序运行的背后总是有着一行代码在执行，只不过需要你去发现它。