魔術方法是一種特殊的方法，當對對象執行某些操作時會覆蓋 PHP 的默認操作。
PHP 保留所有以 __ 開頭的方法名稱。
因此，除非覆蓋 PHP 的行為，否則不建議使用此類方法名稱。
下列方法名被認為是魔術方法： __construct() 、 __destruct() 、 __call() 、 __callStatic() 、 __get() 、 __set() 、 __isset() 、 __unset() 、 __sleep() 、 __wakeup() 、 __serialize() 、 __unserialize() 、 __toString() 、 __invoke() 、 __set_state() 、 __clone() 、 __debugInfo() 。
除了 __construct()，
__destruct() ，和
__clone() 之外的所有魔術方法都
必須 聲明為 public，
否則會發出 E_WARNING。
在 PHP 8.0.0 之前沒有為魔術方法
__sleep() 、
__wakeup() 、
__serialize() 、
__unserialize() 、
__set_state() 發出診斷信息。
如果定義魔術方法時使用類型聲明，它們必須與本文檔中描述的簽名相同，否則會發出致命錯誤。 在 PHP 8.0.0 之前，不會發出診斷信息。 然而， __construct() 和 __destruct() 不能聲明返回類型， 否則會發出致命錯誤。
serialize() 函數會檢查類中是否存在一個魔術方法
__sleep()。如果存在，該方法會先被調用，然后才執行序列化操作。此功能可以用于清理對象，并返回一個包含對象中所有應被序列化的變量名稱的數組。如果該方法未返回任何內容，則
null 被序列化，并產生一個 E_NOTICE 級別的錯誤。
注意:
__sleep() 不能返回父類的私有成員的名字。這樣做會產生一個
E_NOTICE級別的錯誤。使用 __serialize() 接口替代。
__sleep() 方法常用于提交未提交的數據，或類似的清理操作。同時，如果有一些很大的對象，但不需要全部保存，這個功能就很好用。
與之相反，unserialize() 會檢查是否存在一個 __wakeup()
方法。如果存在，則會先調用 __wakeup 方法，預先準備對象需要的資源。
__wakeup() 經常用在反序列化操作中，例如重新建立數據庫連接，或執行其它初始化操作。
示例 #1 Sleep 和 wakeup
<?php
class Connection
{
protected $link;
private $server, $username, $password, $db;
public function __construct($server, $username, $password, $db)
{
$this->server = $server;
$this->username = $username;
$this->password = $password;
$this->db = $db;
$this->connect();
}
private function connect()
{
$this->link = mysql_connect($this->server, $this->username, $this->password);
mysql_select_db($this->db, $this->link);
}
public function __sleep()
{
return array('server', 'username', 'password', 'db');
}
public function __wakeup()
{
$this->connect();
}
}
?>
$data): voidserialize() 函數會檢查類中是否存在一個魔術方法 __serialize() 。如果存在，該方法將在任何序列化之前優先執行。它必須以一個代表對象序列化形式的 鍵/值 成對的關聯數組形式來返回，如果沒有返回數組，將會拋出一個 TypeError 錯誤。
注意:
如果類中同時定義了 __serialize() 和 __sleep() 兩個魔術方法，則只有 __serialize() 方法會被調用。 __sleep() 方法會被忽略掉。如果對象實現了 Serializable 接口，接口的
serialize()方法會被忽略，做為代替類中的 __serialize() 方法會被調用。
__serialize() 的預期用途是定義對象序列化友好的任意表示。 數組的元素可能對應對象的屬性，但是這并不是必須的。
相反， unserialize() 檢查是否存在具有名為 __unserialize() 的魔術方法。此函數將會傳遞從 __serialize() 返回的恢復數組。然后它可以根據需要從該數組中恢復對象的屬性。
注意:
如果類中同時定義了 __unserialize() 和 __wakeup() 兩個魔術方法，則只有 __unserialize() 方法會生效，__wakeup() 方法會被忽略。
注意:
此特性自 PHP 7.4.0 起可用。
示例 #2 序列化和反序列化
<?php
class Connection
{
protected $link;
private $dsn, $username, $password;
public function __construct($dsn, $username, $password)
{
$this->dsn = $dsn;
$this->username = $username;
$this->password = $password;
$this->connect();
}
private function connect()
{
$this->link = new PDO($this->dsn, $this->username, $this->password);
}
public function __serialize(): array
{
return [
'dsn' => $this->dsn,
'user' => $this->username,
'pass' => $this->password,
];
}
public function __unserialize(array $data): void
{
$this->dsn = $data['dsn'];
$this->username = $data['user'];
$this->password = $data['pass'];
$this->connect();
}
}?>
__toString() 方法用于一個類被當成字符串時應怎樣回應。例如
echo $obj; 應該顯示些什么。
從 PHP 8.0.0 起，返回值遵循標準的 PHP 類型語義， 這意味著如果禁用 嚴格類型 ，它將會強制轉換為字符串。
從 PHP 8.0.0 起，任何包含 __toString() 方法的類都將隱性實現 Stringable 接口， 因此將通過該接口的類型檢查。推薦無論如何應顯式實現該接口。
在 PHP 7.4 中，返回值 必須 是 string ，否則會拋出 Error 。
在 PHP 7.4.0 之前，返回值 必須 是 string
，否則會拋出致命錯誤 E_RECOVERABLE_ERROR 。
在 PHP 7.4.0 之前不能在 __toString() 方法中拋出異常。這么做會導致致命錯誤。
示例 #3 簡單示例
<?php
// 聲明一個簡單的類
class TestClass
{
public $foo;
public function __construct($foo)
{
$this->foo = $foo;
}
public function __toString() {
return $this->foo;
}
}
$class = new TestClass('Hello');
echo $class;
?>
以上例程會輸出：
Hello
當嘗試以調用函數的方式調用一個對象時，__invoke() 方法會被自動調用。
示例 #4 使用 __invoke()
<?php
class CallableClass
{
function __invoke($x) {
var_dump($x);
}
}
$obj = new CallableClass;
$obj(5);
var_dump(is_callable($obj));
?>
以上例程會輸出：
int(5) bool(true)
$properties): object當調用 var_export() 導出類時，此靜態 方法會被調用。
本方法的唯一參數是一個數組，其中包含按 ['property' => value, ...] 格式排列的類屬性。
示例 #5 使用 __set_state()>
<?php
class A
{
public $var1;
public $var2;
public static function __set_state($an_array)
{
$obj = new A;
$obj->var1 = $an_array['var1'];
$obj->var2 = $an_array['var2'];
return $obj;
}
}
$a = new A;
$a->var1 = 5;
$a->var2 = 'foo';
$b = var_export($a, true);
var_dump($b);
eval('$c = ' . $b . ';');
var_dump($c);
var_dump($b);
?>
以上例程會輸出：
string(60) "A::__set_state(array(
'var1' => 5,
'var2' => 'foo',
))"
object(A)#2 (2) {
["var1"]=>
int(5)
["var2"]=>
string(3) "foo"
}
注意: 導出對象時， var_export() 不會檢查對象類是否實現了 __set_state() ， 所以如果 __set_state() 沒有實現， 重新導入對象會觸發 Error 異常。特別是這會影響內部(內置)類。 程序員有責任驗證要重新導入的類是否實現了 __set_state() 。
當通過 var_dump() 轉儲對象，獲取應該要顯示的屬性的時候， 該函數就會被調用。如果對象中沒有定義該方法，那么將會展示所有的公有、受保護和私有的屬性。
示例 #6 使用 __debugInfo()
<?php
class C {
private $prop;
public function __construct($val) {
$this->prop = $val;
}
public function __debugInfo() {
return [
'propSquared' => $this->prop ** 2,
];
}
}
var_dump(new C(42));
?>
以上例程會輸出：
object(C)#1 (1) {
["propSquared"]=>
int(1764)
}