WordPress 插件更新機(jī)制詳解及最佳實(shí)踐

WordPress 本身并不提供原生插件更新流程，開(kāi)發(fā)者需要自行實(shí)現(xiàn)。這包括更新數(shù)據(jù)庫(kù)中的版本號(hào)以及必要時(shí)創(chuàng)建新的選項(xiàng)。

WordPress 插件的版本號(hào)應(yīng)存儲(chǔ)在兩個(gè)地方：插件主文件中的常量和數(shù)據(jù)庫(kù)中的選項(xiàng)。這使得能夠檢測(cè)自上次插件更新以來(lái)數(shù)據(jù)庫(kù)選項(xiàng)是否已更新。

更新選項(xiàng)時(shí)，開(kāi)發(fā)者應(yīng)注意不要覆蓋用戶(hù)的選擇。如果數(shù)據(jù)庫(kù)中不存在某個(gè)選項(xiàng)，則應(yīng)創(chuàng)建它；如果已存在，則不應(yīng)覆蓋它。

對(duì)于存儲(chǔ)為數(shù)組的選項(xiàng)，開(kāi)發(fā)者可以使用 PHP 函數(shù) array_merge() 來(lái)確保所有鍵都已定義，并且不會(huì)引入任何不存在的選項(xiàng)。這也確保如果用戶(hù)更改了舊選項(xiàng)，則會(huì)保留其值。

幾周前，我收到一封關(guān)于 WP Photo Sphere（我開(kāi)發(fā)的一個(gè) WordPress 插件）的郵件。問(wèn)題很大：更新插件導(dǎo)致某些安裝程序崩潰。經(jīng)過(guò)一番調(diào)查，我發(fā)現(xiàn)問(wèn)題源于插件使用的選項(xiàng)：這些安裝程序沒(méi)有為我添加的新選項(xiàng)提供任何默認(rèn)值。

這些值非常重要，所以我需要一種方法來(lái)創(chuàng)建默認(rèn)值。但是，與我的想法相反，WordPress 沒(méi)有提供任何原生方法來(lái)處理更新過(guò)程。

這就是我想寫(xiě)這篇教程的原因。首先，我們將準(zhǔn)確了解為什么我們需要更新過(guò)程以及為什么 WordPress 不提供此類(lèi)過(guò)程。然后，我將向您展示如何正確創(chuàng)建自己的過(guò)程來(lái)更新您的選項(xiàng)。

插件更新過(guò)程的重要性

通常，僅更改文件不足以正確更新某些內(nèi)容。例如，當(dāng)您手動(dòng)將 WordPress 文件更新到新版本時(shí)，平臺(tái)會(huì)要求您點(diǎn)擊一個(gè)按鈕來(lái)更新數(shù)據(jù)庫(kù)。

假設(shè)您在插件中使用選項(xiàng)。隨著插件的發(fā)展，您在新版本中將需要更多選項(xiàng)。在用戶(hù)首次激活插件時(shí)創(chuàng)建新選項(xiàng)很容易，您只需使用激活鉤子即可。

例如，讓我們看一下以下代碼：

function my_awesome_plugin_activation() {
    update_option('my_awesome_plugin_option', 'default value');
}
register_activation_hook(__FILE__, 'my_awesome_plugin_activation');

如果您不熟悉使用 update_option() 來(lái)代替 add_option()，請(qǐng)不要擔(dān)心，我們稍后將在討論如何處理更新過(guò)程時(shí)進(jìn)行解釋。

如果您想要一個(gè)新的選項(xiàng)，或者如果您在新版本中更新了現(xiàn)有選項(xiàng)的值，則需要更新已經(jīng)使用您的插件的用戶(hù)數(shù)據(jù)庫(kù)，因此我們需要一個(gè)在更新后立即調(diào)用的函數(shù)。

激活鉤子可能有點(diǎn)令人困惑。畢竟，當(dāng)您自動(dòng)更新插件時(shí)，它會(huì)被停用并重新激活，因此我們可以預(yù)期會(huì)調(diào)用此鉤子。但事實(shí)并非如此。

更準(zhǔn)確地說(shuō)，它曾經(jīng)是，但 WordPress 在 3.1 版中停止了此行為。開(kāi)發(fā)團(tuán)隊(duì)解釋了這個(gè)選擇，您可以在 Make WordPress Core 博客上閱讀完整的解釋。主要原因是它并非每次都被調(diào)用，因?yàn)槿绻脩?hù)手動(dòng)更新插件，則可以跳過(guò)激活鉤子。

因此，WordPress 沒(méi)有提供在插件更新后自動(dòng)調(diào)用函數(shù)的默認(rèn)方法。這就是為什么您需要構(gòu)建自己的過(guò)程。

如何處理更新過(guò)程

在本教程的這一部分中，我將向您展示如何在插件更新后自動(dòng)調(diào)用給定函數(shù)。我們將在下一部分中看到如何正確處理現(xiàn)有選項(xiàng)的更新以及新選項(xiàng)的創(chuàng)建（在同一個(gè)函數(shù)中）。

此方法的原理

我們方法的全局原則是，我們將插件的版本號(hào)存儲(chǔ)在兩個(gè)地方：插件主文件中的常量和數(shù)據(jù)庫(kù)中的選項(xiàng)。

數(shù)據(jù)庫(kù)中的數(shù)字將存儲(chǔ)用戶(hù)當(dāng)前安裝的版本，而常量中的數(shù)字是當(dāng)前版本。如果這兩個(gè)數(shù)字不同，則自上次插件更新以來(lái)數(shù)據(jù)庫(kù)選項(xiàng)尚未更新，因此我們需要執(zhí)行此操作。

在這種情況下，我們將調(diào)用一個(gè)更新所有必要選項(xiàng)的函數(shù)。此函數(shù)還更新存儲(chǔ)在數(shù)據(jù)庫(kù)中的版本號(hào)：這樣，我們就不會(huì)過(guò)度調(diào)用此函數(shù)。

常量

既然我們已經(jīng)介紹了我們將要做什么，那么是時(shí)候編寫(xiě)代碼了！首先，在插件主文件中添加一個(gè)常量定義，并將您的當(dāng)前版本號(hào)作為值。為了防止任何問(wèn)題，我們測(cè)試它是否尚未存在。

function my_awesome_plugin_activation() {
    update_option('my_awesome_plugin_option', 'default value');
}
register_activation_hook(__FILE__, 'my_awesome_plugin_activation');

通常，插件版本使用數(shù)字標(biāo)識(shí)，但是，如果您使用其他系統(tǒng)，請(qǐng)隨意使用它。這里的唯一約束是為每個(gè)版本或至少為每個(gè)需要更改數(shù)據(jù)庫(kù)（新選項(xiàng)、新默認(rèn)值等）的版本提供唯一的標(biāo)識(shí)符。

檢查函數(shù)

我們現(xiàn)在需要編寫(xiě)一個(gè)函數(shù)來(lái)檢查數(shù)據(jù)庫(kù)是否需要更新。此函數(shù)將比較前面定義的常量與當(dāng)前存儲(chǔ)在數(shù)據(jù)庫(kù)中的值。為此，我們將確保我們的函數(shù)在任何地方都被調(diào)用，使用 plugins_loaded 動(dòng)作，一旦所有插件加載完畢就會(huì)觸發(fā)。

if (!defined('MY_AWESOME_PLUGIN_VERSION'))
    define('MY_AWESOME_PLUGIN_VERSION', '3.4.1');

此函數(shù)將很簡(jiǎn)單。我們檢索存儲(chǔ)在數(shù)據(jù)庫(kù)中的版本號(hào)，就像任何其他選項(xiàng)一樣，并將它與常量進(jìn)行比較。如果這些值不同，我們將調(diào)用 my_awesome_plugin_activation() 函數(shù)。

function my_awesome_plugin_check_version() {
}

add_action('plugins_loaded', 'my_awesome_plugin_check_version');

現(xiàn)在，我們需要澄清一些問(wèn)題。首先，如果選項(xiàng)在數(shù)據(jù)庫(kù)中尚不存在怎么辦？如果選項(xiàng)不存在，get_option() 將返回 false，這與您的版本號(hào)不同，因此將調(diào)用該函數(shù)。

那么我們?yōu)槭裁匆{(diào)用激活函數(shù)呢？明確地說(shuō)，我們可以創(chuàng)建一個(gè)新的函數(shù)，專(zhuān)門(mén)用于更新過(guò)程。但是，如果您這樣做，您會(huì)看到這個(gè)新函數(shù)將與激活非常相似，因?yàn)楦逻x項(xiàng)可以與創(chuàng)建選項(xiàng)的方式相同。

更新數(shù)據(jù)庫(kù)中的版本號(hào)

您可以在上面調(diào)用的激活函數(shù)中做任何您想做的事情。但是，有一件事是必要的，那就是更新存儲(chǔ)在數(shù)據(jù)庫(kù)中的版本號(hào)。這樣，我們不會(huì)在每次加載頁(yè)面時(shí)都調(diào)用我們的函數(shù)。

function my_awesome_plugin_activation() {
    update_option('my_awesome_plugin_option', 'default value');
}
register_activation_hook(__FILE__, 'my_awesome_plugin_activation');

請(qǐng)注意技巧：我們不使用 add_option()，只使用 update_option()。事實(shí)上，如果選項(xiàng)尚不存在，update_option() 將創(chuàng)建它。如果它存在，它將把它的值更新為指示的值。這就是為什么我們可以毫無(wú)問(wèn)題地將我們的激活函數(shù)用作更新函數(shù)。

更新選項(xiàng)

不要覆蓋用戶(hù)的選擇！

更新任何選項(xiàng)都可以與我們更新版本號(hào)的方式相同：您可以調(diào)用 update_option()，然后就完成了，即使這是 WordPress 第一次看到該選項(xiàng)。

但是，我們并不總是想更新選項(xiàng)值。事實(shí)上，如果您使用選項(xiàng)，通常是為了讓您的用戶(hù)個(gè)性化設(shè)置。通過(guò)使用 update_option()，您將在每次更新插件時(shí)覆蓋用戶(hù)的選擇，這不是我們想要做的。

在上面，我們看到如果選項(xiàng)不存在，get_option() 將返回 false。我們將使用此行為來(lái)測(cè)試我們想要更新的選項(xiàng)是否存在于數(shù)據(jù)庫(kù)中。如果是這種情況，我們什么也不做。否則，我們創(chuàng)建該選項(xiàng)。

if (!defined('MY_AWESOME_PLUGIN_VERSION'))
    define('MY_AWESOME_PLUGIN_VERSION', '3.4.1');

請(qǐng)注意，此測(cè)試對(duì)于我們不想覆蓋的選項(xiàng)是必要的。在某些情況下，我們可能想要這樣做，考慮版本號(hào)，我們當(dāng)然不想保留舊值！

特殊情況——數(shù)組

您應(yīng)該知道 WordPress 允許數(shù)組存儲(chǔ)我們的選項(xiàng)的值，并且創(chuàng)建它們并不比創(chuàng)建其他選項(xiàng)更難。例如：

function my_awesome_plugin_check_version() {
}

add_action('plugins_loaded', 'my_awesome_plugin_check_version');

如果您需要多個(gè)設(shè)置，使用數(shù)組是一個(gè)好主意。這樣，您不會(huì)在數(shù)據(jù)庫(kù)中使用大量條目，并且您限制了另一個(gè)插件使用相同名稱(chēng)的選項(xiàng)的機(jī)會(huì)。但是，當(dāng)我們考慮更新過(guò)程時(shí)，這可能會(huì)導(dǎo)致問(wèn)題。

為了理解原因，假設(shè)您有一個(gè)數(shù)組作為選項(xiàng)，帶有一些鍵。您的用戶(hù)肯定會(huì)個(gè)性化這些值。使用我們上面做的測(cè)試，我們只能在選項(xiàng)不存在時(shí)創(chuàng)建它，并且這些選擇不會(huì)被覆蓋。這看起來(lái)很簡(jiǎn)單，但是如果您想在數(shù)組中創(chuàng)建一個(gè)新鍵怎么辦？

如果選項(xiàng)存在于數(shù)據(jù)庫(kù)中，則前面的代碼不會(huì)創(chuàng)建它，因此您的新鍵將不存在。但是，如果我們刪除條件，則數(shù)組將在每次新更新時(shí)檢索其默認(rèn)值。不太理想。幸運(yùn)的是，有一個(gè)解決方案！

首先，我們定義一個(gè)包含選項(xiàng)默認(rèn)值的數(shù)組（如果存在新鍵）。

if (MY_AWESOME_PLUGIN_VERSION !== get_option('my_awesome_plugin_version'))
    my_awesome_plugin_activation();

然后，我們檢索當(dāng)前存儲(chǔ)在數(shù)據(jù)庫(kù)中的數(shù)組。

function my_awesome_plugin_activation() {
    update_option('my_awesome_plugin_option', 'default value');
}
register_activation_hook(__FILE__, 'my_awesome_plugin_activation');

現(xiàn)在我們可以使用 PHP 函數(shù) array_merge()，將我們的默認(rèn)值數(shù)組作為第一個(gè)參數(shù)，將用戶(hù)的數(shù)組作為第二個(gè)參數(shù)。這樣，我們將得到一個(gè)包含 $default 數(shù)組中定義的所有鍵的數(shù)組，并且我們不會(huì)有任何不存在的選項(xiàng)。如果用戶(hù)更改了舊選項(xiàng)之一，則會(huì)保留其值。使用 array_merge()，我們始終保留最新的定義。

if (!defined('MY_AWESOME_PLUGIN_VERSION'))
    define('MY_AWESOME_PLUGIN_VERSION', '3.4.1');

最后，我們使用 update_option() 將結(jié)果存儲(chǔ)在數(shù)據(jù)庫(kù)中。

function my_awesome_plugin_check_version() {
}

add_action('plugins_loaded', 'my_awesome_plugin_check_version');

我們快結(jié)束了，但是如果函數(shù)第一次執(zhí)行，我們現(xiàn)在需要修復(fù)一個(gè)您可能會(huì)遇到的錯(cuò)誤。

此函數(shù)在插件激活時(shí)被調(diào)用，這就是我們想要的。但是，在這種情況下，選項(xiàng)尚不存在，因此 get_option() 返回 false。問(wèn)題是將 false 用作 array_merge() 的參數(shù)會(huì)導(dǎo)致錯(cuò)誤。

我們想要的是簡(jiǎn)單的，如果選項(xiàng)不存在，我們希望 $option 是一個(gè)空數(shù)組。為此，我們可以使用 get_option() 的第二個(gè)參數(shù)，它表示要獲取的默認(rèn)值（為了不返回 false）。

if (MY_AWESOME_PLUGIN_VERSION !== get_option('my_awesome_plugin_version'))
    my_awesome_plugin_activation();

結(jié)論

一旦您仔細(xì)閱讀了它，處理 WordPress 插件的更新過(guò)程并不復(fù)雜。但是，如果您使用選項(xiàng)，這很重要，因?yàn)闆](méi)有初始化選項(xiàng)可能會(huì)導(dǎo)致一些問(wèn)題。

目前，WordPress 沒(méi)有提供處理插件更新的原生方法。事實(shí)上，考慮到我們上面列出的問(wèn)題，如果我們看到有一天引入了這種類(lèi)型的功能，則應(yīng)該以類(lèi)似于本教程的方式實(shí)現(xiàn)它。

您可以在這里獲取我的示例插件的代碼。將此代碼視為實(shí)現(xiàn)您自己的 WordPress 插件更新過(guò)程的框架。如果您有任何反饋，請(qǐng)?jiān)谙旅娴脑u(píng)論中告訴我。

WordPress 插件更新常見(jiàn)問(wèn)題解答 (FAQ)

定期更新 WordPress 插件的重要性是什么？

定期更新 WordPress 插件至關(guān)重要，原因如下：首先，更新通常包含可以增強(qiáng)網(wǎng)站性能的新功能和功能。其次，更新通常會(huì)修復(fù)可能危及網(wǎng)站安全的錯(cuò)誤和漏洞。最后，更新確保與最新版本的 WordPress 兼容，確保您的網(wǎng)站平穩(wěn)高效地運(yùn)行。

如何確保安全更新我的 WordPress 插件？

為了確保安全更新，請(qǐng)務(wù)必在啟動(dòng)更新過(guò)程之前備份您的網(wǎng)站。這樣，如果在更新過(guò)程中出現(xiàn)任何問(wèn)題，您可以輕松地將您的網(wǎng)站恢復(fù)到之前的狀態(tài)。此外，建議在將其應(yīng)用于您的實(shí)時(shí)網(wǎng)站之前，在暫存網(wǎng)站上測(cè)試更新。

如果插件更新失敗，我該怎么辦？

如果插件更新失敗，第一步是從備份中恢復(fù)您的網(wǎng)站。然后，嘗試確定失敗的原因。這可能是由于與另一個(gè)插件或主題沖突，或者與您的 WordPress 版本存在兼容性問(wèn)題。一旦您確定了問(wèn)題，您可以自己解決它，或者聯(lián)系插件開(kāi)發(fā)者尋求幫助。

如何自動(dòng)執(zhí)行更新 WordPress 插件的過(guò)程？

WordPress 具有內(nèi)置功能，允許您自動(dòng)更新插件。您可以通過(guò)轉(zhuǎn)到 WordPress 儀表板中的“插件”部分，選擇您想要自動(dòng)更新的插件，然后單擊“啟用自動(dòng)更新”來(lái)啟用此功能。

如果插件更新導(dǎo)致我的網(wǎng)站出現(xiàn)問(wèn)題，我可以回滾插件更新嗎？

是的，如果插件更新導(dǎo)致您的網(wǎng)站出現(xiàn)問(wèn)題，您可以回滾插件更新。有幾個(gè)可用的插件，例如 WP Rollback，允許您輕松地恢復(fù)到插件的先前版本。

如何更新高級(jí) WordPress 插件？

高級(jí) WordPress 插件的更新方式與免費(fèi)插件類(lèi)似。但是，您需要擁有有效的許可證密鑰才能訪問(wèn)更新。輸入許可證密鑰后，您可以從 WordPress 儀表板更新插件。

管理多個(gè) WordPress 網(wǎng)站的更新的最佳方法是什么？

如果您正在管理多個(gè) WordPress 網(wǎng)站，則可能需要花費(fèi)大量時(shí)間為每個(gè)網(wǎng)站單獨(dú)更新插件。更有效的方法是使用 WordPress 管理工具（例如 ManageWP 或 MainWP），它允許您從單個(gè)儀表板管理所有網(wǎng)站的更新。

如何禁用特定 WordPress 插件的自動(dòng)更新？

如果您想禁用特定插件的自動(dòng)更新，可以使用 Easy Updates Manager 等插件。此插件允許您控制網(wǎng)站上每個(gè)插件的自動(dòng)更新。

如何檢查插件更新與我的 WordPress 版本的兼容性？

在更新插件之前，您可以通過(guò)訪問(wèn) WordPress 插件目錄上的插件頁(yè)面來(lái)檢查其與您的 WordPress 版本的兼容性。在這里，您會(huì)找到有關(guān)插件與不同 WordPress 版本的兼容性的信息。

如果插件更新破壞了我的網(wǎng)站，我該怎么辦？

如果插件更新破壞了您的網(wǎng)站，第一步是從備份中恢復(fù)您的網(wǎng)站。然后，停用導(dǎo)致問(wèn)題的插件。如果您無(wú)法訪問(wèn)您的 WordPress 儀表板，您可以通過(guò) FTP 停用插件，方法是重命名 wp-content/plugins 目錄中的插件文件夾。停用插件后，您可以排除故障或聯(lián)系插件開(kāi)發(fā)者尋求幫助。

以上是WordPress插件以正確的方式更新的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！