開發環境 · WordPress開發手冊

## 為什么要建立開發環境？在開發主題時，最好在與最終托管WordPress安裝的生產服務器相同的環境中執行此操作。您的開發環境可以是本地的或遠程的。配置本地環境來處理WordPress主題有以下幾個原因： - 您可以在本地構建您的主題而不依靠遠程服務器。這可以加速您的開發過程，并允許您立即在瀏覽器中查看更改。 - 您不需要Internet連接來構建您的主題。 - 您可以從各種角度測試您的主題。這很重要，特別是如果您打算將主題發布給更多的受眾，并希望確保最大的兼容性。 ## WordPress本地開發環境要開發WordPress主題，您需要設置適合于WordPress的開發環境。要開始，您將需要一個本地服務器堆棧和一個文本編輯器。有很多選擇，包括：本地服務器堆棧 - 本地服務器堆棧（如LAMP（Linux Apache MySQL PHP））或WAMP（Windows Apache MySQL PHP）是服務器（與您的Web服務器上運行的服務器非常相似），您將在本地機器上進行配置。您可以安裝包含所有這些的預捆綁程序，如MAMP（適用于Mac）或XAMPP（Mac或Windows），以快速設置您的環境。虛擬環境 - 使用Vagrant和VirtualBox創建的虛擬化功能允許您創建易于重現的開發環境。[ Varyant Vagrant Vagrant（VVV）](https://github.com/Varying-Vagrant-Vagrants/VVV)是流行的Vagrant選項，創建了WordPress開發環境。文本編輯器 - 除了本地服務器環境之外，還需要一個文本編輯器來編寫代碼。您選擇的文本編輯器是個人的，但請記住，一個好的文本編輯器可以加快您的開發過程。您的文本編輯器可以從編寫代碼到完全集成的開發環境（IDE）的基本工具中進行調試和測試。值得進行研究，有些甚至包括對WordPress開發的支持。熱門的選擇是Atom，Sublime Text和PhpStorm。 >[warning] 您可以在頁面底部找到有關設置開發環境的教程列表。 ## 支持較舊版本的WordPress WordPress主題的標準做法是至少支持兩個版本，以確保最小的向后兼容性。例如，如果當前版本的WordPress為4.6，那么您還應該確保您的主題在4.5和4.4版本中運行良好。您可以參考[WordPress路線圖](https://wordpress.org/about/roadmap/)頁面訪問舊版本的WordPress。然后，您可以下載并安裝較舊的WordPress版本，創建多個開發站點，每個版本運行不同的WordPress版本進行測試。 ### WP_DEBUG 配置調試是WordPress主題開發的重要組成部分。 WordPress提供了許多常量來支持您的調試工作。這些包括： WP_DEBUG - `WP_DEBUG`PHP常量用于在您的WordPress安裝上觸發內置的“調試”模式。這允許您查看主題中的錯誤。啟用它： 1. 打開您的WordPress安裝的wp-config.php文件 2. 修改: ```PHP define( 'WP_DEBUG', false ); ``` 為 ```PHP define( 'WP_DEBUG', true ); ``` >[info] 注意：通常在wp-config.php文件中設置為“false”，默認情況下，即將發布的WP_DEBUG版本的WordPress-alpha和beta版本的開發副本已設置為“true”。 ### WP_DEBUG_DISPLAY 和 WP_DEBUG_LOG `WP_DEBUG_LOG`和`WP_DEBUG_DISPLAY`是擴展`WP_DEBUG`的其他PHP常量。 `WP_DEBUG_LOG`與`WP_DEBUG`結合使用，將所有錯誤消息記錄到WordPress /wp-content/目錄中的debug.log中。要啟用此功能，您的`wp-config.php`文件中將`WP_DEBUG_LOG`設置為`true`。 ```php define( 'WP_DEBUG_LOG', true ); ``` `WP_DEBUG_DISPLAY`用于控制調試消息是否顯示在主題頁面的HTML中。要在屏幕上顯示錯誤消息，請在`wp-config.php`文件中將此設置配置為`true`。 ```php define( 'WP_DEBUG_DISPLAY', true ); ``` 啟用`WP_DEBUG`和`WP_DEBUG_DISPLAY`后，錯誤消息將顯示在您網站頁面的頂部。 >[info] 注意：錯誤將顯示在您的站點的前端和管理區域。這些調試工具用于本地測試和后臺安裝，而不是在發布站點。 ## 其他WordPress開發工具除了`WP_DEBUG`，以下插件和單元測試數據集是開發工具集的重要組成部分，可幫助您開發更好的WordPress主題。 ### 測試數據 #### WordPress.org 主題單元測試數據 [WordPress.org主題單元測試數據](https://codex.wordpress.org/Theme_Unit_Test)是一個包含虛擬測試數據的XML文件，您可以上傳以測試主題如何與不同類型和內容布局進行匹配。 #### WordPress.com 主題單元測試數據 [WordPress.com主題單元測試數據](http://themetest.wordpress.com/)是虛擬測試數據，您可以上傳到WordPress安裝來測試您的主題，包括特定于WordPress.com的功能。 ## 插件 **Debug Bar (WordPress插件)** - Debug Bar為您的WordPress管理員添加一個管理欄，提供調試中心位置。 **Query Monitor (WordPress插件)** - Query Monitor 允許調試數據庫查詢，API請求和AJAX調用用于生成主題頁和主題功能。 **Log Deprecated Notices (WordPress插件)** - 日志已棄用通知記錄不正確的功能使用和WordPress主題中使用已棄用的文件和功能。 **Monster Widgets (WordPress插件)** - Monster Widget將核心WordPress小部件整合到一個小部件中，允許您在主題中測試小部件的樣式和功能。 **Developer (WordPress插件)** - 開發人員通過輕松安裝工具和插件來幫助您排除故障并確保代碼質量，幫助您優化開發環境。 **Theme-Check (WordPress插件)** - Theme-Check測試您的主題，以符合最新的WordPress標準和做法。 ## WordPress主題評論指南除了上述開發工具之外，最好在[WordPress.org主題評審小組](https://make.wordpress.org/themes/2013/11/10/guidelines-shouldnt-fail-a-theme/)的主題提交指南和[WordPress編碼標準](https://make.wordpress.org/core/handbook/best-practices/coding-standards/)會議指導上保持最新。這些指南是質量主題開發的“黃金標準”，即使您不打算在WordPress.org上發布主題，也是有用的。 ## 其他資源 - 使用MAMP本地開發WordPress (Mac, MAMP) - 如何為Windows設置WordPress開發環境 (Windows, XAMPP) - WordPress主題評論VVV：測試主題的快速流動設置 (Cross-platform, Vagrant) - 設置開發環境 (WordPress.com VIP) - wptest.io – 從WordPress的主題單元測試派生的一系列WordPress測試數據