PHP 庫很方便,因為可以從應用程式中的任何位置存取它們:從插件、元件模型、模組等。如果有人已經解決了類似的問題並將其設計為庫(甚至更新了它),將這個庫連接到您的 Joomla 是有意義的。例如,要為線上商店開發支付方式,您需要支付聚合器的官方庫。或者您對某些CRM官方的PHP SDK是否滿意。
Joomla 不支援直接使用 Composer。為了在工作中使用該庫,您需要將其「包裝」在 Joomla 擴充類型庫中並安裝它。在嚴肅的專案中,採用修復專案所有元件版本的方法:程式碼經過多次檢查、測試並允許在生產中工作。
您使用您的庫建立一個包,將其安裝在您需要的任何地方。隨著庫的新版本發布,您可以更新包裝器並獲得使用 Joomla 擴展的所有優勢:以標準方式更新擴展,包括透過 CLI。在更新等之前,請在管理區域中查看擴充功能的變更日誌
更新至 Joomla 5 之前,請在管理區域中查看變更日誌擴充功能。
Joomla 符合 PSR 標準,因此在這方面使用它很方便。 Joomla 核心中包含一些 Symfony 軟體包(控制台、字串、vardumper、yaml、錯誤處理程序等),因此如果您突然想要添加更多軟體包,它們將適合併運行良好。除了庫/供應商中的 Symfony 元件之外,您還可以看到 Joomla 中還有哪些有價值的內容。
沒什麼複雜的。庫檔案通常位於 src 資料夾中。在此資料夾旁邊,您需要根據文件 (manual.joomla.org) 建立 Joomla 擴充功能的 XML 清單。然後我們將所有內容打包到 zip 檔案中,就是這樣!可以安裝了。
如果您需要在資料庫中擁有自己的表才能使程式庫正常運作,則需要在安裝或更新過程中使用 SQL 查詢新增必要的檔案。由於 Joomla 4 使用命名空間,因此在擴充功能的 XML 清單中指定此命名空間非常重要。以下是 Joomla 庫的 XML 清單的縮寫範例。
<?xml version="1.0" encoding="UTF-8" ?> <extension type="library" method="upgrade"> <name>WebTolk AmoCRM library</name> <libraryname>Webtolk/Amocrm</libraryname> <version>1.2.1</version> ... <namespace path="src">Webtolk\Amocrm</namespace> <files> <folder>src</folder> <filename>amocrm.xml</filename> </files> </extension>
;標籤表示我們存檔中的 src 資料夾將複製到 JPATH_SITE/libraries/Webtolk/Amocrm。在中部分,我們指出需要從檔案中填寫的內容。和
<?php use Joomla\CMS\Helper\LibraryHelper; use Joomla\CMS\Cache\Cache; /** * Function called before extension installation/update/removal procedure commences. * * @param string $type The type of change (install or discover_install, update, uninstall) * @param InstallerAdapter $adapter The adapter calling this method * * @return boolean True on success * * @since 1.0.0 */ public function preflight(string $type, InstallerAdapter $adapter): bool { if ($type == 'uninstall') { return true; } /** * * Joomla when updating extensions of the library type, it actually deletes them (along with the data in the database), * and then installs it again. * In order to avoid losing library data from the database, we are writing this crutch. * * @see https://github.com/joomla/joomla-cms/issues/39360 * */ if ($type == 'update') { $lib_params = LibraryHelper::getParams('Webtolk/Amocrm'); $jconfig = $this->app->getConfig(); $options = array( 'defaultgroup' => 'wt_amo_crm_temp', 'caching' => true, 'cachebase' => $jconfig->get('cache_path'), 'storage' => $jconfig->get('cache_handler'), ); $cache = Cache::getInstance('', $options); $cache->store($lib_params, 'wt_amo_crm_temp'); } return true; }
相應地,在 postflight() 方法中,我們使用 LibraryHelper::saveParams('Webtolk/Amocrm', $lib_params); 將保存的參數放回原處。
<?php use Joomla\CMS\Plugin\PluginHelper; use Joomla\Registry\Registry; if (PluginHelper::isEnabled('system', 'wt_amocrm')) { $plugin = PluginHelper::getPlugin('system', 'wt_amocrm'); $params = \json_decode($plugin->params); $param = $params->param; // OR you can use Joomla\Registry\Registry $params = new Registry($plugin->params); $param = $params->get('param', 'defatul value if empty'); }
以上是在 Joomla 中連接第三方 PHP 函式庫的詳細內容。更多資訊請關注PHP中文網其他相關文章!