閱讀(1k) 書簽贊(0) 我要糾錯

PHP8 屬性

2023-08-16 17:34 更新

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

注意:另一種過時的聲明類屬性的方法是使用 var 關(guān)鍵字，而不是使用修飾符。

注意: 沒有聲明訪問控制（可見性）修飾符的屬性將默認(rèn)聲明為 public。

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

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

示例 #1 屬性聲明

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

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

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

// 沒有訪問控制修飾符：
static $var9;
readonly int $var10;
}
?>

注意:更多關(guān)于類／對象的處理函數(shù)，請查看類／對象函數(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);

?>

以上示例會輸出：

int(1234)
NULL

類型屬性必須在訪問前初始化，否則會拋出 Error 。

示例 #3 訪問屬性

<?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());
?>

以上示例會輸出：

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)建沒有類型約束的只讀屬性。

注意:不支持對靜態(tài)屬性只讀。

只讀屬性只能初始化一次，并且只能從聲明它的作用域內(nèi)初始化。對屬性的任何賦值和修改都會導(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)值，因為具有默認(rèn)值的只讀屬性等同于常量，因此不是特別有用。

注意:只讀屬性一旦初始化就不能 unset()。但可以在初始化之前從聲明屬性的作用域中取消只讀屬性。

修改不一定是簡單的賦值，以下所有行為也會導(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);
?>

然而，只讀屬性并不會妨礙內(nèi)部可變性。存儲在只讀屬性中的對象（或資源）仍然可以在內(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;
?>

動態(tài)屬性

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

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

以上內(nèi)容是否對您有幫助：

← PHP8 基本概念

PHP8 類常量 →

寫筆記

我要補(bǔ)充