PHP8 屬性

2023-08-16 17:34 更新

類的變量成員叫做屬性，或者叫字段，在本文檔統(tǒng)一稱為屬性。 屬性開頭至少使用一個(gè)修飾符（比如 訪問(wèn)控制（可見性）、靜態(tài)（static）關(guān)鍵字或者自 PHP 8.1.0 起支持的 readonly）， 除了 readonly 屬性之外都是可選的，然后自 PHP 7.4 起可以跟一個(gè)類型聲明，然后跟一個(gè)普通的變量聲明來(lái)組成。屬性中的變量可以初始化，但是初始化的值必須是 常量值。

注意:另一種過(guò)時(shí)的聲明類屬性的方法是使用 var 關(guān)鍵字，而不是使用修飾符。
注意: 沒(méi)有聲明 訪問(wèn)控制（可見性） 修飾符的屬性將默認(rèn)聲明為 public。

在類的成員方法里面，可以用 ->（對(duì)象運(yùn)算符）：$this->property（其中 property 是該屬性名）這種方式來(lái)訪問(wèn)非靜態(tài)屬性。靜態(tài)屬性則是用 ::（雙冒號(hào)）：self::$property 來(lái)訪問(wèn)。更多靜態(tài)屬性與非靜態(tài)屬性的區(qū)別參見 靜態(tài)（static）關(guān)鍵字。

當(dāng)一個(gè)方法在類定義內(nèi)部被調(diào)用時(shí)，有一個(gè)可用的偽變量 $this。$this 是一個(gè)到主叫對(duì)象的引用（通常是該方法所從屬的對(duì)象，但如果是從第二個(gè)對(duì)象靜態(tài)調(diào)用時(shí)也可能是另一個(gè)對(duì)象）。

示例 #1 屬性聲明

<?php
class SimpleClass
{
public $var1 = 'hello ' . 'world';
public $var2 = <<<EOD
hello world
EOD;
public $var3 = 1+2;
// 錯(cuò)誤的屬性聲明
public $var4 = self::myStaticMethod();
public $var5 = $myVar;

// 正確的屬性聲明
public $var6 = myConstant;
public $var7 = array(true, false);

public $var8 = <<<'EOD'
hello world
EOD;

// 沒(méi)有訪問(wèn)控制修飾符：
static $var9;
readonly int $var10;
}
?>
注意:更多關(guān)于類／對(duì)象的處理函數(shù)，請(qǐng)查看類／對(duì)象函數(shù)。

類型聲明

從 PHP 7.4.0 開始，屬性定義可以包含類型聲明，但 callable 除外。

示例 #2 類型聲明的示例

<?php

class User
{
public int $id;
public ?string $name;

public function __construct(int $id, ?string $name)
{
$this->id = $id;
$this->name = $name;
}
}

$user = new User(1234, null);

var_dump($user->id);
var_dump($user->name);

?>

以上示例會(huì)輸出：

int(1234)
NULL

類型屬性必須在訪問(wèn)前初始化，否則會(huì)拋出 Error 。

示例 #3 訪問(wèn)屬性


<?php

class Shape
{
public int $numberOfSides;
public string $name;

public function setNumberOfSides(int $numberOfSides): void
{
$this->numberOfSides = $numberOfSides;
}

public function setName(string $name): void
{
$this->name = $name;
}

public function getNumberOfSides(): int
{
return $this->numberOfSides;
}

public function getName(): string
{
return $this->name;
}
}

$triangle = new Shape();
$triangle->setName("triangle");
$triangle->setNumberofSides(3);
var_dump($triangle->getName());
var_dump($triangle->getNumberOfSides());

$circle = new Shape();
$circle->setName("circle");
var_dump($circle->getName());
var_dump($circle->getNumberOfSides());
?>

以上示例會(huì)輸出：

string(8) "triangle"
int(3)
string(6) "circle"

Fatal error: Uncaught Error: Typed property Shape::$numberOfSides must not be accessed before initialization

只讀屬性

自 PHP 8.1.0 起，可以使用 readonly 修飾符聲明屬性，防止初始化后修改屬性。

示例 #4 只讀屬性示例

<?php
class Test {
public readonly string $prop;
public function __construct(string $prop) {
// 初始化正常。
$this->prop = $prop;
}
}
$test = new Test("foobar");
// 讀取正常。
var_dump($test->prop); // string(6) "foobar"
// 再賦值異常。分配的值是否相同并不重要。
$test->prop = "foobar";
// Error: Cannot modify readonly property Test::$prop
?>
注意:readonly 修飾符只能應(yīng)用于類型化屬性?？梢允褂?nbsp;Mixed 類型創(chuàng)建沒(méi)有類型約束的只讀屬性。
注意:不支持對(duì)靜態(tài)屬性只讀。

只讀屬性只能初始化一次，并且只能從聲明它的作用域內(nèi)初始化。對(duì)屬性的任何賦值和修改都會(huì)導(dǎo)致 Error 異常。

示例 #5 初始化只讀屬性異常

<?php
class Test1 {
public readonly string $prop;
}
$test1 = new Test1;
// 私有作用域之外異常初始化。
$test1->prop = "foobar";
// Error: Cannot initialize readonly property Test1::$prop from global scope
?>
注意:禁止在只讀屬性上指定默認(rèn)值，因?yàn)榫哂心J(rèn)值的只讀屬性等同于常量，因此不是特別有用。
注意:只讀屬性一旦初始化就不能 unset()。但可以在初始化之前從聲明屬性的作用域中取消只讀屬性。

修改不一定是簡(jiǎn)單的賦值，以下所有行為也會(huì)導(dǎo)致 Error 異常：

<?php
class Test {
public function __construct(
public readonly int $i = 0,
public readonly array $ary = [],
) {}
}
$test = new Test;
$test->i += 1;
$test->i++;
++$test->i;
$test->ary[] = 1;
$test->ary[0][] = 1;
$ref =& $test->i;
$test->i =& $ref;
byRef($test->i);
foreach ($test as &$prop);
?>

然而，只讀屬性并不會(huì)妨礙內(nèi)部可變性。存儲(chǔ)在只讀屬性中的對(duì)象（或資源）仍然可以在內(nèi)部修改：

<?php
class Test {
public function __construct(public readonly object $obj) {}
}
$test = new Test(new stdClass);
// 內(nèi)部可變正常。
$test->obj->foo = 1;
// 賦值異常。
$test->obj = new stdClass;
?>

動(dòng)態(tài)屬性

如果嘗試在 object 上賦值不存在的屬性，PHP 將會(huì)自動(dòng)創(chuàng)建相應(yīng)的屬性。動(dòng)態(tài)創(chuàng)建的屬性將僅能在此類實(shí)例上使用。

警告
自 PHP 8.2.0 起棄用動(dòng)態(tài)屬性。建議更改為屬性聲明。要處理任意屬性名稱，類應(yīng)該實(shí)現(xiàn)魔術(shù)方法 __get() 和 __set()。最后可以使用 #[\AllowDynamicProperties] 注解標(biāo)記此類。


以上內(nèi)容是否對(duì)您有幫助：
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)