開(kāi)發(fā)工具代碼質(zhì)量靜態(tài)分析【免費(fèi)下載鏈接】phpstanPHP Static Analysis Tool - discover bugs in your code without running it!項(xiàng)目地址https://gitcode.com/gh_mirrors/ph/phpstan點(diǎn)擊查看免費(fèi)下載導(dǎo)讀new.interface是 PHPStan 靜態(tài)分析工具報(bào)告的錯(cuò)誤標(biāo)識(shí)符Error Identifier當(dāng)代碼中嘗試使用new關(guān)鍵字實(shí)例化一個(gè) PHP 接口時(shí)觸發(fā)。本文將以 website/errors/new.interface.md 文檔為骨架結(jié)合倉(cāng)庫(kù)中的錯(cuò)誤標(biāo)識(shí)符生成規(guī)范website/errors/CLAUDE.md與標(biāo)識(shí)符映射表website/src/errorsIdentifiers.json完整講解該錯(cuò)誤的觸發(fā)場(chǎng)景、底層原理、修復(fù)方式以及它與其他new.*系列標(biāo)識(shí)符如new.deprecatedInterface、new.internalInterface之間的關(guān)系。該錯(cuò)誤的定位new.*前綴從何而來(lái)在 PHPStan 的標(biāo)識(shí)符體系中new.interface屬于new前綴家族。根據(jù) website/errors/CLAUDE.md 中的「Identifier prefix reference」表格new前綴對(duì)應(yīng)new ClassName()實(shí)例化表達(dá)式即只有代碼中出現(xiàn)new關(guān)鍵字時(shí)才會(huì)產(chǎn)生此類(lèi)標(biāo)識(shí)符。同一前綴下還包含new.deprecatedClass、new.deprecatedInterface、new.internalInterface、new.notFound等同族錯(cuò)誤。從倉(cāng)庫(kù)的標(biāo)識(shí)符映射表 website/src/errorsIdentifiers.json第 11766 行附近可以看到new.interface由核心規(guī)則類(lèi)PHPStan\Rules\Classes\InstantiationRule報(bào)告——該規(guī)則專(zhuān)門(mén)負(fù)責(zé)分析所有new表達(dá)式是否合法接口實(shí)例化是它重點(diǎn)攔截的場(chǎng)景之一。ignorable: true表明該錯(cuò)誤可以通過(guò) PHPDoc 注釋或配置文件進(jìn)行忽略ignore。觸發(fā)示例一份必然報(bào)錯(cuò)的代碼原文檔給出了最小觸發(fā)示例。以下代碼會(huì)在 PHPStan 分析時(shí)被標(biāo)記為new.interface?php declare(strict_types 1); interface LoggerInterface { public function log(string $message): void; } $logger new LoggerInterface();關(guān)鍵點(diǎn)文件以?php declare(strict_types 1);開(kāi)頭啟用嚴(yán)格類(lèi)型模式這是 PHPStan 官方錯(cuò)誤示例文檔的標(biāo)準(zhǔn)寫(xiě)法見(jiàn) website/errors/CLAUDE.md 的 Code example 規(guī)范LoggerInterface只聲明了方法契約log(string $message): void沒(méi)有任何方法實(shí)現(xiàn)第 17 行new LoggerInterface()嘗試直接創(chuàng)建接口的實(shí)例這正是觸發(fā)點(diǎn)。從源碼結(jié)構(gòu)可以推斷InstantiationRule在分析new表達(dá)式時(shí)會(huì)先解析目標(biāo)類(lèi)型若目標(biāo)類(lèi)型是接口interface則直接報(bào)告new.interface因?yàn)榻涌谠谌魏吻闆r下都不存在合法的實(shí)例化路徑。為什么會(huì)被報(bào)告PHP 語(yǔ)言層面的根本原因原文檔給出的核心解釋是PHP interfaces cannot be instantiated. An interface defines a contract that classes must implement, but it does not provide concrete implementations of its methods. Attempting to usenewwith an interface name will result in a fatal error at runtime.翻譯過(guò)來(lái)即PHP 接口不能被實(shí)例化。接口只定義了一套「契約」contract約定實(shí)現(xiàn)類(lèi)必須提供哪些方法簽名但它自身不包含任何方法的實(shí)際實(shí)現(xiàn)。因此對(duì)接口執(zhí)行new在運(yùn)行時(shí)必然觸發(fā)致命錯(cuò)誤fatal error。具體可以從兩個(gè)層面理解運(yùn)行時(shí)層面如果這段代碼真的被執(zhí)行PHP 引擎會(huì)直接拋出致命錯(cuò)誤類(lèi)似Cannot instantiate interface LoggerInterface程序中斷后續(xù)代碼全部無(wú)法運(yùn)行。也就是說(shuō)這不僅是「不推薦」的寫(xiě)法而是必然崩潰的寫(xiě)法。語(yǔ)義層面接口中只有方法簽名沒(méi)有方法體。即使允許實(shí)例化調(diào)用$logger-log(...)時(shí)也無(wú)任何實(shí)現(xiàn)可執(zhí)行接口對(duì)象在概念上就是不完整的對(duì)象。PHPStan 的目標(biāo)是「在不運(yùn)行代碼的情況下發(fā)現(xiàn) bug」因此在靜態(tài)分析階段就將其攔截避免錯(cuò)誤留到運(yùn)行時(shí)才暴露。這也解釋了為什么new.interface屬于「代碼會(huì)崩潰 / 根本不會(huì)按預(yù)期執(zhí)行」這一類(lèi)錯(cuò)誤——PHPStan 報(bào)告它是因?yàn)檫@段代碼無(wú)論怎么執(zhí)行都不可能成功。如何修復(fù)實(shí)例化實(shí)現(xiàn)接口的具體類(lèi)修復(fù)思路非常直接不要實(shí)例化接口而是實(shí)例化一個(gè)實(shí)現(xiàn)了該接口的具體類(lèi)。原文檔給出的修復(fù)方案如下?php declare(strict_types 1); -$logger new LoggerInterface(); $logger new FileLogger();其中FileLogger是一個(gè)實(shí)現(xiàn)了LoggerInterface的類(lèi)例如?php declare(strict_types 1); class FileLogger implements LoggerInterface { public function log(string $message): void { file_put_contents(/var/log/app.log, $message . PHP_EOL, FILE_APPEND); } }修復(fù)后的調(diào)用鏈變?yōu)閚ew FileLogger()創(chuàng)建的是有完整實(shí)現(xiàn)的真實(shí)對(duì)象$logger-log(...)能夠正常工作。同時(shí)由于FileLogger實(shí)現(xiàn)了LoggerInterface變量可以安全地賦值給LoggerInterface類(lèi)型的參數(shù)或?qū)傩越涌诘钠跫s價(jià)值依然得到保留。更符合工程實(shí)踐的修復(fù)模式在實(shí)際項(xiàng)目中直接寫(xiě)死具體實(shí)現(xiàn)類(lèi)雖然能消除new.interface錯(cuò)誤但會(huì)犧牲接口解耦的意義。更常見(jiàn)的做法是通過(guò)依賴(lài)注入DI或工廠來(lái)獲取實(shí)現(xiàn)?php declare(strict_types 1); final class LoggerFactory { public static function create(string $driver): LoggerInterface { return match ($driver) { file new FileLogger(), console new ConsoleLogger(), default throw new \InvalidArgumentException(Unknown logger driver: . $driver), }; } } // 使用時(shí) $logger LoggerFactory::create(file);這樣既滿足 PHPStan 的類(lèi)型檢查又保持了面向接口編程的靈活性。修復(fù)優(yōu)先級(jí)遵循 PHPStan 官方文檔的修復(fù)順序根據(jù) website/errors/CLAUDE.md 的「How to fix it」規(guī)范修復(fù)此類(lèi)錯(cuò)誤應(yīng)遵循以下優(yōu)先級(jí)順序修復(fù)真正的 bug——即把new的目標(biāo)從接口換成具體實(shí)現(xiàn)類(lèi)這是本文場(chǎng)景的唯一正確修復(fù)用原生 PHP 類(lèi)型聲明收窄類(lèi)型用 PHPDoc 類(lèi)型param、return、var收窄類(lèi)型在函數(shù)體內(nèi)通過(guò)類(lèi)型收窄邏輯處理如果規(guī)則本身可配置再考慮通過(guò)配置調(diào)整 PHPStan。對(duì)于new.interface而言前 4 步都不適用接口實(shí)例化不存在「類(lèi)型收窄」的余地唯一正確的做法就是第 1 步替換為具體實(shí)現(xiàn)類(lèi)。因此它也是最簡(jiǎn)單、最直接的錯(cuò)誤類(lèi)型之一。與相關(guān)標(biāo)識(shí)符的區(qū)分deprecated 與 internal 變體new.interface不是孤立的它與new前綴下的其他接口相關(guān)標(biāo)識(shí)符容易混淆。倉(cāng)庫(kù)中已有兩份關(guān)聯(lián)文檔可以對(duì)照閱讀new.deprecatedInterface已廢棄接口的實(shí)例化見(jiàn) website/errors/new.deprecatedInterface.md。該標(biāo)識(shí)符由phpstan-deprecation-rules擴(kuò)展報(bào)告針對(duì)的是代碼中實(shí)例化了一個(gè)被deprecated標(biāo)記的接口/** deprecated Use NewInterface instead */ interface OldInterface { } $x new OldInterface();該文檔特別指出一個(gè)關(guān)鍵事實(shí)觸發(fā)這個(gè)標(biāo)識(shí)符本身就要求實(shí)例化接口而 PHP 不允許這樣做因此 PHPStan 總會(huì)同時(shí)報(bào)告一個(gè)new.interface錯(cuò)誤在實(shí)踐中new.deprecatedInterface反而不會(huì)單獨(dú)出現(xiàn)。換句話說(shuō)new.interface是更底層的「硬錯(cuò)誤」new.deprecatedInterface是在其之上的「附加信息」。new.internalInterface內(nèi)部接口的使用見(jiàn) website/errors/new.internalInterface.md。該標(biāo)識(shí)符由RestrictedInternalClassNameUsageExtensionnew.internalClass等標(biāo)識(shí)符的同一套內(nèi)部標(biāo)簽機(jī)制報(bào)告。該文檔同樣明確指出In practice, this is typically reported as Cannot instantiate interface (new.interface) because interfaces cannot be instantiated at all.即由于接口根本無(wú)法實(shí)例化這類(lèi)訪問(wèn)內(nèi)部接口的代碼在實(shí)際分析中通常也會(huì)落回new.interface這條更通用的錯(cuò)誤路徑上new.internalInterface只在「內(nèi)部訪問(wèn)違規(guī)」是主要關(guān)注點(diǎn)時(shí)才被報(bào)告。三者的關(guān)系小結(jié)標(biāo)識(shí)符觸發(fā)條件報(bào)告方實(shí)際可單獨(dú)出現(xiàn)new.interface實(shí)例化任意接口核心規(guī)則InstantiationRule是本文主題new.deprecatedInterface實(shí)例化deprecated接口phpstan-deprecation-rules 擴(kuò)展否總是伴隨new.interfacenew.internalInterface實(shí)例化標(biāo)記為 internal 的接口內(nèi)部標(biāo)簽擴(kuò)展規(guī)則通常否落回new.interface補(bǔ)充為什么new.interface可被忽略ignorable文檔 Frontmatter 中ignorable: true表明該錯(cuò)誤允許被忽略。雖然接口實(shí)例化在任何時(shí)候都是錯(cuò)誤的但 PHPStan 仍將其設(shè)計(jì)為可忽略類(lèi)型原因包括部分代碼庫(kù)可能通過(guò)代碼生成、運(yùn)行時(shí)動(dòng)態(tài)代理等機(jī)制間接「實(shí)例化」接口盡管標(biāo)準(zhǔn) PHP 無(wú)法做到此時(shí)團(tuán)隊(duì)需要抑制該報(bào)告在漸進(jìn)式引入 PHPStan 的過(guò)程中團(tuán)隊(duì)可能希望先集中處理更嚴(yán)重的錯(cuò)誤暫時(shí)將此類(lèi)問(wèn)題放入 baseline。忽略方式與 PHPStan 其他錯(cuò)誤的忽略機(jī)制一致例如在 phpstan.neon 中配置ignoreErrors或在代碼中使用phpstan-ignore注釋具體可參考 website/errors/CLAUDE.md 中「Suggest ignoring the error (the detail page already covers that)」的說(shuō)明——錯(cuò)誤詳情頁(yè)本身已涵蓋忽略方法因此文檔正文不再贅述。需要留意的是并非所有標(biāo)識(shí)符都可忽略ignorable: false的標(biāo)識(shí)符使用-nonIgnorable()構(gòu)建或前綴為phpstan.、phpstanPlayground.是強(qiáng)制報(bào)告的new.interface不在其列。如何在自己的項(xiàng)目中定位并復(fù)現(xiàn)要驗(yàn)證這個(gè)錯(cuò)誤可以在當(dāng)前倉(cāng)庫(kù)的 e2e 測(cè)試目錄之外任意創(chuàng)建一個(gè)測(cè)試文件或直接復(fù)用本文的示例代碼然后運(yùn)行 PHPStan# 在當(dāng)前倉(cāng)庫(kù)根目錄下執(zhí)行分析示例文件 php phpstan analyse path/to/your-file.php --error-formattable輸出中會(huì)顯示錯(cuò)誤消息類(lèi)似Cannot instantiate interface LoggerInterface以及對(duì)應(yīng)的錯(cuò)誤標(biāo)識(shí)符new.interface。若希望輸出中直接顯示標(biāo)識(shí)符列可使用php phpstan analyse path/to/your-file.php --error-formatraw或結(jié)合--error-formatjson查看結(jié)構(gòu)化輸出中的identifier字段。這是確認(rèn)錯(cuò)誤標(biāo)識(shí)符、并將其用于 CI 忽略規(guī)則或 baseline 管理的第一步。小結(jié)new.interface由核心規(guī)則InstantiationRule報(bào)告見(jiàn) website/src/errorsIdentifiers.json 中第 11766 行起的映射對(duì)應(yīng)new前綴下的接口實(shí)例化場(chǎng)景觸發(fā)原因本質(zhì)上是 PHP 語(yǔ)言規(guī)則接口只有契約、沒(méi)有實(shí)現(xiàn)運(yùn)行時(shí)必然致命錯(cuò)誤唯一正確修復(fù)是實(shí)例化實(shí)現(xiàn)了該接口的具體類(lèi)配合依賴(lài)注入/工廠模式可以兼顧類(lèi)型安全與解耦它與new.deprecatedInterface、new.internalInterface屬于同族錯(cuò)誤但后兩者在實(shí)際分析中通常會(huì)落回new.interface因?yàn)榻涌诟緹o(wú)法實(shí)例化該標(biāo)識(shí)符ignorable: true可按需通過(guò) ignore 機(jī)制或 baseline 忽略。如需繼續(xù)深入可閱讀本倉(cāng)庫(kù)中new前綴系列的其他標(biāo)識(shí)符文檔website/errors 目錄下的new.*.md文件以及錯(cuò)誤標(biāo)識(shí)符文檔的整體生成與寫(xiě)作規(guī)范 website/errors/CLAUDE.md。贊分享開(kāi)發(fā)工具代碼質(zhì)量靜態(tài)分析【免費(fèi)下載鏈接】phpstanPHP Static Analysis Tool - discover bugs in your code without running it!項(xiàng)目地址https://gitcode.com/gh_mirrors/ph/phpstan點(diǎn)擊查看免費(fèi)下載相關(guān)推薦PHPStan 錯(cuò)誤標(biāo)識(shí)符 selfOut.trait 詳解為什么 phpstan-self-out 不能引用 trait以及如何正確修復(fù)PHPStan 錯(cuò)誤標(biāo)識(shí)符 selfOut.trait 詳解為什么 phpstan self out 不能引用 trait以及如何正確修復(fù) 本文圍繞 PH開(kāi)發(fā)工具代碼質(zhì)量靜態(tài)分析PHPStan 錯(cuò)誤標(biāo)識(shí)符 new.abstract 完全解讀為什么實(shí)例化抽象類(lèi)會(huì)被報(bào)告以及如何正確修復(fù)PHPStan 錯(cuò)誤標(biāo)識(shí)符 new.abstract 完全解讀為什么實(shí)例化抽象類(lèi)會(huì)被報(bào)告以及如何正確修復(fù) 導(dǎo)讀 new.abstract 是 PHPStan開(kāi)發(fā)工具代碼質(zhì)量靜態(tài)分析PHPStan 錯(cuò)誤標(biāo)識(shí) new.trait 全解析為什么不能 new 一個(gè) Trait以及如何修復(fù)PHPStan 錯(cuò)誤標(biāo)識(shí) new.trait 全解析為什么不能 new 一個(gè) Trait以及如何修復(fù) new.trait 是 PHPStan 靜態(tài)分析器開(kāi)發(fā)工具代碼質(zhì)量靜態(tài)分析創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考