快捷導(dǎo)航

PhpStorm 2020.3：新增開箱即用的PHP 8屬性(推薦)

更新時間：2020年10月30日 11:31:07 作者：不如溫暖過生活

這篇文章主要介紹了PhpStorm 2020.3：新增開箱即用的PHP 8屬性的相關(guān)資料,本文給大家介紹的非常詳細(xì)，對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值，需要的朋友可以參考下

PhpStorm是一個輕量級且便捷的PHP IDE，其旨在提高用戶效率，可深刻理解用戶的編碼，提供智能代碼補全，快速導(dǎo)航以及即時錯誤檢查?？呻S時幫助用戶對其編碼進行調(diào)整，運行單元測試或者提供可視化debug功能。

下載PHPSTORM 2020.2最新試用

Jetbrains PhpStorm 2020.1 完美版(附安裝教程)

PhpStorm 2020.3將附帶幾個開箱即用的PHP 8屬性：
#[ArrayShape]，#[ExpectedValues]，#[NoReturn]，#[Pure]，#[Deprecated]，#[Immutable]。繼續(xù)閱讀以了解有關(guān)屬性的更多信息。

你可能已經(jīng)聽說過 PHP 8 中的屬性，但也許你不知道的是它們將是取代 PHPDoc 的結(jié)構(gòu)化元數(shù)據(jù)的新格式，現(xiàn)在將成為該語言的一部分。

PHP 8 中的屬性是什么？
除了調(diào)用 ReflectionAttribute::newInstance()時的語法定義和驗證之外，PHP 8 沒有提供任何開箱即用的屬性。對于你定義的屬性，你必須自己實現(xiàn)它們的行為。

在 PhpStorm 2020.3 中會有哪些屬性？
在PhpStorm 2020.3中，一些屬性將在\JetBrains\PhpStorm\命名空間下可用。#[ExpectedValues]和#[NoReturn]是.phpstorm.meta.php函數(shù)的高級后裔。而#[ArrayShape]是PHPDoc的數(shù)組描述的一個備受期待的進化。此外，還會有#[Deprecated]、#[Pure]和#[Immutable]。

以下屬性的設(shè)計仍在進行中，非常歡迎你的反饋。

#[Deprecated]
這個屬性類似于@deprecated PHPDoc標(biāo)簽，用于標(biāo)記方法、函數(shù)、類或類常量，它表示這些方法、函數(shù)、類或類常量在未來的版本中會被刪除，因為它們已經(jīng)過時了。

這個新屬性的主要優(yōu)點是，你可以指定替換函數(shù)和方法。這將幫助被廢棄功能的用戶進行遷移。

如果為屬性指定了reason參數(shù)，那么它將在檢查工具提示中顯示給用戶。

#[Deprecated(reason: '', replacement: '')]

讓我們看一個真實的例子。

在Symfony 5.2中，/Symfony/Component/DependencyInjection/Alias::setPrivate()將被廢棄。有了#[Deprecated]屬性，我們可以更容易地進行遷移。

#[Deprecated(
 reason: 'since Symfony 5.2, use setPublic() instead',
 replacement: '%class%->setPublic(!%parameter0%)'
)]

＃[ArrayShape]

PhpStorm要求最多的功能之一是支持更具體的數(shù)組PHPDoc注釋。這在Psalm支持下得到了部分實現(xiàn)。

但另一部分--指定可能的鍵和它們對應(yīng)的值類型--仍然缺失。當(dāng)處理簡單的數(shù)據(jù)結(jié)構(gòu)或類似對象的數(shù)組時，當(dāng)定義一個真正的類可能會感覺過度時，這個功能可能會很有用。

從PhpStorm 2020.3開始，可以使用#[ArrayShape]來定義這種數(shù)組的結(jié)構(gòu)。

語法如下。

#[ArrayShape([
 // ‘key' => 'type',
 ‘key1' => ‘int',
 ‘key2' => ‘string',
 ‘key3' => ‘Foo',
 ‘key3' => App\PHP 8\Foo::class,
])]
function functionName(...): array

如您所見，“類型”可以指定為字符串中的標(biāo)量，也可以指定為FQN字符串或::class常量形式的類引用。.

您可以將定義形狀的數(shù)組提取為常量，然后在其適用的屬性內(nèi)重用它：

const MY_ARRAY_SHAPE = [];
#[ArrayShape(MY_ARRAY_SHAPE)]

那些不能升級到PHP 8的遺留項目呢？
幸運的是，單行屬性的語法是向后兼容的。這意味著，如果將#[ArrayShape]屬性添加到PHP 7. *項目的單獨一行中，則PHP解釋器會將其解析為一行注釋，并且不會出現(xiàn)解析錯誤。但是，多行屬性對于8之前的PHP版本并不安全。

與PHP解釋器不同，PhpStorm仍然會分析屬性！因此，即使您的項目在PHP 7.4或更低版本上運行，您仍然可以從添加#[ArrayShape]屬性中受益。

請注意，在PhpStorm中使用較早的PHP版本時，您將完成代碼，但是檢查將僅在8級及以上的語言下進行。

＃[Immutable]

不可變對象是初始化或創(chuàng)建后無法更改的對象。使用它們的好處如下：

程序狀態(tài)更可預(yù)測。
調(diào)試更容易。

可以使用getter和setter或魔術(shù)方法在某種程度上模擬不可變的對象。從PhpStorm 2020.3開始，您可以簡單地用#[Immutable]屬性標(biāo)記對象或?qū)傩浴?/p>

PhpStorm將檢查對象和屬性的用法，并突出顯示更改嘗試。

你可以將寫范圍限制調(diào)整為只限制構(gòu)造函數(shù)，或者模擬私有和保護范圍。要做到這一點，請將常量CONSTRUCTOR_WRITE_SCOPE、PRIVATE_WRITE_SCOPE、PROTECTED_WRITE_SCOPE中的一個傳遞給#[Immutable]屬性構(gòu)造函數(shù)。