wp-browser 3.x 升級 4.0 完整遷移指南避開所有坑【免費(fèi)下載鏈接】wp-browserThe easy and reliable way to test WordPress with Codeception. 10 years of proven success.項目地址: https://gitcode.com/gh_mirrors/wp/wp-browserwp-browser是目前最流行的 Codeception WordPress 測試框架用它給 WordPress 插件、主題和站點(diǎn)寫自動化測試已經(jīng)驗證了 10 年。如果你還在用 3.x 老版本升到 4.0 并不復(fù)雜但命名空間、測試斷言、配置文件都有變化稍不注意就會踩坑。這篇 wp-browser 3.x 升級 4.0 遷移指南帶你一步步走完全部流程讓你快速無痛完成升級。一、遷移前先搞清楚3.x 與 4.0 有什么本質(zhì)區(qū)別升級 wp-browser 到 4.0最核心的一刀切變化是兩個硬性環(huán)境要求維度wp-browser 3.xwp-browser 4.0PHP 版本5.68.0必須Codeceptionv4v5必須Composer API1.x 即可2.2必須命名空間tad\WPBrowser、Codeception\Modulelucatume\WPBrowser統(tǒng)一長期維護(hù)? 已停止演進(jìn)? 后續(xù)所有新版本都基于 4.x一句話只要你的項目 PHP 是 8.0 以上就應(yīng)該直接遷移到 4.0。3.x 已經(jīng)沒有新功能了留在舊版本意味著錯過dbUrl一鍵配置、WPLoader.dump多數(shù)據(jù)庫導(dǎo)入等大量新能力。 官方說明wp-browser 未來的開發(fā)都發(fā)生在 4.x 上遷移是遲早要做的事不如現(xiàn)在做完。詳見 CHANGELOG.md 中 4.0.0 版本的完整變更記錄。二、遷移前必做的 3 項準(zhǔn)備工作5 分鐘1. 確認(rèn) PHP 與 Codeception 版本在終端執(zhí)行以下兩條命令確認(rèn)你的環(huán)境達(dá)標(biāo)php -v # 必須是 8.0 或更高 vendor/bin/codecept -v # 需要 5.x如果 Codeception 還是 4.x先單獨(dú)升級它c(diǎn)omposer require --dev codeception/codeception:^5.02. 備份數(shù)據(jù)庫轉(zhuǎn)儲文件wp-browser 依賴dump.sql或 SQLite 的dump.sqlite作為測試數(shù)據(jù)快照。遷移過程不會改動它但萬一測試失敗需要回滾有一份備份讓你高枕無憂。3. 通讀官方遷移清單升級前 10 分鐘讀一遍倉庫中的 docs/migration.md它就是本文所有坑點(diǎn)的官方出處本文只是把它翻譯成了可操作的清單。三、最快配置方法composer 一鍵升級 wp-browser 4.0第 1 步修改 composer.json 并安裝打開項目根目錄的composer.json把開發(fā)依賴改為{ require-dev: { lucatume/wp-browser: ^4.0 } }然后執(zhí)行composer require --dev lucatume/wp-browser:^4.0第 2 步可選克隆源碼倉庫研究細(xì)節(jié)如果遷移過程中想對照源碼排錯可以克隆倉庫到本地git clone https://gitcode.com/gh_mirrors/wp/wp-browser建議重點(diǎn)看兩個文件src/version-4-aliases.php里面列出了全部舊類名到新類名的映射表是你全局搜索替換時的字典docs/migration.md官方遷移步驟原文四、代碼改動清單命名空間遷移是最大工作量4.0 把散落在tad\WPBrowser和Codeception兩個命名空間的類全部收編到lucatume\WPBrowser。用全局搜索替換處理對照表如下舊寫法3.x新寫法4.0用途tad\WPBrowser\...lucatume\WPBrowser\...所有工具類、輔助函數(shù)Codeception\Module\WPBrowser等lucatume\WPBrowser\Module\WPBrowser等模塊類Codeception\Command\GenerateWPUnit等lucatume\WPBrowser\Command\GenerateWPUnit等代碼生成命令Codeception\TestCase\WPTestCase等lucatume\WPBrowser\TestCase\WPTestCase等測試用例基類tad\WPBrowser\Extension\Eventslucatume\WPBrowser\Extension\EventDispatcherBridge事件橋接擴(kuò)展好消息有向后兼容的類別名兜底4.0 內(nèi)置了一套class_alias兼容層見src/version-4-aliases.php舊類名短期內(nèi)仍可用。但這只是過渡拐杖建議遷移完就刪干凈否則后續(xù)升級會突然斷掉。?? 坑點(diǎn)提醒tad\WPBrowser\pregErrorMessage、Patchwork/PHPUnit 相關(guān)的舊函數(shù)已被徹底移除沒有任何別名兜底用到它們會直接報函數(shù)/類不存在。五、測試用例常見坑廢棄處理與斷言變嚴(yán)格這是 3.x 升級 4.0 后測試莫名失敗的重災(zāi)區(qū)共 3 個坑坑 1runInSeparateProcess注解被移除4.0 不再支持 PHPUnit 的runInSeparateProcess注解。如果你的測試還在用它需要在套件配置文件如tests/functional.suite.yml中啟用隔離擴(kuò)展extensions:yaml extensions: enabled: - lucatume\\WPBrowser\\Extension\\IsolationSupport擴(kuò)展詳情見倉庫文檔docs/extensions/IsolationSupport.md?？?2廢棄函數(shù)/類的預(yù)期申報方式變了3.x 時代靠過濾deprecated_function_trigger_error等鉤子來忍廢棄告警4.0 改用 Core PHPUnit 原生機(jī)制。老寫法全部失效換成兩個方法// 申報我知道這里用了廢棄的函數(shù)/類/文件/鉤子 $this-setExpectedDeprecated( my_deprecated_function ); // 申報我知道這里觸發(fā)了 doing_it_wrong $this-setExpectedIncorrectUsage( my_doing_it_wrong );同時直接改$this-expected_deprecated[]屬性數(shù)組的老寫法也要一并改掉——屬性訪問已被移除?？?3斷言類型檢查變嚴(yán)格新版 PHPUnit 核心的部分?jǐn)嘌匀鏰ssertEqualFields會檢查參數(shù)類型。如果你習(xí)慣數(shù)組對象混著傳會突然失敗。顯式轉(zhuǎn)換類型即可$this-assertEqualFields( (object) [ a 1 ], [ a 1 ] );六、配置文件必改項codeception.yml 命令與模塊更新打開項目根目錄的codeception.yml注意不是套件配置把extensions.commands里的舊命令全部換成新命名空間并補(bǔ)上新命令extensions: commands: - lucatume\\WPBrowser\\Command\\GenerateWPUnit - lucatume\\WPBrowser\\Command\\GenerateWPRestApi - lucatume\\WPBrowser\\Command\\GenerateWPRestController - lucatume\\WPBrowser\\Command\\GenerateWPRestPostTypeController - lucatume\\WPBrowser\\Command\\GenerateWPAjax - lucatume\\WPBrowser\\Command\\GenerateWPCanonical - lucatume\\WPBrowser\\Command\\GenerateWPXMLRPC # 4.0 新增命令建議一并啟用 - lucatume\\WPBrowser\\Command\\RunOriginal - lucatume\\WPBrowser\\Command\\RunAll - lucatume\\WPBrowser\\Command\\DbExport - lucatume\\WPBrowser\\Command\\DbImport命令源碼在src/Command/目錄下每個文件對應(yīng)一個命令類想深入了解可逐個查看。WPLoader 模塊配置刪舊用新檢查codeception.yml中WPLoader的配置鍵4.0 有明確的廢棄/新增清單?刪除installationTableHandling、skipPluggables、wpDebug、isolatedInstall4.0 中安裝永遠(yuǎn)隔離此參數(shù)無意義??替換activatePlugins→ 改用plugins參數(shù)指定即自動激活推薦dbUrl一個 URL 配齊庫名/用戶/密碼/主機(jī)如mysql://user:passhost:3306/db、dump安裝后、首測前自動導(dǎo)入一個或多個轉(zhuǎn)儲文件、template/stylesheet模板與外觀分開指定WPLoader模塊源碼見src/Module/WPLoader.php配置項的默認(rèn)值都寫在里面。七、遷移驗證跑通全部測試的完整流程改完配置和代碼后按這個順序驗證能最快定位殘留問題冒煙測試vendor/bin/codecept run --help確認(rèn)新命令wp:db:export、wp:db:import出現(xiàn)在命令列表里單元套件vendor/bin/codecept run unit——最快、不碰 WordPress 本體功能套件vendor/bin/codecept run functional——覆蓋 WPDb、WPFilesystem 等模塊端到端套件vendor/bin/codecept run acceptance如有 WebDriver 測試如果第 2 步就能通過說明命名空間遷移基本干凈失敗信息里出現(xiàn) Class not found 或 Function tad\WPBrowser\xxx not found 時回到第四節(jié)的對照表逐個替換。八、避坑清單6 個高頻問題速查#癥狀原因與解法1Class Codeception\Module\WPLoader not found模塊類命名空間未更新見第四對照表2測試隨機(jī)互相串味、nonce 沖突新 Core PHPUnit 套件清理全局狀態(tài)更徹底在測試?yán)镲@式設(shè)置所有依賴的全局變量3runInSeparateProcess無效改用IsolationSupport擴(kuò)展見第五節(jié)坑 14廢棄告警導(dǎo)致測試失敗用setExpectedDeprecated()/setExpectedIncorrectUsage()申報5assertEqualFields等斷言報類型錯誤顯式類型轉(zhuǎn)換后再斷言6升級后WPCLI模塊命令偶發(fā)報錯4.0 的 WPCLI 模塊改用嚴(yán)格參數(shù)解析把字符串命令改為數(shù)組格式傳參更穩(wěn)妥九、遷移完成后的收尾檢查最后用 3 分鐘做一遍收尾把兼容拐杖全部拆除? 全局搜索tad\WPBrowser和Codeception\Command\GenerateWP確認(rèn)命中為 0? 全局搜索expected_deprecated、expected_doing_it_wrong確認(rèn)沒有直接改屬性的殘留?composer update --lock提交新的鎖文件? CI 流水線跑一次完整套件確認(rèn)綠燈到這里你的 wp-browser 就完成從 3.x 到 4.0 的全部遷移了。整個流程核心就是四件事升 Composer 依賴 → 換命名空間 → 改測試用例的廢棄申報 → 更新 codeception.yml。照這份清單走基本不會踩到任何隱藏的坑?！久赓M(fèi)下載鏈接】wp-browserThe easy and reliable way to test WordPress with Codeception. 10 years of proven success.項目地址: https://gitcode.com/gh_mirrors/wp/wp-browser創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 wp-browser 3.x 升級 4.0 完整遷移指南：避開所有坑
wp-browser 3.x 升級 4.0 完整遷移指南避開所有坑【免費(fèi)下載鏈接】wp-browserThe easy and reliable way to test WordPress with Codeception. 10 years of proven success.項目地址: https://gitcode.com/gh_mirrors/wp/wp-browserwp-browser是目前最流行的 Codeception WordPress 測試框架用它給 WordPress 插件、主題和站點(diǎn)寫自動化測試已經(jīng)驗證了 10 年。如果你還在用 3.x 老版本升到 4.0 并不復(fù)雜但命名空間、測試斷言、配置文件都有變化稍不注意就會踩坑。這篇 wp-browser 3.x 升級 4.0 遷移指南帶你一步步走完全部流程讓你快速無痛完成升級。一、遷移前先搞清楚3.x 與 4.0 有什么本質(zhì)區(qū)別升級 wp-browser 到 4.0最核心的一刀切變化是兩個硬性環(huán)境要求維度wp-browser 3.xwp-browser 4.0PHP 版本5.68.0必須Codeceptionv4v5必須Composer API1.x 即可2.2必須命名空間tad\WPBrowser、Codeception\Modulelucatume\WPBrowser統(tǒng)一長期維護(hù)? 已停止演進(jìn)? 后續(xù)所有新版本都基于 4.x一句話只要你的項目 PHP 是 8.0 以上就應(yīng)該直接遷移到 4.0。3.x 已經(jīng)沒有新功能了留在舊版本意味著錯過dbUrl一鍵配置、WPLoader.dump多數(shù)據(jù)庫導(dǎo)入等大量新能力。 官方說明wp-browser 未來的開發(fā)都發(fā)生在 4.x 上遷移是遲早要做的事不如現(xiàn)在做完。詳見 CHANGELOG.md 中 4.0.0 版本的完整變更記錄。二、遷移前必做的 3 項準(zhǔn)備工作5 分鐘1. 確認(rèn) PHP 與 Codeception 版本在終端執(zhí)行以下兩條命令確認(rèn)你的環(huán)境達(dá)標(biāo)php -v # 必須是 8.0 或更高 vendor/bin/codecept -v # 需要 5.x如果 Codeception 還是 4.x先單獨(dú)升級它c(diǎn)omposer require --dev codeception/codeception:^5.02. 備份數(shù)據(jù)庫轉(zhuǎn)儲文件wp-browser 依賴dump.sql或 SQLite 的dump.sqlite作為測試數(shù)據(jù)快照。遷移過程不會改動它但萬一測試失敗需要回滾有一份備份讓你高枕無憂。3. 通讀官方遷移清單升級前 10 分鐘讀一遍倉庫中的 docs/migration.md它就是本文所有坑點(diǎn)的官方出處本文只是把它翻譯成了可操作的清單。三、最快配置方法composer 一鍵升級 wp-browser 4.0第 1 步修改 composer.json 并安裝打開項目根目錄的composer.json把開發(fā)依賴改為{ require-dev: { lucatume/wp-browser: ^4.0 } }然后執(zhí)行composer require --dev lucatume/wp-browser:^4.0第 2 步可選克隆源碼倉庫研究細(xì)節(jié)如果遷移過程中想對照源碼排錯可以克隆倉庫到本地git clone https://gitcode.com/gh_mirrors/wp/wp-browser建議重點(diǎn)看兩個文件src/version-4-aliases.php里面列出了全部舊類名到新類名的映射表是你全局搜索替換時的字典docs/migration.md官方遷移步驟原文四、代碼改動清單命名空間遷移是最大工作量4.0 把散落在tad\WPBrowser和Codeception兩個命名空間的類全部收編到lucatume\WPBrowser。用全局搜索替換處理對照表如下舊寫法3.x新寫法4.0用途tad\WPBrowser\...lucatume\WPBrowser\...所有工具類、輔助函數(shù)Codeception\Module\WPBrowser等lucatume\WPBrowser\Module\WPBrowser等模塊類Codeception\Command\GenerateWPUnit等lucatume\WPBrowser\Command\GenerateWPUnit等代碼生成命令Codeception\TestCase\WPTestCase等lucatume\WPBrowser\TestCase\WPTestCase等測試用例基類tad\WPBrowser\Extension\Eventslucatume\WPBrowser\Extension\EventDispatcherBridge事件橋接擴(kuò)展好消息有向后兼容的類別名兜底4.0 內(nèi)置了一套class_alias兼容層見src/version-4-aliases.php舊類名短期內(nèi)仍可用。但這只是過渡拐杖建議遷移完就刪干凈否則后續(xù)升級會突然斷掉。?? 坑點(diǎn)提醒tad\WPBrowser\pregErrorMessage、Patchwork/PHPUnit 相關(guān)的舊函數(shù)已被徹底移除沒有任何別名兜底用到它們會直接報函數(shù)/類不存在。五、測試用例常見坑廢棄處理與斷言變嚴(yán)格這是 3.x 升級 4.0 后測試莫名失敗的重災(zāi)區(qū)共 3 個坑坑 1runInSeparateProcess注解被移除4.0 不再支持 PHPUnit 的runInSeparateProcess注解。如果你的測試還在用它需要在套件配置文件如tests/functional.suite.yml中啟用隔離擴(kuò)展extensions:yaml extensions: enabled: - lucatume\\WPBrowser\\Extension\\IsolationSupport擴(kuò)展詳情見倉庫文檔docs/extensions/IsolationSupport.md?？?2廢棄函數(shù)/類的預(yù)期申報方式變了3.x 時代靠過濾deprecated_function_trigger_error等鉤子來忍廢棄告警4.0 改用 Core PHPUnit 原生機(jī)制。老寫法全部失效換成兩個方法// 申報我知道這里用了廢棄的函數(shù)/類/文件/鉤子 $this-setExpectedDeprecated( my_deprecated_function ); // 申報我知道這里觸發(fā)了 doing_it_wrong $this-setExpectedIncorrectUsage( my_doing_it_wrong );同時直接改$this-expected_deprecated[]屬性數(shù)組的老寫法也要一并改掉——屬性訪問已被移除?？?3斷言類型檢查變嚴(yán)格新版 PHPUnit 核心的部分?jǐn)嘌匀鏰ssertEqualFields會檢查參數(shù)類型。如果你習(xí)慣數(shù)組對象混著傳會突然失敗。顯式轉(zhuǎn)換類型即可$this-assertEqualFields( (object) [ a 1 ], [ a 1 ] );六、配置文件必改項codeception.yml 命令與模塊更新打開項目根目錄的codeception.yml注意不是套件配置把extensions.commands里的舊命令全部換成新命名空間并補(bǔ)上新命令extensions: commands: - lucatume\\WPBrowser\\Command\\GenerateWPUnit - lucatume\\WPBrowser\\Command\\GenerateWPRestApi - lucatume\\WPBrowser\\Command\\GenerateWPRestController - lucatume\\WPBrowser\\Command\\GenerateWPRestPostTypeController - lucatume\\WPBrowser\\Command\\GenerateWPAjax - lucatume\\WPBrowser\\Command\\GenerateWPCanonical - lucatume\\WPBrowser\\Command\\GenerateWPXMLRPC # 4.0 新增命令建議一并啟用 - lucatume\\WPBrowser\\Command\\RunOriginal - lucatume\\WPBrowser\\Command\\RunAll - lucatume\\WPBrowser\\Command\\DbExport - lucatume\\WPBrowser\\Command\\DbImport命令源碼在src/Command/目錄下每個文件對應(yīng)一個命令類想深入了解可逐個查看。WPLoader 模塊配置刪舊用新檢查codeception.yml中WPLoader的配置鍵4.0 有明確的廢棄/新增清單?刪除installationTableHandling、skipPluggables、wpDebug、isolatedInstall4.0 中安裝永遠(yuǎn)隔離此參數(shù)無意義??替換activatePlugins→ 改用plugins參數(shù)指定即自動激活推薦dbUrl一個 URL 配齊庫名/用戶/密碼/主機(jī)如mysql://user:passhost:3306/db、dump安裝后、首測前自動導(dǎo)入一個或多個轉(zhuǎn)儲文件、template/stylesheet模板與外觀分開指定WPLoader模塊源碼見src/Module/WPLoader.php配置項的默認(rèn)值都寫在里面。七、遷移驗證跑通全部測試的完整流程改完配置和代碼后按這個順序驗證能最快定位殘留問題冒煙測試vendor/bin/codecept run --help確認(rèn)新命令wp:db:export、wp:db:import出現(xiàn)在命令列表里單元套件vendor/bin/codecept run unit——最快、不碰 WordPress 本體功能套件vendor/bin/codecept run functional——覆蓋 WPDb、WPFilesystem 等模塊端到端套件vendor/bin/codecept run acceptance如有 WebDriver 測試如果第 2 步就能通過說明命名空間遷移基本干凈失敗信息里出現(xiàn) Class not found 或 Function tad\WPBrowser\xxx not found 時回到第四節(jié)的對照表逐個替換。八、避坑清單6 個高頻問題速查#癥狀原因與解法1Class Codeception\Module\WPLoader not found模塊類命名空間未更新見第四對照表2測試隨機(jī)互相串味、nonce 沖突新 Core PHPUnit 套件清理全局狀態(tài)更徹底在測試?yán)镲@式設(shè)置所有依賴的全局變量3runInSeparateProcess無效改用IsolationSupport擴(kuò)展見第五節(jié)坑 14廢棄告警導(dǎo)致測試失敗用setExpectedDeprecated()/setExpectedIncorrectUsage()申報5assertEqualFields等斷言報類型錯誤顯式類型轉(zhuǎn)換后再斷言6升級后WPCLI模塊命令偶發(fā)報錯4.0 的 WPCLI 模塊改用嚴(yán)格參數(shù)解析把字符串命令改為數(shù)組格式傳參更穩(wěn)妥九、遷移完成后的收尾檢查最后用 3 分鐘做一遍收尾把兼容拐杖全部拆除? 全局搜索tad\WPBrowser和Codeception\Command\GenerateWP確認(rèn)命中為 0? 全局搜索expected_deprecated、expected_doing_it_wrong確認(rèn)沒有直接改屬性的殘留?composer update --lock提交新的鎖文件? CI 流水線跑一次完整套件確認(rèn)綠燈到這里你的 wp-browser 就完成從 3.x 到 4.0 的全部遷移了。整個流程核心就是四件事升 Composer 依賴 → 換命名空間 → 改測試用例的廢棄申報 → 更新 codeception.yml。照這份清單走基本不會踩到任何隱藏的坑?！久赓M(fèi)下載鏈接】wp-browserThe easy and reliable way to test WordPress with Codeception. 10 years of proven success.項目地址: https://gitcode.com/gh_mirrors/wp/wp-browser創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考