升級(jí)PHP 7.x代碼庫(kù)通過(guò)替換phpdoc的類型（例如@param String | int）使用本機(jī)聯(lián)合類型（例如for參數(shù)和返回類型），從而改善類型的安全性和清晰度，例如@param string | int | int | int | int | int； 2。將聯(lián)合類型應(yīng)用於混合輸入?yún)?shù)（例如，ID的int |字符串），可無(wú)效或多類型值（例如，字符串| int | null），函數(shù)返回多個(gè)可能的類型（例如，用戶| false）; 3。遵循最佳實(shí)踐，避免混合類型，始終訂購(gòu)聯(lián)合類型（例如，最常見(jiàn)的第一），啟用聲明（strict_types = 1），刪除冗餘PHPDOC註釋，並確保IDE和與PHP 8的工具兼容； 4。避免遇到諸如在工會(huì)中使用void或混合的陷阱，與對(duì)像類型過(guò)於寬，而忽略了更新工具； 5。諸如ParseValue之類的重構(gòu)示例使用本機(jī)聯(lián)合類型，從而產(chǎn)生更清潔，更安全和自我紀(jì)錄的代碼，從而提前捕獲錯(cuò)誤並增強(qiáng)開(kāi)發(fā)人員的體驗(yàn)。

升級(jí)PHP代碼庫(kù)利用PHP 8的聯(lián)合類型不僅僅是使用新的語(yǔ)法 - 它是使您的代碼更具表現(xiàn)力，自我記錄且易於錯(cuò)誤的機(jī)會(huì)。如果您要從PHP 7.X轉(zhuǎn)移到PHP 8，則聯(lián)合類型可以顯著提高類型的安全性和清晰度，尤其是在變量或參數(shù)通常接受多種類型的現(xiàn)實(shí)應(yīng)用程序中。

這是使用聯(lián)合類型有效化代碼的方法。

什麼是工會(huì)類型？

在PHP 8.0中，聯(lián)合類型允許您指定參數(shù)，返回值或?qū)傩钥梢允菐追N類型之一。在PHP 8之前，您要么依賴PHPDOC註釋，要么根本沒(méi)有類型的提示：

 // PHP 7-沒(méi)有本地工會(huì)支持
/**
 * @param字符串| int $ id
 * @return數(shù)組|布爾
 */
功能Finduser（$ id）{...}

現(xiàn)在，使用PHP 8，您可以直接在簽名中表達(dá)這一點(diǎn)：

函數(shù)finduser（int | string $ id）：array | bool {
    // ...
}

這是在運(yùn)行時(shí)強(qiáng)制執(zhí)行的，因此無(wú)效的類型觸發(fā)了TypeError ，並且IDE可以提供更好的自動(dòng)完成和分析。

在您的代碼庫(kù)中使用聯(lián)合類型的位置

升級(jí)時(shí)尋找這些常見(jiàn)模式：

1。具有混合輸入類型的參數(shù)

許多功能都接受可能是整數(shù)或字符串的ID（例如，UUID與自動(dòng)插入DB ID）：

 public函數(shù)loadRecord（int |字符串$ id）：？對(duì)象
{
    // ...
}

這取代了模棱兩可的mixed或鬆動(dòng)的string鑄件，並使有效的輸入明確。

2。無(wú)效類型（比?Type更好）

而?string是string|null ，聯(lián)合類型使您更加靈活性：

函數(shù)setStatus（字符串| int | null $ status）：void {...}

在這裡， ?string不會(huì)覆蓋int ，因此需要聯(lián)合類型。

3。具有多種可能性的返回類型

現(xiàn)在可以準(zhǔn)確鍵入失?。ǔＲ?jiàn)的PHP模式）的數(shù)據(jù)或false的功能：

功能FindbyeMail（字符串$電子郵件）：用戶| false
{
    返回$ this->用戶 - > find（$ email）？ ：false;
}

更好的是：考慮返回?User （即User|null ），並為特殊情況保留false但是，如果您的代碼庫(kù)使用false ，則至少現(xiàn)在已記錄下來(lái)。

現(xiàn)代化時(shí)的最佳實(shí)踐

• 避免過(guò)度mixed
  即使允許mixed ，也喜歡特定的工會(huì)。 int|float|string可能是冗長(zhǎng)的，但它告訴呼叫者的期望。

• 訂單類型一致
  沒(méi)有執(zhí)行訂單，但是許多團(tuán)隊(duì)按特異性或頻率排序：

  公共功能logerror（字符串|數(shù)組$消息）：void

  （將最常見(jiàn)的類型放在首位。）

• 與strict_types=1
  使嚴(yán)格的鍵入能夠儘早捕獲類型不匹配：

  聲明（strict_types = 1）;

• 僅在必要時(shí)更新PHPDOC
  本地聯(lián)合類型使許多@param和@return註釋冗餘。刪除它們以避免重複和潛在的不匹配。

當(dāng)心陷阱

• 在工會(huì)中不支持void
  您不能執(zhí)行string|void void意思是“不返回”，因此在聯(lián)合中沒(méi)有意義。

• 沒(méi)有對(duì)工會(huì)mixed支持
  mixed|bool無(wú)效，因?yàn)?code>mixed已經(jīng)包含所有類型。

• object
  雖然您可以使用object|resource ，但請(qǐng)記住， object很廣。在可能的情況下更喜歡特定的類類型。

• IDE和工具兼容性
  確保您的IDE，Linter（例如Phpstan或Psalm）和CI工具支持PHP 8。較舊的版本可能不了解工會(huì)類型。

示例：之前和之後

之前（PHP 7）：

 /**
 * @param int |字符串$ value
 * @return數(shù)組
 */
功能parsevalue（$ value）
{
    if（is_string（$ value））{
        返回爆炸（'，'，$ value）;
    }
    返回[$ value];
}

之後（PHP 8）：

函數(shù)parsevalue（int |字符串$ value）：數(shù)組
{
    返回is_string（$ value）？爆炸（'，'，$ value）：[$ value];
}

清潔，更安全，自我記錄。

使用工會(huì)類型的現(xiàn)代化是您在採(cǎi)用PHP 8時(shí)可以進(jìn)行的最有影響力的升級(jí)之一。它可以降低歧義，改善工具支持並提前捕獲錯(cuò)誤。首先，使用PHPDOC的工會(huì)識(shí)別功能，然後應(yīng)用本機(jī)語(yǔ)法 - 不要忘記運(yùn)行測(cè)試。

基本上，如果您的功能已經(jīng)在DocBlock中具有@param string|int ，則是一個(gè)完美的候選人。只需刪除評(píng)論並添加真實(shí)類型即可。那是現(xiàn)代的PHP。

以上是使用PHP 8的工會(huì)類型對(duì)您的代碼庫(kù)進(jìn)行現(xiàn)代化現(xiàn)代化的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！