phpstorm是一個輕量級且便捷的php ide，其旨在提高用戶效率，可深刻理解用戶的編碼，提供智能代碼補全，快速導航以及即時錯誤檢查。可隨時幫助用戶對其編碼進行調(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]。

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

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

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

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

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

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

在symfony 5.2中，/symfony/component/dependencyinjection/alias::setprivate()將被廢棄。有了#[deprecated]屬性，我們可以更容易地進行遷移。

＃[arrayshape]

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

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

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

語法如下。

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

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

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

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

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

＃[immutable]

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

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

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

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

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

＃[immutable]屬性即使在php 7.4及更低版本中也可以使用！

＃[pure]

您可以將不會產(chǎn)生任何副作用的函數(shù)標記為pure函數(shù)。如果之后執(zhí)行的結(jié)果未在代碼中使用，則可以安全地刪除此類函數(shù)。

phpstorm將檢測pure函數(shù)的冗余調(diào)用。

如果該函數(shù)被標記為pure函數(shù)，但您嘗試在函數(shù)外部進行更改，即產(chǎn)生副作用，則phpstorm將警告您并突出顯示不安全的代碼。

＃[expectedvalues]

使用此屬性，您可以指定函數(shù)接受哪些值作為參數(shù)，以及可以返回哪些值。

這與expectedarguments()函數(shù)可以執(zhí)行的操作類似.phpstorm.meta.php，不同之處在于meta版本更像是完成對手。相反，該屬性假定參數(shù)或返回值沒有其他可能的值。

例如，讓我們看一下count函數(shù)：
count ( array|countable $array_or_countable [, int $mode = count_normal ] ) : int

它接受的第二個參數(shù)是整數(shù)，但實際上，它不是整數(shù)。而是它是常數(shù)count_normalor之一count_recursive，對應于0和1。

您可以將#[expectedvalues]屬性添加到第二個參數(shù)。這就是這種情況下代碼完成的方式。

沒有元

在.phpstorm.meta.php中具有expectedarguments（）

使用＃[expectedvalues]屬性

如何指定可能的值或位掩碼。

＃[expectedvalues]示例

讓我們看一下response()laravel中的助手。它以http狀態(tài)代碼作為第二個參數(shù)。

這使我們?nèi)鄙賰蓚€關(guān)鍵功能：

• 可能狀態(tài)代碼的代碼完成
• 在編輯器中驗證

我們可以通過添加屬性 #[expectedvalues(valuesfromclass: response::class)]來解決此問題

＃[noreturn]

代碼庫中的某些功能可能會導致腳本執(zhí)行停止。首先，從函數(shù)名稱中并不總是很明顯，例如，trigger_error()根據(jù)第二個參數(shù)可以停止執(zhí)行。其次，phpstorm不能總是檢測到此類功能，因為深入分析可能會導致性能問題。

這就是為什么將這些功能標記為出口點，以通過添加#[noreturn]屬性來進行更準確的控制流分析的原因。

而且，phpstorm將提供通過快速修復在整個層次結(jié)構(gòu)中向下傳播屬性的功能，以進行更加明確的分析。

phpstorm點擊此處下載

到此這篇關(guān)于phpstorm 2020.3：新增開箱即用的php 8屬性的文章就介紹到這了,更多相關(guān)phpstorm 2020.3新增php 8屬性內(nèi)容請搜索服務器之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持服務器之家！

原文鏈接：https://blog.csdn.net/qq_42444778/article/details/109336051