開發(fā)工具代碼質(zhì)量靜態(tài)分析【免費下載鏈接】phpstanPHP Static Analysis Tool - discover bugs in your code without running it!項目地址https://gitcode.com/gh_mirrors/ph/phpstan點擊查看免費下載PHP 8.1 引入的枚舉enum是語言層面的“預定義單例”不允許通過new關鍵字創(chuàng)建實例。本文以 PHPStan 的錯誤標識new.enumCannot instantiate enum為主線結合倉庫中該錯誤標識的官方文檔 website/errors/new.enum.md 與源碼映射關系完整講解該錯誤的觸發(fā)代碼、底層原因、修復方式以及它與new.interface、new.deprecatedEnum、new.internalEnum等相鄰標識的區(qū)別。讀完本文你將能準確識別這類錯誤、用枚舉 case 正確替換new調(diào)用并在 PHPStan 配置中按標識精確忽略或排除誤報。一、錯誤標識new.enum是什么new.enum是 PHPStan 內(nèi)部使用的錯誤標識error identifier其官方定義為Enums cannot be instantiated with the new keyword.枚舉不能使用new關鍵字實例化。在倉庫的 website/src/errorsIdentifiers.json 中new.enum被映射到核心規(guī)則類PHPStan\Rules\Classes\InstantiationRule位于 phpstan-src 的 src/Rules/Classes/InstantiationRule.php 對應行號附近也就是說它由 PHPStan 核心的“實例化檢查規(guī)則”直接報告而不是任何第三方擴展。與所有new.*系列標識一樣new.enum在文檔 front matter 中標記為ignorable: true意味著它可以被列入 baseline 或通過ignoreErrors精確忽略詳見下文“如何按標識忽略”一節(jié)。二、觸發(fā)該錯誤的代碼示例文檔 website/errors/new.enum.md 給出的觸發(fā)示例非常簡潔?php declare(strict_types 1); enum Suit { case Hearts; case Diamonds; case Clubs; case Spades; } $suit new Suit(); // error: Cannot instantiate enum Suit.執(zhí)行 PHPStan 分析時第 13 行new Suit()會被報告為Cannot instantiate enum Suit.對應標識new.enum。這個例子同時也說明一個關鍵點PHPStan 的規(guī)則檢查針對的是靜態(tài)代碼分析階段——即使這段代碼永遠不會真正執(zhí)行到new Suit()一行PHPStan 依然會在分析時報告錯誤因為語言層面已經(jīng)決定了該寫法必然非法。三、為什么會報告這個錯誤從語言語義層面看原因如下文檔“Why is it reported?”一節(jié)PHP 中的枚舉不允許使用new關鍵字實例化枚舉 case 是預定義的單例實例必須直接通過 case 名稱訪問例如Suit::Hearts嘗試對枚舉執(zhí)行new在運行時如果代碼被真正執(zhí)行將直接觸發(fā)致命錯誤fatal error。從 PHPStan 的實現(xiàn)層面看該檢查由核心規(guī)則類InstantiationRule負責。從源碼結構可以推斷InstantiationRule在遇到new表達式時會解析目標類型的性質(zhì)——當解析出的類型是枚舉enum時規(guī)則判定該實例化操作非法并報告錯誤。這與同一規(guī)則家族中其他new.*標識如new.interface報告接口不可實例化的判定邏輯是一致的都是圍繞“目標類型是否允許實例化”這一核心問題展開。3.1 與new.interface的異同兩者都屬于“類型不允許被new”的范疇但對象不同new.interface接口interface只是契約沒有具體實現(xiàn)new一個接口必然致命錯誤對應文檔 website/errors/new.interface.mdnew.enum枚舉的 case 是預定義單例不存在“構造”的概念。修復思路也因此不同接口需要改實例化一個實現(xiàn)了該接口的具體類如new FileLogger()而枚舉則需要改用其 case如Suit::Hearts。3.2 與new.deprecatedEnum、new.internalEnum的關系倉庫中還收錄了兩個與枚舉實例化相關的特殊標識它們在實際使用中有很強的“疊報”特征new.deprecatedEnum見 website/errors/new.deprecatedEnum.md由 phpstan-deprecation-rules 擴展報告針對deprecated枚舉出現(xiàn)在new表達式中的情況。文檔明確注明要觸發(fā)該標識必須實例化枚舉而 PHP 本身不允許這樣做因此 PHPStan 總是會同時甚至優(yōu)先報告new.enum在實踐中該廢棄標識實際上不會被單獨報告。new.internalEnum見 website/errors/new.internalEnum.md針對internal枚舉在包外部被用于實例化上下文的情況文檔同樣注明實踐中通常會報告為new.enum只有在內(nèi)部訪問違規(guī)是首要關注點時才會報告new.internalEnum。這兩個文檔共同揭示了 PHPStan 錯誤報告的一個設計特征當一次new同時違反“語言規(guī)則”和“元信息規(guī)則”廢棄/內(nèi)部標記時PHPStan 優(yōu)先報告語言層面必然錯誤的new.enum其余標識更多是理論上的觸發(fā)路徑。四、如何修復修復方式很直接——放棄實例化直接使用枚舉 case-$suit new Suit(); $suit Suit::Hearts;結合倉庫中相鄰錯誤文檔的修復示例可以歸納出枚舉使用的通用寫法// 正確通過 case 名稱直接訪問預定義單例 $suit Suit::Hearts; $suit Suit::Clubs; // 正確使用 match / switch 基于 case 進行分支 $name match ($suit) { Suit::Hearts hearts, Suit::Diamonds diamonds, Suit::Clubs clubs, Suit::Spades spades, };如果業(yè)務邏輯需要的是“某種默認/回退值”也應通過 case 或枚舉自帶的方法如from()/tryFrom()針對 backed enum來獲取而不是試圖構造枚舉實例。五、如何按標識忽略或納入 baseline由于new.enum的ignorable為true你可以在phpstan.neon中按標識精確處理parameters: ignoreErrors: - identifier: new.enum message: #Cannot instantiate enum#或者使用--generate-baseline將此類錯誤沉淀為 baselinevendor/bin/phpstan analyse --generate-baseline生成的 baseline 會以標識級別記錄該類錯誤后續(xù)新出現(xiàn)的同類問題仍會報告從而實現(xiàn)“存量豁免、增量攔截”。需要注意從倉庫文檔約定website/errors/CLAUDE.md可以得知只有ignorable: true的標識才能被忽略而new.enum明確滿足這一條件因此上述配置是合法可用的。六、官方文檔在倉庫中的組織方式new.enum的說明文檔位于 website/errors/new.enum.md屬于 PHPStan 官網(wǎng)“錯誤標識”文檔體系的一部分。該目錄下的每一份文檔都遵循統(tǒng)一結構front matter 代碼示例 原因說明 修復方式并通過 website/src/errorsIdentifiers.json 將每個標識映射到產(chǎn)生它的規(guī)則類與源碼位置。以new.enum為例該 JSON 明確記錄了其來源為PHPStan\Rules\Classes\InstantiationRule這讓開發(fā)者可以沿“標識 → 規(guī)則類 → 源碼實現(xiàn)”的鏈路深入排查規(guī)則行為。七、小結要點說明錯誤標識new.enum報錯文案Cannot instantiate enum Suit.報告規(guī)則PHPStan 核心PHPStan\Rules\Classes\InstantiationRule觸發(fā)條件對枚舉enum使用new關鍵字根本原因枚舉 case 是預定義單例不允許實例化運行時將致命錯誤修復方式改為直接使用枚舉 case如Suit::Hearts可否忽略可以ignorable: true支持標識級 ignoreErrors 與 baseline相關標識new.interface、new.deprecatedEnum、new.internalEnum一句話記住這個錯誤在 PHP 里枚舉沒有“構造函數(shù)”只有預定義好的 case把new Suit()換成Suit::Hearts即可同時消除靜態(tài)分析錯誤和潛在的運行時致命錯誤。贊分享開發(fā)工具代碼質(zhì)量靜態(tài)分析【免費下載鏈接】phpstanPHP Static Analysis Tool - discover bugs in your code without running it!項目地址https://gitcode.com/gh_mirrors/ph/phpstan點擊查看免費下載相關推薦PHPStan 錯誤標識符 new.interface 詳解為什么接口不能被實例化以及如何修復PHPStan 錯誤標識符 new.interface 詳解為什么接口不能被實例化以及如何修復 導讀 new.interface 是 PHPStan 靜態(tài)分開發(fā)工具代碼質(zhì)量靜態(tài)分析PHPStan 錯誤標識 new.trait 全解析為什么不能 new 一個 Trait以及如何修復PHPStan 錯誤標識 new.trait 全解析為什么不能 new 一個 Trait以及如何修復 new.trait 是 PHPStan 靜態(tài)分析器開發(fā)工具代碼質(zhì)量靜態(tài)分析PHPStan 錯誤標識符 selfOut.trait 詳解為什么 phpstan-self-out 不能引用 trait以及如何正確修復PHPStan 錯誤標識符 selfOut.trait 詳解為什么 phpstan self out 不能引用 trait以及如何正確修復 本文圍繞 PH開發(fā)工具代碼質(zhì)量靜態(tài)分析創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 PHPStan 錯誤標識 new.enum 詳解：為什么枚舉不能用 new 實例化以及如何修復
開發(fā)工具代碼質(zhì)量靜態(tài)分析【免費下載鏈接】phpstanPHP Static Analysis Tool - discover bugs in your code without running it!項目地址https://gitcode.com/gh_mirrors/ph/phpstan點擊查看免費下載PHP 8.1 引入的枚舉enum是語言層面的“預定義單例”不允許通過new關鍵字創(chuàng)建實例。本文以 PHPStan 的錯誤標識new.enumCannot instantiate enum為主線結合倉庫中該錯誤標識的官方文檔 website/errors/new.enum.md 與源碼映射關系完整講解該錯誤的觸發(fā)代碼、底層原因、修復方式以及它與new.interface、new.deprecatedEnum、new.internalEnum等相鄰標識的區(qū)別。讀完本文你將能準確識別這類錯誤、用枚舉 case 正確替換new調(diào)用并在 PHPStan 配置中按標識精確忽略或排除誤報。一、錯誤標識new.enum是什么new.enum是 PHPStan 內(nèi)部使用的錯誤標識error identifier其官方定義為Enums cannot be instantiated with the new keyword.枚舉不能使用new關鍵字實例化。在倉庫的 website/src/errorsIdentifiers.json 中new.enum被映射到核心規(guī)則類PHPStan\Rules\Classes\InstantiationRule位于 phpstan-src 的 src/Rules/Classes/InstantiationRule.php 對應行號附近也就是說它由 PHPStan 核心的“實例化檢查規(guī)則”直接報告而不是任何第三方擴展。與所有new.*系列標識一樣new.enum在文檔 front matter 中標記為ignorable: true意味著它可以被列入 baseline 或通過ignoreErrors精確忽略詳見下文“如何按標識忽略”一節(jié)。二、觸發(fā)該錯誤的代碼示例文檔 website/errors/new.enum.md 給出的觸發(fā)示例非常簡潔?php declare(strict_types 1); enum Suit { case Hearts; case Diamonds; case Clubs; case Spades; } $suit new Suit(); // error: Cannot instantiate enum Suit.執(zhí)行 PHPStan 分析時第 13 行new Suit()會被報告為Cannot instantiate enum Suit.對應標識new.enum。這個例子同時也說明一個關鍵點PHPStan 的規(guī)則檢查針對的是靜態(tài)代碼分析階段——即使這段代碼永遠不會真正執(zhí)行到new Suit()一行PHPStan 依然會在分析時報告錯誤因為語言層面已經(jīng)決定了該寫法必然非法。三、為什么會報告這個錯誤從語言語義層面看原因如下文檔“Why is it reported?”一節(jié)PHP 中的枚舉不允許使用new關鍵字實例化枚舉 case 是預定義的單例實例必須直接通過 case 名稱訪問例如Suit::Hearts嘗試對枚舉執(zhí)行new在運行時如果代碼被真正執(zhí)行將直接觸發(fā)致命錯誤fatal error。從 PHPStan 的實現(xiàn)層面看該檢查由核心規(guī)則類InstantiationRule負責。從源碼結構可以推斷InstantiationRule在遇到new表達式時會解析目標類型的性質(zhì)——當解析出的類型是枚舉enum時規(guī)則判定該實例化操作非法并報告錯誤。這與同一規(guī)則家族中其他new.*標識如new.interface報告接口不可實例化的判定邏輯是一致的都是圍繞“目標類型是否允許實例化”這一核心問題展開。3.1 與new.interface的異同兩者都屬于“類型不允許被new”的范疇但對象不同new.interface接口interface只是契約沒有具體實現(xiàn)new一個接口必然致命錯誤對應文檔 website/errors/new.interface.mdnew.enum枚舉的 case 是預定義單例不存在“構造”的概念。修復思路也因此不同接口需要改實例化一個實現(xiàn)了該接口的具體類如new FileLogger()而枚舉則需要改用其 case如Suit::Hearts。3.2 與new.deprecatedEnum、new.internalEnum的關系倉庫中還收錄了兩個與枚舉實例化相關的特殊標識它們在實際使用中有很強的“疊報”特征new.deprecatedEnum見 website/errors/new.deprecatedEnum.md由 phpstan-deprecation-rules 擴展報告針對deprecated枚舉出現(xiàn)在new表達式中的情況。文檔明確注明要觸發(fā)該標識必須實例化枚舉而 PHP 本身不允許這樣做因此 PHPStan 總是會同時甚至優(yōu)先報告new.enum在實踐中該廢棄標識實際上不會被單獨報告。new.internalEnum見 website/errors/new.internalEnum.md針對internal枚舉在包外部被用于實例化上下文的情況文檔同樣注明實踐中通常會報告為new.enum只有在內(nèi)部訪問違規(guī)是首要關注點時才會報告new.internalEnum。這兩個文檔共同揭示了 PHPStan 錯誤報告的一個設計特征當一次new同時違反“語言規(guī)則”和“元信息規(guī)則”廢棄/內(nèi)部標記時PHPStan 優(yōu)先報告語言層面必然錯誤的new.enum其余標識更多是理論上的觸發(fā)路徑。四、如何修復修復方式很直接——放棄實例化直接使用枚舉 case-$suit new Suit(); $suit Suit::Hearts;結合倉庫中相鄰錯誤文檔的修復示例可以歸納出枚舉使用的通用寫法// 正確通過 case 名稱直接訪問預定義單例 $suit Suit::Hearts; $suit Suit::Clubs; // 正確使用 match / switch 基于 case 進行分支 $name match ($suit) { Suit::Hearts hearts, Suit::Diamonds diamonds, Suit::Clubs clubs, Suit::Spades spades, };如果業(yè)務邏輯需要的是“某種默認/回退值”也應通過 case 或枚舉自帶的方法如from()/tryFrom()針對 backed enum來獲取而不是試圖構造枚舉實例。五、如何按標識忽略或納入 baseline由于new.enum的ignorable為true你可以在phpstan.neon中按標識精確處理parameters: ignoreErrors: - identifier: new.enum message: #Cannot instantiate enum#或者使用--generate-baseline將此類錯誤沉淀為 baselinevendor/bin/phpstan analyse --generate-baseline生成的 baseline 會以標識級別記錄該類錯誤后續(xù)新出現(xiàn)的同類問題仍會報告從而實現(xiàn)“存量豁免、增量攔截”。需要注意從倉庫文檔約定website/errors/CLAUDE.md可以得知只有ignorable: true的標識才能被忽略而new.enum明確滿足這一條件因此上述配置是合法可用的。六、官方文檔在倉庫中的組織方式new.enum的說明文檔位于 website/errors/new.enum.md屬于 PHPStan 官網(wǎng)“錯誤標識”文檔體系的一部分。該目錄下的每一份文檔都遵循統(tǒng)一結構front matter 代碼示例 原因說明 修復方式并通過 website/src/errorsIdentifiers.json 將每個標識映射到產(chǎn)生它的規(guī)則類與源碼位置。以new.enum為例該 JSON 明確記錄了其來源為PHPStan\Rules\Classes\InstantiationRule這讓開發(fā)者可以沿“標識 → 規(guī)則類 → 源碼實現(xiàn)”的鏈路深入排查規(guī)則行為。七、小結要點說明錯誤標識new.enum報錯文案Cannot instantiate enum Suit.報告規(guī)則PHPStan 核心PHPStan\Rules\Classes\InstantiationRule觸發(fā)條件對枚舉enum使用new關鍵字根本原因枚舉 case 是預定義單例不允許實例化運行時將致命錯誤修復方式改為直接使用枚舉 case如Suit::Hearts可否忽略可以ignorable: true支持標識級 ignoreErrors 與 baseline相關標識new.interface、new.deprecatedEnum、new.internalEnum一句話記住這個錯誤在 PHP 里枚舉沒有“構造函數(shù)”只有預定義好的 case把new Suit()換成Suit::Hearts即可同時消除靜態(tài)分析錯誤和潛在的運行時致命錯誤。贊分享開發(fā)工具代碼質(zhì)量靜態(tài)分析【免費下載鏈接】phpstanPHP Static Analysis Tool - discover bugs in your code without running it!項目地址https://gitcode.com/gh_mirrors/ph/phpstan點擊查看免費下載相關推薦PHPStan 錯誤標識符 new.interface 詳解為什么接口不能被實例化以及如何修復PHPStan 錯誤標識符 new.interface 詳解為什么接口不能被實例化以及如何修復 導讀 new.interface 是 PHPStan 靜態(tài)分開發(fā)工具代碼質(zhì)量靜態(tài)分析PHPStan 錯誤標識 new.trait 全解析為什么不能 new 一個 Trait以及如何修復PHPStan 錯誤標識 new.trait 全解析為什么不能 new 一個 Trait以及如何修復 new.trait 是 PHPStan 靜態(tài)分析器開發(fā)工具代碼質(zhì)量靜態(tài)分析PHPStan 錯誤標識符 selfOut.trait 詳解為什么 phpstan-self-out 不能引用 trait以及如何正確修復PHPStan 錯誤標識符 selfOut.trait 詳解為什么 phpstan self out 不能引用 trait以及如何正確修復 本文圍繞 PH開發(fā)工具代碼質(zhì)量靜態(tài)分析創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考